package resto

  1. Overview
  2. Docs
A minimal OCaml library for type-safe HTTP/JSON RPCs

Install 

dune-project
 Dependency

gitlab.com Readme Changelog Edit opam file Versions (13)

Authors

  1. N
    Nomadic Labs
  2. O
    Ocamlpro

Maintainers

  1. C
    contact@nomadic-labs.com

Sources

resto-v1.0.tar.gz
md5=394275a7579c7dbcb29631b447006253
sha512=20f7d3ee730b4b202707ec7802662733ec2e3db76a7be78d4f794eb22796d8fc54e3e16e5a8e2fff80b391ea84cfbe470044772b815eebfd389d0a6754e1df85

doc/resto/Resto/Arg/index.html

Module Resto.ArgSource

Arguments are documented serializers-deserializers for parameters.

Sourcetype 'a t

The type of an argument.

Sourcetype 'a arg = 'a t
Sourceval make : ?descr:string -> name:string -> destruct:(string -> ('a, string) result) -> construct:('a -> string) -> unit -> 'a arg

make ?descr ~name ~destruct ~construct () is an argument. The values of descr and name are used for documentation purpose only. The values of destruct and construct are used for conversion from/to strings. Note that it is expected that destruct and construct round-trip (modulo the result error wrapping).

Sourcetype descr = {
  1. name : string;
  2. descr : string option;
}

descr is a type for the documentation of a t.

Sourceval descr : 'a arg -> descr

descr t is the documentation of t.

Sourceval bool : bool arg

bool is an argument for boolean values. The strings "yes", "y", "true", and "t", as well as all capitalisation variation thereof, all parsed to true. The strings "no", "n", "false", and "f", as well as all capitalisation variation thereof, all parsed to false. All other strings fail to parse.

Sourceval int : int arg

int is an argument for integer values. The parsing is identical to that of Stdlib.int_of_string -- refer to that function's documentation.

Sourceval int32 : int32 arg

int32 is an argument for 32-bit integer values. The parsing is identical to that of Int32.of_string -- refer to that function's documentation.

Sourceval int64 : int64 arg

int64 is an argument for 64-bit integer values. The parsing is identical to that of Int64.of_string -- refer to that function's documentation.

Sourceval float : float arg

float is an argument for floating-point decimal values. The parsing is identical to that of Float.of_string -- refer to that function's documentation.

Sourceval string : string arg

string is an argument for string values. No parsing is done.

Sourceval like : 'a arg -> ?descr:string -> string -> 'a arg

like a ?descr name is a new argument which carries the same type parameter and uses the same constructor/destructor functions as a, but has a different name and description. It is intended to be used to give different meaning to isomorphic arguments. E.g.,

let date = make ~descr:"A date in YYYY-MM-DD format" ~name:"date" ~destruct:(fun s -> ..) ~construct:(fun d -> ..) () in let birth_date = like date ~descr:"A date of birth in the YYYY-MM-DD format" "birth-date" in ..

Sourceval eq : 'a arg -> 'b arg -> ('a, 'b) eq option

eq a b is Some Eq if a and b are the same and None otherwise.

Note that eq a (like a ..) is always None.