Unihan-etl

_Maintenance only, no bug fixes, or new features_

Internal changes

- {mod}`unihan_etl._internal.app_dirs` improvements (287)

- Breaking: `app_dirs` moved

- Before 0.23.x: `unihan_etl.app_dirs`
- After 0.23.x: `unihan_etl._internal.app_dirs`

- New feature: Override directories on a one-off basis
- New feature: Template replacement of variables replacing environmental variables
via {func}`os.path.expandvars` + {func}`os.path.expanduser`
- {mod}`doctests`: See the above in action thanks to doctests
- Dedicated tests via pytest

Documentation

- API docs (288):
- Limit depth of table of contents to one
- Fix section heading
- Fix comment in `AppDirs`

Bug fixes

- Fix for `destination` of files not replacing file extension correctly (285)

{class}`unihan_etl.options.Options`

Documentation

- Add {mod}`doctest` support (274)

- Initial doctest example added to README.md, test.py, and util.py.

- Stub out initial pytest plugin (274)
- Split _API_ docs into multiple files (283)
- Fix `make start` in `docs/Makefile` by fixing argument positions (283)

Bug fixes

- Fix for `destination` of files not replacing file extension correctly (286)

_Maintenance only, no bug fixes or features_

Internal improvements

- Move file locations to {mod}`pathlib` internally (277)
- Improved typing download `urlretrive_fn` and `reporthook` via {class}`typing.Protocol` (277)

_Maintenance only, no bug fixes or features_

Breaking changes

- **Python 3.7 Dropped**

Python 3.7 support has been dropped (272)

Its end-of-life is June 27th, 2023 and Python 3.8 will add support for
{mod}`typing`'s {class}`typing.TypedDict` and {class}`typing.Protocol` out of the box without needing
{mod}`typing_extensions`'s.

Internal improvements

- Typings:

- Import {mod}`typing` as a namespace, e.g. `import typing as t` (276)
- Use `typing` for {class}`typing.TypedDict` and {class}`typing.Literal` (276)
- Use typing_extensions' {py:data}`TypeAlias` for repeated types, such in test_expansions (276)