• Mill now takes a lock on the out/ folder whenver evaluating it to avoid race conditions on disk. #3599. Pass in --no-build-lock to disable it at your own risk

• Update Zinc to 0.10.3 to fix issues with over-compilation #3748

• runIvyDeps is now transitive, as is the newly-introduced runModuleDeps, to try and match the semantics of runtime deps in Mavenhttps://github.com//pull/3774[#3774]

Changes since 0.12.0-RC2

• -j/--jobs now allows computed values of the form -j 0.5C (half as many jobs as cores) or -j C-2 (two less jobs than cores) to allow for automatic scaling based on the number of cores available #3554

• Fix testOnly handling of ScalaTest tagged tests #3557

• Make ./mill without any arguments point you towards --help, flesh out --help into a cheat sheet #3556

• Use Task instead of T when constructing targets and other tasks #3565. The new syntax (given below) is intended to be more idiomatic Scala and less idiosyncratic. The old syntax will continue to work for backwards compatibility, but using the new syntax is recommended

  • T {…​} → Task {…​}

  • T.command {…​} → Task.Command {…​}

  • T.input {…​} → Task.Input {…​}

  • T.source {…​} → Task.Source {…​}

  • T.sources {…​} → Task.Sources {…​}

  • T.persistent {…​} → Task(persistent = true) {…​}

  • T.task {…​} → Task.Anon {…​}

• Introduced Task.Command(exclusive = true) to allow explicit annotation of which commands need to run without parallelism, allowing .test and other commands to run parallel by default #3617

• Lots of added docs for Building Kotlin with Mill:

  • Kotlin Build Examples and Linting #3555, with KtLint and Detekt support

  • Kotlin Module Configuration #3585

  • Publishing and Testing Kotlin with Mill #3589

  • Using Mill to build a Ktor web server #3621

• Additional support for Kotlin tools and frameworks

  • KtFmt support #3620

  • Kover support #3624

• Show Worker tasks in resolve/show/inspect #3580

• mill clean now terminates Worker tasks #3579

• Overhaul of the terminal "ticker" UI for displaying task progress to better support parallel builds #3577

  • Mill now shows all active tasks and their duration at the bottom of your terminal

  • Stream task logs are now prefixed with the task index on the left and the task name above, so you can attribute each line of logs to the task that generated it

• Add API for tasks to spawn concurrent and parallel futures via Task.fork.{async,await} #3478

• Allow large test modules with many classes to be broken up to use multiple concurrent JVMs by overriding def testForkGrouping #3478

• Use coursier thread pool to run coursier-related tasks to avoid deadlocks #3614

• inspect now shows useful information when used on modules, not just tasks #3532

• mill init now supports creating a project based on examples from Mill’s documentation #3583, and unpacks the example into the current folder rather than a subfolder #3626

• MILL_TEST_RESOURCE_FOLDER has been renamed to MILL_TEST_RESOURCE_DIR for consistency with other environment variable names #3637

Changes since 0.12.0-RC1

• Support exclude attribute in Dep parser. You can give exclusions with ;exclude=org:name or ;exclude=org:* or ;exclude=*:name #3492

• Fix ScalaModule#console by properly inheriting streams #3500

• Adjust codegen to allow custom mainargs.TokensReaders, and include a mainargs.TokensReader[os.Path] by default for convenience #3504

• Update to OS-Lib 0.10.7 to allow concise multi-segment sub-paths; you can now write os.pwd / "foo/bar/qux" rather than os.pwd / "foo" / "bar" / "qux"

• Add JavaModule.mandatoryJavacOptions. Those are not propagated to the inner test traits intentionally, since those options are typically configured by other means, e.g. dedicated targets. #3503

• Add plugins to run Checkstyle and generate reports #3516

• Simplified PublishModule's publishing setup via #3523. You can now run mill mill.scalalib.PublishModule/ with the proper environment variables (below) and it should do the right thing by default

  • Prefix all environment variables with MILL_: MILL_SONATYPE_USERNAME, MILL_SONATYPE_PASSWORD, MILL_PGP_SECRET_BASE64, MILL_PGP_PASSPHRASE to try and add some rudimentary ownership and namespacing

• Allow external modules to have a defaultCommandName #3545. This has been applied to ScalafmtModule and PublishModule, so you can now autoformat your code via mill mill.scalalib.ScalafmtModule/ and publish it via mill mill.scalalib.PublishModule/ without needing the /reformatAll .sources or /publishAll .publishArtifacts suffix

• Integrated Kotlin integration as a first partly module and add example documentation #3514. This is still pretty spartan, but we expect to flesh it out over time

• Move .mill.sc alternate file extension to .mill.scala #3521

• Breaking Changes

  • Build file overhaul: Mill’s build file management has been overhauled to better support large projects. See Structuring Large Builds for details

    • Mill now uses .mill as its file extension, with some semantic changes from the old .sc files to allow better IDE support. The .sc extension is still supported and its semantics are largely unchanged the ease the migration, but you should convert your Mill configs to .mill files to benefit from Mill’s improved IDE experience going forward.

    • The build.sc file has been renamed build.mill to prevent confusion with Ammonite/Scala-CLI scripts, and all associated .sc files have been renamed to .mill.

      • Until IntelliJ-Scala adds support for .mill files built in, you can add it yourself via Settings / Editor / File Types / Scala and add the pattern *.mill

    • All .mill files must have a package declaration, with package build for .mill files in the root folder and package build.foo.bar for .mill files in foo/bar/.

      • The package declaration remains optional for legacy .sc files

    • Only foo.mill files in folders directly containing a build.mill or package.mill can be imported via import $file.

      • You need to create empty package.mill files in any folder containing scripts if they are not already adjacent to your build.mill in the root folder

      • foo.sc files can continue to be imported from arbitrary paths, to ease in the migration

    • Builds can now be modularized into per-folder definitions by defining package.mill files in subfolders #3213. You can no longer define targets and modules in arbitrary foo.sc files

      • All target and module definitions must be moved into package.mill files in each folder.

    • $file references in .mill files are now absolute from the project root, and thus .^ to refer to parent package is no longer supported, for consistency with other programming environments

      • $file references in old .sc files are unchanged and continue being relative, preserving the current behavior.

  • RootModules can only be named package, e.g. object foo extends RootModule must now be named object package extends RootModule.

    • If you have an existing RootModule, you need to rename it object package extends RootModule

  • Turn on parallelism for task evaluation by default, except for commands which always run serially at the end #3265

    • This can be disabled by passing --jobs 1

  • Mill uses empty sandbox folders as the working directory for running its own code and #3367 and test suites #3347, to avoid accidental interference between tasks and tests due to parallelism. See Mill Sandboxing for details

    • This can be disabled by adding def testSandboxWorkingDir = false in your test module

  • Mill commands now require arguments to be passed named via ./mill mycommand --key value, rather than allowing just ./mill mycommand value. #3431.

    • You can pass in --allow-positional-command-args to fall back to the old behavior, or use @mainargs.arg(positional = true) on individual parameters

  • Dropped support for Java 8, Scala 2.11.x/3.1.x, and Scala-Native 0.4.x, following suit with the rest of the com-lihaoyi ecosystem. We now expect a minimum of Java 11, Scala 2.12.x/3.2.x, and Scala-Native 0.5.x

  • --disable-callgraph-invalidation is no longer supported. The flag is still accepted but is now a no-op.

• Other Changes

  • Overhaul the Mill client-server protocol to improve robustness #3363 #3366 #3368 #3370

  • Mill now has explicitly supported workflows for third-party plugin authors, and publishes unit, integration, and example test fixtures for writing plugins as mill-testkit #3398 for downstream plugin authors to use in testing their own Mill extensions.

    • See Writing Mill Plugins for more details.

    • mill-testkit is experimental and does not provide the same stability or binary-compatibility guarantees as the rest of Mill. Nevertheless, if you are writing Mill plugins, please try it out and let us know what you think!

  • Bump default Sonatype Maven Central publishing timeouts to 10 minutes to avoid timeouts due to slowness https://github.com/com-lihaoyi/mill/commit/b4c9386b0233fab53a312426715e226e4a7f6302

  • Importing Mill projects into IntelliJ via BSP now properly marks the out/, .idea/, and .bsp/ folders as excluded #3329

  • Optimizations to Mill evaluation logic to reduce fixed overhead of running Mill on large projects #3388

  • Improvements to visualize and visualizePlan such that they no longer need to be prefixed with show and no longer need a separate graphviz/dot install on Mac-OSX #3438

This release is binary incompatible to 0.11.0-M10.

Changes since 0.11.0-M10:

• Make foo.test command run tests with user code in the boot classloader, rather than in a sub-classloader #2561

• Mill backend server timeout is now configurable #2550

• Mill assembly is now distributed via Maven Central, rather than Github release assets, to remove an unnecessary single point of failure #2560

• Tests inner trait was removed, to avoid trait shadowing which will be removed in Scala 3. Please use ScalaTests, ScalaJSTests, or ScalaNativeTests instead #2558

For details refer to milestone 0.11.0-M11 and the list of commits.

This release is binary incompatible to 0.11.0-M9.

Changes since 0.11.0-M9:

• Make mill.define.Module a trait to allow abstract/virtual modules to be traits rather than classes #2536

• Move mill.BuildInfo to mill.main.BuildInfo to avoid name conflicts with mill.contrib.buildinfo.BuildInfo #2537

• PlatformScalaModule now exposes platformScalaSuffix for user code to use #2534

• Add Agg.when operator to simplify common workflow of adding optional flags or command line parameters #2353

• Generalize handling of test module source folder layout, such that they always match the folder layout of the enclosing module #2531

For details refer to milestone 0.11.0-M10 and the list of commits.

This release is binary incompatible to 0.11.0-M8.

Changes since 0.11.0-M8:

• Overhauled target resolution logic. It is now significantly lazier, resulting in less of the module tree being un-necessarily instantiated, and also more precise and predictable #2453 #2511

• Allow tasks to be passed as the CLI parameters of the run command, allowing run to be easily used in the implementation of other tasks #2452

• Task.Inputs are now watched properly with --watch, and trigger re-evaluations when the watched value changes #2489

• Support for Java 20 #2501

• Broke up mill.modules package #2513, with functionality re-distributed to mill.util and mill.scalalib

• Overhaul BSP-related code, for improved fidelity and correctness #2415 #2414 #2518 #2521

• Enabled compilation warnings in build.sc #2519

• Print out the CLI flags when inspecting Task.Commands #2522

For details refer to milestone 0.11.0-M9 and the list of commits.

This release is binary incompatible to 0.11.0-M7.

Changes since 0.11.0-M7:

• Added an example/ folder in the Mill repo, containing common build setups demonstrating Mill features with explanations of how each feature works

• Pre-compiled Scala incremental compiler interface #2424, to speed up clean builds

• Add some helpers to simplify cross-version/cross-platform modules {#2406}[#2406]

• You can now override T{…​} Targets with Task.Source or Task.Sources, and vice versa #2402

• Removed the Ammonite script runner dependency used to evaluate build.sc files and instead compile them using Mill #2377

• Add TestModule.ZioTest #2432

• Caching fixes for external modules #2419

• Overhaul of the Mill BuildInfo plugin, moving the key-value into resources to avoid needing to re-compile your module when the values change, adding JavaModule support, and allowing Javadoc/Scaladoc comments to be associated with the generated BuildInfo constants #2425

• Global Configuration via ~/.mill/ammonite/predefScript.sc is no longer supported in this version. If that breaks your workflow, please report and tell us your use case so we can provide sufficient replacement or support for your use case before Mill 0.11.

• Overhaul of the documentation. Created many executable example projects which are included in the documentation and run/tested on CI

• Change cross module definitions to be traits instead of classes, for greater regularity and less builerplate at call sites. This change requires slight modification to existing build scripts that define cross modules.

For details refer to milestone 0.11.0-M8 and the list of commits.

This release is binary incompatible to 0.11.0-M6.

Changes since 0.11.0-M6:

• Introduced automatic PathRef validation for cached targets; default-enabled it for CoursierModule.resolveDeps and various resolvedIvyDeps targets

• bsp: Update Protocol version to 2.1.0-M4

• bsp: Support new mainClasses field in run and test environments

• bsp: Fixed handling of Mill plugins and other improvements

• scalanativelib: new nativeDump setting in ScalaNativeModule

• contrib.twirllib: Use newer scala-parser-combinators version when used with Scala 3

• contrib.scalapblib: Added new flag to search for proto files in dependencies

• Various refactorings to improve binary compatibility

• Updated dependencies: Ammonite 3.0.0-M0-5 coursier 2.1.0, scala native tools 0.4.12, semanticdb 4.7.6, trees 4.7.6, upickle 3.0.0

• DX improvements

For details refer to milestone 0.11.0-M7 and the list of commits.

This release is binary incompatible to 0.11.0-M5.

Changes since 0.11.0-M5:

• main: Re-added missing --color and predef cli arguments.

For details refer to milestone 0.11.0-M6 and the list of commits.

This release is binary incompatible to 0.11.0-M4.

Changes since 0.11.0-M4:

• Cross is no longer adding the cross parameters to the millSourcePath.

  You should review your cross modules setups to avoid build issues like incorrect source paths or missing files. CrossScalaModule is not affected by this change.

• API refactorings: PathRef, moved JarManifest to mill.main

• No longer inherit the Ammonite CLI config

• scalalib: Fixed loosing customized mapDependencies when ScalaModule get mixed in after

• scalalib: New TestModule.Weaver

• scalajslib: New JsEnvConfig.Selenium

• testrunner: Fixed concurrency issue with test event reporting

• Updated dependencies: ammonite 3.0.0-M0-3, coursier 2.1.0-RC6, jarajar-abrams-core 1.8.2, lambdatest 0.8.0, log4j-core 2.20.0, os-lib 0.9.1, scoverage 2.0.8, semanticdb-scalac 4.7.5, trees 4.7.5

• Documentation updates

For details refer to milestone 0.11.0-M5 and the list of commits.

This release is binary incompatible to 0.11.0-M3.

Changes since 0.11.0-M3:

• scalalib: New configuration target zincReportCachedProblems which, when true, enables reporting of all found problems, even for files which were not re-compiled

• scalalib: Improved SemanticDB support for Java and Scala

• scalalib: Mitigate another coursier download issue

• scalajslib: Fetch more tooling dependencies in prepareOffline

• scalanativelib: Fetch more tooling dependencies in prepareOffline

• scalanativelib: Updated tools to version 0.4.10

• bsp: Improved support for the mill-build module which should improve the editing experience for build.sc and other build files

• Cleanups and internal improvements

• Updated dependencies: Ammonite 3.0.0-M0-1, junixsocket 2.6.2, semanticdb-java 0.8.13, upickle 3.0.0-M2

For details refer to milestone 0.11.0-M4 and the list of commits.

This release is binary incompatible to 0.11.0-M2.

Changes since 0.11.0-M2:

• Slightly changed the out/ folder layout for overridden and private tasks. Instead of foo.overridden we now use a foo.super path to hold the metadata and scratch files.

• Fixed the caching for private targets with same name but defined in different super traits.

• Fixed non-functional clean command when used with arguments denoting modules.

• scalalib: Fixed GenIdea issues on Windows, when the build uses plugins or additional libraries.

• scalajslib: ScalaJSModule.ScalaJSTests now extends ScalaModule.ScalaTests which improves consistency, better default values and compatibility with other modules like ScoverageModule.

• scalanativelib: ScalaNativeModule.ScalaNativeTests now extends ScalaModule.ScalaTests which improves consistency, better default values and compatibility with other modules.

• contrib.gitlab: Improved error handling for token lookup and documentation.

• Updated dependencies: coursier 2.1.0-RC5, jna 5.13.0, semanticdb-scala 4.7.3, trees 4.7.3

• Documentation improvements

For details refer to milestone 0.11.0-M3 and the list of commits.

This release is binary incompatible to 0.11.0-M1.

Changes since 0.11.0-M1:

• Splitted BSP module into mill.bsp and mill.bsp.worker and removed various dependencies (guava, bsp4j, xtends, lsp4j, …​) from Mill API

• scalalib: Added support to generate semanticdb data for Java source files

• scalajslib: Added support for scalaJSOutputPattern

• scalajslib: Added suport for scalaJSSourceMap

• scalajslib: Dropped support for Scala.js 0.6

• Updated dependencies: ammonite 2.5.6, coursier 2.1.0-RC4, semanticdb 4.7.1, requests 0.8.0, scalafmt 3.6.1, trees 4.7.1, upickle 3.0.0-M1, utest 0.8.1

• Various internal cleanups and improvements

• Documentation improvements

For details refer to milestone 0.11.0-M2 and the list of commits.

This release is binary incompatible to 0.10.10.

Changes since 0.10.10:

• Greatly improved dependency resolution between modules, making it possible to mix Java and Scala modules

• main: Restrict Cross parameter to be of type Module

• scalalib: Performance improvements in Zinc worker module

• scalalib: Resources are no longer added to compileClasspath.

• scalalib: Added new compileResources which will end up in compileClasspath

• scalalib: Consolidated artifact and platform suffix handling

• scalajslib : Performance improvements in worker module

• scalanativelib : Performance improvements in worker module

• Updated dependencies: coursier 2.1.0-RC3, os-lib 0.9, scala 2.12.17, trees 4.7.0

• Removed lots of deprecated API

• Various internal cleanups and improvements

For details refer to milestone 0.11.0-M1 and the list of commits.

Changes since 0.10.13:

• Make semanticDbEnablePluginScalacOptions protected and thus accessible for downstream use and customization

For details refer to milestone 0.10.15 and the list of commits.

Changes since 0.10.12:

This version especially aids the transition from Mill 0.10 to Mill 0.11.

• Backport of Java 20 compatibility

• Deprecated mill.define.SelectMode.Single

• Backport of mill.eval.Evaluator.evalOrThrow

• Deprecated all inner Tests traits of modules derived from JavaModule and provide type aliases to use their successors

• Dependency updates: Ammonite 2.5.11, Coursier 2.1.7, jarjar-abrams 1.9.0, Junixxocket 2.8.2, Play 2.8.21, Scalameta Trees 4.8.12, Scala Native 0.4.16, Scoverage 2.0.11, Zinc 1.9.5

For details refer to milestone 0.10.13 and the list of commits.

Changes since 0.10.11:

• scalalib: Mitigate another coursier download issue (backported from 0.11.0-M4)

• testrunner: Fixed a concurrency issue with test event reporting (backported from 0.11.0-M5)

• scalajslib: Deprecated fastOpt and fullOpt

• Updated dependencies: coursier 2.1.0, jarjar-abrams 1.8.2, jna 5.13.0, junixsocket 2.6.2, log4j-core 2.20.0, scalafmt-dynamic 3.6.1, trees 4.7.6

For details refer to milestone 0.10.12 and the list of commits.

Changes since 0.10.10:

• Fixed non-functional clean command when used with arguments denoting modules.

• scalalib: Fixed GenIdea issues on Windows, when the build uses plugins or additional libraries.

• scalajslib: Performance improvements in worker module

• scalajslib: Pass more settings from ScalaJSModule to its Tests

  If you have issues after the update (like org.scalajs.jsenv.UnsupportedInputException, #2300), check your settings in the test modules for consistency.

• Some internal improvements backported from 0.11.0-M3

For details refer to milestone 0.10.11 and the list of commits.

After this release, the main branch is open for development of the next major version of Mill, which is probably 0.11. Further maintenance work will happen in the 0.10.x branch.

Changes since 0.10.9:

• Lots of documentation improvements, additions and restructurings

• core: Fixed some rare issues with reading the .mill-jvm-opts file

• core: We made slight adaptions to the T.dest location of target defined in included files, to fix potential colliding cache locations

• scalalib: JAR archives created by Mill now by default contain directory entries

• scalalib: Updated zinc to 1.8.0

• scalajslib: Added support for more JsEnv providers

  If you get some issues (like connect ECONNREFUSED, #2204) after the update, review your settings for JsEnv providers.

• scalanativelib: Support for incremental compilation since Scala Native 0.4.9

• contrib.testng: The TestNG library is no longer provided transitively; you need to provide it explicitly

• contrib.bloop: Fixed re-generation of bloop config dir; previously, it could happen, that there where no config files at all

• BSP: implement buildTarget/OutputPaths request

• Various version bumps and internal improvements

For details refer to milestone 0.10.10 and the list of commits.

Changes since 0.10.8:

• Hardened Maven and Ivy artifact handling to prevent path-traversal attacks (see CVE-2022-37866), also updated coursier dependency to a non-vulnerable version

• Decoupled mill-moduledefs module into a separate project, to better suite compiler plugin packaging and improve support for various Scala versions

• Applied more workarounds to coursier concurrency issues to make parallel builds more robust

• Added support for newer Scala versions in GenIdea (2.2 and 2.3)

• Fixed an issue where PublishModule dropped module dependencies when mixed-in after other trait which overrode moduleDeps

• new JMH contrib plugin

• Lots of internal improvements and dependency updates

For details refer to milestone 0.10.9 and the list of commits.

Changes since 0.10.7:

• Improvements for better Scala 3.2 support

• Fixed non-working default commands in cross modules

• CoursierModule: mitigate more download failure situations (e.g. checksum failures)

• PublishModule: properly show gpg output in server mode

• BSP: Better compiler message handling (logMessage instead of showMessage) and support for diagnostic code

• ScoverageModule: Support for Scoverage 2.x

• New contrib module GitlabPublishModule

• Various internal improvements and version bumps

• Documentation improvements

For details refer to milestone 0.10.8 and the list of commits.

Changes since 0.10.6:

• Don’t print unwanted debug messages from zinc

For details refer to milestone 0.10.7 and the list of commits.

Changes since 0.10.5:

• PathRefs sigs are now more reproducible and independent of the used filesystem

• JavaModule can now use a non-local Java Compiler to support all options

• Logger: new debugEnabled to detect whether debug logging is enabled

• New testkit module, to use UnitTester in external projects

• Fixed reading of .mill-jvm-opts in server mode

• BSP: Automatic SemanticDB enablement to improve Metals support

• mill.twirllib.TwirlModule - new mandatory target twirlScalaVersion to configure the Scala version used by Twirl compiler, and support for newer versions

• Lots of documentation updates and additions

• Upgraded to Zinc 1.7.1 and various other dependency updates

For details refer to milestone 0.10.6 and the list of commits.

Changes since 0.10.4:

• New init command, to create new Mill projects from Gitter8 (g8) templates

• PathRef now gracefully ignores socket files. This also fixes an annoying issue when Mill was previously ran in a source directory.

• Fixed a bug with using mill --repl without any further arguments, which was introduced in Mill 0.10.2 and prevented proper no-server mode

• Fixed the visualize command which wasn’t working on some newer JREs

• Improved Mill server support for Windows 11 and some Windows Server versions

• ScalaModule / ZincWorkerModule: Fixed incremental compilation issue with JRE 17 (and probably others)

• TestModule now better supports JUnit5 test suites

• ScalaJsModule: internal improvements to the stability of the Scala.js linker

• ScalaNativeModule: Added support for nativeEmbedResources

• BSP: improved handling of the mill-build module when the BSP client is IntelliJ IDEA

• Documentation updates and link fixes

• Various dependency updates

For details refer to milestone 0.10.5 and the list of commits.

Changes since 0.10.3:

• Switched from ipcsocket to junixsocket library to enhance the robustness of Mill client server communication. This should greatly improve the user experience on Windows.

• Internal improvements and better support of GraalVM

• The Mill Documentation site has now built-in search functionality

• ScalaJsModule: New targets fastLinkJS and fullLinkJS and deprecated fastOpt and fullOpt

• ScalaJsModule: Support for ModuleSplitStyle

• BSP: Updated to protocol version 2.1.0-M1, added support for test framework names and support for the JVM extension

• GenIdea: More consistent ordering of libraries and dependent modules and support for Scala 3.1 language level

• Bloop: Added support for runtime dependencies

• Enhanced test suite to cover Mill client server scenarios

• Various dependency updates

For details refer to milestone 0.10.4 and the list of commits.

Changes since 0.10.2:

• Fixed import $file for files with hyphens and other symbols in its name

• Fixed an issues with truncated output just before Mill finishes

• Mill commands now support arguments of type Task[T], which can improve writing re-usable commands, especially, they can be called from other tasks more easily

• JavaModule: Improved correctness and performance of compileClasspath and bspCompileClasspath targets. This fixes an issue with BSP for large projects. Also, compile-time dependencies no longer sneak into the classpath transitively.

• JavaModule: Added docJarUseArgsFile target and fix issue with Windows command length restrictions in docJar

• BSP and Bloop: Better detect foreign modules

• Various internal API refinements and improvements

• Reorganized integration test suite and build setup

For details refer to milestone 0.10.3 and the list of commits.

Changes since 0.10.1:

• Mill workers can now implement AutoCloseable to properly free resources

• ScalaModule: Fixed repl start

• CoursierModule: Fixed concurrent download issues with coursier (we detect and retry)

• MainModule: Fixed potential match error with show and showNamed

• Restructured contrib module documentation

• Internal improvements

For details refer to milestone 0.10.2 and the list of commits.

Changes since 0.10.0:

• MillClienMain can now act as universal main to start mill with or without a server process

• Improved show command that always returns valid JSON

• Added showNamed command that includes the task names in the output

• Implemented more granular cache invalidation which keeps more caches intact when you split your build setup over multiple .sc files with import $file.

• The local .mill-jvm-opts file is no longer restricted to -X options

• CoursierModule: Added coursierCacheCustomizer to support a FileCache customizers

• JavaModule: the docJar target no longer includes hidden files

• ScalaModule: Updated to latest zinc version

• ScalaModule: Reworked scalac plugins handling for the better and to support Scala 3

• ScalaNativeModule: fixed Dep.withDottyCompat behavior

• ScalaJSModule: support for linking multiple modules

• ScalafmtModule: Support for newer Scalafmt versions

• Tool chain: Update to Mill 0.10.0

• Tool chain: we no longer create files outside the mill project directory (e.g. ~/mill-release is now under target/mill-release)

• Various dependency updates

• Lots of internal improvements

For details refer to milestone 0.10.1 and the list of commits.

Changes since 0.10.0-M5:

• Changed structure of out directory, out/foo/dest is now out/foo.dest

• Fixed issues with loading of predef scripts

• --watch now supports manual re-runs by pressing enter

• Improved subprocess handling

• Published poms can now contain properties and versionScheme information

• Improved Scala.js support, including more target configuration options and support for Node 17

• Improved Scala Native for version > 0.4.2 and support Scala 3

• Internal improvements, fixes and dependency version updates

For details refer to milestone 0.10.0 and the list of commits.

This release breaks binary compatibility for external plugins.

Changes since 0.10.0-M4:

• Fixed Log4Shell security vulnerability in ZincWorkerModule (CVE-2021-44228)

• Factored out the testrunner into a new module, which also fixes some potential classloader issues when executing tests (e.g. with JNA)

• Removed the limitation of max 22 inputs for tasks

• --watched commands can now re-run when pressing enter-key

• task and arguments of commands can now have hyphens in their name

• Reworked and decluttered the out-folder structure

• prepareOffline now has a all flag to control if all or only some dependency should be prefetched

• Made caching more effective for targets overridden in stackable-traits

• Further BSP improvements, esp. for Metals and Scala 3

• Lots of other internal improvements and fixes

• Various dependency updates

For details refer to milestone 0.10.0-M5 and the list of commits.

Changes since 0.10.0-M3:

• BSP support rework and overhaul of built-in BSP server

• GenIdea: failures when inspecting and resolving the build are not properly reported

• Coursier: we now implemented a workaround to tackle concurrent downloads issues

• New + separator to provide multiple targets (with parameters) via cmdline

• New --import cmdline option to run ad-hoc plugins without editing of build.sc

• New T.ctx().workspace API to access the project root directory

• Various internal improvements and bug fixes

• Various refactorings and cleanups

For details refer to milestone 0.10.0-M4 and the list of commits.

This is a milestone release. This release breaks binary compatibility for external plugins build for mill 0.9.x. The API is suspected to change before a 0.10.0 releae.

Changes since 0.10.0-M2:

• ScalaModule with PublishModule: the scala-library artifact is now always part of the dependencies in published `pom.xml`s and `ivy.xml`s

• New JavaModule.mandatoryIvyDeps target to provide essential dependencies like scala-library without forcing the user to call super.ivyDeps

• ScalaJSModule.scalaLibraryIvyDeps no longer contains the scala-js-library, but only the scala-library; if you need that, use ScalaJSModule.mandatoryIvyDeps instead.

• import $ivy support $MILL_BIN_PLATFORM variable and a new sort notations for external plugins

• We fixed and enabled lots of tests to run on Windows

• Some generic targets like plan or path now also return their output

• GenIdea: improved support for Scala 3 projects *

For details refer to milestone 0.10.0-M3 and the list of commits.

This is a early milestone release. This release breaks binary compatibility for external plugins build for mill 0.9.x. The API is suspected to change before a 0.10.0 releae.

Changes since 0.9.9:

• Removed deprecated API

• ScalaModule: added mandatoryScalacOptions to avoid the common issue that users forget to include mandatory options when defining their own.

• Renamed toolsClasspath targets found in various modules to avoid hard to resolve clashes when mixing traits

• Fixed and improved our test suite on Windows

• Various fixes and improvements

• Various dependency updates

For details refer to milestone 0.10.0-M2 and the list of commits.

• fixed parsing of command parameters in show command

• zinc worker: Updated log4j2 to 2.17.1

For details refer to milestone 0.9.12 and the list of commits.

• zinc worker: Updated log4j2 to 2.16.0 to fix Log4Shell (CVE-2021-44228) vulnerability

For details refer to milestone 0.9.11 and the list of commits.

• Some feature backports from mill 0.10

• New + separator to provide multiple targets (with parameters) via cmdline

• New --import cmdline option to run ad-hoc plugins without editing of build.sc

• import $ivy support $MILL_BIN_PLATFORM variable and a new sort notations for external plugins

For details refer to milestone 0.9.10 and the list of commits.

Changes since 0.9.8:

• BSP: Fixed/improved source item for root project

• Bloop: Prevent compilation during bloop config generation

• GenIdea: Fix content path of root project (mill-build)

• Various version bumps

For details refer to milestone 0.9.9 and the list of commits.

Changes since 0.9.7:

• Fixed some potential binary incompatibilities with external plugins (builds against older os-lib versions)

• Fixed location and configuration of mills home path (used for caching of build scripts)

• Properly close jar resources - should fix issues in assembly, esp. on Windows where open resources are locked

• BSP: Repaired mills BSP server

• playlib: Fixed issues with the play-contrib module and added support for Play 2.8

• GenIdea: changed dir for generated mill modules to .idea/mill_modules

• Various version bumps, including Scala 2.13.5

For details refer to milestone 0.9.8 and the list of commits.

Changes since 0.9.6:

• ScalaModule: Support for Scala 3

• CoursierModule: Support customized dependency resolution (needed to work with ScalaFX)

• TestModule: Added new testFramework target and only support one test framework. Deprecated testFrameworks targets.

• TestModule: Added new convenience traits to configure popular test frameworks, e.g. TestModule.Junit4, TestModule.ScalaTest, TestModule.Utest and many more

• Bloop: Added support for foreign modules

• Better support for Windows environments

• Various internal improvements, cleanups, and deprecations

• Various dependencies updates

• Removed tut contrib module because of unmaintained/archived upstream dependency

For details refer to milestone 0.9.7 and the list of commits.

The mill project home and repository has been moved to https://github.com/com-lihaoyi/mill.

• repl and console targets now support forkArgs and forkEnv

• Support for Scala 3 release candidates and new Scaladoc 3 tool

• Support for Scala.js on Scala 3

• Scala Native improvements

• Test runner now uses an args file to support running tests on Windows

• GenIdea: better supports source jars, full config contributions and provided/runtime dependencies

• Various dependency updates

• Documentation site reworked to support multiple release versions

• Improved CI setup to better test mill on Windows

For details refer to milestone 0.9.6 and the list of commits.

• Updated zinc to 1.4.4

• Support for Scala Native 0.4.0

• Support for Scala.js ESModule (including Bloop support)

• Inner Tests traits in modules like JavaModule, ScalaModule and others now have unique names (JavaModuleTests, ScalaTests, etc), to allow for easier customization

• Various version bumps of dependencies

• CI now runs all tests, it did miss some before

For details refer to milestone 0.9.5 and the list of commits.

• Implemented more BSP protocol commands and fixed some glitches with IntelliJ

• Stabilized CI builds

• Various fixes and improvements

• Various version bumps

For details refer to milestone 0.9.4 and the list of commits.

(We also tagged 0.9.0, 0.9.1, and 0.9.2, but due to release difficulties, we ask you not to use them.)

• Replace the built in @main method functionality with the MainArgs library

• Note that the MainArgs replacement has some backwards incompatibilities: Short flags like -i can no longer be passed via --i, the @doc("") is now @arg(doc = ""), Seq[T] parameters are now passed via repeated --foo flags rather than comma-separated.

• Add the ability to relocate/shade files in .assembly #947

• Twirl enhancements #952

• Add scalacPluginClasspath to Tests #956

• Add toMap methods to BuildInfo #958

• Bump coursier to version 2.0.0 #973

• Make BSP support a first-class citizen #969

• Omit the suffix in artifactName in cross modules #953

• Allow test classes with constructor parameters #982

• Proguard contrib module #972

• Support Scala.js useECMAScript2015 option and ModuleKind.ESModule #1004

• Support Scala.js incremental linking #1007

For details refer to milestone 0.9.3 and the list of commits.

• Bump external dependencies: uPickle 1.2.0, Ammonite 2.2.0, etc.

• Use default coursier repos (#931)

• Work around relative paths issue on windows (#936)

• Support Scala.js versions >1.0.0 (#934)

For details refer to milestone 0.8.0 and the list of commits.

• new command line options --repl and --no-server, deprecated --interactive option

• Support for Scala.js 1.1

• Fixed missing source maps for Scala.js 1.0 and 1.1

• Improved BSP contrib module

For details refer to milestone 0.7.4 and the list of commits.

For details refer to milestone 0.7.3 and the list of commits.

For details refer to milestone 0.7.2 and the list of commits.

For details refer to milestone 0.7.1 and the list of commits.

• Greatly improved parallel builds via -j <n>/--jobs <n>, with better scheduling and utilization of multiple cores

• build.sc files now uses Scala 2.13.2

• Avoid duplicate target resolution with mill resolve __

• Add ability to pass GPG arguments to publish via --gpgArgs

• -w/--watch now works for Task.Source targets

For details refer to milestone 0.7.0 and the list of commits.

• Finished incomplete support to publish extra artifacts to IVY repositories (publishLocal)

• Improved Sonatype uploads

• GenIdea: improvements for shared source dirs and skipped modules

• ScoverageModule: Some refactorings to allow better customization

• More robust classpath handling under Windows

For details refer to milestone 0.6.3 and the list of commits.

• Mill can now execute targets in parallel. This is experimental and need to be enabled with --jobs <n> option.

• PublishModule: new publishM2Local to publish into local Maven repositories

• PublishModule: enhanced publishLocal to specify to ivy repository location

• Windows: Fixed windows launcher and more robust classpath handling

• ScalaNativeModule: improved compiling and linking support

• new contrib module VersionFile

• Dependency: improved dependency update checker and expose results for programmatic use

• ǹew contrib module Bintray

• ǹew contrib module Artifactory

• fixed testCached support in various modules

• GenIdea: improvements, esp. related to source jars

For details refer to milestone 0.6.2 and the list of commits.

• Bugfix: Mill now no longer leaks open files (version bump to uPickle 1.0.0)

• New --version option

• Added Support for Scala.js 1.0.0+

• Added Support for Scala Native 0.4.0-M2

• JavaModule: Enhanced ivyDepsTree to optionally include compile-time and runtime-time dependencies

• JavaModule: allSourceFiles no longer include Scala sources

• JavaModule: assembly supports configurable separator when merging resources

• ScoverageModule: respect unmanagedClasspath, added console reporter

• ScalaPBModule: added more configuration options

• Bloop: Fixed inconsistent working directory when executing tests via bloop (forces -Duser.dir when generating bloop config)

For details refer to milestone 0.6.1 and the list of commits.

• Support for METALS 0.8.0 in VSCode

For details refer to milestone 0.6.0 and the list of commits.

• Bump library versions again

• Alias T.ctx. functions to T.: T.dest, T.log, etc.

• Bump Mill’s client-connect-to-server timeout, to reduce flakiness when the server is taking a moment to start up

For details refer to the list of commits.

Version 0.5.8 has some binary compatibility issues in requests-scala/geny and should not be used.

• Bump library versions: Ammonite 2.0.1, uPickle 0.9.6, Scalatags 0.8.3, OS-Lib 0.6.2, Requests 0.4.7, Geny 0.4.2

For details refer to milestone 0.5.7 and the list of commits.

(we skipped version 0.5.4 as we had some publishing issues)

• Bump library versions: Ammonite 1.9.2, uPickle 0.9.0, Scalatags 0.8.2, OS-Lib 0.5.0, Requests 0.3.0, Geny 0.2.0, uTest 0.7.1

• Fixed a long standing issue that output of sub-processes are only shown when -i option was used. Now, you will always seen output of sub-process.

• Mill now properly restarts it’s server after it’s version has changed

• PublishModule: added ability to publish into non-staging repositories

• ScalaPBModule: added extra include path option

For details refer to milestone 0.5.5 and the list of commits.

• GenIdea/idea: improved support for generated sources and use/download sources in more cases

• ScalaJS: improvements and support for ScalaJS 0.6.29+ and 1.0.1.RC1

• Introduced new CoursierModule to use dependency management independent from a compiler

• ScoverageModule: better handling of report directories

• ScalaPBModule: more configuration options

• various other fixes and improvements

For details refer to milestone 0.5.3 and the list of commits.

• TestModule: new `testCached`target, which only re-runs tests after relevant changes

• TestModule.test: fixed issue when stacktraces have no filename info

• Dependency/updates: fixed issue with reading stale dependencies

• GenIdea/idea: no longer shared output directories between mill and IntelliJ IDEA

• support for Dotty >= 0.18.1

• Fixed backwards compatibility of mill wrapper script

• Mill now support the Build Server Protocol 2.0 (BSP) and can act as a build server

• bloop: removed semanticDB dependency

• Documentation updates

For details refer to milestone 0.5.2 and the list of commits.

• GenIdea: Bug fixes

• GenIdea: Support for module specific extensions (Facets) and additional config files

• Add ability to define JAR manifests

• Dotty support: Updates and support for binary compiler bridges

• Ivy: improved API to create optional dependendies

• Interpolate $MILL_VERSION in ivy imports

• Zinc: Fixed logger output

• Scoverage: Upgrade to Scoverage 1.4.0

• Flyway: Upgrade to Flyway 6.0.1

• Bloop: Updated semanticDB version to 4.2.2

• Documentation updates

• Improved robustness in release/deployment process

For details refer to milestone 0.5.1 and the list of commits.

• Mill now supports a ./mill bootstrap script, allowing a project to pin the version of Mill it requires, as well as letting contributors use ./mill …​ to begin development without needing to install Mill beforehand.

• Support for a .mill-version file or MILL_VERSION environment variable for Overriding Mill Versions

• Fix scoverage: inherit repositories from outer project #645

• Improvements to IntelliJ project generation #616

• Allow configuration of Scala.js' JsEnv #628

• Fixes for scala native test suites without test frameworks #627

• Fix publication of artifacts by increasing sonatype timeouts

• Bug fixes for Scoverage integration #623

• Publish compileIvyDeps as provided scope (535)

• Added contrib modules to integrate Bloop, Flyway, Play Framework, Scoverage

• Allow configuration of GPG key names when publishing (530)

• Bump Ammonite version to 1.6.7, making Requests-Scala available to use in your build.sc

• Support for Scala 2.13.0-RC2

• ScalaFmt support now uses the version specified in .scalafmt.conf

• Started to splitting out mill.api from mill.core

• Avoid unnecessary dependency downloading by providing fetches per cache policy

• Added detailed dependency download progress to the progress ticker

• Fixed internal code generator to support large projects

• Zinc worker: compiler bridge can be either pre-compiled or on-demand-compiled

• Zinc worker: configurable scala library/compiler jar discovery

• Zinc worker: configurable compiler cache supporting parallelism

• Version bumps: ammonite 1.6.0, scala 2.12.8, zinc 1.2.5

• Mill now by default fails fast, so in case a build tasks fails, it exits immediately

• Added new -k/--keep-going commandline option to disable fail fast behaviour and continue build as long as possible in case of a failure

• Bump uPickle to 0.7.1

• Mill is now bundled with OS-Lib, providing a simpler way of dealing with filesystem APIs and subprocesses

• Added new debug method to context logger, to log additional debug info into the task specific output dir (out/<task>/log)

• Added --debug option to enable debug output to STDERR

• Fix ScalaModule#docJar task when Scala minor versions differ 475

• Automatically detect main class to make ScalaModule#assembly self-executable

• Bump Ammonite to 1.3.2, Fastparse to 2.0.4

• Sped up ScalaModule#docJar task by about 10x, greatly speeding up publishing

• Add a flag JavaModule#skipIdea you can override to disable Intellij project generation #458

• Allow sub-domains when publishing #441

• mill inspect now displays out the doc-comment documentation for a task.

• Avoid shutdown hook failures in tests #422

• Ignore unreadable output files rather than crashing #423

• Don’t compile hidden files #428

• Add visualizePlan command

• Basic build-info plugin in mill-contrib-buildinfo

• ScalaPB integration in mill-contrib-scalapblib

• Fixes for Twirl support, now in mill-contrib-twirllib

• Support for building Dotty projects #397

• Allow customization of run/runBackground working directory via forkWorkingDir

• Reduced executable size, improved incremental compilation in #414

• Improve incremental compilation to work with transitive module dependencies

• Speed up hot compilation performance by properly re-using classloaders

• Speed up compilation time of build.sc files by removing duplicate macro generated routing code

• Add .runBackground and .runMainBackground commands, to run something in the background without waiting for it to return. The process will keep running until it exits normally, or until the same .runBackground command is run a second time to spawn a new version of the process. Can be used with -w for auto-reloading of long-running servers.

• Scala-Native support. Try it out!

• Add --disable-ticker to reduce spam in CI

• Fix propagation of --color flag

• Fix resolution of scala-{library,compiler,reflect} in case of conflict

• Allow configuration of JavaModule and ScalafmtModule scala workers

• Allow hyphens in module and task names

• Fix publishing of ScalaJS modules to properly handle upstream ScalaJS dependencies

• Added the mill visualize command, making it easy to visualize the relationships between various tasks and modules in your Mill build.

• Improve Intellij support (351): better jump-to-definition for third-party libraries, no longer stomping over manual configuration, and better handling of import $ivy in your build file.

• Support for un-signed publishing and cases where your GPG key has no passphrase (346)

• Basic support for Twirl, Play Framework’s templating language (271)

• Better performance for streaming large amounts of stdout from Mill’s daemon process.

• Allow configuration of append/exclude rules in ScalaModule#assembly (309)

• Preserve caches when transitioning between -i/--interactive and the fast client/server mode (329)

• Keep Mill daemon running if you Ctrl-C during -w/--watch mode (327)

• Allow mill version to run without a build file (328)

• Make docJar (and thus publishing) robust against scratch files in the source directories (334) and work with Scala compiler options (336)

• Allow passing Ammonite command-line options to the foo.repl command (333)

• Add mill clean (315) to easily delete the Mill build caches for specific targets

• Improve IntelliJ integration of `MavenModule`s/`SbtModule`s' test folders (298)

• Avoid showing useless stack traces when foo.test result-reporting fails or foo.run fails

• ScalaFmt support (308)

• Allow ScalaModule#generatedSources to allow single files (previous you could only pass in directories)

• Universal (combined batch/sh) script generation for launcher, assembly, and release (#264)

• Windows client/server improvements (#262)

• Windows repl support (note: MSYS2 subsystem/shell will be supported when jline3 v3.6.3 is released)

• Fixed Java 9 support

• Remove need for running publishAll using --interactive when on OSX and your GPG key has a passphrase

• First-class support for `JavaModule`s

• Properly pass compiler plugins to Scaladoc (#282)

• Support for ivy version-pinning via ivy"…​".forceVersion()

• Support for ivy excludes via ivy"…​".exclude() (#254)

• Make ivyDepsTree properly handle transitive dependencies (#226)

• Fix handling of runtime-scoped ivy dependencies (#173)

• Make environment variables available to Mill builds (#257)

• Support ScalaCheck test runner (#286)

• Support for using Typelevel Scala (#275)

• If a module depends on multiple submodules with different versions of an ivy dependency, only one version is resolved (#273)

• Support for non-interactive (client/server) mode on Windows.

• More fixes for Java 9

• Bumped the Mill daemon timeout from 1 minute to 5 minutes of inactivity before it shuts down.

• Avoid leaking Node.js subprocesses when running ScalaJSModule tests

• Passing command-line arguments with spaces in them to tests no longer parses wrongly

• ScalaModule#repositories, scalacPluginIvyDeps, scalacOptions, javacOptions are now automatically propagated to Tests modules

• ScalaJSModule linking errors no longer show a useless stack trace

• ScalaModule#docJar now properly uses the compileClasspath rather than runClasspath

• Bumped underlying Ammonite version to 1.1.0, which provides the improved Windows and Java 9 support

• Fixes for non-interactive (client/server) mode on Java 9

• Windows batch (.bat) generation for launcher, assembly, and release

• Introduced the mill plan foo.bar command, which shows you what the execution plan of running the foo.bar task looks like without actually evaluating it.

• Mill now generates an out/mill-profile.json file containing task-timings, to make it easier to see where your mill evaluation time is going

• Introduced ScalaModule#ivyDepsTree command to show dependencies tree

• Rename describe to inspect for consistency with SBT

• mill resolve now prints results sorted alphabetically

• Node.js configuration can be customised with ScalaJSModule#nodeJSConfig

• Scala.js fullOpt now uses Google Closure Compiler after generating the optimized Javascript output

• Scala.js now supports NoModule and CommonJSModule module kinds

• Include compileIvyDeps when generating IntelliJ projects

• Fixed invalid POM generation

• Support for Java 9 (and 10)

• Fixes for Windows support

• Fixed test classes discovery by skipping interfaces

• Include "optional" artifacts in dependency resolution if they exist

• out/{module_name} now added as a content root in generated IntelliJ project

• Speed up Mill client initialization by another 50-100ms

• Speed up incremental `assembly`s in the common case where upstream dependencies do not change.

• Make ScalaJSModule#run work with main-method discovery

• Make ScalaWorkerModule user-defineable, so you can use your own custom coursier resolvers when resolving Mill’s own jars

• Simplify definitions of SCM strings

• Make the build REPL explicitly require -i/--interactive to run

• Log a message when Mill is initializing the Zinc compiler interface

• Greatly reduced the overhead of evaluating Mill tasks, with a warm already-cached mill dev.launcher now taking ~450ms instead of ~1000ms

• Mill now saves compiled build files in ~/.mill/ammonite, which is configurable via the --home CLI arg.

• Fixed linking of multi-module Scala.js projects

• Mill now keeps a long-lived work-daemon around in between commands; this should improve performance of things like compile which benefit from the warm JVM. You can use -i/--interactive for interactive consoles/REPLs and for running commands without the daemon

• Implemented the ScalaModule#launcher target for easily creating command-line launchers you can run outside of Mill

• ScalaModule#docJar no longer fails if you don’t have scala-compiler on classpath

• Support for multiple testFrameworks in a test module.

• Fixes for foo.console

• Enable Ammonite REPL integration via foo.repl

• First public release