2.1.0~alpha

This is the alpha release of opam 2.1.0.

This alpha release contains many new features, please see blog post for some highlights and upgrade instructions.

Binaries and full archive are signed by @AltGr.

Changelog (possibly scripts breaking changes are prefixed with ✘):

New features

Recursive pin

Opam now handles lookup for opam files on subdirectories with recursive, subpath based, and subpath recursive pin: --recursive and --subpath PATH options. On recursive mode, opam goes through subdirectories to find opam files & pin them to their subdirectories. On subpath based mode, opam goes to the given subdirectory to find opam file & pin it to this subdirectory.

• Recursive & subpath based pin [#3499 @rjbou @hngrgr - fix #3174 #3477] {2.1.0-alpha}

Switch Invariant

Define switch base packages as a switch invariant, a generic dependency formula instead of an immutable specific package/version.

• Define switch invariants rather than "base packages" [#3894 @AltGr] {2.1.0-alpha}

• Don't warn on switch creation with 'ocaml' as invariant [#4108 @AltGr] {2.1.0-alpha}

• Better error handling on switch creation [#4121 @AltGr] {2.1.0-alpha}

Lock

opam-lock was during a long time an opam plugin, and it is now integrated into opam. Option --locked permits to lock an opam package, according the current switch. It produces a locked file (by default <pkgname>.opam.locked, can be specified with --lock-suffix) that contains the original opam file with its depends: field all package are set to their exact version available in the current switch.

• Integrate lock plugin [#3746 @rjbou - fix #3734 #3769 #3694] {2.1.0-alpha}

• Check consistency with opam file when reading lock file to suggest regeneration message [#3680 @rjbou - fix #3654] {2.0.2}

Options configuration

Replace switch and global variables settings opam config set options, by opam var and opam option to generalize them to all modifiable options and variables:

• opam var|option: list modifiable options and their values

• opam var|option foo: display foo value, available for all

• opam var|option foo(=|-=|+=)bar: update foo value

• opam var|option foo=: remove/revert foo value

By default, acts on switch scope. It can be specified with --global or --switch sw.

It deprecates opam config (set|unset|set-global-unset-global) commands.

• Add configuration modifications as opam config subcommands [#3992 @rjbou] {2.1.0-alpha}

• opam var and opam option outside of opam config [#4116 @rjbou - fix #4119] {2.1.0-alpha}

• Enable option var optim switch load [#4138 @rjbou] {2.1.0-alpha}

Depext

opam-depext is also a long time opam plugin, used to show / install external dependencies of opam packages. It is now fully integrated in the opam workflow:

• check of installed package dependencies

• on install, check that required dependencies are present, show / propose to install if not

Global configuration option depext, depext-verify, depext-cannot-install, depext-run-installs, and depext-bypasspermit to configure depext use and interactions. CLI options--assume-depextsand--no-depexts` can also be used for a single command.

• Integrate depext plugin [#3975 @rjbou @AltGr - fix #3790 #1519 #2426 #3692] {2.1.0-alpha}

• Enable command/output display only from verbose level 3 [#4141 @rjbou] {2.1.0-alpha}

New options

Install

• opam install --check <pkg> checks that <pkg> dependencies are already installed in the switch. It reports missing ones and exits with 1, 0 otherwise. It is used on a check only purpose, additionally to --deps-only. [#3854 @rjbou - fix #3823] {2.1.0-alpha}

• --ignore-conflicts to use with --deps-only in case it is needed to install dependencies without taking conflicts into account. [#3853 @rjbou - fix #3846] {2.1.0-alpha}

Show

• opam show --just-file <file> shows information of a given file, without loading the switch state. It can be combined with other options, as field filter --field. It deprecates --file option. [#3729 @rjbou - fix #3721] {2.1.0-alpha}

• opam show --all-versions <pkg> displays information of all versions of the given package. It can be used in combination of field filter. [#3867 @rjbou - fix #2980] {2.1.0-alpha}

• opam show --sort <pkg> display on stdout a sorted opam file: all fields are alphabetically sorted. [#3866 @rjbou - fix ocaml-opam/opam2web#173] {2.1.0-alpha}

• Better error handling. [#4118 @rjbou - fix #3875] {2.1.0-alpha}

Lint

• opam lint --check-upstream enables lint checks on archive urls. This option lead to download archives to check their checksum. [#3758 @rjbou] {2.0.5}

List

• --silent to not write in the output, exit with return code 0 if the list is not empty, 1 otherwise. [#3533 @rjbou - fix #3525] {2.0.1}

Env

• opam env --check permit to indicates if an opam environment is synchronized: returns 0 if up-to-date, 1 otherwise. [#4074 @rjbou - fix #3725] {2.1.0-alpha}

Switch export

• --freeze option record VCS commit hash when a VCS url is specified. [#4055 @hannesm] {2.1.0-alpha}

• With --full option, include extra-files in switch export, on import create an overlay directory with the file contents. [#4040 @hannesm] {2.1.0-alpha}

Enhancements, updates, and fixes

Repository Management

• Optimize repository loading: we store the repository contents as .tar.gz files in ~/.opam/repo instead. Rather than resorting to a complex in-memory structure, we just untar them to /tmp when they need to be read, and re-tar them after modification (opam update, or format upgrade only). Then we let the OS disk cache do the job: in normal operation, the tree never needs to be flushed to disk, and loading the .tar.gz is orders of magnitude faster than loading the individual files. [#3752 @AltGr - fix l#3721] {2.1.0-alpha}

Fixes

• Remove mismatching extra-files: sort list before comparing them. [#3744 @rjbou] {2.0.4}

• Handle failure or interruption of tar during opam update. [#3861 @AltGr] {2.1.0-alpha}

• Fallback in case repository archive doesn't exist. [#4008 @rjbou] {2.1.0-alpha}

• In case repository archive is corrupted, delete it and ask to launch an update. [#4075 @rjbou - fix #4053] {2.1.0-alpha}

• When adding a repository, an error is displayed in case of mismatching urls, now both urls are displayed. [#4086 @rjbou - fix #4085] {2.1.0-alpha}

Update

• Handle url backend change to VCS of a package from repository. [#4007 @rjbou - fix #3991] {2.1.0-alpha}

Switch & install

• Allow local compiler switch creation. [#3720 @rjbou - fix #3713] {2.1.0-alpha}

• Fix multiple compiler candidate. [#3884 @rjbou - fix #3874] {2.1.0-alpha}

• Make reinstall handling stricter. [#3907 @AltGr] {2.1.0-alpha}

List

• Fix opam list --external [#3558 @rjbou - fix #3557 ocaml/opam-repository#12677] {2.0.1}

• ✘ With --resolve restrain test dependencies to direct one instead of listing all test dependencies of queried package(s) [#3923 @rjbou - fix ocaml-opam/opam-depext#121] {2.1.0-alpha}

Show

• opam show with local opam file returns local file information. Fixes also the non 1.2 conversion to 2.0 format of local files with opam show --raw. [#3536 @rjbou - fix #3423] {2.0.1}

• Fields are no longer required to end with a colon. [#3931 @rjbou] {2.1.0-alpha}

• ✘ With --normalise disable terminal width wrapping. [#3868 @rjbou - fix #3751] {2.1.0-alpha}

• String fields printed with quotes, as lists. [#3368 @rjbou - fix #3365] {2.0.1}

• Remove pin depends messages. [#3679 @rjbou] {2.0.2}

Pinning

• Update source of (version) pinned directory [#3726 @rjbou - fix #3651] {2.0.4}

• Pin edit: fix editing an opam file without a name field. [#3535 @rjbou] {2.0.1}

• Upgrade pin depends on pinning. [#3684 @rjbou - fix #3508] {2.0.2}

• Update pin-depends confirmation message to add a skip option. [#3852 @rjbou - fix #3840] {2.1.0-alpha}

• To avoid lint warning 57 (description error) on 1.2 opam file pinning, add auxiliary files (descr, url) before linting. [#3687 @rjbou] {2.0.2}

• Fix --ignore-pin-depends with autopin. [#3736 @AltGr] {2.0.4}

• Fix pin not installing/upgrading already pinned package. [#3800 @AltGr] {2.0.4}

Working directory

• Add OPAMDROPWORKINGDIR environment variable for C. [#3792 @rjbou - fix #3727] {2.1.0-alpha}

• Don't restrain copy to versioned file. [#3759 @rjbou] {2.1.0-alpha}

• Don't fetch sources when working-dir is set. [#4046 @rjbou] {2.1.0-alpha}

• Update in place source copy:

  • review sync_dirty on VCS:
    • use VCS to synchronize, then rsync & remove others files
    • exclude _build, _opam & VCS directories
  • when --inplace-build is given, it does a dirty synchronization of the
    sources, in order to keep tracking package stats (clean, local or dirty). [#3948 @rjbou] {2.1.0-alpha}

• Fix working-dir messages on update command. [#3824 @rjbou] {2.1.0-alpha}

• Working-dir fixes. [#3982 @rjbou] {2.1.0-alpha}

Download & url management

Download

• Don't execute validation hook if update is empty. [#3490 @hannesm] {2.0.1}

• Don't check hash with --no-checksum on pull_upstream. [#3658 @rjbou - fix #3652] {2.0.2}

• Update download errors handling during actions processing. [#3811 @AltGr] {2.1.0-alpha}

• Update ftp command, to pass url last. [#3910 @hannesm] {2.1.0-alpha}

• Terminate (with double dashes) list of command-line download optio...

2.0.7

This is the release of opam 2.0.7.

This minor release contains small fixes, please see blog post for upgrade instructions.

Binaries and full archive are signed by @AltGr.
As an addendum to this release, the macOS/arm64 binary was built by @avsm (but not yet signed).

Changelog:

• Properly escape Windows paths on manpages [#4129 @AltGr @rjbou]
• Fix opam installer opam file [#4058 @rjbou]
• Fix various warnings [#4132 @rjbou @AltGr - fix #4100]
• Fix dune 2.5.0 promote-install-files duplication [#4132 @rjbou ]
• opam exec: display command not found message [#4133 @rjbou - fix #4131]

2.0.6

This is the release of opam 2.0.6.

This minor release contains mainly fixes, please see the changelog for details, and blog post for upgrade instructions.

Binaries and full archive are signed by @AltGr.

2.0.5

This is the release of opam 2.0.5.

This minor release contains mainly fixes, please see the changelog for details, and blog post for upgrade instructions.

Binaries and full archive are signed by @AltGr.

2.0.4

This is the release of opam 2.0.4.

This minor release contains mainly fixes, please see the changelog for details, and blog post for upgrade instructions.

Binaries and full archive are signed by @AltGr.

2.0.3

This is the release of opam 2.0.3.

This minor release contains mainly fixes, please see the changelog for details, and blog post for upgrade instructions.

2.0.2

This is the release of opam 2.0.2.

This minor release contains mainly fixes, plese see the changelog for details, and blog post for upgrade instructions.

Binaries and full archive are signed by @AltGr.

2.0.1

This is the release of opam 2.0.1.

This minor release contains mainly fixes.

Binaries and full archive are signed by @AltGr.

2.0.0

This is the release of opam 2.0.0.

See the Upgrade Guide for an overview of changes.

2.0.0~rc4 FINAL

This is the final release of opam 2.0.0.

Since there is a repository format change involved from our last stable release 1.2.0, we are leaving a few weeks for things to settle before officially switching the official package repository to 2.0.0 format. This release remains tagged as rc4 in the meantime.

You are encouraged to switch as soon as you see fit:

• there is already a 2.0.0 branch in the official repository, that is automatically used by opam 2, and automatically updated.
• opam 2.0.0 can read 1.2.0 repositories and package definition files transparently.
• on the other hand, once the switch is made, new packages will appear only on opam 2.0.0. Backports to the 1.2.0 repository will be limited.

See the Upgrade Guide to get started with opam 2.0 and see what is new.