# BrDocs

Utilities for Brazilian documents in Elixir.

## CNPJ

`BrDocs.CNPJ` supports both the numeric CNPJ model and the alphanumeric model
announced by Receita Federal for new registrations from July 2026.

```elixir
BrDocs.CNPJ.format("00000000000191")
# {:ok, "00.000.000/0001-91"}

BrDocs.CNPJ.format("ab12cd34000184")
# {:ok, "AB.12C.D34/0001-84"}

BrDocs.CNPJ.unformat("AB.12C.D34/0001-84")
# {:ok, "AB12CD34000184"}

BrDocs.CNPJ.valid?("AB.12C.D34/0001-84")
# true
```

## CPF

```elixir
BrDocs.CPF.format("12345678909")
# {:ok, "123.456.789-09"}

BrDocs.CPF.unformat("123.456.789-09")
# {:ok, "12345678909"}

BrDocs.CPF.valid?("123.456.789-09")
# true
```

## Installation

If [available in Hex](https://hex.pm/docs/publish), the package can be installed
by adding `br_docs` to your list of dependencies in `mix.exs`:

```elixir
def deps do
  [
    {:br_docs, "~> 0.1.0"}
  ]
end
```

Documentation can be generated with [ExDoc](https://github.com/elixir-lang/ex_doc)
and published on [HexDocs](https://hexdocs.pm). Once published, the docs can
be found at <https://hexdocs.pm/br_docs>.

## License

This project is licensed under the MIT License. See the [LICENSE](LICENSE) file
for details.