Module `Tyre`Source

Typed regular expressions

Tyre is a set of combinators to build type-safe regular expressions, allowing automatic extraction and modification of matched groups.

Tyre is bi-directional: a typed regular expressions can be used both for matching and evaluation. Multiple tyregexs can be combined in order to do routing in similar manner as switches/pattern matching. Typed regular expressions are strictly as expressive as regular expressions from re (and are, as such, regular expressions, not PCREs). Performances should be exactly the same.

# let dim = Tyre.( str"dim:" *> int <&> str"x" *> int ) ;;
val dim : (int * int) Tyre.t

# let dim_re = Tyre.compile dim ;;
val dim_re : (int * int) Tyre.re

# Tyre.exec dim_re "dim:3x4" ;;
- : (int * int, (int * int) Tyre.error) result = Result.Ok (3, 4)

# Tyre.eval dim (2, 5) ;;
- : string = "dim:2x5"

ppx_tyre allows to use the usual regular syntax, if prefered:

# let dim = [%tyre "dim:(?&int)x(?&int)"] ;;
val dim : (int * int) Tyre.t

Sourcetype 'a t

A typed regular expression.

The type variable is the type of the returned value when the typed regular expression (tyregex) is executed.

For example tyre : int t can be used to return an int. In the rest of the documentation, we will use «tyre» to designate a value of type t.

Combinators

Sourceval pcre : string -> string t

pcre s is a tyregex that matches the PCRE s and return the corresponding string. Groups in s are ignored.

Sourceval regex : Re.t -> string t

regex re is a tyregex that matches re and return the corresponding string. Groups inside re are erased.

Sourceval conv : ('a -> 'b) -> ('b -> 'a) -> 'a t -> 'b t

conv to_ from_ tyre matches the same text as tyre, but converts back and forth to a different data type.

to_ is allowed to raise an exception exn. In this case, exec will return `ConverterFailure exn.

For example, this is the implementation of pos_int:

let pos_int =
  Tyre.conv
    int_of_string string_of_int
    (Tyre.regex (Re.rep1 Re.digit))

Sourceval opt : 'a t -> 'a option t

opt tyre matches either tyre or the empty string. Similar to Re.opt.

Sourceval alt : 'a t -> 'b t -> [ `Left of 'a | `Right of 'b ] t

alt tyreL tyreR matches either tyreL (and will then return `Left v) or tyreR (and will then return `Right v).

Repetitions

Sourceval rep : 'a t -> 'a Seq.t t

rep tyre matches tyre zero or more times. Similar to Re.rep.

For matching, rep tyre will matches the string a first time, then tyre will be used to walk the matched part to extract values.

Sourceval rep1 : 'a t -> ('a * 'a Seq.t) t

rep1 tyre is seq tyre (rep tyre). Similar to Re.rep1.

Sequences

Sourceval seq : 'a t -> 'b t -> ('a * 'b) t

seq tyre1 tyre2 matches tyre1 then tyre2 and return both values.

Sourceval prefix : _ t -> 'a t -> 'a t

prefix tyre_i tyre matches tyre_i, ignores the result, and then matches tyre and returns its result. Converters in tyre_i are never called.

Sourceval suffix : 'a t -> _ t -> 'a t

Same as prefix, but reversed.

Infix operators

Sourceval (<|>) : 'a t -> 'b t -> [ `Left of 'a | `Right of 'b ] t

t <|> t' is alt t t'.

Sourceval (<&>) : 'a t -> 'b t -> ('a * 'b) t

t <&> t' is seq t t'.

Sourceval (*>) : _ t -> 'a t -> 'a t

ti *> t is prefix ti t.

Sourceval (<*) : 'a t -> _ t -> 'a t

t <* ti is suffix t ti.

Sourcemodule Infix : sig ... end

Useful combinators

Sourceval str : string -> unit t

str s matches s and evaluates to s.

Sourceval char : char -> unit t

char c matches c and evaluates to c.

Sourceval blanks : unit t

blanks matches Re.(rep blank) and doesn't return anything.

Sourceval int : int t

int matches -?[0-9]+ and returns the matched integer.

Integers that do not fit in an int will fail.

Sourceval pos_int : int t

pos_int matches [0-9]+ and returns the matched positive integer.

Integers that do not fit in an int will fail.

Sourceval float : float t

float matches -?[0-9]+( .[0-9]* )? and returns the matched floating point number.

Floating point numbers that do not fit in a float returns infinity or neg_infinity.

Sourceval bool : bool t

bool matches true|false and returns the matched boolean.

Sourceval list : 'a t -> 'a list t

list e is similar to rep e, but returns a list.

Sourceval terminated_list : sep:_ t -> 'a t -> 'a list t

terminated_list ~sep tyre is list (tyre <* sep) .

Sourceval separated_list : sep:_ t -> 'a t -> 'a list t

separated_list ~sep tyre is equivalent to opt (e <&> list (sep *> e)).

Other combinators

See Re for details on the semantics of those combinators.

Sourceval start : unit t

Sourceval stop : unit t

Sourceval word : 'a t -> 'a t

Sourceval whole_string : 'a t -> 'a t

Sourceval longest : 'a t -> 'a t

Sourceval shortest : 'a t -> 'a t

Sourceval first : 'a t -> 'a t

Sourceval greedy : 'a t -> 'a t

Sourceval non_greedy : 'a t -> 'a t

Sourceval nest : 'a t -> 'a t

Matching

Sourcetype 'a re

A compiled typed regular expression.

Sourceval compile : 'a t -> 'a re

compile tyre is the compiled tyregex representing tyre.

Sourcetype 'a error = [

| `NoMatch of 'a re * string
| `ConverterFailure of exn

]

Sourceval pp_error : Format.formatter -> _ error -> unit

Source

val exec : 
  ?pos:int ->
  ?len:int ->
  'a re ->
  string ->
  ('a, 'a error) Result.result

exec ctyre s matches the string s using the compiled tyregex ctyre and returns the extracted value.

Returns Error (`NoMatch (tyre, s) if tyre doesn't match s. Returns Error (`ConverterFailure exn) if a converter failed with the exception exn.

parameter pos
Optional beginning of the string (default 0)

parameter len
Length of the substring of str that can be matched (default to the end of the string)

Sourceval execp : ?pos:int -> ?len:int -> 'a re -> string -> bool

execp ctyre s returns true if ctyre matches s. Converters are never called.

parameter pos
Optional beginning of the string (default 0)

parameter len
Length of the substring of str that can be matched (default to the end of the string)

since 0.1.1

Repeated Matching

Source

val all : 
  ?pos:int ->
  ?len:int ->
  'a re ->
  string ->
  ('a list, 'a error) Result.result

all ctyre s calls to exec repeatedly and returns the list of all the matches.

Sourceval all_seq : ?pos:int -> ?len:int -> 'a re -> string -> 'a Seq.t

all_seq ctyre s is all ctyre s but returns a gen instead. Matches are enumerated lazily.

Exceptions raised by converters are not caught.

Routing

Sourcetype +'a route =

| Route : 'x t * ('x -> 'a) -> 'a route
(*
A route is a pair of a tyregex and a handler. When the tyregex is matched, the function is called with the result of the matching.
*)

Sourceval (-->) : 'x t -> ('x -> 'a) -> 'a route

tyre --> f is Route (tyre, f).

Sourceval route : 'a route list -> 'a re

route [ tyre1 --> f1 ; tyre2 --> f2 ] produces a compiled tyregex such that, if tyre1 matches, f1 is called, and so on.

The compiled tyregex shoud be used with exec.

Evaluating

Sourceval eval : 'a t -> 'a -> string

eval tyre v returns a string s such that exec (compile tyre) s = v.

Note that such string s is not unique. eval will usually returns a very simple witness.

Sourceval evalpp : 'a t -> Format.formatter -> 'a -> unit

evalpp tyre ppf v is equivalent to Format.fprintf ppf "%s" (eval tyre v), but more efficient.

Is is generally used with "%a":

let my_pp = Tyre.evalpp tyre in
Format.printf "%a@." my_pp v

Pretty printing

Sourceval pp : Format.formatter -> 'a t -> unit

Sourceval pp_re : Format.formatter -> 'a re -> unit

Install

Dune Dependency

Authors

Maintainers

Sources

doc/tyre/Tyre/index.html

Module `Tyre`Source

Typed regular expressions

Combinators

Repetitions

Sequences

Infix operators

Useful combinators

Other combinators

Matching

Repeated Matching

Routing

Evaluating

Pretty printing

package tyre

Install

Dune Dependency

Authors

Maintainers

Sources

doc/tyre/Tyre/index.html

Module TyreSource

Typed regular expressions

Combinators

Repetitions

Sequences

Infix operators

Useful combinators

Other combinators

Matching

Repeated Matching

Routing

Evaluating

Pretty printing

Module `Tyre`Source