Django-docutils

Breaking changes: Debloating, Part 1

django-docutils is a hastily-extracted hunk of specialized django code - and only now is getting
dedicated attention.

To begin, django-docutils just got leaner downstream, beginning with removal of
non-essential dependencies and experimental code.

Remove `favicon`, `references` and `rst_post` (374)

_Resolves 371_

These are ORM based parts and too specialized for a docutils package for django.

This also includes references to ads, e.g. `inject_ads`, `add_keywords`, and
`BASED_ADS` (fixes 372).

If you want to use these, please file an issue on the tracker.

Remove old references to `based` prefixes to `django_docutils` (374)

_Fixes 373_

- Settings: `BASED` -> `DJANGO_DOCUTILS`, e.g. `BASED_LIB` ->
`DJANGO_DOCUTILS_LIB`.

Remove dependency on `tqdm` and `tldextract` (374)

_Fixes 363_

These packages aren't required by the core reStructuredText functionality.

- Run black formatter on codebase.

Internal improvements

- [ruff]: Improved linting via additional ruff rules, including import sorting
(368)

Post releases

_Maintenance only, no bug fixes or features_

Internal improvements

- Move formatting, import sorting, and linting to [ruff].

This rust-based checker has dramatically improved performance. Linting and
formatting can be done almost instantly.

This change replaces isort, flake8 and flake8 plugins.

- Tests: Remove reliance on [`py.local.path`](https://py.readthedocs.io/en/latest/path.html#py-path-local-local-file-system-path) (369)

It has has been deprecated by pytest in favor of {class}`pathlib.Path` parts.

- Remove some partial typings, in lieu of full typings in the future (369)

This typings were unused and in some cases incorrect.

[ruff]: https://ruff.rs

Packaging

- Add `pytz` required dependency

Required, implicitly removed in newer django versions.

- Remove `MANIFEST.in`

poetry handles this via `include` in pyproject.toml

- Remove `.readthedocs.yml`, unused as we self-host
- poetry: 1.4.0 -> 1.5.1

See also:

Breaking changes

- `tqdm` and `tldextract` are not installed by default (362)

This is for simplicity for the user (to note have to wrestle with sub-packages)

Infrastructure

- CI speedups (361)

- Split out release to separate job so the PyPI Upload docker image isn't pulled on normal runs
- Clean up CodeQL

- Poetry: Bump 1.1.x to 1.2.x

Packaging

- Remove `.tmuxp-before-script.sh` (was used by `.tmuxp.yaml`'s `before_script`)

Development

- Moved project structure to `src/` (356)
- Add [flake8-bugbear](https://github.com/PyCQA/flake8-bugbear) (#352)
- Add [flake8-comprehensions](https://github.com/adamchainz/flake8-comprehensions) (#353)

Documentation

- Render changelog in [`linkify_issues`] (350, 355)
- Fix Table of contents rendering with sphinx autodoc with [`sphinx_toctree_autodoc_fix`] (355)

[`linkify_issues`]: https://gp-libs.git-pull.com/linkify_issues/
[`sphinx_toctree_autodoc_fix`]: https://gp-libs.git-pull.com/sphinx_toctree_autodoc_fix/