package opam-client
Install
Dune Dependency
Authors
-
VVincent Bernardoff <vb@luminar.eu.org>
-
RRaja Boujbel <raja.boujbel@ocamlpro.com>
-
RRoberto Di Cosmo <roberto@dicosmo.org>
-
TThomas Gazagnaire <thomas@gazagnaire.org>
-
LLouis Gesbert <louis.gesbert@ocamlpro.com>
-
FFabrice Le Fessant <Fabrice.Le_fessant@inria.fr>
-
AAnil Madhavapeddy <anil@recoil.org>
-
GGuillem Rieu <guillem.rieu@ocamlpro.com>
-
RRalf Treinen <ralf.treinen@pps.jussieu.fr>
-
FFrederic Tuong <tuong@users.gforge.inria.fr>
Maintainers
Sources
md5=6f69e91a0535297272127e184c314272
sha512=f75d81b4eb19ef6603e7a2a18e1a281ea6f5eea47b820ae888593102db5b98ded5b593b176e70235611b63a07f4a406a57fe016386f4e921f51b55eb62b9864d
doc/opam-client/OpamAuxCommands/index.html
Module OpamAuxCommandsSource
Some command helpers, and auxiliary opam management functions used by the CLI
val copy_files_to_destdir :
'a OpamStateTypes.switch_state ->
OpamTypes.dirname ->
OpamTypes.package_set ->
unitGets the file changes done in the installation of the given packages in the given switch, and copies the corresponding files to the same relative paths below the given prefix ; files that are not current according to the recorded package changes print warnings and aren't copied.
val remove_files_from_destdir :
'a OpamStateTypes.switch_state ->
OpamTypes.dirname ->
OpamTypes.package_set ->
unitRemoves all files that may have been installed by copy_files_to_destdir; it's more aggressive than OpamDirTrack.revert and doesn't check if the files are current.
If the URL points to a local, version-controlled directory, qualify it by suffixing `#current-branch` if no branch/tag/hash was specified.
val name_and_dir_of_opam_file :
OpamTypes.filename ->
OpamTypes.name option * OpamTypes.dirnameFrom an in-source opam file, return the corresponding package name if it can be found, and the corresponding source directory
val opams_of_dir :
?recurse:bool ->
?subpath:string ->
OpamFilename.Dir.t ->
(OpamTypes.name * OpamFile.OPAM.t OpamFile.t * string option) listFrom a directory, retrieve its opam files and returns packages name, opam file and subpath option
val opams_of_dir_w_target :
?recurse:bool ->
?subpath:string ->
?same_kind:(OpamUrl.t -> bool) ->
OpamUrl.t ->
OpamFilename.Dir.t ->
(OpamTypes.name * OpamFile.OPAM.t OpamFile.t * OpamUrl.t * string option)
listLike opam_of_dirs, but changes the pinning_url if needed. If given url is local dir with vcs backend, and opam files not versioned, its pinning url is changed to rsync path-pin. If ame_kind the_new_url returns true, package information (name, opam file, new_url, subpath) are added to the returned list, otherwise it is discarded.
val resolve_locals :
?quiet:bool ->
?recurse:bool ->
?subpath:string ->
[ `Atom of OpamTypes.atom
| `Filename of OpamTypes.filename
| `Dirname of OpamTypes.dirname ]
list ->
(OpamTypes.name * OpamUrl.t * string option * OpamFile.OPAM.t OpamFile.t)
list
* OpamTypes.atom listResolves the opam files and directories in the list to package name and location, and returns the corresponding pinnings and atoms. May fail and exit if package names for provided `Filename could not be inferred, or if the same package name appears multiple times.
val resolve_locals_pinned :
'a OpamStateTypes.switch_state ->
?recurse:bool ->
?subpath:string ->
[ `Atom of OpamTypes.atom | `Dirname of OpamTypes.dirname ] list ->
OpamTypes.atom listResolves the opam files and directories in the list to package name and location, according to what is currently pinned, and returns the corresponding list of atoms. Prints warnings for directories where nothing is pinned, or opam files corresponding to no pinned package.
val autopin :
OpamStateTypes.rw OpamStateTypes.switch_state ->
?simulate:bool ->
?quiet:bool ->
?recurse:bool ->
?subpath:string ->
[ `Atom of OpamTypes.atom
| `Filename of OpamTypes.filename
| `Dirname of OpamTypes.dirname ]
list ->
OpamStateTypes.rw OpamStateTypes.switch_state * OpamTypes.atom listResolves the opam files in the list to package name and location, pins the corresponding packages accordingly if necessary, otherwise updates them, and returns the resolved atom list. With simulate, don't do the pinnings but return the switch state with the package definitions that would have been obtained if pinning. Also synchronises the specified directories, that is, unpins any package pinned there but not current (no more corresponding opam file).
This also handles pin-depends: of the local packages. That part is done even if simulate is true.
val simulate_autopin :
'a OpamStateTypes.switch_state ->
?quiet:bool ->
?for_view:bool ->
?recurse:bool ->
?subpath:string ->
[ `Atom of OpamTypes.atom
| `Filename of OpamTypes.filename
| `Dirname of OpamTypes.dirname ]
list ->
'a OpamStateTypes.switch_state * OpamTypes.atom listThe read-only version of autopin ~simulate:true: this doesn't require a write-locked switch, and doesn't update the local packages. for_view will result in the switch state containing more accurate information to be displayed to the user, but should never be flushed to disk because ; without that option, the state can safely be worked with and will just contain the proper package definitions