sbt, the interactive build tool
Go to file
Edward Samson a362c964de Use exec to launch when not in cygwin
This allows, for example, capturing the correct PID when launching sbt
from within a bash script. The original change from
1a07150560 was to address an issue
specific to cygwin.
2019-11-20 13:57:33 +08:00
.github/ISSUE_TEMPLATE Fix typo in no-new-issues.md 2019-08-03 08:33:10 +01:00
.idea/runConfigurations Add IntelliJ run configuration for integrationTest/test 2019-10-19 12:21:35 -07:00
bin export repo using Coursier (#267) 2019-05-15 10:52:39 -04:00
citest Update citest to use 1.3.0 release 2019-11-17 11:49:58 -08:00
integration-test/src/test/scala Update sbt.bat --script-version to execute early and avoid java check/robocopy bootstrap - Fixes #5220 2019-11-17 08:35:30 -08:00
java9-rt-export/src/main/java/io/github/retronym/java9rtexport Whitelist java9-rt-ext- output in rt export process 2018-02-12 09:20:30 -08:00
project Fix dangling ivy.xml without JAR files 2019-05-09 23:17:22 -04:00
src Use exec to launch when not in cygwin 2019-11-20 13:57:33 +08:00
upload Allow env vars defaults, rename S3 vars 2018-05-07 17:17:29 +02:00
.gitattributes Windows config now works. Still an issue with sbt.bat not setting up paths/temp files correctly.... 2012-09-22 10:12:03 -04:00
.gitignore Ignore upload cookies 2019-09-22 15:50:31 -04:00
.java-version add JDK 9 support 2017-02-15 04:57:47 -05:00
.travis.yml Run the full integrationTest/test on OSX 2019-10-19 11:51:31 -07:00
CONTRIBUTING.md Update sbt.build.version in CONTRIBUTING too. 2017-11-16 11:02:18 +00:00
LICENSE Apache License 2.0 2019-04-05 09:25:06 -04:00
NOTICE Apache License 2.0 2019-04-05 09:25:06 -04:00
README.md Remove unimplemented --sbt-rc and --sbt-snapshot arguments from docs and scripts 2019-10-19 18:34:13 -07:00
build.sbt Update javacOptions to target 1.8 2019-10-19 12:13:08 -07:00

README.md

sbt: the launcher script

This is a launcher script for running sbt.

Current -help output:

Usage: sbt [options]

  -h | -help         print this message
  -v | -verbose      this runner is chattier
  -V | -version      print the version of mothership sbt
  -d | -debug        set sbt log level to debug
  -no-colors         disable ANSI color codes
  -sbt-create        start sbt even if current directory contains no sbt project
  -sbt-dir   <path>  path to global settings/plugins directory (default: ~/.sbt)
  -sbt-boot  <path>  path to shared boot directory (default: ~/.sbt/boot in 0.11 series)
  -ivy       <path>  path to local Ivy repository (default: ~/.ivy2)
  -mem    <integer>  set memory options (default: 1024, which is -Xms1024m -Xmx1024m -XX:ReservedCodeCacheSize=128m)
  -no-share          use all local caches; no sharing
  -no-global         uses global caches, but does not use global ~/.sbt directory.
  -jvm-debug <port>  Turn on JVM debugging, open at the given port.
  -batch             Disable interactive mode

  # sbt version (default: from project/build.properties if present, else latest release)
  -sbt-version  <version>   use the specified version of sbt
  -sbt-jar      <path>      use the specified jar as the sbt launcher

  # java version (default: java from PATH, currently openjdk version "1.8.0_172")
  -java-home <path>         alternate JAVA_HOME

  # jvm options and output control
  JAVA_OPTS          environment variable, if unset uses ""
  .jvmopts           if this file exists in the current directory, its contents
                     are appended to JAVA_OPTS
  SBT_OPTS           environment variable, if unset uses ""
  .sbtopts           if this file exists in the current directory, its contents
                     are prepended to the runner args
  /etc/sbt/sbtopts   if this file exists, it is prepended to the runner args
  -Dkey=val          pass -Dkey=val directly to the java runtime
  -J-X               pass option -X directly to the java runtime
                     (-J is stripped)
  -S-X               add -X to sbt's scalacOptions (-S is stripped)

Native packages

This project also includes native packages to run sbt for

  • Windows
  • RedHat (rpm)
  • Debian (deb)

Locations for download to be available soon.

Build status

Build Status Build Status