Miscellaneous machinery around traversing & querying the build hierarchy, that should not be needed by normal users of Mill

Bind a dependency (Dep) to the actual module context (e.g. the scala version and the platform suffix)

Customize the coursier file cache.

This is rarely needed to be changed, but sometimes e.g. you want to load a coursier plugin. Doing so requires adding to coursier's classpath. To do this you could use the following:

override def coursierCacheCustomizer = Task.Anon {
   Some( (fc: coursier.cache.FileCache[Task]) =>
     fc.withClassLoaders(Seq(classOf[coursier.cache.protocol.S3Handler].getClassLoader))
   )
}

Optional custom Java Home for the ZincWorker to use

If this value is None, then the ZincWorker uses the same Java used to run the current mill instance.

Map dependencies before resolving them. Override this to customize the set of dependencies.

Prepare the module for working offline. This should typically fetch (missing) resources like ivy dependencies.

The repositories used to resolved dependencies with resolveDeps().

Customize the coursier resolution process. This is rarely needed to changed, as the default try to provide a highly reproducible resolution process. But sometime, you need more control, e.g. you want to add some OS or JDK specific resolution properties which are sometimes used by Maven and therefore found in dependency artifact metadata. For example, the JavaFX artifacts are known to use OS specific properties. To fix resolution for JavaFX, you could override this task like the following:

override def resolutionCustomizer = Task.Anon {
  Some( (r: coursier.core.Resolution) =>
    r.withOsInfo(coursier.core.Activation.Os.fromProperties(sys.props.toMap))
  )
}

Resolution parameters, allowing to customize resolution internals

This rarely needs to be changed. This allows to disable the new way coursier handles BOMs since coursier 2.1.17 (used in Mill since 0.12.3) for example, with:

def resolutionParams = super.resolutionParams()
  .withEnableDependencyOverrides(Some(false))

Note that versions forced with Dep#forceVersion() take over forced versions manually set in resolutionParams. The former should be favored to force versions in dependency resolution.

The Scala version set via ScalaModule#scalaVersion also takes over any Scala version provided via ResolutionParams#scalaVersionOpt.

Task that resolves the given dependencies using the repositories defined with repositoriesTask.