Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Installs and updates Scala software
branch: webstart

This branch is even with n8han:webstart

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
app
installer
notes
plugin
project
src/main/conscript/cs
.gitignore
README.markdown
build.sbt
setup.sh

README.markdown

conscript: Scala at your command

This is a tool for installing and updating Scala software programs. It does less than you think, because the sbt launcher does more than you think. What?

conscript...

  • Queries a github project for launch configurations
  • Writes these to your local filesystem, with a personalized boot path
  • Creates scripts to execute the launch configurations

sbt-launcher...

  • Reads a given launch configuration
  • Fetches needed dependencies on first run
  • Uses the same ivy cache as sbt itself

So conscript just assumes a convention and helps you adhere to it. Firstly, ~/.conscript/boot is used as a boot directory for all. Program launch configurations are stored according to the github project name and script name, such as:

~/.conscript/n8han/conscript/cs/launchconfig

And finally, program scripts are created in ~/bin that reference launch configurations, e.g. ~/bin/cs

Installation

curl https://raw.github.com/n8han/conscript/master/setup.sh | sh

You'll probably want to add ~/bin to your $PATH, if it's not already there.

Use

The only command currently is install/update, initiated by calling conscript with the name of a github project. This installs the giter8 templating system:

cs n8han/giter8

If at some point your conscript boot directory contains stale artifacts such as snapshot releases, you can clean it:

cs --clean-boot

When you next run any conscript app (such as cs) it will fetch its cleaned dependencies back into the shared boot directory; generally it only has to look as far as the local ivy cache to find them.

Conscripting

We hope you'll make your own programs that use conscript. The conscript-plugin for sbt makes these easier to build and test, and there's a conscript.g8 template to get you started. (See above for g8 install.)

Something went wrong with that request. Please try again.