stackage-sandbox: Work with shared stackage sandboxes

[ deprecated, development, library, mit, program ] [ Propose Tags ]

Deprecated in favor of stack

Work with shared stackage sandboxes

[Skip to Readme]

Downloads

stackage-sandbox-0.1.0.tar.gz [browse] (Cabal source package)
Package description (as included in the package)

Maintainer's Corner

Package maintainers

ChrisDone, DanBurton, MichaelSnoyman, borsboom

For package maintainers and hackage trustees

edit package information

Candidates

No Candidates

Versions [RSS]	0.1.0, 0.1.1, 0.1.2, 0.1.3, 0.1.4, 0.1.5, 0.1.6
Change log	ChangeLog.md
Dependencies	base (>=4.7 && <5), filepath, optparse-applicative, process, stackage-cli, system-fileio, system-filepath, text [details]
License	MIT
Copyright	2015 FP Complete Corporation
Author	Dan Burton
Maintainer	danburton@fpcomplete.com
Category	Development
Home page	https://www.stackage.org/package/stackage-sandbox
Bug tracker	https://github.com/fpco/stackage-sandbox/issues
Source repo	head: git clone git://github.com/fpco/stackage-sandbox.git
Uploaded	by DanBurton at 2015-05-04T20:22:22Z
Distributions
Reverse Dependencies	1 direct, 1 indirect [details]
Executables	stackage-sandbox
Downloads	4880 total (27 in the last 30 days)
Rating	(no votes yet) [estimated by Bayesian average]
Your Rating	λ λ λ
Status	Docs not available [build log] Last success reported on 2016-12-09 [all 7 reports]

Readme for stackage-sandbox-0.1.0

[back to package description]

stackage-cli

A command-line interface for leveraging stackage.

You must have ghc, ghc-pkg, and 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 stk). The 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:

stackage init

Downloads a 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.

stackage purge

Calls 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 upgrade

A stackage purge followed by stackage init.

stackage sandbox

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

Delete cabal.config and cabal.sandbox.config.

Unlike 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

Replace cabal.config and cabal.sandbox.config with newer versions and (possibly) a new shared sandbox.