The Haskell Tool Stack
See https://haskellstack.org/ for installation and upgrade instructions.
Changes since v2.9.1:
Behavior changes:
package-index key is introduced which takes precedence over the existing package-indices key. The latter is deprecated.hackage-security key of the package-index key or the package-indices item can be omitted, and the Hackage Security configuration for the item will default to that for the official Hackage server. See #5870.stack config set package-index download-prefix command to set the location of Stack's package index in YAML configuration files.stack setup with the --no-install-ghc flag warns that the flag and the command are inconsistent and now takes no action. Previously the flag was silently ignored.[S-nnnn], where nnnn is a four-digit number.stdin) will not throw an exception. Previously, they would thow an exception, consistent with Cabal's 'exitcode-stdio-1.0' test suite interface specification. Pass the flag --no-tests-allow-stdin to stack build to enforce Cabal's specification. See #5897
Other enhancements:
stack upgrade warns that if GHCup is used to install Stack, only GHCup should be used to upgrade Stack. That is because GHCup uses an executable named stack to manage versions of Stack, that Stack will likely overwrite on upgrade.stack ls dependencies cabal command, which lists dependencies in the format of exact Cabal constraints.STACK_XDG environment variable to use the XDG Base Directory Specification for the Stack root and Stack's global YAML configuration file, if the Stack root location is not set on the command line or by using the STACK_ROOT environment variable.stack path --global-config, to yield the full path of Stack's user-specific global YAML configuration file (config.yaml).allow-newer-deps, which allows users to specify a subset of dependencies for which version bounds should be ignored (allow-newer-deps: ['foo', 'bar']). This field has no effect unless allow-newer is enabled.Bug fixes:
Distribution.PackageDescription, if compiling StackSetupShim with Cabal-syntax-3.8.1.0 in package database. See #5886.package-indices key (or the hackage-security key of its item) is omitted, the expiration of timestamps
is now ignored, as intended. See Pantry #63
Thanks to all our contributors for this release:
Changes since v2.9.1:
Behavior changes:
package-index key is introduced which takes precedence over the existing package-indices key. The latter is deprecated.hackage-security key of the package-index key or the package-indices item can be omitted, and the Hackage Security configuration for the item will default to that for the official Hackage server. See #5870.stack config set package-index download-prefix command to set the location of Stack's package index in YAML configuration files.stack setup with the --no-install-ghc flag warns that the flag and the command are inconsistent and now takes no action. Previously the flag was silently ignored.[S-nnnn], where nnnn is a four-digit number.stdin) will not throw an exception. Previously, they would thow an exception, consistent with Cabal's 'exitcode-stdio-1.0' test suite interface specification. Pass the flag --no-tests-allow-stdin to stack build to enforce Cabal's specification. See #5897.Other enhancements:
stack upgrade warns that if GHCup is used to install Stack, only GHCup should be used to upgrade Stack. That is because GHCup uses an executable named stack to manage versions of Stack, that Stack will likely overwrite on upgrade.stack ls dependencies cabal command, which lists dependencies in the format of exact Cabal constraints.STACK_XDG environment variable to use the XDG Base Directory Specification for the Stack root and Stack's global YAML configuration file, if the Stack root location is not set on the command line or by using the STACK_ROOT environment variable.stack path --global-config, to yield the full path of Stack's user-specific global YAML configuration file (config.yaml).allow-newer-deps, which allows users to specify a subset of dependencies for which version bounds should be ignored (allow-newer-deps: ['foo', 'bar']). This field has no effect unless allow-newer is enabled.Bug fixes:
Distribution.PackageDescription, if compiling StackSetupShim with Cabal-syntax-3.8.1.0 in package database. See #5886.package-indices key (or the hackage-security key of its item) is omitted, the expiration of timestamps
is now ignored, as intended. See Pantry #63.See https://haskellstack.org/ for installation and upgrade instructions.
Changes since v2.7.5:
Behavior changes:
stack build --coverage will generate a unified coverage report, even if there is only one *.tix file, in case a package has tested the library of another package that has not tested its own library. See #5713
stack --verbose no longer includes the lengthy raw snapshot layer (rsl) in the debug output by default. The new stack --[no-]rsl-in-log flag enables or disables the inclusion of the rsl in the debug output.Other enhancements:
DisplayVersion in the registry, enabling tools like winget to properly read the version number.--script-no-run-compile (disabled by default) that uses the --no-run option with stack script (and forces the --compile option). This enables a command like stack --script-no-run-compile Script.hs to behave like stack script <arguments> --no-run --compile -- Script.hs but without having to list all the <arguments> in the Stack interpreter options comment in Script.hs on the command line. That may help test that scripts compile in CI (continuous integration). See #5755
stack ls now yields the equivalent of stack ls --help). See #809
--cabal-verbosity=VERBOSITY to specify the Cabal verbosity level (the option accepts Cabal's numerical and extended syntax). See #1369
sh script to customise fully GHC installation. See #5585
tools subcommand added to stack ls, to list stack's installed tools.stack uninstall shows how to uninstall Stack.--ghc-variant accepts int-native as a variant.Bug fixes:
stack clean --full, so that the files to be deleted are not in use. See #5714
stack build --coverage
stack new
pantry-0.5.6: Remove operational and mirror keys from bootstrap key set. See #53
cpp-options: in the Cabal file to GHCi using GHC's -optP flag. See #5608
with-gcc option when installing GHC. See #5609
get_isa() in get-stack.sh to exclude systems that don't have x86 in their uname -m output. See #5792.stack ls snapshots local on Windows, to behave like that on Unix-like operating systems.Thanks to all our contributors for this release:
Changes since v2.7.5:
Behavior changes:
stack build --coverage will generate a unified coverage report, even if
there is only one *.tix file, in case a package has tested the library of
another package that has not tested its own library. See
#5713
stack --verbose no longer includes the lengthy raw snapshot layer (rsl) in
the debug output by default. The new stack --[no-]rsl-in-log flag enables or
disables the inclusion of the rsl in the debug output.Other enhancements:
DisplayVersion in the registry, enabling
tools like winget to properly read the version number.--script-no-run-compile (disabled by default) that uses the
--no-run option with stack script (and forces the --compile option).
This enables a command like stack --script-no-run-compile Script.hs to
behave like stack script <arguments> --no-run --compile -- Script.hs but
without having to list all the <arguments> in the Stack interpreter options
comment in Script.hs on the command line. That may help test that scripts
compile in CI (continuous integration). See
#5755
stack ls now yields the equivalent of stack ls --help). See
#809
--cabal-verbosity=VERBOSITY to specify the Cabal verbosity
level (the option accepts Cabal's numerical and extended syntax).
See #1369
sh script to customise fully GHC installation. See
#5585
tools subcommand added to stack ls, to list stack's installed tools.stack uninstall shows how to uninstall Stack.--ghc-variant accepts int-native as a variant.Bug fixes:
stack clean --full, so that the files to be deleted are not in use. See
#5714
stack build --coverage
stack new
pantry-0.5.6: Remove operational and mirror keys from bootstrap key
set #53
cpp-options: in the Cabal file to GHCi
using GHC's -optP flag. See
#5608
with-gcc option when installing
GHC. See #5609
get_isa() in get-stack.sh to exclude systems that don't
have x86 in their uname -m output. See
5792.stack ls snapshots local on Windows, to behave like that on
Unix-like operating systems.See https://haskellstack.org/ for installation and upgrade instructions.
Changes since v2.7.3:
Behavior changes:
Other enhancements:
stack setup supports installing GHC for macOS aarch64 (M1)
stack upload supports authentication with a Hackage API key (via
HACKAGE_KEY environment variable).
Bug fixes:
extra-path works for case-insensitive PATHs on Windows.
See rio#237
ghc and ghc-pkg locations.
#5597
stack ghci now uses package flags in stack.yaml
#5434
Thanks to all our contributors for this release:
See https://haskellstack.org/ for installation and upgrade instructions.
Changes since v2.7.1:
Other enhancements:
stack upgrade will download from haskellstack.org before trying
github.com. See
#5288
stack upgrade makes less assumptions about archive format. See
#5288
--no-run flag to the script command when compiling.Bug fixes:
stack setup always looks for the unpacked directory name to support
different tar file naming conventions. See
#5545
pantry version for better OS support. See
pantry#33
GHC_PACKAGE_PATH.stack.yaml no longer fails with an error.
#5568
stack setup will look in sandboxed directories for executables, not
relying on `findExecutables. See
GHC issue 20074
setup-config properly to avoid reconfiguring on every
change. See #5578
Thanks to all our contributors for this release:
See https://haskellstack.org/ for installation and upgrade instructions.
Changes since v2.5.1.1:
Behavior changes:
stack repl now always warns about GHCi problems with loading multiple
packages. It also sets now proper working directory when invoked with
one package. See
#5421
custom-setup dependencies are now properly initialized for stack dist.
This makes explicit-setup-deps no longer required and that option was
removed. See
#4006
Other enhancements:
Nix integration now passes ghcVersion (in addition to existing ghc) to
shell-file as an identifier that can be looked up in a compiler attribute set.
Nix integration now allows Nix integration if the user is ready in nix-shell. This gets rid of "In Nix shell but reExecL is False" error.
stack list is a new command to list package versions in a snapshot.
See #5431
Consider GHC 9.0 a tested compiler and remove warnings.
custom-preprocessor-extensions is a new configuration option for allowing
stack to be aware of any custom preprocessors you have added to Setup.hs.
See #3491
Added --candidate flag to upload command to upload a package candidate
rather than publishing the package.
Error output using --no-interleaved-output no longer prepends indentating
whitespace. This allows emacs compilation-mode and vim quickfix to locate
and track errors. See
#5523
Bug fixes:
stack new now suppports branches other than master as default for
GitHub repositories. See
#5422
Support basic auth in package-indices. See #5509.
Add support for parsing .hi. files from GHC 8.10 and 9.0. See
hi-file-parser#2.
Thanks to all our contributors for this release:
Release notes:
stack.yaml has
moved to lts-17.10. This means Stack can now be built on macOS 11.0 (Big
Sur) without ugly workarounds. GHC 8.8 is now the minimum GHC version
supported for building Stack itself (but this does not effect users of
Stack, which still supports using much older GHC versions).Changes since v2.7.0.1:
(no changes)
Changes since v2.5.1.1:
Behavior changes:
stack repl now always warns about GHCi problems with loading multiple
packages. It also sets now proper working directory when invoked with
one package. See
#5421
custom-setup dependencies are now properly initialized for stack dist.
This makes explicit-setup-deps no longer required and that option was
removed. See
#4006
Other enhancements:
Nix integration now passes ghcVersion (in addition to existing ghc) to
shell-file as an identifier that can be looked up in a compiler attribute set.
Nix integration now allows Nix integration if the user is ready in nix-shell. This gets rid of "In Nix shell but reExecL is False" error.
stack list is a new command to list package versions in a snapshot.
See #5431
Consider GHC 9.0 a tested compiler and remove warnings.
custom-preprocessor-extensions is a new configuration option for allowing
stack to be aware of any custom preprocessors you have added to Setup.hs.
See #3491
Added --candidate flag to upload command to upload a package candidate
rather than publishing the package.
Error output using --no-interleaved-output no longer prepends indentating
whitespace. This allows emacs compilation-mode and vim quickfix to locate
and track errors. See
#5523
Bug fixes:
stack new now suppports branches other than master as default for
GitHub repositories. See
#5422
Support basic auth in package-indices. See #5509.
Add support for parsing .hi. files from GHC 8.10 and 9.0. See
hi-file-parser#2.
See https://haskellstack.org/ for installation and upgrade instructions.
Changes since v2.3.3
Major changes:
snapshot-location-base yaml configuration option, which allows to
override the default location of snapshot configuration files. This option
affects how snapshot synonyms (LTS/Nightly) are expanded to URLs by the
pantry library.docker-network configuration key added to override docker --net argBehavior changes:
--watch-all
#5310
Other enhancements:
stack ls dependencies json now includes fields sha256 and size for
dependencies of type archive in location.
#5280
stack --help and the --stack-colors
option, and stack ls stack-colors --help) now include info, debug,
other-level, secondary and highlight, used with verbose output.Bug fixes:
stack test --coverage when using Cabal 3stack new now generates PascalCase'd module name correctly.
#5376
Thanks to all our contributors for this release: