// Add or run Scala CLI integration tests. Use when adding integration tests, debugging RunTests/CompileTests/etc., or working in modules/integration.
| name | scala-cli-integration-tests |
| description | Add or run Scala CLI integration tests. Use when adding integration tests, debugging RunTests/CompileTests/etc., or working in modules/integration. |
Location: modules/integration/. Tests invoke the CLI as an external process.
Run: ./mill -i integration.test.jvm (all). Filter: ./mill -i integration.test.jvm 'scala.cli.integration.RunTestsDefault.*' or by test name. Native: ./mill -i integration.test.native.
Structure: *TestDefinitions.scala (abstract, holds test logic) → *TestsDefault, *Tests213, etc. (concrete, Scala version trait). Traits: TestDefault, Test212, Test213, Test3Lts, Test3NextRc.
Adding a test:
*TestDefinitions (e.g. RunTestDefinitions for run).test("description") { … } using TestInputs(os.rel / "Main.scala" -> "…").fromRoot { root => … } and os.proc(TestUtil.cli, "run", …).call(cwd = root).Helpers: TestInputs(...).fromRoot, TestUtil.cli. Test groups (CI): SCALA_CLI_IT_GROUP=1..5; see modules/integration/ for group mapping.
Deprecate CLI options, option aliases, using directives, sub-commands, or config keys in Scala CLI. Use when marking a feature as deprecated with a warning.
Add or change using directives in Scala CLI. Use when adding a new //> using directive, registering a directive handler, or editing directive preprocessing.