# Quickstart

The main convenience function expands known abbreviations while preserving the
rest of the input:

```python
from abbr2words import abbr2words

text = "Prof. Klein kommt ggf. am Fr."
print(abbr2words(text, lang="de"))
# Professor Klein kommt gegebenenfalls am Freitag
```

Locale forms and common aliases are normalized to the bundled base language:

```python
abbr2words("Prof. Klein", lang="de-DE")
abbr2words("Prof. Klein", lang="ger")
```

Context detection is enabled by default. For German `Fr.`, the surrounding text
can distinguish a title from the weekday:

```python
abbr2words("Fr. Klein", lang="de")       # Frau Klein
abbr2words("Fr. Klein", lang="de", context=False)  # Freitag Klein
```

The `context` choice applies to each call and is independent of earlier calls.

The package expands abbreviations only. It does not normalize ordinary numbers,
dates, times, currencies, measurements, or general punctuation. The input must
be a string; a non-string raises `TypeError`, and an unknown language raises
`ValueError`.
