Mill is a fast JVM build tool that supports Java and Scala. Mill aims to make your project’s build process performant, maintainable, and flexible.
If you want to use Mill in your own projects, check out our documentation:
Here is some quick example, so that you can imagine how it looks:
import mill._, scalalib._
object foo extends ScalaModule {
def scalaVersion = "3.3.4"
}
object bar extends ScalaModule {
def moduleDeps = Seq(foo)
def scalaVersion = "3.3.4"
}
If you use Mill and like it, you will probably enjoy the following book by the Author:
The remainder of this readme is developer-documentation targeted at people who wish to work on Mill’s own codebase. The developer docs assume you have read through the user-facing documentation linked above. It’s also worth spending a few minutes reading the following blog posts to get a sense of Mill’s design & motivation:
Mill is profiled using the JProfiler Java Profiler, by courtesy of EJ Technologies.
Mill is built using Mill.
To begin, you just need a JVM installed, and the
./mill
script will be sufficient to bootstrap the project.
If you are using IntelliJ IDEA to edit Mill’s Scala code, IntelliJ’s built in BSP support should
be sufficient to load the Mill project, but you need to set up the file association from
*.mill
as Scala source files manually in the following settings:
-
Settings
/Editor
/File Types
/Scala
, add the pattern*.mill
The following table contains the main ways you can test the code in
com-lihaoyi/mill
, via manual testing or automated tests:
Config |
Automated Testing |
Manual Testing |
Manual Testing CI |
In-Process Tests |
|
||
Sub-Process w/o packaging/publishing |
|
|
|
Sub-Process w/ packaging/publishing |
|
|
|
Bootstrapping: Building Mill with your current checkout of Mill |
|
|
In general, println
or pprint.log
should work in most places and be sufficient for
instrumenting and debugging the Mill codebase. In the occasional spot where println
doesn’t work you can use mill.main.client.DebugLog.println
which writes to a file
~/mill-debug-log.txt
in your home folder. DebugLog
is useful for scenarios like
debugging Mill’s terminal UI (where println
would mess things up) or subprocesses
(where stdout/stderr may get captured or used and cannot be used to display your own
debug statements).
In-process tests live in the .test
sub-modules of the various Mill modules.
These range from tiny unit tests, to larger integration tests that instantiate a mill.testkit.BaseModule
in-process and a UnitTester
to evaluate tasks on it.
Most "core" tests live in main.__test
; these should run almost instantly, and cover most of Mill’s functionality that is not specific to Scala/Scala.js/etc..
Tests specific to Scala/Scala.js/Scala-Native live in
scalalib.test
/scalajslib.test
/scalanativelib.test
respectively, and take a lot longer to run because running them involves actually compiling Scala code.
The various contrib
modules also have tests in this style, e.g.
contrib.buildinfo.test
Note that the in-memory tests compile the BaseModule
together with the test suite, and do not exercise the Mill script-file bootstrapping, transformation, and compilation process.
example.__.local
and integration.__.local
tests run Mill end-to-end in a subprocess, but without the expensive/slow steps of packaging the core packages into an assembly jar and publishing the remaining packages to
~/.ivy2/local
.
You can reproduce these tests manually using
./mill dist.run <test-folder-path> <command>
.
example
tests are written in a single build.mill
file, with the test commands written in a comment with a bash-like syntax together with the build code and comments that explain the example.
These serve three purposes:
-
Basic smoke-tests to make sure the functionality works at all, without covering every edge case
-
User-facing documentation, with the test cases, test commands, and explanatory comments included in the Mill documentation site
-
Example repositories, that Mill users can download to bootstrap their own projects
The integration
tests are similar to example
tests and share most of their test infrastructure, but with differences:
-
integration
tests are meant to test features more thoroughly thenexample
tests, covering more and deeper edge cases even at the expense of readability -
integration
tests are written using a Scala test suite extendingIntegrationTestSuite
, giving more flexibility at the expense of readability
You can reproduce any of the tests manually using dist.run
, e.g.
Automated Test
./mill "example.basic[1-simple].local"
Manual Test
./mill dist.run example/basic/1-simple run --text hello
Manual Test using Launcher Script
./mill dist.launcher && (cd example/javalib/basic/1-simple && ../../../../out/dist/launcher.dest/run run --text hello)
example.__.server
, integration.__.server
, example.__.fork
and
integration.__.fork
cover the same test cases as the .local
tests described above, but they perform packaging of the Mill core modules into an assembly jar, and publish the remaining modules to ~/.ivy2/local
.
This results in a more realistic test environment, but at the cost of taking tens-of-seconds more to run a test after making a code change.
You can reproduce these tests manually using dist.assembly
:
./mill dist.assembly && (cd example/basic/1-simple && ../../../out/dist/assembly.dest/mill run --text hello)
There are two flavors of these tests:
-
.server
test run the test cases with the default configuration, so consecutive commands run in the same long-lived background server process -
.fork
test run the test cases with--no-server
, meaning each command runs in a newly spawned Mill process
In general you should spend most of your time working with the .local
version of the example
and integration
tests to save time, and only run .fork
or .server
once .local
is passing.
To test bootstrapping of Mill’s own Mill build using a version of Mill built from your checkout, you can run
./mill installLocal
ci/patch-mill-bootstrap.sh
This creates a standalone assembly at target/mill-release
you can use, which references jars published locally in your ~/.ivy2/local
cache, and applies any necessary patches to build.mill
to deal with changes in Mill between the version specified in .config/mill-version
that is normally used to build Mill and the HEAD
version your assembly was created from.
You can then use this standalone assembly to build & re-build your current Mill checkout without worrying about stomping over compiled code that the assembly is using.
This assembly is design to work on bash, bash-like shells and Windows Cmd.
If you have another default shell like zsh or fish, you probably need to invoke it with sh ~/mill-release
or prepend the file with a proper shebang.
If you want to install into a different location or a different Ivy repository, you can set its optional parameters.
/tmp
$ ./mill installLocal --binFile /tmp/mill --ivyRepo /tmp/millRepo
...
Published 44 modules and installed /tmp/mill
For testing documentation changes locally, you can generate documentation for the current checkout via
$ ./mill docs.fastPages
To generate documentation for both the current checkout and earlier versions, you can use
$ ./mill docs.localPages
The Mill project is organized roughly as follows:
-
runner
,main.*
,scalalib
,scalajslib
,scalanativelib
.
These are general lightweight and dependency-free: mostly configuration & wiring of a Mill build and without the heavy lifting.
Heavy lifting is delegated to the worker modules (described below), which the core modules resolve from Maven Central (or from the local filesystem in dev) and load into isolated classloaders.
-
scalalib.worker
,scalajslib.worker[0.6]
,scalajslib.worker[1.0]
These modules are where the heavy-lifting happens, and include heavy dependencies like the Scala compiler, Scala.js optimizer, etc.. Rather than being bundled in the main assembly & classpath, these are resolved separately from Maven Central (or from the local filesystem in dev) and kept in isolated classloaders.
This allows a single Mill build to use multiple versions of e.g. the Scala.js optimizer without classpath conflicts.
-
contrib/bloop/
,contrib/flyway/
,contrib/scoverage/
, etc.
These are modules that help integrate Mill with the wide variety of different tools and utilities available in the JVM ecosystem.
These modules are not as stringently reviewed as the main Mill core/worker codebase, and are primarily maintained by their individual contributors. These are maintained as part of the primary Mill Github repo for easy testing/updating as the core Mill APIs evolve, ensuring that they are always tested and passing against the corresponding version of Mill.
Mill maintains backward binary compatibility for each major version (major.minor.point
), enforced with Mima, for the following packages:
-
mill.api
-
mill.util
-
mill.define
-
mill.eval
-
mill.resolve
-
mill.scalalib
-
mill.scalajslib
-
mill.scalanativelib
Other packages like mill.runner
, mill.bsp
, etc. are on the classpath but offer no compatibility guarantees.
Currently, Mill does not offer compatibility guarantees for mill.contrib
packages, although they tend to evolve slowly.
This may change over time as these packages mature over time.
-
Changes to the main branch need a pull request. Exceptions are preparation commits for releases, which are meant to be pushed with tags in one go
-
Merged pull request (and closed issues) need to be assigned to a Milestone
-
Pull requests are typically merged via "Squash and merge", so we get a linear and useful history
-
Larger pull request, where it makes sense to keep single commits, or with multiple authors may be committed via merge commits.
-
The title should be meaningful and may contain the pull request number in parentheses (typically automatically generated on GitHub)
-
The description should contain additional required details, which typically reflect the content of the first PR comment
-
A full link to the pull request should be added via a line:
Pull request: <link>
-
If the PR has multiple authors but is merged as merge commit, those authors should be included via a line for each co-author:
Co-authored-by: <author>
-
If the message contains links to other issues or pull requests, you should use full URLs to reference them
The Mill 0.12.0 release focuses on improving the scalability of Mill builds: in terms of performance, code organization, adherence to best practices, and community.
Major changes:
-
Mill now runs tasks parallel by default, rather than opt-in. This includes a new parallel-friendly terminal UI, task and test sandboxing to guard against race conditions, parallelization of test suites, and other measures optimizing for parallel builds
-
Mill now uses
build.mill
rather thanbuild.sc
as the primary file extension, to avoid confusion with Scala-CLI or Ammonite scripts, and theT
/T.worker
/T.input
syntax has been deprecated in favor ofTask
/Task.Worker
/T.Input
for a more idiomatic style -
Mill now supports for Modularizing Large Builds into multiple
package.mill
files, to help support large codebases and incremental compilation of the build files. -
Mill now provides official support for Writing Mill Plugins, with tested workflows and an official testkit to help you write and publish your own Mill plugins for others to use
-
Mill now supports other JVM langauges: Java, experimental support for Kotlin/KotlinJs, and even-more-experimental support for Android. This includes IDE integrations, tooling integrations (docs, autoformatters, linters, testing frameworks, etc.)
-
The Mill doc-site at https://mill-build.org/ has undergone a massive overhaul. New comparisons with other build tools of (Maven, Gradle, SBT), documentation for adding new language toolchains and running dynamic JVM code, and re-organized the pages for Scala/Java/Kotlin by-use-case to make them more navigable
For a more detailed view of Mill changes since 0.11.12, along with migration instructions, see the sections below on:
0.12.x is binary compatible with 0.11.x, and so Mill plugins published for Mill 0.11.x can continue to be used without updating them. Although binary compatible, Mill 0.12.x does have breaking changes listed below with instructions provided on how to either disable the breaking change with a flag or adjust your code to accommodate it. You should download the latest version of the Mill Bootstrap Script if you are upgrading from a prior version.
If you need help upgrading from 0.11.x or hit any issues, please visit the #mill Discord Channel or 0.12.x Github Discussion Thread. We’d love to hear from you on your experience with Mill in general and Mil 0.12.x in particular
-
Example Upgrade PRs
-
The following PRs are example upgrades of Mill from 0.11.x to 0.12.0-RC1 for various projects in the
com.lihaoyi
ecosystem.-
Trivial upgrades that just needed to bump a version: com-lihaoyi/geny#87 , com-lihaoyi/sourcecode#175, com-lihaoyi/fansi#107, com-lihaoyi/PPrint#141, https://github.com/com-lihaoyi/mainargs/pull/159/files, com-lihaoyi/fastparse#319, com-lihaoyi/scalatags#284 com-lihaoyi/castor#64, com-lihaoyi/utest#351
-
Less trivial upgrades, needing to make use of
MILL_TEST_RESOURCE_DIR
or other explicit path references to be compatible with test sandboxing: com-lihaoyi/requests-scala#174, com-lihaoyi/upickle#627, com-lihaoyi/os-lib#300, com-lihaoyi/scalasql#30, com-lihaoyi/Ammonite#1575 -
More involved upgrades: com-lihaoyi/cask#143
-
-
-
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-introducedrunModuleDeps
, to try and match the semantics of runtime deps in Mavenhttps://github.com/com-lihaoyi/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 ofT
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:
-
Additional support for Kotlin tools and frameworks
-
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
-
...
[3861/4712] main.client.publishLocalCached
[3861] Publishing Artifact(com.lihaoyi,mill-main-client,0.12.0-RC2-67-a566d8-DIRTY875bcbb1) to ivy repo /Users/lihaoyi/.ivy2/local
[3868/4712] runner.client.publishLocalCached
[3868] Publishing Artifact(com.lihaoyi,mill-runner-client,0.12.0-RC2-67-a566d8-DIRTY875bcbb1) to ivy repo /Users/lihaoyi/.ivy2/local
[3869/4712] ======================================= installLocalCache ============================================== 4s
[3676] scalajslib.worker-api.docJar 1s
[3688] scalanativelib.worker-api.docJar 1s
[3706] contrib.playlib.worker[2.9].docJar 1s
[3707] contrib.playlib.worker[2.6].docJar 1s
... and 3 more threads
-
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 inspect dist0
dist0(build.mill:745)
Version of [[dist]] meant for local integration testing within the Mill
repo. Looks mostly the same as [[dist]], except it does not have a reference
to itself in its [[testTransitiveDeps]], to avoid a circular dependency.
Inherited Modules: MillPublishJavaModule
Module Dependencies: runner, idea
Default Task: dist0.run
Tasks: dist0.fix, dist0.testTransitiveDeps
Changes since 0.12.0-RC1
-
Support
exclude
attribute inDep
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.TokensReader
s, and include amainargs.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 thanos.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 runmill 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 toScalafmtModule
andPublishModule
, so you can now autoformat your code viamill mill.scalalib.ScalafmtModule/
and publish it viamill 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 renamedbuild.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 viaSettings / Editor / File Types / Scala
and add the pattern*.mill
-
-
All
.mill
files must have apackage
declaration, withpackage build
for.mill
files in the root folder andpackage build.foo.bar
for.mill
files infoo/bar/
.-
The package declaration remains optional for legacy
.sc
files
-
-
Only
foo.mill
files in folders directly containing abuild.mill
orpackage.mill
can be imported viaimport $file
.-
You need to create empty
package.mill
files in any folder containing scripts if they are not already adjacent to yourbuild.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 arbitraryfoo.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.
-
-
-
RootModule
s can only be namedpackage
, e.g.object foo extends RootModule
must now be namedobject
.package
extends RootModule-
If you have an existing
RootModule
, you need to rename itobject
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
andvisualizePlan
such that they no longer need to be prefixed withshow
and no longer need a separategraphviz
/dot
install on Mac-OSX #3438
-
Changes since 0.11.11:
-
Bump uTest to 0.8.4 #3340
-
Manage TestModule dependencies via
build.sc
#3320 -
Fix the warning not being printed when -i/--interactive/--no-server/--bsp are not the first argument #3346
-
GenIdea: Make Scala SDK specific for JS / Native #3348
-
CI: Adapt CI for 0.11.x branch #3350
-
GenIdea: unroll module dependencies #3358
-
Print pretty error message when Result.Failure is thrown #3393
-
Avoid spurious deprecation warnings in generated code #3400
For details refer to milestone 0.11.12 and the list of commits.
We initially tagged 0.11.11
on 2024-11-31 but never published the released due to technical issues. On 2024-08-05 we re-tagged and published 0.11.11
.
Changes since 0.11.10:
-
Workaround issue in Sonatype which started failing on double slashes in URLs (even though they previously worked) Link
-
Overhaul of the documentation site at https://mill-build.org
-
New Java- and Scala-specific sections on the documentation, with more detailed comparisons to existing build tools
-
Added graphviz diagrams throughout to help the user in visualizing the concepts involved
-
Update versions of JUnit sbt-test-interface libraries that Mill uses #3296
-
Make it simpler to resolve dependencies in custom tasks via
defaultResolver().resolveDeps
#3330
For details refer to milestone 0.11.11 and the list of commits.
Changes since 0.11.9:
Fixes and Improvements
For details refer to milestone 0.11.10 and the list of commits.
Changes since 0.11.8:
New features
-
First class support for Java projects #3261
Fixes and Improvements
-
Add coarse grained lock around BSP request to avoid deadlocks #3243
For details refer to milestone 0.11.9 and the list of commits.
Changes since 0.11.7:
New features
-
Add
jvmOptions
to docker contrib configuration #3079 -
Pass auxiliary class files to zinc, so they are deleted together #3072
-
BSP: Handle new
JvmCompileClasspath
request #3086 -
Add support for Cobertura XML report task to help integration #3093
-
Support Scala.js minify via
scalaJSMinify: T[String]
#3094 -
Restructure
TestModule
, addRunModule
#3064 -
Move
run
-targets intoRunModule
#3090 -
TestModule
: Support generation of JUnit-compatible xml report #3099 #3172 #3135 #3184 -
Use docker image hash to determine if build should rerun #3124
-
Add multi platform support to contrib.docker through docker buildx #3143
-
Add ability to re-write ESModule imports at link time #3109
-
Add
TestModule.discoveredTestClasses
target to ease test inspection #3191 -
Support "pom" packaging type in
PublishModule
#3222
Fixes and Improvements
-
Restructure
VersionFinder
, increase speed, added ticker messages #3014 -
Fix bsp compile classpath inconsistencies #3017
-
Bring more bsp-specific targets in line with their non-bsp versions #3018
-
Make BSP task processing more resilient #3022
-
Update example
build.sc
with current library versions #3055 -
Scoverage: Do not include the scalac plugin in the reporting classpath #3060
-
Add Scala 2.13.13 and 2.12.19 to supported bridges list #3066
-
Fix BuildInfo static Java file generator #3074
-
Scoverage inner module defaults to
skipIdea = outer.skipIdea
#3098 -
Deduplicate input tasks in
inspect
command #3102 -
CI: add scalafix-check to precondition to publish #3095
-
Docs for Continuous cache invalidation #3096
-
Isolate scoverage modules from their parent modules #3118
-
Scoverage improve classpath override to the minimal #3122
-
Improve internal BSP API and docs, fix a match error condition #3111
-
Retry example integration tests that didn’t finish after 5 minutes #3125
-
Fix mill script for parameter starting with -i #3127
-
Fixed semanticdb file copying issue, added more tests #3080
-
Detect assemblies with too many entries to fail shell script prepending #3140
-
Exclude mill provided dependencies in meta builds #3189 #3221
-
Fix Scala.js toolchain logs in server-client mode #3196
-
Fix compiler bridge build setup and build essential versions in CI #3179
-
Add Scala 2.13.14 to bridgeScalaVersions #3166
-
GenIdea improvements #3153
-
GenIdea: Use synthetic scala-SDK entry for compiler setup #3154
-
Fix classpath regression in Bloop export #1918 #3211
-
Support
build.sc
in Bloop #3208 -
Fail if
testOnly
does not match any test case #3224
Updates and internal changes
-
Code cleanups
-
Documentation updates and fixes
-
Test and CI improvements
-
Updates: acyclic 0.3.12, Ammonite 3.0.0-M2-11-713b6963, asm 9.7, commons-compress 1.26.2, commons-io 2.16.1, coursier 2.1.10, fastparse 3.1.0, fansi 0.5.0, guava 33.2.1, jarjar-abrams-core 1.14.0, jline 3.26.2, junixsocket 2.9.1, log4j-core 2.23.1, mainargs 0.7.0 mill-mima 0.1.1, mill-scalafix 0.4.0, os-lib 0.10.2, Play 2.8.22 / 2.9.4 / 3.0.4, pprint 0.9.0, protobuf-java 3.25.3, Scala 2.12.19 / 2.13.14, Scala Native 0.4.17 / 0.5.3, scala-xml 2.3.0, scalacheck 1.18.0, scalatest 3.2.18, scoverage 2.1.1, semanticdb-java 0.9.10, semanticdb-scalac 4.9.7 requests 0.8.3, upickle 3.3.1, utest 0.8.3, zinc 1.10.0
For details refer to milestone 0.11.8 and the list of commits.
Changes since 0.11.6:
New features
-
Support type selectors as path selection syntax in resolve #2997, #2998
-
Read coursier default config files to set up repositories and support mirror configuration #2886, #2917
-
Added support for
type
attribute when parsing dependencies #2994 -
Add new
ScalaModule.scalacHelp
command #2921 -
Add a
ScalaModule.consoleScalacOptions
target #2948 -
Enable colored output for Scala 2 compiler output #2950
-
Add
publishLocalCached
andpublishM2LocalCached
targets toPublishModule
#2976 -
Support Scala Native build target. This allows to build static and dynamic libraries other than binaries #2898
-
Prepare the Scala.js integration for SIP-51 #2988
Fixes and Improvements
-
Better detect Windows Subsystem for Linux environments #2901
-
Avoid evaluating `Task.Input`s twice #2952
-
Deduplicate (anonymous) tasks in results #2959
-
Synchronize
evaluateGroupCached
to avoid concurrent access to cache #2980 -
Properly sanitize Windows reserved names and symbols in evaluator paths #2964, #2965
-
Detect colliding cross module values #2984
-
Mask forward slashes in cross values to fix their cache locations #2986
-
Re-enable test result summary (print
done
message from test framework to stdout) #2993 -
Fix overeager caching of
cliImports
value ingeneratedScriptSources
#2977 -
Allow resolving moduleDeps with older Scala 3 versions #2877
-
GenIdea: Put module dependencies after library dependencies #2925
-
BSP: do not filter clean-requests for meta-builds #2931
-
BSP: Add
JavaModule.bspBuildTargetData
to makeJavaModule
reports workableBuildTarget
#2930 -
BSP: Send
logMessage
instead of diagnostics whentextDocument
is unknown #2979 -
Scoverage inner module defaults new to
skipIdea = true
#2989
Updates and internal changes
-
Dependency updates: asm-tree 9.6, bsp4j 2.2.0-M1, coursier 2.1.8, jline 3.25.0, jna 5.14.0, junixsocket-core 2.8.3, log4j-core 2.22.1, mainargs 0.6.1, os-lib 0.9.3, scalafmt 3.7.15, Scala.js 1.15.0, scala-native 8.4.16, semanticdb-java 0.9.8, semanticdb-scala 4.8.15, upickle 3.1.4, zinc 1.9.6
-
Contrib dependency updates: Play 2.8.21, Play 2.9.1, Play 3.0.1
-
Documentation updates and new sections
-
More code cleanups, explicit result types and enforcement of some code quality metrics via mill-scalafix
For details refer to milestone 0.11.7 and the list of commits.
Changes since 0.11.5:
-
Make
PathRef
robust against concurrent filesyste modifications #2832 -
Use logger error stream for informational messages #2839
-
Harden assembly logic against Zip-Slip vulnerabilities #2847
-
Add an option to disable incremental compilation with zinc #2851
-
Add check for right Tests traits in ScalaJS and Native #2874
-
Attempt to recover from client/server connection errors to #2879
-
Fix discovery of targets whose names get mangled #2883
-
Make
mill show
skip-j
prefixes to ensure machine readability #2884
For details refer to milestone 0.11.6 and the list of commits.
Changes since 0.11.4:
-
Support for Java 21 #2768
-
The
T.workspace
context path now always points to the top-level project directory, also for meta builds #2809 -
Mill now better detects and reports logical cycles in inter-module dependencies #2790
-
Fixed semanticDB data generation for meta builds #2809
-
The
prepareOffline
command also fetches relevant compiler-bridges for Scala modules #2791 -
Improved
ScalaJSModule
and added support forIRFileCache
#2783 -
The
JavaModule.zincReportCachedProblems
configuration can now also customized via a Java system property #2775 -
Fixed a file truncation issue in protobuf module and print a warning when proto file get overwritten #2800
-
Documentation improvements
-
Dependency updates: bsp4j 2.1.0-M7, castor 0.3.0, coursier-interface 1.0.19, jarjarabrams 1.9.0, jline 3.23.0, junitsocket 2.8.1, mainargs 0.5.4, scalafmt 3.7.14, Scala.js 1.14.0, semanticdb-java 0.9.6, semanticdb-scala 4.8.10
-
Various other improvements and cleanups
For details refer to milestone 0.11.5 and the list of commits.
Changes since 0.11.2:
-
Allow Mill CLI to select the meta-build frame it operates on via
--meta-level <n>
#2719 -
Improve the
mill resolve
suggestion when a user specifies a target in the wrong module #2731 -
Fix conflicting dependencies between upstream JavaModules #2735
-
Fix the scala-library dependency for (generic) platform modules #2739
-
Fix terminal forwarding in
.console
and.repl
commands #2743
For details refer to milestone 0.11.3 and the list of commits.
Changes since 0.11.1:
-
Target invalidation after making changes to
build.sc
is now done at a fine-grained method-level granularity, using callgraph reachability analysis to see which targets depend on the code that was changed. See #2417 for more details -
Fix redirection of stdout stream to stderr when using
show
#2689 -
Fix line numbers in errors for scripts starting with leading comments or whitespace #2686
-
Fix
init
command and support runnig Mill without existingbuild.sc
file #2662 -
Fixes for BSP editor integration sometimes using the wrong output folder for meta-build metadata, causing subsequent builds from the command line to fail #2692
-
Added a new
mill.idea.GenIdea/idea
command to generate IntelliJ IDE metadata, improving-upon and replacing the oldermill.scalalib.GenIdea/idea
command which is now deprecated #2638 -
Update Coursier to 2.1.6 to mitigate CVE CVE-2022-46751 #2705
For details refer to milestone 0.11.2 and the list of commits.
Changes since 0.11.0:
-
mill.define.Cross
: Introduced default cross segments and some CLI convenience -
mill.testrunner
: Fixed exception when running ScalaTest or ZIOTest frameworks -
mill.runner
: Removed some obsolete / defunct cli options -
mill.runner
: Properly distinct-ify commands when resolving wide matching target patterns -
mill.scalajslib
: Restored correct defaults foresFeature
-
mill.bsp
: Fixed aMatchError
in thebuildtarget/scalaTestClasses
request -
mill.contrib.bloop
: Corrected accidentally changed package name resulting in non-functional plugin -
mill.contrib.scoverage
: Fixed defunct plugin due to a missing type annotation -
Various internal improvements
-
Dependency updates: Ammonite 3.3.0-M0-32-96e851cb, bsp4j 2.1.0-M5, zinc 1.9.1
-
Mill is now build with Mill 0.11
For details refer to milestone 0.11.1 and the list of commits.
This release is binary incompatible to 0.11.0-M11.
Changes since 0.11.0-M11:
-
0.11.0 is the next breaking version after the 0.10.x series, with a large number of improvements. See the changelog below for 0.11.0-M1 to 0.11.0-M11 for a full list of user-facing changes.
For details refer to milestone 0.11.0 and the list of commits.
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 useScalaTests
,ScalaJSTests
, orScalaNativeTests
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
atrait
to allow abstract/virtual modules to betrait
s rather thanclass
es #2536 -
Move
mill.BuildInfo
tomill.main.BuildInfo
to avoid name conflicts withmill.contrib.buildinfo.BuildInfo
#2537 -
PlatformScalaModule
now exposesplatformScalaSuffix
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, allowingrun
to be easily used in the implementation of other tasks #2452 -
Task.Input
s 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 tomill.util
andmill.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.Command
s #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}[com-lihaoyi#2406]
-
You can now override
T{…}
Target
s withTask.Source
orTask.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, addingJavaModule
support, and allowing Javadoc/Scaladoc comments to be associated with the generatedBuildInfo
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 forCoursierModule.resolveDeps
and variousresolvedIvyDeps
targets -
bsp
: Update Protocol version to 2.1.0-M4 -
bsp
: Support newmainClasses
field in run and test environments -
bsp
: Fixed handling of Mill plugins and other improvements -
scalanativelib
: newnativeDump
setting inScalaNativeModule
-
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
andpredef
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 themillSourcePath
.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
, movedJarManifest
tomill.main
-
No longer inherit the Ammonite CLI config
-
scalalib
: Fixed loosing customizedmapDependencies
whenScalaModule
get mixed in after -
scalalib
: NewTestModule.Weaver
-
scalajslib
: NewJsEnvConfig.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 targetzincReportCachedProblems
which, whentrue
, 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 inprepareOffline
-
scalanativelib
: Fetch more tooling dependencies inprepareOffline
-
scalanativelib
: Updated tools to version 0.4.10 -
bsp
: Improved support for themill-build
module which should improve the editing experience forbuild.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 offoo.overridden
we now use afoo.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
: FixedGenIdea
issues on Windows, when the build uses plugins or additional libraries. -
scalajslib
:ScalaJSModule.ScalaJSTests
now extendsScalaModule.ScalaTests
which improves consistency, better default values and compatibility with other modules likeScoverageModule
. -
scalanativelib
:ScalaNativeModule.ScalaNativeTests
now extendsScalaModule.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
andmill.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 forscalaJSOutputPattern
-
scalajslib
: Added suport forscalaJSSourceMap
-
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
: RestrictCross
parameter to be of typeModule
-
scalalib
: Performance improvements in Zinc worker module -
scalalib
: Resources are no longer added tocompileClasspath
. -
scalalib
: Added newcompileResources
which will end up incompileClasspath
-
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 fromJavaModule
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
: DeprecatedfastOpt
andfullOpt
-
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
: FixedGenIdea
issues on Windows, when the build uses plugins or additional libraries. -
scalajslib
: Performance improvements in worker module -
scalajslib
: Pass more settings fromScalaJSModule
to itsTests
If you have issues after the update (like
org.scalajs.jsenv.UnsupportedInputException
, com-lihaoyi#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 theT.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 moreJsEnv
providersIf you get some issues (like
connect ECONNREFUSED
, com-lihaoyi#2204) after the update, review your settings forJsEnv
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
: implementbuildTarget/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 overrodemoduleDeps
-
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 showgpg
output in server mode -
BSP
: Better compiler message handling (logMessage
instead ofshowMessage
) 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:
-
PathRef
s 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
: newdebugEnabled
to detect whether debug logging is enabled -
New
testkit
module, to useUnitTester
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 targettwirlScalaVersion
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 fornativeEmbedResources
-
BSP
: improved handling of themill-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 targetsfastLinkJS
andfullLinkJS
and deprecatedfastOpt
andfullOpt
-
ScalaJsModule
: Support forModuleSplitStyle
-
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 ofcompileClasspath
andbspCompileClasspath
targets. This fixes an issue with BSP for large projects. Also, compile-time dependencies no longer sneak into the classpath transitively. -
JavaModule
: AddeddocJarUseArgsFile
target and fix issue with Windows command length restrictions indocJar
-
BSP
andBloop
: 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
: Fixedrepl
start -
CoursierModule
: Fixed concurrent download issues with coursier (we detect and retry) -
MainModule
: Fixed potential match error withshow
andshowNamed
-
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 withimport $file
. -
The local
.mill-jvm-opts
file is no longer restricted to-X
options -
CoursierModule
: AddedcoursierCacheCustomizer
to support aFileCache
customizers -
JavaModule
: thedocJar
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
: fixedDep.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 undertarget/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 nowout/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 aall
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 ofbuild.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
: thescala-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 callsuper.ivyDeps
-
ScalaJSModule.scalaLibraryIvyDeps
no longer contains the scala-js-library, but only the scala-library; if you need that, useScalaJSModule.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
orpath
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
: addedmandatoryScalacOptions
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 ofbuild.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 newtestFramework
target and only support one test framework. DeprecatedtestFrameworks
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
andconsole
targets now supportforkArgs
andforkEnv
-
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 likeJavaModule
,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 toBuildInfo
#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 forTask.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
: newpublishM2Local
to publish into local Maven repositories -
PublishModule
: enhancedpublishLocal
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
: EnhancedivyDepsTree
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
: respectunmanagedClasspath
, 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 toT.
: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 orMILL_VERSION
environment variable for Overriding Mill Versions -
Fix scoverage: inherit repositories from outer project #645
-
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
-
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
-
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 viaforkWorkingDir
-
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
andScalafmtModule
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 orfoo.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 toTests
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 thefoo.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
toinspect
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
andCommonJSModule
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 havescala-compiler
on classpath -
Support for multiple
testFrameworks
in a test module.