Gp-libs

- _Add your latest changes from PRs here_

Breaking changes

Minimum requirements

To lift the development burden of supporting legacy APIs, as this package is
lightly used, minimum constraints have been pinned:

- docutils: 0.20.1+
- myst-parser: 2.0.0+

If you have even passing interested in supporting legacy versions, file an
issue on the tracker.

Development

- Aggressive automated lint fixes via `ruff` (33)

via ruff v0.3.4, all automated lint fixes, including unsafe and previews were applied:

sh
ruff check --select ALL . --fix --unsafe-fixes --preview --show-fixes; ruff format .


Branches were treated with:

sh
git rebase \
--strategy-option=theirs \
--exec 'poetry run ruff check --select ALL . --fix --unsafe-fixes --preview --show-fixes; poetry run ruff format .; git add src tests; git commit --amend --no-edit' \
origin/master


- poetry: 1.7.1 -> 1.8.1

See also: https://github.com/python-poetry/poetry/blob/1.8.1/CHANGELOG.md

- ruff 0.2.2 -> 0.3.0 (32)

Related formattings. Update CI to use `ruff check .` instead of `ruff .`.

See also: https://github.com/astral-sh/ruff/blob/v0.3.0/CHANGELOG.md

- Strengthen linting (31)

- Add flake8-commas (COM)

- https://docs.astral.sh/ruff/rules/#flake8-commas-com
- https://pypi.org/project/flake8-commas/

- Add flake8-builtins (A)

- https://docs.astral.sh/ruff/rules/#flake8-builtins-a
- https://pypi.org/project/flake8-builtins/

- Add flake8-errmsg (EM)

- https://docs.astral.sh/ruff/rules/#flake8-errmsg-em
- https://pypi.org/project/flake8-errmsg/

Packaging

- Relax pytest version constraint from 8+ to 7+ (30)

Breaking change

- Support pytest >8 (29)

- Update doctest pytest plugin for pytest 8.

Development

- ruff 0.2.0

_Maintenance release: no bug fixes or new features._

CI

- Move CodeQL from advanced configuration file to GitHub's default

Development

- ci: Add pydocstyle rule to ruff (28)

Documentation

- Add docstrings to functions, methods, classes, and packages (28)

Development

- poetry: 1.6.1 -> 1.7.0

See also: https://github.com/python-poetry/poetry/blob/1.7.0/CHANGELOG.md

- Move formatting from `black` to [`ruff format`] (27)

This retains the same formatting style of `black` while eliminating a
dev dependency by using our existing rust-based `ruff` linter.

[`ruff format`]: https://docs.astral.sh/ruff/formatter/

- CI: Update action packages to fix warnings

- [dorny/paths-filter]: 2.7.0 -> 2.11.1

[dorny/paths-filter]: https://github.com/dorny/paths-filter

Packaging

- Add Python 3.12 to trove classifiers
- Packaging (poetry): Fix development dependencies

Per [Poetry's docs on managing dependencies] and `poetry check`, we had it wrong: Instead of using extras, we should create these:

toml
[tool.poetry.group.group-name.dependencies]
dev-dependency = "1.0.0"


Which we now do.

[Poetry's docs on managing dependencies]: https://python-poetry.org/docs/master/managing-dependencies/