release-notes/cabal-install-3.8.0.20220526.md

   1 cabal-install 3.8.0.20220526 Changelog
   2 ---
   3
   4 ### Significant changes
   5
   6 - `cabal init` rewrite [#1074](https://github.com/haskell/cabal/issues/1074) [#6758](https://github.com/haskell/cabal/issues/6758) [#6864](https://github.com/haskell/cabal/issues/6864) [#7251](https://github.com/haskell/cabal/issues/7251) [#7255](https://github.com/haskell/cabal/issues/7255) [#7256](https://github.com/haskell/cabal/issues/7256) [#7273](https://github.com/haskell/cabal/issues/7273)
   7
   8   - Restructures the `cabal init` command to fix historical
   9     issues. All flags are preserved.
  10     - Codebases for interactive and non-interactive flags
  11       are disentangled.
  12     - Data structures now exploit relevant stanza structure
  13       and formatters only care about stanza data.
  14     - Heuristics and prompts have a pure and impure implementation.
  15
  16   - Sets default behavior to be `--interactive` as opposed to
  17     `--non-interactive`.
  18
  19   - Rewrites tests to achieve 98% coverage
  20     - Golden files now test every stanza individually.
  21     - Every flag is covered by a unit test.
  22     - Interactive, simple, and non-interactive workflows are
  23       covered.
  24
  25 - Make `Paths_` modules work with non-standard preludes again [#7494](https://github.com/haskell/cabal/issues/7494) [#7649](https://github.com/haskell/cabal/issues/7649)
  26
  27   - Reverts [#7510](https://github.com/haskell/cabal/pull/#7510) that failed on Windows when used with pre-generated scripts included in packages such as `network`, `time`, `process`.
  28   - Adds a subtler fix/workaround for the deficiencies of new `autoconf` versions on Windows.
  29
  30 - Windows: rewrite paths to configure [#7494](https://github.com/haskell/cabal/issues/7494) [#7649](https://github.com/haskell/cabal/issues/7649)
  31
  32 - Expose `cabal-install` as library [#1597](https://github.com/haskell/cabal/issues/1597) [#3781](https://github.com/haskell/cabal/issues/3781) [#4798](https://github.com/haskell/cabal/issues/4798) [#6090](https://github.com/haskell/cabal/issues/6090) [#7224](https://github.com/haskell/cabal/issues/7224) [#7358](https://github.com/haskell/cabal/pull/7358)
  33
  34 - Conditionals and imports in `cabal.project` files [#7556](https://github.com/haskell/cabal/issues/7556) [#7783](https://github.com/haskell/cabal/pull/7783)
  35
  36   `cabal.project` files now allow conditional logic on compiler version, arch, etc. as well as imports of other local or remote project of freeze files (both old and new style).
  37
  38 - Split out package `Cabal-syntax` for `.cabal` file syntax and parsing [#7559](https://github.com/haskell/cabal/issues/7559) [#7620](https://github.com/haskell/cabal/pull/7620)
  39
  40 ### Other changes
  41
  42 - Remove `world` file functionality [#6767](https://github.com/haskell/cabal/issues/6767) [#7746](https://github.com/haskell/cabal/pull/7746)
  43
  44   In `v1-install`, `world` was used to trace what packages have been
  45   installed, and re-install everything that is listed in it on-demand. However, in
  46   `v2-install`, this is no longer needed, and outdated.
  47   Additionally, `world` code-path is probably not up-to-date, remove it instead of
  48   having partial features.
  49
  50   - Don't generate `world` file in `~/.cabal` when `v1-install` is executed.
  51
  52   - Don't ever read `world` from `~/.cabal`.
  53
  54   - Remove meta-target `world` from `v1-install`.
  55
  56 - A default configuration is no longer written when a config file is given explicitly [#7705](https://github.com/haskell/cabal/issues/7705) [#7715](https://github.com/haskell/cabal/pull/7715)
  57
  58   - When no config file exists, `cabal` commands will create a default one.
  59
  60   - This behavior is discontinued now when the config file is given explicitly
  61     via the `--config-file` option or the `CABAL_CONFIG` environment variable.
  62
  63   - If no config file is given explicitly, and the default config file
  64     (relative to `CABAL_DIR`) does not exist, it is created as it used to be.
  65
  66 - Use `nroff -man | less` instead of `man` as backend for `cabal man` [#7714](https://github.com/haskell/cabal/issues/7714) [#7726](https://github.com/haskell/cabal/pull/7726)
  67
  68   The previous implementation of `cabal man` used `man` as backend to
  69   view the generated manpage file.  However, macOS' and BSD's `man` does
  70   not accept a file as input, so `cabal man` was broken on macOS and
  71   BSD.
  72
  73   The issue has been fixed by piping the generated manpage through
  74   `nroff -man` and then into `$PAGER` which defaults to `less`.  Thus,
  75   `cabal man` now works both on Linux and macOS/BSD.
  76
  77   NB: `cabal man` requires `nroff` to be installed which is the case for
  78   standard setups (but may not be case on slim setups like VMs used in
  79   CI).  Note that `nroff` is not necessarily a prerequisite of a package
  80   containing `man`.
  81
  82 - Use `Win32 >= 2.8` to get `Win32.sYNCHRONIZE` [#7835](https://github.com/haskell/cabal/issues/7835) [#7982](https://github.com/haskell/cabal/pull/7982)
  83
  84   #7982 also completes a changelog entry for `Cabal-3.6.1.0`, noting it is required for `cabal-install >= 3.6`.
  85
  86 - Handle option argument parse errors without `error` [#7573](https://github.com/haskell/cabal/issues/7573) [#7579](https://github.com/haskell/cabal/pull/7579)
  87
  88   - Errors parsing arguments such as `-v=3` no longer result in
  89     stack traces.
  90   - `Distribution.ReadE.readEOrFail` was removed.
  91
  92 - Add `preferred-versions` support for `LocalIndexRepo` [#7294](https://github.com/haskell/cabal/issues/7294) [#7295](https://github.com/haskell/cabal/pull/7295)
  93
  94   - Previously, the only repo-index-type that reads the preferred-versions file was `RepoRemote`.
  95     `LocalIndexRepo` now also supports parsing `preferred-versions` file, main purpose is to write tests.
  96     As a nice side-effect, users can provide their own overlay over package sets to restrict or prefer certain package versions.
  97
  98 - Add `preferred-versions` support for `cabal outdated` [#5603](https://github.com/haskell/cabal/issues/5603) [#7249](https://github.com/haskell/cabal/issues/7249) [#7296](https://github.com/haskell/cabal/pull/7296)
  99
 100   - `cabal outdated` honours the `preferred-versions` file which might deprecate or prefer certain
 101     versions of packages. In particular, if the only newer version of a package has been deprecated,
 102     `cabal outdated` should not report that there are newer versions available.
 103
 104 - Changes to `cabal v2-configure` [#5591](https://github.com/haskell/cabal/issues/5591) [#7180](https://github.com/haskell/cabal/issues/7180) [#7405](https://github.com/haskell/cabal/issues/7405) [#7402](https://github.com/haskell/cabal/pull/7402)
 105
 106   - removes the `--dry-run` part of the `v2-configure` command
 107   - add `--enable-append` and `--disable-append` flags to `v2-configure`, which toggle the option for the new configuration to be appended to the old config file
 108   - add `--enable-backup` and `--disable-backup` flags to `v2-configure`, which toggle the backup feature for the configuration file
 109
 110 - Standalone tests for `cabal init` [#7410](https://github.com/haskell/cabal/issues/7410) [#7424](https://github.com/haskell/cabal/pull/7424)
 111
 112   - change the behaviour of the `--tests` flag for `cabal init`,
 113     see https://github.com/haskell/cabal/issues/7410#issuecomment-849913926
 114   - add a new value `TestSuite` for the `PackageType` type
 115
 116 - `cabal outdated --v2-freeze-file` prints error message if no freeze file can be found [#7406](https://github.com/haskell/cabal/issues/7406) [#7440](https://github.com/haskell/cabal/pull/7440)
 117
 118   Instead of ignoring a missing `.freeze` file, abort execution and print an error message.
 119
 120 - Make `cabal` respect `setgid` permission bit when creating directories [#7560](https://github.com/haskell/cabal/issues/7560) [#7572](https://github.com/haskell/cabal/pull/7572)
 121
 122   - Previously `cabal` would override an admin's choice to use setgid on the
 123     `.cabal` directory by using hardcoded file and directory modes upon
 124     creation. Instead we now take what the system decides and only add to
 125     that set of permissions.
 126
 127 - Glob expand `extra-source-files` when tracking for rebuild [#4746](https://github.com/haskell/cabal/issues/4746) [#7608](https://github.com/haskell/cabal/pull/7608)
 128
 129   - Since 3.4, `extra-source-files` have been tracked by cabal-install in the rebuild-checking logic. However, this tracking did not, until this PR, take into account glob-expansion.
 130
 131 - Improve error message when no test/benchmark is found [#5079](https://github.com/haskell/cabal/issues/5079) [#5255](https://github.com/haskell/cabal/issues/5255) [#7834](https://github.com/haskell/cabal/pull/7834)
 132
 133   When `cabal test` and the error message recommends setting `tests: True`, the next `cabal test` run is likely to fail with a solver error. The user might incorrectly conclude that setting `tests: True` made the problem worse, because the failure now occurs earlier (at solving time rather than at testing time).
 134
 135   By including the fact that a plan failure is expected in the error message, hopefully users will be more confident that setting `tests: True` was the right move, so they will be able to focus on the true cause of the problem: the fact that no plan including the tests exists.
 136
 137 - Better support for scripts [#5508](https://github.com/haskell/cabal/issues/5508) [#5698](https://github.com/haskell/cabal/issues/5698) [#6149](https://github.com/haskell/cabal/issues/6149) [#6354](https://github.com/haskell/cabal/issues/6354) [#7073](https://github.com/haskell/cabal/issues/7073) [#7842](https://github.com/haskell/cabal/issues/7842) [#7851](https://github.com/haskell/cabal/pull/7851) [#7925](https://github.com/haskell/cabal/pull/7925) [#7938](https://github.com/haskell/cabal/pull/7938) [#7990](https://github.com/haskell/cabal/pull/7990) [#7997](https://github.com/haskell/cabal/pull/7997)
 138
 139   - Script support improved or added across relevant commands.
 140   - `cabal run script` will now cache results and will not do a fresh build every time.
 141   - `cabal build script` added: It will build the cache for script.
 142   - `cabal repl script` added: It will open a repl for script using the cache if available.
 143   - `cabal clean script` added: It will clean the cache for script.
 144   - `cabal clean` will now remove script caches for which there is no marching script.
 145   - `cabal list-bin` now works with scripts
 146   - The name of the generated script executable has been changed from "script" to
 147     "cabal-script-<your-sanitized-script-name>" for easier process management.
 148   - Reduce the default verbosity of scripts, so that the build output doesn't interfere with the script output.
 149   - Scripts now support a project metadata block that allows them to use options
 150     that would normally be set in a cabal.project file.
 151
 152 - Remove `Distribution.Client.Compat.FilePerms` [#7948](https://github.com/haskell/cabal/pull/7948)
 153
 154   - Remove the module `Distribution.Client.Compat.FilePerms`, since it's
 155     both dead code and duplicates code from `Distribution.Compat.CopyFile`.
 156
 157 - Avoid malformed range requests [#5952](https://github.com/haskell/cabal/issues/5952) [#7970](https://github.com/haskell/cabal/pull/7970)
 158
 159   - Don't send malformed range requests. Should make fetching from head.hackage and other "unstable" overlays more reliable.
 160
 161 - Apply local options only to local packages [#7998](https://github.com/haskell/cabal/issues/7998) [#7973](https://github.com/haskell/cabal/pull/7973)
 162
 163   - Command-line `ghc-options` only applies to local packages
 164   - `program-options` stanza only applies to local packages
 165
 166 - Improve error message for empty `--allow-newer=`  [#7740](https://github.com/haskell/cabal/issues/7740) [#8140](https://github.com/haskell/cabal/pull/8140)
 167
 168   Instead of internal error, the message now explains that empty argument for
 169   `--allow-newer=` is not allowed and reminds what `--allow-newer` (with the empty
 170   argument) means.
 171
 172 - `cabal check` now fails when no upper bounds for `base` or `Cabal` are present in setup dependencies [#4683](https://github.com/haskell/cabal/issues/4683) [#5370](https://github.com/haskell/cabal/pull/5370) [#7409](https://github.com/haskell/cabal/pull/7409)
 173
 174 - Fix `v2-haddock` results in "unexpected status" [#6679](https://github.com/haskell/cabal/issues/6679) [#7843](https://github.com/haskell/cabal/pull/7843)
 175
 176 - Fix that cabal v2 commands (`install`, `repl`, `run`) use duplicate global config and rebuild libs twice in the store [#6907](https://github.com/haskell/cabal/issues/6907) [#7753](https://github.com/haskell/cabal/pull/7753) [#7759](https://github.com/haskell/cabal/pull/7759)
 177
 178 - `--repl-no-load` option skips startup modules load in REPL [#7541](https://github.com/haskell/cabal/issues/7541) [#7578](https://github.com/haskell/cabal/pull/7578)
 179
 180 - Fix post-checkout-command crash when 0 exit status bug [#7641](https://github.com/haskell/cabal/issues/7641) [#7847](https://github.com/haskell/cabal/pull/7847)
 181
 182 - Fix `list-bin` to only choose the selected component [#7679](https://github.com/haskell/cabal/issues/7679) [#7791](https://github.com/haskell/cabal/pull/7791)
 183
 184 - `cabal sdist` works in projects with `extra-packages` [#7698](https://github.com/haskell/cabal/issues/7698)
 185
 186 - Add `-c` alias for `--constraint` command line flag [#7765](https://github.com/haskell/cabal/issues/7765) [#7766](https://github.com/haskell/cabal/pull/7766)
 187
 188 - Ensure that `v2-sdist` command respects the `--ignore-project` flag [#7965](https://github.com/haskell/cabal/issues/7965) [#8109](https://github.com/haskell/cabal/pull/8109)
 189
 190 - Make enable/disable nix flags easier to read [#8036](https://github.com/haskell/cabal/issues/8036) [#8054](https://github.com/haskell/cabal/pull/8054)
 191
 192 - Add "prompt" strategy when symlinking binaries. [#5672](https://github.com/haskell/cabal/pull/5672)
 193
 194 - Add a verbosity flag `+nowarn`, to suppress all warnings [#7286](https://github.com/haskell/cabal/issues/7286) [#7470](https://github.com/haskell/cabal/pull/7470)
 195
 196 - Lazily decode cache files for checking invalidation [#7466](https://github.com/haskell/cabal/issues/7466) [#7516](https://github.com/haskell/cabal/pull/7516)
 197
 198 - Add `--open` flag to `cabal haddock` [#7366](https://github.com/haskell/cabal/issues/7366) [#7550](https://github.com/haskell/cabal/pull/7550)
 199
 200 - Defer `build-tools-depends` choices as well as setup choices [#7532](https://github.com/haskell/cabal/pull/7532) [#7561](https://github.com/haskell/cabal/pull/7561)
 201
 202 - Fix running GHCJS executables [#6175](https://github.com/haskell/cabal/issues/6175) [#6361](https://github.com/haskell/cabal/issues/6361) [#7575](https://github.com/haskell/cabal/pull/7575)
 203
 204 - Support Git submodules in `source-package-respository` [#5536](https://github.com/haskell/cabal/issues/5536) [#7625](https://github.com/haskell/cabal/pull/7625)
 205
 206 - Add support for `--package-db` flags to v2 commands [#5773](https://github.com/haskell/cabal/issues/5773) [#7676](https://github.com/haskell/cabal/pull/7676)
 207
 208 - `cabal init` now takes an optional argument and treats it as root directory for the new package [#7871](https://github.com/haskell/cabal/issues/7871) [#7873](https://github.com/haskell/cabal/pull/7873)
 209
 210 - Silence warning about `world`-file field being unrecognised for flat config files [#7894](https://github.com/haskell/cabal/issues/7894) [#7903](https://github.com/haskell/cabal/pull/7903)
 211
 212 - Fix Ctrl-C handling during package download [#6322](https://github.com/haskell/cabal/issues/6322) [#7929](https://github.com/haskell/cabal/pull/7929)
 213
 214 - Fix the timestamp shown during `cabal update` [#7934](https://github.com/haskell/cabal/pull/7934)
 215
 216 - Sync darcs repos [#7137](https://github.com/haskell/cabal/pull/7137)
 217
 218 - `cabal-install-solver`: Provide more context in error messages [#7468](https://github.com/haskell/cabal/issues/7468) [#7473](https://github.com/haskell/cabal/pull/7473)
 219
 220   - Error messages for misspelled extensions and languages now provide additional context.
 221   - The error messages will provide a suggested fix if the misspelled extension or language is similar enough
 222     to known languages and extensions.
 223
 224 ### Internal changes
 225
 226 - Remove bootstrapping plan files from version control, and simplify bootstrap update `Makefile` targets. [#7949](https://github.com/haskell/cabal/pull/7949)
 227
 228 - CI setup
 229
 230   - Remove Travis scripts [#6959](https://github.com/haskell/cabal/pull/6959)