package opam-client

  1. Overview
  2. Docs
Client library for opam 2.5

Install 

dune-project
 Dependency

opam.ocaml.org Readme Edit opam file Versions (29)

Authors

  1. David Allsopp
  2. V
    Vincent Bernardoff <vb@luminar.eu.org>
  3. R
    Raja Boujbel <raja.boujbel@ocamlpro.com>
  4. K
    Kate Deplaix <kit-ty-kate@outlook.com>
  5. R
    Roberto Di Cosmo <roberto@dicosmo.org>
  6. T
    Thomas Gazagnaire <thomas@gazagnaire.org>
  7. L
    Louis Gesbert <louis.gesbert@ocamlpro.com>
  8. F
    Fabrice Le Fessant <Fabrice.Le_fessant@inria.fr>
  9. A
    Anil Madhavapeddy <anil@recoil.org>
  10. G
    Guillem Rieu <guillem.rieu@ocamlpro.com>
  11. R
    Ralf Treinen <ralf.treinen@pps.jussieu.fr>
  12. F
    Frederic Tuong <tuong@users.gforge.inria.fr>

Maintainers

  1. O
    opam-devel@lists.ocaml.org

Sources

2.5.0-alpha1.tar.gz
md5=a5ac5882814d72ec3f8ed512ca9a1fe6
sha512=7c3a23798cad6a940f12154904144bdebf622a55c2a56e813a6bf3b180f5e5843971b21902c46547716836fd7e04c239256f8238db1b6ba049b878438fdad38f

doc/opam-client/OpamListCommand/index.html

Module OpamListCommandSource

Functions handling the "opam list" subcommand

Sourcetype dependency_toggles = {
  1. recursive : bool;
  2. depopts : bool;
  3. build : bool;
  4. post : bool;
  5. test : bool;
  6. dev_setup : bool;
  7. doc : bool;
  8. dev : bool;
}

Switches to determine what to include when querying (reverse) dependencies

Sourceval default_dependency_toggles : dependency_toggles
Sourcetype pattern_selector = {
  1. case_sensitive : bool;
  2. exact : bool;
  3. glob : bool;
  4. fields : string list;
  5. ext_fields : bool;
    (*

    Match on raw strings in x-foo fields

    *)
}
Sourceval default_pattern_selector : pattern_selector
Sourcetype selector =
  1. | Any
  2. | Installed
  3. | Root
  4. | Compiler
  5. | Available
  6. | Installable
  7. | Pinned
  8. | Latests_only
  9. | Depends_on of dependency_toggles * OpamTypes.atom list
  10. | Required_by of dependency_toggles * OpamTypes.atom list
  11. | Conflicts_with of OpamTypes.package list
  12. | Coinstallable_with of dependency_toggles * OpamTypes.package list
  13. | Solution of dependency_toggles * OpamTypes.atom list
  14. | Pattern of pattern_selector * string
  15. | Atoms of OpamTypes.atom list
  16. | Flag of OpamTypes.package_flag
  17. | NotFlag of OpamTypes.package_flag
  18. | Tag of string
  19. | From_repository of OpamTypes.repository_name list
  20. | Owns_file of OpamTypes.filename

Package selectors used to filter the set of packages

Sourceval uses_depexts : selector -> bool

Returns true if the selector might require depexts availibility information when applied using filter. Returns false otherwise.

Applies a formula of selectors to filter the package from a given switch state

Sourceval pattern_selector : string list -> selector OpamFormula.formula

Or-filter on package patterns (NAME or NAME.VERSION)

Get the aggregated active external dependencies of the given packages

Sourceval print_depexts : OpamSysPkg.Set.t -> unit

Lists the given aggregated active external dependencies of the given packages

Sourcetype output_format =
  1. | Name
    (*

    Name without version

    *)
  2. | Version
    (*

    Version of the currently looked-at package

    *)
  3. | Package
    (*

    name.version

    *)
  4. | Synopsis
    (*

    One-line package description

    *)
  5. | Synopsis_or_target
    (*

    Pinning target if pinned, synopsis otherwise

    *)
  6. | Description
    (*

    The package description, excluding synopsis

    *)
  7. | Field of string
    (*

    The value of the given opam-file field

    *)
  8. | Raw_field of string
    (*

    The raw value of the given opam-file field

    *)
  9. | Installed_version
    (*

    Installed version or "--" if none

    *)
  10. | Pinning_target
    (*

    Empty string if not pinned

    *)
  11. | Source_hash
    (*

    The VC-reported ident of current version, for dev packages. Empty if not available

    *)
  12. | Raw
    (*

    The full contents of the opam file (reformatted)

    *)
  13. | All_installed_versions
    (*

    List of the installed versions in all switches with the corresponding switches in brackets

    *)
  14. | Available_versions
    (*

    List of the available versions (currently installed one in bold if color enabled)

    *)
  15. | All_versions
    (*

    List of the existing package versions (installed, installed in current switch and unavailable colored specifically if color enabled)

    *)
  16. | Repository
    (*

    The repository the package was found in (may be empty for pinned packages)

    *)
  17. | Installed_files
    (*

    The list of files that the installed package added to the system

    *)
  18. | VC_ref
    (*

    The version-control branch or tag the package url is bound to, if any

    *)
  19. | Depexts
    (*

    The external dependencies

    *)

Element of package information to be printed. Fixme: should be part of the run-time man!

Sourceval default_list_format : output_format list

Gets either the current switch state, if a switch is selected, or a virtual state corresponding to the configured repos

Sourceval raw_field_names : (output_format * string) list

For documentation, includes a dummy '<field>:' for the Field format. Used for the --columns argument.

Sourceval field_names : (output_format * string) list

For documentation, includes a dummy '<field>:' and '<field>' for the Field format. Used for the --field argument.

Sourceval string_of_field : ?raw:bool -> output_format -> string
Sourceval field_of_string : raw:bool -> string -> output_format
Sourcetype package_listing_format = {
  1. short : bool;
  2. header : bool;
  3. columns : output_format list;
  4. all_versions : bool;
  5. wrap : [ `Wrap of string | `Truncate | `None ] option;
  6. separator : string;
  7. value_printer : [ `Normal | `Pretty | `Normalised ];
  8. order : [ `Standard | `Dependency | `Custom of OpamTypes.package -> OpamTypes.package -> int ];
}
Sourceval default_package_listing_format : package_listing_format

Outputs a list of packages as a table according to the formatting options. normalise supersedes prettify and uses a canonical way of displaying package definition file fields. prettify uses a nicer to read format for the package definition file fields.

Sourceval info : 'a OpamStateTypes.switch_state -> fields:string list -> raw:bool -> where:bool -> ?normalise:bool -> ?show_empty:bool -> ?all_versions:bool -> ?sort:bool -> OpamTypes.atom list -> unit

Display a general summary of a collection of packages.

Sourceval mini_field_printer : ?prettify:bool -> ?normalise:bool -> OpamParserTypes.FullPos.value -> string

Prints the value of an opam field in a shortened way (with prettify -- the default -- puts lists of strings in a format that is easier to read

Sourceval string_of_formula : selector OpamFormula.formula -> string