# stack-all

A CLI tool for building Haskell projects easily over Stackage major versions.

This is how I do my Haskell "build ci" now locally.

## Usage

`stack-all` by default runs `stack build` over
recent Stackage LTS major versions and Nightly
(current default is nightly, lts-17, lts-16, lts-14,... , lts-11)
corresponding to latest major ghc minor versions,
using the stack's `--resolver` option.

### Overriding stack.yaml
`stack-all` can use `stack-ltsXX.yaml` files to override the default `stack.yaml`
file for particular lts major versions. Note that a `stack-ltsXX.yaml` file
will also be used for earlier lts major versions until
another `stack-ltsYY.yaml` file is found.

For example if you have `stack-lts14.yaml` and `stack-lts12.yaml` files
in your project,
then `stack.yaml` will be used as normal to build nightly, lts-17 and lts-16,
but `stack-lts14.yaml` will be used for building lts-14 and lts-13,
and `stack-lts12.yaml` will be used for lts-12, lts-11 (and earlier).
Since `stack-all` overrides the resolver with `--resolver lts-XX`
the exact minor lts version specified in the `stack*.yaml` files
doesn't actually matter: `stack-all` always uses the latest minor release of
the lts major version according to Stackage.

(Other versioned stack.yaml filenames like stack-ghc-8.8.yaml
are not currently supported.)

### Configuring the oldest lts to build
You can configure the oldest working LTS major version for your project
by running for example `stack-all -c -o lts-13` which generates a `.stack-all`
project config file like this:
```
[versions]
# lts-12 too old
oldest = lts-13
```
(the comment line can be used to document why the older lts doesn't work).
This specifies that the oldest lts version to build for is lts-13.

### Specifying lts versions
You can abbreviate `lts-XX` args to `ltsXX` on the commandline.

There are `--oldest`  and `--newest` options to specify the range of
lts versions.

You can specify the oldest major lts to build with eg `stack-all -o lts13`.
Otherwise if not configured the default oldest lts is currently `lts-11`.

Similarly you can specify the newest lts version to build from with
`stack-all -n lts16`. (The default is to build from nightly.)

Alternatively, one can give one or more explicit lts major version to build for
as arguments: eg `stack-all lts14` if you only wish to build that version.

### Running other stack commands
By default `stack-all` just runs the stack `build` command over lts versions.

You can also specify stack commands and options on the command line: eg
```
$ stack-all test --no-rerun-tests
```
will run `stack test` over the LTS versions instead.

Happy stack building!

## Install
The project is released on Hackage.

You can also build from source with `stack install` or `cabal install`.

## Collaboration
The project is hosted at https://github.com/juhp/stack-all under a BSD license.