A command-line interface for leveraging stackage.
You must have
cabal on your $PATH. This program will make various calls to those executables on your behalf.
This package provides a number of executables. Primary among these is the
stackage executable (and its alias
stackage command-line program will inspect your path for stackage plugins, and will dispatch to them. Anything on your $PATH prefixed
stackage- that responds to the
--summary flag is considered a stackage plugin.
(This package also provides a library,
Stackage.CLI, which is intended to make the process of writing stackage plugins easier.)
This package provides the following stackage plugins:
cabal.config file from
stackage.org. That’s all it does! The
cabal.config file constrains the package versions used to build your project. Stackage.org is constantly calculating the best compatible build plans for a big subset of Hackage.
ghc-pkg unregister on your package databases. (You will be prompted on a per-db basis; use
stackage purge --force if you don’t want to be prompted.) This is an easy way to clean out your sandbox.
stackage purge followed by
The sandbox plugin has a few commands of its own that mirror the above three stackage commands:
stackage sandbox init
In addition to downloading a
cabal.config file, this will also set up a shared sandbox (via
cabal.sandbox.config) corresponding to whatever stackage snapshot is used. By default, the latest available Stackage LTS snapshot will be used.
Shared sandboxes are located at
$HOME/.stackage/sandboxes. Be aware! Anything you
cabal install to this sandbox will be available to any other projects that share the same sandbox. The
cabal.config file should help make sure you don’t install anything incompatible.
stackage sandbox delete
stackage purge, this does not alter any package databases. The shared sandbox will remain untouched. You can use
stackage sandbox delete NAME to delete the shared sandbox called NAME (e.g. lts-2.0) from your system.
stackage sandbox upgrade
cabal.sandbox.config with newer versions and (possibly) a new shared sandbox.
See also: this example on the stackage-cli wiki.
- Added temporary solution for dealing with changes to stackage.org (#4)
- Added temporary solution for detecting wrong ghc version on path. (#1)
- Added stk sandbox print (#3)
- Migrated off of system-filepath and system-fileio in favor of filepath and directory.
- Added an associated library (stubbed)
- Now copies cabal.config into cabal.sandbox.config
- Initial release