# Abnf
## Example
```elixir
iex(1)> parser = Abnf.load("priv/rfc5234.abnf")
Rfc5234
iex(2)> parser.parse(:rule, "DQUOTE = %x22\r\n")
[{:rule, "DQUOTE = %x22\r\n",
[{:rulename, "DQUOTE",
[{:ALPHA, "D", []}, {:ALPHA, "Q", []}, {:ALPHA, "U", []}, {:ALPHA, "O", []},
{:ALPHA, "T", []}, {:ALPHA, "E", []}]},
{:"defined-as", " = ",
[{:"c-wsp", " ", [{:WSP, " ", [{:SP, " ", []}]}]}, {:literal, "=", []},
{:"c-wsp", " ", [{:WSP, " ", [{:SP, " ", []}]}]}]},
{:elements, "%x22",
[{:alternation, "%x22",
[{:concatenation, "%x22",
[{:repetition, "%x22",
[{:element, "%x22",
[{:"num-val", "%x22",
[{:literal, "%", []},
{:"hex-val", "x22",
[{:literal, "x", []}, {:HEXDIG, "2", [{:DIGIT, "2", []}]},
{:HEXDIG, "2", [{:DIGIT, "2", []}]}]}]}]}]}]}]}]},
{:"c-nl", "\r\n", [{:CRLF, "\r\n", [{:CR, "\r", []}, {:LF, "\n", []}]}]}]}]
```
## TODO
- [x] Build minimal parser
- [x] Build minimal generator
- [x] Use self-hosted parser
- [ ] Parse rfc2822
- [ ] Improve test coverage
- [ ] Clean up generator
- [ ] Log error messages during parsing
- [ ] Improve UX of parsing for specific rules
## Installation
If [available in Hex](https://hex.pm/docs/publish), the package can be installed as:
1. Add abnf to your list of dependencies in `mix.exs`:
def deps do
[{:abnf, "~> 0.0.1"}]
end
2. Ensure abnf is started before your application:
def application do
[applications: [:abnf]]
end