package opam-monorepo

duniverse -- the spice of OCaml build life

This is an experimental vendoring system for Dune. Not for public consumption just yet.

Please see the manual pages for an explanation of how to use the tool:

• duniverse: the overall usage
• duniverse init
• duniverse pull

Contact @avsm if you have any queries.

Manual Pages

duniverse

NAME
       opam-monorepo - the spice of build life

SYNOPSIS
       opam-monorepo COMMAND ...

DESCRIPTION
       The opam-monorepo plugin provides a convenient interface to bridge the
       opam package manager with having a local copy of all the source code
       required to build a project using the dune build tool.

       It works by analysing opam package metadata and calculating a set of
       URLs that can be downloaded or cloned into the local repository into a
       duniverse/ subdirectory. Once the external code has been pulled into
       the repository, a single dune build command is sufficient to build the
       whole project in a standalone fashion, without opam being required.
       This is a particularly convenient way of publishing CLI tools to users
       who do not need the full power of opam.

       You can access the functionality directly via the monorepo-lock and
       monorepo-pull commands,

       Also see https://github.com/avsm/platform for an example of a fully
       bootstrapping use of this tool.

COMMANDS
       lock
           analyse opam files to generate a project-wide lock file

       pull
           fetch the dependencies sources as specified by the lockfile

COMMON OPTIONS
       --help[=FMT] (default=auto)
           Show this help in format FMT. The value FMT must be one of `auto',
           `pager', `groff' or `plain'. With `auto', the format is `pager` or
           `plain' whenever the TERM env var is `dumb' or undefined.

       --version
           Show version information.

SEE ALSO
       dune(1), git(1), opam(1)