Uri template parse

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
primitive URITemplateParse
  """
  Parse a URI template string, returning either a valid `URITemplate`
  or a `URITemplateParseError` describing what went wrong.

  Use this instead of the `URITemplate` constructor when you need details
  about parse failures.

  ```pony
  match URITemplateParse("{+path}/here")
  | let tpl: URITemplate =>
    let result = tpl.expand(vars)
  | let err: URITemplateParseError =>
    env.err.print("Bad template: " + err.string())
  end
  ```
  """
  fun apply(template: String): (URITemplate | URITemplateParseError) =>
    """
    Parse a URI template string.

    Returns a `URITemplate` on success or a `URITemplateParseError` with
    details about the syntax error on failure.
    """
    match _URITemplateParser.parse(template)
    | let parts: Array[_TemplatePart] val =>
      URITemplate._from_parts(template, parts)
    | let err: URITemplateParseError =>
      err
    end