package oasis

  1. Overview
  2. Docs
Tooling for building OCaml libraries and applications

Install 

dune-project
 Dependency

oasis.forge.ocamlcore.org Edit opam file Versions (4)

Authors

  1. S
    Sylvain Le Gall

Maintainers

  1. S
    Sylvain Le Gall <sylvain@le-gall.net>

Sources

oasis-0.4.8.tar.gz
sha256=1e535de19fce623cc0019d2bbc4b158ac47e10b0165620e2ea459b1b0fdbc7d2
md5=9ba176512a3cc008ec39cd4b528cc4e5

doc/oasis.cli/CLISubCommand/index.html

Module CLISubCommand

SubCommand definition

  • author Sylvain Le Gall
type cli_parsing_t = (Arg.key * Arg.spec * Arg.doc) list * Arg.anon_fun

Define the command line arguments required for a subcommand.

type 'a cli_parsing_post_t = unit -> 'a

Function to run after parsing command line arguments.

type 'a main_t = ctxt:OASISContext.t -> 'a

The main function to run the subcommand.

type 'a run_t = unit -> cli_parsing_t * 'a main_t

Generate command line arguments and the function to run the main of the subcommand.

type t = {
  1. scmd_name : OASISTypes.name;
    (*

    Name of the subcommand, used to call it

    *)
  2. scmd_synopsis : string;
    (*

    Short description of the subcommnad, displayed when doing a summary of the available subcommands

    *)
  3. scmd_help : string;
    (*

    Long description of the subcommand, displayed when showing help of the subcommand.

    It can contains variable substitution as defined in Buffer.add_substitute.

    *)
  4. scmd_usage : string;
    (*

    Arg usage text

    *)
  5. scmd_deprecated : bool;
    (*

    Is this subcommand deprecated.

    *)
  6. scmd_run : unit run_t;
    (*

    Generate the specs and a main function.

    *)
}
val default_anon : Arg.anon_fun
val default_fspecs : unit -> cli_parsing_t * unit cli_parsing_post_t
val make_run : (unit -> cli_parsing_t * 'a cli_parsing_post_t) -> ('a -> 'b) main_t -> 'b run_t

make_run fspecs main Create a run_t by combining argument parsing with the main function. The goal is to make main not use global variable and create what is need to store them in fspecs. This allow to make the whole subcommand invocation thread safe.

val register : ?usage:string -> ?deprecated:bool -> OASISTypes.name -> string -> string -> unit run_t -> unit

register ~usage name synopsis help run Create a subcommand using provided data, see t for their meanings. See make_run to define a run function. You can also see CLICommon for useful functions to wrap your run.

val find : OASISTypes.name -> t

Find a subcommand.

val list_plugin : ?deprecated:bool -> unit -> PluginLoader.entry list

List all PluginLoader entries registered. Set deprecated to false to filter out deprecated plugin

val list_builtin : ?deprecated:bool -> unit -> t list

List all builtin plugin registered. Set deprecated to false to filter out deprecated builtin.