package ez_cmdliner

  1. Overview
  2. Docs
Easy interface to Cmdliner à la Arg.parse with sub-commands

Install 

dune-project
 Dependency

ocamlpro.github.io Readme Changelog LGPL-2.1-only WITH OCaml-LGPL-linking-exception License Edit opam file Versions (5)

Authors

  1. F
    Fabrice Le Fessant <fabrice.le_fessant@ocamlpro.com>

Maintainers

  1. F
    Fabrice Le Fessant <fabrice.le_fessant@ocamlpro.com>

Sources

v0.4.3.tar.gz
sha256=a4aaa008bf2bf29189e3c66c9481aab5d2e12b20c0b769a484df5dc07d68961d

doc/ez_cmdliner/Ezcmd/index.html

Module EzcmdSource

Sourcemodule V1 : sig ... end
Sourcemodule V2 : sig ... end

Easy interface over Cmdliner. Very similar to the Stdlib Arg module.

include module type of struct include V1.Ezcmd end
Sourcemodule TYPES = V1.Ezcmd.TYPES
Sourcemodule MANPAGE = V1.Ezcmd.MANPAGE
Sourceval parse : ?name:string -> ?version:string -> ?man:TYPES.block list -> (string * TYPES.Arg.spec * string) list -> (string -> unit) -> string -> unit
Sourceval translate : ?docs:string -> (string * TYPES.Arg.spec * string) list -> (string list * TYPES.Arg.spec * TYPES.info) list
Sourceval translate_anon : (string -> unit) -> (string list * TYPES.Arg.spec * TYPES.info) list
Sourceval env : ?docs:string -> ?doc:string -> string -> TYPES.env

env ~docs ~doc var describes an environment variable var. doc is the man page information of the environment variable, defaults to "undocumented". docs is the title of the man page section in which the environment variable will be listed, it defaults to Manpage.s_environment.

In doc the documentation markup language can be used with following variables:

  • $(env), the value of var.
  • The variables mentioned in info
Sourceval info : ?docs:string -> ?docv:string -> ?env:TYPES.env -> string -> TYPES.info

info docs docv env doc defines information for an argument.

  • env defines the name of an environment variable which is looked up for defining the argument if it is absent from the command line. See environment variables for details.

  • doc is the man page information of the argument. The documentation language can be used and the following variables are recognized:

    • "$(docv)" the value of docv (see below).
    • "$(opt)", one of the options of names, preference is given to a long one.
    • "$(env)", the environment var specified by env (if any).

    These functions can help with formatting argument values.

  • docv is for positional and non-flag optional arguments. It is a variable name used in the man page to stand for their value.
  • docs is the title of the man page section in which the argument will be listed. For optional arguments this defaults to Manpage.s_options. For positional arguments this defaults to Manpage.s_arguments. However a positional argument is only listed if it has both a doc and docv specified.
Sourceval main_with_subcommands : name:string -> ?version:string -> ?default:TYPES.command -> doc:string -> ?man:TYPES.block list -> ?topics:(string * Cmdliner.Manpage.block list) list -> ?argv:string array -> TYPES.command list -> unit
Sourceval main : ?version:string -> ?argv:string array -> TYPES.command -> unit