Search code examples
scalaimplicitscala-reflectscalametadotty

In scala 2 or 3, is it possible to debug implicit resolution process in runtime?


In scala language, implicit resolution is often done in compile-time and sometimes throws obfuscating error information, one famous example of such error is when shapeless Generic throws error information like:

error: could not find implicit value for parameter encoder: CsvEncoder[Foo]

(see https://books.underscore.io/shapeless-guide/shapeless-guide.html for detail)

A solution to this problem is to run implicit resolution algorithm (should be a graph query algorithm internally) in runtime, this has at least 2 benefits:

  • debugging tools can be used to reproduce the resolution process step-by-step, so even error information & documentations are incomplete it would be easy to spot the error.

  • in many cases type information can be impossible to be determined in compile-time (e.g. type depending on the control flow). If implicit conversion cannot be delayed to runtime phase, many benefit of defining implicit conversion will be nullified.

So my question is, does this feature exist in Scala 2.x or Dotty? Or is it on the roadmap?

Thanks a lot for your opinion.


Solution

  • You can debug implicits at compile time:

    1. switch on compiler flag -Xlog-implicits

    2. try to resolve implicits manually (maybe specifying type parameters as well) and see compile errors

       implicitly[...](...manually...)
      
    3. use scala.reflect

       println(reify { implicitly[...] }.tree)
      

      (or switch on compiler flag -Xprint:typer) in order to see how implicits are resolved

    4. use IDE functionality to show implicits

      https://github.com/ljwagerfield/debugging-scala-implicits-in-intellij

      https://www.jetbrains.com/help/idea/edit-scala-code.html

    5. using macros with compiler internals you can debug implicit resolution

      Is there a type-class that checks for existence of at least one implicit of a type?

      create an ambiguous low priority implicit

      Using the "Prolog in Scala" to find available type class instances

      Finding the second matching implicit

      How to summon a `given` member?

      shapeless/package.scala (def cachedImplicitImpl[T](implicit tTag: WeakTypeTag[T]): Tree = ...)

    If you're developing a type class don't forget to use annotations @implicitNotFound and @implicitAmbiguous.


    You can always postpone compilation of your program till runtime. So instead of program

    object App {
      def main(args: Array[String]): Unit = {
        println("test") // test
      }
    }
    

    you can have

    import scala.reflect.runtime.currentMirror
    import scala.reflect.runtime.universe._
    import scala.tools.reflect.ToolBox
    val toolbox = currentMirror.mkToolBox()
    
    toolbox.eval(q"""
      object App {
        def main(args: Array[String]): Unit = {
          println("test")
        }
      }
    
      App.main(Array())
    """) // test
    

    And instead of

    implicitly[Numeric[Int]]
    

    you can have

    toolbox.compile(q"""
      implicitly[Numeric[Int]]
    """)
    

    or

    toolbox.inferImplicitValue(
      toolbox.typecheck(tq"Numeric[Int]", mode = toolbox.TYPEmode).tpe, 
      silent = false
    )
    

    But it's too optimistic to think that postponing program compilation till runtime you'll be able to debug implicits easier at runtime rather than at compile time. Actually postponing program compilation till runtime you add one level of indirection more i.e. make things harder to debug.