doc draft

Author: c0d33ngr

example/extending/evaluator/1-resolve-segments/build.mill

@@ -0,0 +1,43 @@
+package build
+import mill.*, scalalib.*
+
+import mill.define._
+import mill.define.SelectMode
+import mill.api.Result.create
+import mill.api.Result
+
+object `package` extends ScalaModule {
+  def scalaVersion = "2.13.11"
+  def mvnDeps = Seq(
+    mvn"com.lihaoyi::scalatags:0.13.1",
+    mvn"com.lihaoyi::mainargs:0.6.2"
+  )
+
+  object test extends ScalaTests {
+    def mvnDeps = Seq(mvn"com.lihaoyi::utest:0.8.5")
+    def testFramework = "utest.runner.Framework"
+  }
+
+  def customSegmentCommand(evaluator: Evaluator, tasks: String*) = Task.Command(exclusive = true) {
+    val segmentsResult = evaluator
+      .resolveSegments(tasks, SelectMode.Multi)
+      .get
+
+    segmentsResult.foreach { segment =>
+      println(s"Segment: ${segment.parts.mkString(", ")}")
+    }
+    ()
+  }
+
+}
+
+// This command resolves the segments of the given tasks and prints them.
+// The segments are the parts of the task names that are used to group tasks.
+
+/** Usage
+
+> ./mill customSegmentCommand compile test
+Segment: compile
+Segment: test
+
+*/

example/extending/evaluator/1-resolve-segments/foo/src/Foo.scala

@@ -0,0 +1,16 @@
+package foo
+import scalatags.Text.all._
+import mainargs.{main, ParserForMethods}
+
+object Foo {
+  def generateHtml(text: String) = {
+    h1(text).toString
+  }
+
+  @main
+  def main(text: String) = {
+    println(generateHtml(text))
+  }
+
+  def main(args: Array[String]): Unit = ParserForMethods(this).runOrExit(args)
+}

example/extending/evaluator/1-resolve-segments/foo/test/src/FooTests.scala

@@ -0,0 +1,18 @@
+package foo
+
+import utest._
+
+object FooTests extends TestSuite {
+  def tests = Tests {
+    test("simple") {
+      val result = Foo.generateHtml("hello")
+      assert(result == "<h1>hello</h1>")
+      result
+    }
+    test("escaping") {
+      val result = Foo.generateHtml("<hello>")
+      assert(result == "<h1>&lt;hello&gt;</h1>")
+      result
+    }
+  }
+}