Skip to content

docs: replace stale Python-versions line with a pyversions badge#234

Open
midhunxavier wants to merge 1 commit into
Farama-Foundation:mainfrom
midhunxavier:fix/readme-python-versions-227
Open

docs: replace stale Python-versions line with a pyversions badge#234
midhunxavier wants to merge 1 commit into
Farama-Foundation:mainfrom
midhunxavier:fix/readme-python-versions-227

Conversation

@midhunxavier
Copy link
Copy Markdown

Description

The README hardcoded Supported Pythons: 3.7 to 3.12, but the package requires >=3.8.0,<3.13 (setup.py) and CI only tests 3.83.12 — so 3.7 was incorrect.

This replaces the manually-maintained line with the dynamic shields.io pyversions badge in the README's top badge row (matching other Farama projects), so the supported-versions info stays correct across future releases without manual edits. This follows the approach suggested by the issue reporter.

Changes

  • README.md — add [![Python](https://img.shields.io/pypi/pyversions/stable-retro.svg)](https://pypi.org/project/stable-retro/) to the top badge row, and remove the stale Supported Pythons: 3.7 to 3.12 line.
  • setup.py — add Programming Language :: Python :: 3.83.12 trove classifiers. The pyversions badge reads these from PyPI, and stable-retro currently ships none.

Note on the badge

The pyversions badge resolves from PyPI trove classifiers, not from requires-python. The latest published stable-retro release has no Python classifiers, so the badge will render python | missing until a release including these classifiers is published. After the next release it will show 3.8 | 3.9 | 3.10 | 3.11 | 3.12.

Verification

  • pre-commit run --files README.md setup.py — all hooks pass (black, isort, flake8, pyupgrade, add-trailing-comma).
  • autopep8 --diff setup.py — no changes (PEP8-clean, per scripts/lint.sh).
  • setup.py parses; the classifiers match python_requires and the CI test matrix.
  • No runtime code is changed, so the test suite is unaffected.

Fixes #227

The README hardcoded "Supported Pythons: 3.7 to 3.12", but the package
requires `>=3.8.0,<3.13` (setup.py) and CI only tests 3.8-3.12, so 3.7 was
incorrect. Replace the manually-maintained line with the dynamic shields.io
`pyversions` badge in the top badge row, matching other Farama projects so it
stays correct across releases.

The `stable-retro` PyPI package currently ships no Python trove classifiers,
which the `pyversions` badge reads, so also add the
`Programming Language :: Python :: 3.8`..`3.12` classifiers to setup.py. The
badge will resolve to 3.8-3.12 once a release including these classifiers is
published.

Fixes Farama-Foundation#227

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Readme says supported python versions are 3.7-3.12

1 participant