# `Localize.Message.Parser`
[🔗](https://github.com/elixir-localize/localize/blob/v1.4.0/lib/localize/message/parser/parser.ex#L1)

Implements a parser for
[ICU MessageFormat 2](https://unicode.org/reports/tr35/tr35-messageFormat.html).

# `message`

```elixir
@spec message(binary(), keyword()) ::
  {:ok, [term()], rest, context, line, byte_offset}
  | {:error, reason, rest, context, line, byte_offset}
when line: {pos_integer(), byte_offset},
     byte_offset: non_neg_integer(),
     rest: binary(),
     reason: String.t(),
     context: map()
```

Parses a MessageFormat 2 message string with the NimbleParsec
combinator that `parse/1` wraps.

### Arguments

* `binary` is a MF2 message string.

* `options` is a keyword list of NimbleParsec options. The default
  is `[]`.

### Returns

* `{:ok, ast, rest, context, position, byte_offset}` on success.

* `{:error, reason, rest, context, position, byte_offset}` when the
  text is not a message.

### Examples

    iex> {:ok, ast, "", _context, _position, _offset} =
    ...>   Localize.Message.Parser.message("{{Hello}}")
    iex> ast
    [{:complex, [], {:quoted_pattern, [text: "Hello"]}}]

# `parse`

```elixir
@spec parse(String.t()) :: {:ok, list()} | {:error, Exception.t()}
```

Parses a MessageFormat 2 message string.

### Arguments

* `input` is a MF2 message string.

### Returns

* `{:ok, ast}` where `ast` is the parsed message AST.

* `{:error, reason}` if the message cannot be parsed.

### Examples

    iex> Localize.Message.Parser.parse("{{Hello, world!}}")
    {:ok, [{:complex, [], {:quoted_pattern, [{:text, "Hello, world!"}]}}]}

# `parse!`

```elixir
@spec parse!(String.t()) :: list() | no_return()
```

Parses a MessageFormat 2 message string, raising on error.

Same as `parse/1` but returns the AST directly or raises
`Localize.ParseError`.

### Arguments

* `input` is a MF2 message string.

### Returns

* The parsed message AST.

### Examples

    iex> Localize.Message.Parser.parse!("{{Hello, world!}}")
    [{:complex, [], {:quoted_pattern, [{:text, "Hello, world!"}]}}]

---

*Consult [api-reference.md](api-reference.md) for complete listing*