package merlin-lib

  1. Overview
  2. Docs
Merlin's libraries

Install 

dune-project
 Dependency

github.com Readme Changelog Edit opam file Versions (12)

Authors

  1. T
    The Merlin team

Maintainers

  1. D
    defree@gmail.com

Sources

merlin-5.6-503.tbz
sha256=b0dcad092aaaf7a23f65ab9a089e8761bd665cc72357909e0ac6c2182f4fc2d4
sha512=9987baf2b2e82bab4c90a328bfcba9945e797e0f3d947156f04435ee84b49542844b379e35a79027c3ffe81f4b7a8f1c60803233999b4c039d4598033371880d

doc/merlin-lib.utils/Merlin_utils/Marg/index.html

Module Merlin_utils.MargSource

Argument parsing library which fold over arguments

Specifications of arguments is split in two passes:

  • _ table for parsing global arguments (compiler flags, merlin configuration)
  • a (string * _ t) for parsing command local arguments
Sourcetype 'acc t = string list -> 'acc -> string list * 'acc

Action associated to a flag updating a state of type 'acc. It takes a list of arguments and either succeeds returning untouched arguments or fails raising an exception.

Sourcetype 'acc table = (string, 'acc t) Hashtbl.t

A table mapping a flag to the corresponding action

Combinators for building actions

Sourceval unit : ('acc -> 'acc) -> 'acc t

Action updating state and not consuming any argument

Sourceval param : string -> (string -> 'acc -> 'acc) -> 'acc t

Action consuming a single argument

Sourceval bool : (bool -> 'acc -> 'acc) -> 'acc t

Action consuming a boolean argument

Sourceval int : (int -> 'acc -> 'acc) -> 'acc t

Action consuming an integer argument

Sourceval unit_ignore : 'acc t

Action doing nothing

Sourceval param_ignore : 'acc t

Action doing nothing and dropping one argument

Parsing of argument lists

Sourcetype docstring = string
Sourcetype 'a spec = string * docstring * 'a t
Sourceval parse_one : warning:(string -> unit) -> 'global table -> 'local spec list -> string list -> 'global -> 'local -> (string list * 'global * 'local) option

Consume at most one flag from the list, returning updated state or None in case of failure. Warning function is called with an error message in case of incorrect use.

Sourceval parse_all : warning:(string -> unit) -> 'global table -> 'local spec list -> string list -> 'global -> 'local -> 'global * 'local

Consume all arguments from the input list, calling warning for incorrect ones and resuming parsing after.