stack-all: CLI tool for building across Stackage major versions

This is a package candidate release! Here you can preview how this package release will appear once published to the main package index (which can be accomplished via the 'maintain' link below). Please note that once a package has been published to the main package index it cannot be undone! Please consult the package uploading documentation for more information.

[maintain] [Publish]

Build your Haskell project over Stackage major LTS versions.

[Skip to Readme]

Properties

Versions	0.1, 0.1.1, 0.1.2, 0.2, 0.2.1, 0.2.2, 0.2.2, 0.3, 0.3.1, 0.4, 0.4.0.1, 0.4.1, 0.4.2, 0.5, 0.5.1, 0.5.2, 0.6, 0.6.1, 0.6.2, 0.6.3, 0.6.4
Change log	ChangeLog.md
Dependencies	base (<5), config-ini, directory (>=1.2.5), extra (>=1.6.15), filepath, process, simple-cmd (>=0.1.4), simple-cmd-args, text [details]
License	BSD-3-Clause
Copyright	2020-2021 Jens Petersen <juhpetersen@gmail.com>
Author	Jens Petersen <juhpetersen@gmail.com>
Maintainer	Jens Petersen <juhpetersen@gmail.com>
Category	Distribution
Home page	https://github.com/juhp/stack-all
Bug tracker	https://github.com/juhp/stack-all/issues
Source repo	head: git clone https://github.com/juhp/stack-all.git
Uploaded	by JensPetersen at 2021-06-07T05:50:38Z

Downloads

stack-all-0.2.2.tar.gz [browse] (Cabal source package)
Package description (as included in the package)

Maintainer's Corner

Package maintainers

JensPetersen

For package maintainers and hackage trustees

edit package information

Readme for stack-all-0.2.2

[back to package description]

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.

Note that stack only works if a stack.yaml file exists. If no stack.yaml file is found, stack-all will create one. Of course it may still fail to build, but this allows for quickly trying to build a package that does not include stack support.

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 to build over:

You can specify the oldest major lts to build for 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 versions 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 the stack command to run and its options on the commandline: 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.