Skip to main content

Publish Local ⚡️

caution

The Publish Local command is restricted and requires setting the --power option to be used. You can pass it explicitly or set it globally by running:

scala-cli config power true

caution

The publish local sub-command is an experimental feature.

Please bear in mind that non-ideal user experience should be expected. If you encounter any bugs or have feedback to share, make sure to reach out to the maintenance team on GitHub.

The publish local sub-command publishes a Scala CLI project in the local Ivy2 repository, just like how sbt publishLocal or mill __.publishLocal do. This repository usually lives under ~/.ivy2/local, and is taken into account most of the time by most Scala tools when fetching artifacts.

Usage​

To publish locally a Scala CLI project, run

scala-cli publish local .
Publishing io.github.scala-cli:hello-scala-cli_3:0.1.0-SNAPSHOT
 ✔ Computed 10 checksums
 🚚 Wrote 15 files

 👀 Check results at
  ~/.ivy2/local/io.github.scala-cli/hello-scala-cli_3/0.1.0-SNAPSHOT/
caution

The publish local sub-command does not currently support publishing of the test scope. This includes any file that is placed in test directory or with the .test.scala suffix.

Read more about test sources in testing documentation.

Required settings​

The publish local command needs the same required settings as the publish command. Like for publish, Scala CLI might already be able to compute sensible defaults for those.