opam-client 2.0.0~beta3 · OCaml Package

Command-line argument parsers and helpers

Helpers and argument constructors

val mk_flag : ?section:string -> string list -> string -> bool Cmdliner.Term.t

val mk_opt : 
  ?section:string ->
  ?vopt:'a ->
  string list ->
  string ->
  string ->
  'a Cmdliner.Arg.converter ->
  'a ->
  'a Cmdliner.Term.t

val mk_opt_all : 
  ?section:string ->
  ?vopt:'a ->
  ?default:'a list ->
  string list ->
  string ->
  string ->
  'a Cmdliner.Arg.converter ->
  'a list Cmdliner.Term.t

Flags

val print_short_flag : bool Cmdliner.Term.t

--short

val installed_roots_flag : bool Cmdliner.Term.t

--installed-root

val shell_opt : OpamTypes.shell Cmdliner.Term.t

--shell

val dot_profile_flag : OpamTypes.filename option Cmdliner.Term.t

--dot-profile

val repo_kind_flag : OpamUrl.backend option Cmdliner.Term.t

--http/ --git/ --local

val jobs_flag : int option Cmdliner.Term.t

--jobs

val name_list : OpamTypes.name list Cmdliner.Term.t

package names

val param_list : string list Cmdliner.Term.t

parameters

val atom_list : OpamFormula.atom list Cmdliner.Term.t

package list with optional constraints

val nonempty_atom_list : OpamFormula.atom list Cmdliner.Term.t

package list with optional constraints

val atom_or_local_list : 
  [ `Atom of OpamTypes.atom
  | `Filename of OpamTypes.filename
  | `Dirname of OpamTypes.dirname ]
    list
    Cmdliner.Term.t

val arg_list : 
  string ->
  string ->
  'a Cmdliner.Arg.converter ->
  'a list Cmdliner.Term.t

Generic argument list builder

val nonempty_arg_list : 
  string ->
  string ->
  'a Cmdliner.Arg.converter ->
  'a list Cmdliner.Term.t

Generic argument list builder

Global options

type global_options = {

debug_level : int option;
verbose : int;
quiet : bool;
color : [ `Always | `Never | `Auto ] option;
opt_switch : string option;
yes : bool;
strict : bool;
opt_root : OpamTypes.dirname option;
git_version : bool;
external_solver : string option;
use_internal_solver : bool;
cudf_file : string option;
solver_preferences : string option;
best_effort : bool;
safe_mode : bool;
json : string option;
no_auto_upgrade : bool;

}

Type for global options

val global_options : global_options Cmdliner.Term.t

Global options

val apply_global_options : global_options -> unit

Apply global options

Build options

type build_options

Abstract type for build options

val build_option_section : string

val build_options : build_options Cmdliner.Term.t

Build options

val apply_build_options : build_options -> unit

Applly build options

Package listing and filtering options

val package_selection_section : string

Man section name

val package_selection : 
  OpamListCommand.selector OpamFormula.formula Cmdliner.Term.t

Build a package selection filter

val package_listing_section : string

Man section name

val package_listing : 
  (force_all_versions:bool ->
    OpamListCommand.package_listing_format)
    Cmdliner.Term.t

Package selection filter based on the current state of packages (installed, available, etc.)

Converters

val repository_name : OpamTypes.repository_name Cmdliner.Arg.converter

Repository name converter

val url : OpamTypes.url Cmdliner.Arg.converter

URL converter

val filename : OpamTypes.filename Cmdliner.Arg.converter

Filename converter

val existing_filename_or_dash : 
  OpamTypes.filename option Cmdliner.Arg.converter

Filename converter also accepting "-" for stdin/stdout

val dirname : OpamTypes.dirname Cmdliner.Arg.converter

Dirnam converter

val existing_filename_dirname_or_dash : 
  OpamFilename.generic_file option Cmdliner.Arg.converter

val positive_integer : int Cmdliner.Arg.converter

val package_name : OpamTypes.name Cmdliner.Arg.converter

Package name converter

val package : 
  (OpamTypes.name * OpamTypes.version option) Cmdliner.Arg.converter

name{.version} (or name=version)

val package_with_version : OpamTypes.package Cmdliner.Arg.converter

name.version (or name=version)

val atom : OpamTypes.atom Cmdliner.Arg.converter

name{(.|=|!=|>|<|>=|<=)version} converter

val atom_or_local : 
  [ `Atom of OpamTypes.atom
  | `Filename of OpamTypes.filename
  | `Dirname of OpamTypes.dirname ]
    Cmdliner.Arg.converter

Accepts atom but also (explicit) file and directory names

val warn_selector : (int * bool) list Cmdliner.Arg.converter

Warnings string "+3..10-4"

type 'a default = [> `default of string ] as 'a

val enum_with_default : (string * 'a default) list -> 'a Cmdliner.Arg.converter

Enumeration with a default command

val opamlist_columns : 
  OpamListCommand.output_format list Cmdliner.Arg.converter

Subcommands

type 'a subcommand = string * 'a * string list * string

A subcommand cmds, v, args, doc is the subcommand cmd, using the documentation doc and the list of documentation parameters args. If the subcommand is selected, return v.

type 'a subcommands = 'a subcommand list

val mk_subcommands : 
  'a subcommands ->
  'a option Cmdliner.Term.t * string list Cmdliner.Term.t

subcommands cmds are the terms cmd and params. cmd parses which sub-commands in cmds is selected and params parses the remaining of the command-line parameters as a list of strings.

val mk_subcommands_with_default : 
  'a default subcommands ->
  'a option Cmdliner.Term.t * string list Cmdliner.Term.t

Same as mk_subcommand but use the default value if no sub-command is selected.

val make_command_alias : 
  ('a Cmdliner.Term.t * Cmdliner.Term.info) ->
  ?options:string ->
  string ->
  'a Cmdliner.Term.t * Cmdliner.Term.info

Create an alias for an existing command. options can be used to add extra options after the original command in the doc (eg like `unpin` is an alias for `pin remove`).

val bad_subcommand : 
  'a default subcommands ->
  (string * 'a option * string list) ->
  'b Cmdliner.Term.ret

bad_subcommand cmds cmd is a command return value denoting a parsing error of sub-commands.

val mk_subdoc : 
  ?defaults:(string * string) list ->
  'a subcommands ->
  Cmdliner.Manpage.block list

mk_subdoc cmds is the documentation block for cmds.

Misc

Documentation

val global_option_section : string

val help_sections : Cmdliner.Manpage.block list

val term_info : 
  string ->
  doc:string ->
  man:Cmdliner.Manpage.block list ->
  Cmdliner.Term.info

package opam-client

Helpers and argument constructors

Flags

Global options

Build options

Package listing and filtering options

Converters

Subcommands

Misc

Documentation