# `Caracola.Headers`
[🔗](https://github.com/netkubes/caracola/blob/v0.1.0-rc.1/lib/caracola/headers.ex#L1)

Header name handling: compact forms and canonical capitalization.

Header names are stored lowercased (`"call-id"`) and capitalized only when
serialized (`"Call-ID"`).

# `canonical_name`

```elixir
@spec canonical_name(String.t()) :: String.t()
```

Capitalizes a lowercased header name for serialization.

    iex> Caracola.Headers.canonical_name("call-id")
    "Call-ID"
    iex> Caracola.Headers.canonical_name("user-agent")
    "User-Agent"

# `normalize_name`

```elixir
@spec normalize_name(String.t()) :: String.t()
```

Normalizes a header name as received: lowercased, compact forms expanded.

    iex> Caracola.Headers.normalize_name("v")
    "via"
    iex> Caracola.Headers.normalize_name("Content-Length")
    "content-length"

---

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