opam - A package manager for OCaml
Opam is a source-based package manager for OCaml. It supports multiple simultaneous compiler installations, flexible package constraints, and a Git-friendly development workflow.
Opam was created and is maintained by OCamlPro.
Compiling this repo
- Make sure you have OCaml and GNU make installed. If you don't have a recent enough version of OCaml (>= 4.01.0) at hand, see the next section.
make lib-extas advertised by
./configureif you don't have the dependencies installed. This will locally take care of all OCaml dependencies for you (downloading them, unless you used the inclusive archive we provide for each release).
This is all you need for installing and using opam, but if you want to use the
opam-lib (to work on opam-related tools), you need to link it to installed
libraries, rather than use
make lib-ext which would cause conflicts. It's
easier to already have a working opam installation in this case, so you can do
it as a second step.
- Make sure to have ocamlfind, ocamlgraph, cmdliner >= 0.9.8, cudf,
dose3, re >= 1.2.0, opam-file-format installed. Or run
opam install opam-lib --deps-onlyif you already have a working instance. Re-run
make libinstallat the end
If you are developing OPAM, you may enable developer features by including the
--enable-developer-mode parameter with
Compiling without OCaml
make cold is provided as a facility to compile OCaml, then bootstrap opam.
You don't need need to run
./configure in that case, but
you may specify
CONFIGURE_ARGS if needed, e.g.:
make cold CONFIGURE_ARGS="--prefix ~/local"
NOTE: You'll still need GNU make.
Have a bug or a feature request ? Please open an issue on our
bug-tracker. Please search for existing
issues before posting, and include the output of
opam config report and any
details that may help track down the issue.
The main documentation entry point to opam is the user manual,
opam --help. To get help for a specific command, use
opam <command> --help.
Guides and Tutorials
API, Code Documentation and Developer Manual
A more thorough technical document describing opam and specifying the package
description format is available in the
make doc will otherwise make the API documentation available under
Keep track of development and community news.
Have a question that's not a feature request or bug report? Ask on the mailing list.
Chat with fellow opamers on IRC. On the
irc.freenode.netserver, in the
We welcome contributions ! Please use Github's pull-request mechanism against
the master branch of the opam repository. If
that's not an option for you, you can use
git format-patch and email us.
The release cycle respects Semantic Versioning.
- ocaml/opam-repository is the official repository for opam packages and compilers. A number of non-official repositories are also available on the interwebs, for instance on Github.
- opam2web generates a collection of browsable HTML files for a given repository. It is used to generate http://opam.ocaml.org.
- opam-rt is the regression framework for opam.
- opam-publish is a tool to facilitate the creation, update and publication of opam packages.
Copyright and license
The version comparison function in
src/core/opamVersionCompare.ml is part of
the Dose library and Copyright 2011 Ralf Treinen.
All other code is:
Copyright 2012-2016 OCamlPro Copyright 2012 INRIA
All rights reserved. Opam is distributed under the terms of the GNU Lesser General Public License version 2.1, with the special exception on linking described in the file LICENSE.
Opam is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.