include module type of struct include Resto.Arg endTyped path argument.
type 'a t = 'a Resto.Arg.tAn argument to a service.
type 'a arg = 'a tval make :
?descr:string ->
name:string ->
destruct:(string -> ('a, string) result) ->
construct:('a -> string) ->
unit ->
'a argmake ?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 roundtrip (modulo the result error wrapping).
descr is a type for the documentation of a t.
val bool : bool argbool 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.
val int : int argint is an argument for integer values. The parsing is identical to that of Stdlib.int_of_string -- refer to that function's documentation.
val int32 : int32 argint32 is an argument for 32-bit integer values. The parsing is identical to that of Int32.of_string -- refer to that function's documentation.
val int64 : int64 argint64 is an argument for 64-bit integer values. The parsing is identical to that of Int64.of_string -- refer to that function's documentation.
val float : float argfloat is an argument for floating-point decimal values. The parsing is identical to that of Float.of_string -- refer to that function's documentation.
val string : string argstring is an argument for string values. No parsing is done.
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
..