Refactor CliCommand, Scaladoc arguments parsing and add some tests

Author: BarkingBad

compiler/src/dotty/tools/dotc/Driver.scala

@@ -64,19 +64,24 @@ class Driver {
 
   protected def sourcesRequired: Boolean = true
 
-  def setup(args: Array[String], rootCtx: Context): (List[AbstractFile], Context) = {
+  protected def command: CompilerCommand = ScalacCommand
+
+  def setup(args: Array[String], rootCtx: Context): (Option[List[AbstractFile]], Context) = {
     val ictx = rootCtx.fresh
-    val summary = CompilerCommand.distill(args, config.ScalaSettings(), ictx.settingsState)
+    val settings = config.ScalaSettings()
+    val summary = command.distill(args, settings, settings.defaultState)
     ictx.setSettings(summary.sstate)
     MacroClassLoader.init(ictx)
     Positioned.init(using ictx)
 
     inContext(ictx) {
       if !ctx.settings.YdropComments.value || ctx.mode.is(Mode.ReadComments) then
         ictx.setProperty(ContextDoc, new ContextDocstrings)
-      val fileNames = CompilerCommand.checkUsage(summary, sourcesRequired)(using ctx.settings)(using ctx.settingsState)
-      val files = fileNames.map(ctx.getFile)
-      (files, fromTastySetup(files))
+      val fileNamesOrNone = command.checkUsage(summary, sourcesRequired)(using ctx.settings)(using ctx.settingsState)
+      fileNamesOrNone.fold((None, ictx)) { fileNames =>
+        val files = fileNames.map(ctx.getFile)
+        (Some(files), fromTastySetup(files))
+      }
     }
   }
 
@@ -183,7 +188,9 @@ class Driver {
    */
   def process(args: Array[String], rootCtx: Context): Reporter = {
     val (files, compileCtx) = setup(args, rootCtx)
-    doCompile(newCompiler(using compileCtx), files)(using compileCtx)
+    files.fold(compileCtx.reporter) {
+      doCompile(newCompiler(using compileCtx), _)(using compileCtx)
+    }
   }
 
   def main(args: Array[String]): Unit = {

compiler/src/dotty/tools/dotc/Resident.scala

@@ -40,16 +40,21 @@ class Resident extends Driver {
 
   final override def process(args: Array[String], rootCtx: Context): Reporter = {
     @tailrec def loop(args: Array[String], prevCtx: Context): Reporter = {
-      var (files, ctx) = setup(args, prevCtx)
-      inContext(ctx) { doCompile(residentCompiler, files) }
-      var nextCtx = ctx
-      var line = getLine()
-      while (line == reset) {
-        nextCtx = rootCtx
-        line = getLine()
-      }
-      if (line.startsWith(quit)) ctx.reporter
-      else loop(line split "\\s+", nextCtx)
+      var (possibleFiles, ctx) = setup(args, prevCtx)
+      if possibleFiles.isDefined then
+        inContext(ctx) {
+          doCompile(residentCompiler, possibleFiles.get) // using more complex constructs like fold or map instead of get will make @tailrec complain
+        }
+        var nextCtx = ctx
+        var line = getLine()
+        while (line == reset) {
+          nextCtx = rootCtx
+          line = getLine()
+        }
+        if (line.startsWith(quit)) ctx.reporter
+        else loop(line split "\\s+", nextCtx)
+      else
+        ctx.reporter
     }
     loop(args, rootCtx)
   }

compiler/src/dotty/tools/dotc/ScalacCommand.scala

@@ -0,0 +1,9 @@
+package dotty.tools.dotc
+
+import config.Properties._
+import config.CompilerCommand
+
+object ScalacCommand extends CompilerCommand:
+  override def cmdName: String = "scalac"
+  override def versionMsg: String = s"Scala compiler $versionString -- $copyrightString"
+  override def ifErrorsMsg: String = "  scalac -help  gives more information"

compiler/src/dotty/tools/dotc/config/CliCommand.scala

@@ -13,9 +13,17 @@ trait CliCommand:
 
   type ConcreteSettings <: CommonScalaSettings with Settings.SettingGroup
 
+  def versionMsg: String
+
+  def ifErrorsMsg: String
+
   /** The name of the command */
   def cmdName: String
 
+  def isHelpFlag(using settings: ConcreteSettings)(using SettingsState): Boolean
+
+  def helpMsg(using settings: ConcreteSettings)(using SettingsState, Context): String
+
   private def explainAdvanced = """
     |-- Notes on option parsing --
     |Boolean settings are always false unless set.
@@ -31,14 +39,6 @@ trait CliCommand:
     |           already are in phase X + 1.
   """
 
-  def shortUsage: String = s"Usage: $cmdName <options> <source files>"
-
-  def versionMsg: String = s"Scala $versionString -- $copyrightString"
-
-  def ifErrorsMsg: String = "  -help  gives more information"
-
-  def shouldStopWithInfo(using settings: ConcreteSettings)(using SettingsState): Boolean
-
   /** Distill arguments into summary detailing settings, errors and files to main */
   def distill(args: Array[String], sg: Settings.SettingGroup, ss: SettingsState): ArgsSummary =
     /**
@@ -64,11 +64,8 @@ trait CliCommand:
 
     sg.processArguments(expandedArguments, ss, processAll = true)
 
-
-  def infoMessage(using settings: ConcreteSettings)(using SettingsState)(using Context): String
-
   /** Creates a help message for a subset of options based on cond */
-  def availableOptionsMsg(cond: Setting[?] => Boolean)(using settings: ConcreteSettings)(using SettingsState): String =
+  protected def availableOptionsMsg(cond: Setting[?] => Boolean)(using settings: ConcreteSettings)(using SettingsState): String =
     val ss                  = (settings.allSettings filter cond).toList sortBy (_.name)
     val width               = (ss map (_.name.length)).max
     def format(s: String)   = ("%-" + width + "s") format s
@@ -90,8 +87,9 @@ trait CliCommand:
 
     ss.map(helpStr).mkString("", "\n", s"\n${format("@<file>")} A text file containing compiler arguments (options and source files).\n")
 
+  protected def shortUsage: String = s"Usage: $cmdName <options> <source files>"
 
-  def createUsageMsg(label: String, shouldExplain: Boolean, cond: Setting[?] => Boolean)(using settings: ConcreteSettings)(using SettingsState): String =
+  protected def createUsageMsg(label: String, shouldExplain: Boolean, cond: Setting[?] => Boolean)(using settings: ConcreteSettings)(using SettingsState): String =
     val prefix = List(
       Some(shortUsage),
       Some(explainAdvanced) filter (_ => shouldExplain),
@@ -100,42 +98,50 @@ trait CliCommand:
 
     prefix + "\n" + availableOptionsMsg(cond)
 
-  def isStandard(s: Setting[?])(using settings: ConcreteSettings)(using SettingsState): Boolean = !isAdvanced(s) && !isPrivate(s)
-  def isAdvanced(s: Setting[?])(using settings: ConcreteSettings)(using SettingsState): Boolean = s.name.startsWith("-X") && s.name != "-X"
-  def isPrivate(s: Setting[?])(using settings: ConcreteSettings)(using SettingsState): Boolean  = s.name.startsWith("-Y") && s.name != "-Y"
+  protected def isStandard(s: Setting[?])(using settings: ConcreteSettings)(using SettingsState): Boolean =
+    !isAdvanced(s) && !isPrivate(s)
+  protected def isAdvanced(s: Setting[?])(using settings: ConcreteSettings)(using SettingsState): Boolean =
+    s.name.startsWith("-X") && s.name != "-X"
+  protected def isPrivate(s: Setting[?])(using settings: ConcreteSettings)(using SettingsState): Boolean =
+    s.name.startsWith("-Y") && s.name != "-Y"
 
   /** Messages explaining usage and options */
-  def usageMessage(using settings: ConcreteSettings)(using SettingsState)    = createUsageMsg("where possible standard", shouldExplain = false, isStandard)
-  def xusageMessage(using settings: ConcreteSettings)(using SettingsState)   = createUsageMsg("Possible advanced", shouldExplain = true, isAdvanced)
-  def yusageMessage(using settings: ConcreteSettings)(using SettingsState)   = createUsageMsg("Possible private", shouldExplain = true, isPrivate)
-
-  def phasesMessage: String =
+  protected def usageMessage(using settings: ConcreteSettings)(using SettingsState) =
+    createUsageMsg("where possible standard", shouldExplain = false, isStandard)
+  protected def xusageMessage(using settings: ConcreteSettings)(using SettingsState) =
+    createUsageMsg("Possible advanced", shouldExplain = true, isAdvanced)
+  protected def yusageMessage(using settings: ConcreteSettings)(using SettingsState) =
+    createUsageMsg("Possible private", shouldExplain = true, isPrivate)
+
+  protected def phasesMessage: String =
     (new Compiler()).phases.map {
       case List(single) => single.phaseName
       case more => more.map(_.phaseName).mkString("{", ", ", "}")
     }.mkString("\n")
 
   /** Provide usage feedback on argument summary, assuming that all settings
    *  are already applied in context.
-   *  @return  The list of files passed as arguments.
+   *  @return  Either Some list of files passed as arguments or None if further processing should be interrupted.
    */
-  def checkUsage(summary: ArgsSummary, sourcesRequired: Boolean)(using settings: ConcreteSettings)(using SettingsState)(using Context): List[String] =
+  def checkUsage(summary: ArgsSummary, sourcesRequired: Boolean)(using settings: ConcreteSettings)(using SettingsState, Context): Option[List[String]] =
     // Print all warnings encountered during arguments parsing
     summary.warnings.foreach(report.warning(_))
 
     if summary.errors.nonEmpty then
       summary.errors foreach (report.error(_))
       report.echo(ifErrorsMsg)
-      Nil
+      None
     else if settings.version.value then
       report.echo(versionMsg)
-      Nil
-    else if shouldStopWithInfo then
-      report.echo(infoMessage)
-      Nil
+      None
+    else if isHelpFlag then
+      report.echo(helpMsg)
+      None
+    else if (sourcesRequired && summary.arguments.isEmpty)
+      report.echo(usageMessage)
+      None
     else
-      if (sourcesRequired && summary.arguments.isEmpty) report.echo(usageMessage)
-      summary.arguments
+      Some(summary.arguments)
 
   extension [T](setting: Setting[T])
     protected def value(using ss: SettingsState): T = setting.valueIn(ss)

compiler/src/dotty/tools/dotc/config/CompilerCommand.scala

@@ -9,19 +9,16 @@ import Properties._
 
 import scala.collection.JavaConverters._
 
-object CompilerCommand extends CliCommand:
-  type ConcreteSettings = ScalaSettings
-  override def cmdName: String = "scalac"
-  override def versionMsg: String = s"Scala compiler $versionString -- $copyrightString"
-  override def ifErrorsMsg: String = "  scalac -help  gives more information"
+abstract class CompilerCommand extends CliCommand:
+  final type ConcreteSettings = ScalaSettings
 
-  def infoMessage(using settings: ScalaSettings)(using SettingsState)(using Context): String =
+  final def helpMsg(using settings: ScalaSettings)(using SettingsState, Context): String =
     if (settings.help.value) usageMessage
     else if (settings.Xhelp.value) xusageMessage
     else if (settings.Yhelp.value) yusageMessage
     else if (settings.showPlugins.value) ctx.base.pluginDescriptions
     else if (settings.XshowPhases.value) phasesMessage
     else ""
 
-  def shouldStopWithInfo(using settings: ScalaSettings)(using SettingsState): Boolean =
+  final def isHelpFlag(using settings: ScalaSettings)(using SettingsState): Boolean =
     Set(settings.help, settings.Xhelp, settings.Yhelp, settings.showPlugins, settings.XshowPhases) exists (_.value)

compiler/src/dotty/tools/dotc/decompiler/Main.scala

@@ -18,7 +18,7 @@ object Main extends dotc.Driver {
     new TASTYDecompiler
   }
 
-  override def setup(args0: Array[String], rootCtx: Context): (List[AbstractFile], Context) = {
+  override def setup(args0: Array[String], rootCtx: Context): (Option[List[AbstractFile]], Context) = {
     var args = args0.filter(a => a != "-decompile")
     if (!args.contains("-from-tasty")) args = "-from-tasty" +: args
     if (args.contains("-d")) args = "-color:never" +: args

compiler/src/dotty/tools/repl/Main.scala

@@ -3,5 +3,5 @@ package dotty.tools.repl
 /** Main entry point to the REPL */
 object Main {
   def main(args: Array[String]): Unit =
-    new ReplDriver(args).runUntilQuit()
+    new ReplDriver(args).tryRunning
 }

compiler/src/dotty/tools/repl/ReplCommand.scala

@@ -0,0 +1,9 @@
+package dotty.tools.repl
+
+import dotty.tools.dotc.config.Properties._
+import dotty.tools.dotc.config.CompilerCommand
+
+object ReplCommand extends CompilerCommand:
+  override def cmdName: String = "scala"
+  override def versionMsg: String = s"Scala code runner $versionString -- $copyrightString"
+  override def ifErrorsMsg: String = "  scala -help  gives more information"

compiler/src/dotty/tools/repl/ReplDriver.scala

@@ -22,6 +22,7 @@ import dotty.tools.dotc.reporting.{Message, Diagnostic}
 import dotty.tools.dotc.util.Spans.Span
 import dotty.tools.dotc.util.{SourceFile, SourcePosition}
 import dotty.tools.dotc.{CompilationUnit, Driver}
+import dotty.tools.dotc.config.CompilerCommand
 import dotty.tools.io._
 import org.jline.reader._
 
@@ -67,7 +68,8 @@ class ReplDriver(settings: Array[String],
   private def initialCtx = {
     val rootCtx = initCtx.fresh.addMode(Mode.ReadPositions | Mode.Interactive | Mode.ReadComments)
     rootCtx.setSetting(rootCtx.settings.YcookComments, true)
-    val ictx = setup(settings, rootCtx)._2
+    val (files, ictx) = setup(settings, rootCtx)
+    shouldStart = files.isDefined
     ictx.base.initialize()(using ictx)
     ictx
   }
@@ -91,13 +93,24 @@ class ReplDriver(settings: Array[String],
   }
 
   private var rootCtx: Context = _
+  private var shouldStart: Boolean = _
   private var compiler: ReplCompiler = _
   private var rendering: Rendering = _
 
   // initialize the REPL session as part of the constructor so that once `run`
   // is called, we're in business
   resetToInitial()
 
+  override protected def command: CompilerCommand = ReplCommand
+
+  /** Try to run REPL if there is nothing that prevents us doing so.
+   *
+   * Possible reason for unsuccessful run are raised flags in CLI like --help or --version
+   */
+  final def tryRunning = if shouldStart then
+    println("Starting scala3 REPL...")
+    runUntilQuit()
+
   /** Run REPL with `state` until `:quit` command found
    *
    *  This method is the main entry point into the REPL. Its effects are not

compiler/src/dotty/tools/scripting/ScriptingDriver.scala

@@ -19,28 +19,30 @@ import sys.process._
 class ScriptingDriver(compilerArgs: Array[String], scriptFile: File, scriptArgs: Array[String]) extends Driver:
   def compileAndRun(pack:(Path, String, String) => Boolean = null): Unit =
     val outDir = Files.createTempDirectory("scala3-scripting")
-    val (toCompile, rootCtx) = setup(compilerArgs :+ scriptFile.getAbsolutePath, initCtx.fresh)
-    given Context = rootCtx.fresh.setSetting(rootCtx.settings.outputDir,
-      new PlainDirectory(Directory(outDir)))
-
-    if doCompile(newCompiler, toCompile).hasErrors then
-      throw ScriptingException("Errors encountered during compilation")
-
-    try
-      val (mainClass, mainMethod) = detectMainClassAndMethod(outDir, ctx.settings.classpath.value, scriptFile)
-      val invokeMain: Boolean =
-        Option(pack) match
-          case Some(func) =>
-            func(outDir, ctx.settings.classpath.value, mainClass)
-          case None =>
-            true
-        end match
-      if invokeMain then mainMethod.invoke(null, scriptArgs)
-    catch
-      case e: java.lang.reflect.InvocationTargetException =>
-        throw e.getCause
-    finally
-      deleteFile(outDir.toFile)
+    val (toCompileOrNone, rootCtx) = setup(compilerArgs :+ scriptFile.getAbsolutePath, initCtx.fresh)
+    toCompileOrNone.map { toCompile =>
+      given Context = rootCtx.fresh.setSetting(rootCtx.settings.outputDir,
+        new PlainDirectory(Directory(outDir)))
+
+      if doCompile(newCompiler, toCompile).hasErrors then
+        throw ScriptingException("Errors encountered during compilation")
+
+      try
+        val (mainClass, mainMethod) = detectMainClassAndMethod(outDir, ctx.settings.classpath.value, scriptFile)
+        val invokeMain: Boolean =
+          Option(pack) match
+            case Some(func) =>
+              func(outDir, ctx.settings.classpath.value, mainClass)
+            case None =>
+              true
+          end match
+        if invokeMain then mainMethod.invoke(null, scriptArgs)
+      catch
+        case e: java.lang.reflect.InvocationTargetException =>
+          throw e.getCause
+      finally
+        deleteFile(outDir.toFile)
+    }
   end compileAndRun
 
   private def deleteFile(target: File): Unit =