Skip to content

Commit 84c4602

Browse files
Jammy2211Jammy2211claude
authored
docs: correct the install page — wrong failure mode, wrong cut release, wrong support range (#706)
* docs: correct the sub-3.12 install note — three claims were false The install page promised behaviour that did not happen. Verified on real 3.9/3.10/3.11 venvs against PyPI before the fix: `pip install autolens` did not fail, it backtracked to 2026.7.29.1 and installed a months-old, JAX-less stack silently. Three corrections: - "will fail with a no matching distribution error" — it did not. It now stops with an explanation, via the 2026.7.29.1.post1 tombstone release. - "dropped support ... in release 2026.4.5.3" — wrong release. That floor was reverted on 2026-04-30 and 2026.5.1.4 ... 2026.7.29.1 all shipped >=3.9 again. The real cut is 2026.7.29.2. - "pre-2026.4.5.3 releases on PyPI have been yanked" — they were not. 396 of 421 autolens releases are live, including every release a sub-3.12 pip was landing on. The section's whole premise was a yank that never happened. Also states the one remaining gap plainly: --only-binary=:all: skips sdists, so it steps past the tombstone to the old wheel. Issue: PyAutoLabs/PyAutoHands#238 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> * docs: the supported range says 3.12 - 3.13 but 3.14 is supported Python 3.14 was promoted on 2026-07-31: it is in the classifiers, and PyAutoHands python_matrix.yml runs it as a REQUIRED unit + smoke leg alongside 3.12 and 3.13. The installation overview still advertised "3.12 - 3.13", understating support and pointing 3.14 users away from a version that is tested every night. Reworded to "Python 3.12 or later", which matches `requires-python = ">=3.12"` and does not need editing again at the next promotion. Checked and deliberately not changed: PyAutoCTI's "Python 3.12 or 3.13" is accurate — its classifiers stop at 3.13, so it genuinely was not promoted. The workspace AGENTS.md files saying CI gates on "3.12 and 3.13" are accurate too: PyAutoHeart's reusable smoke-tests workflow defaults to `["3.12", "3.13"]` and none of them override it. Issue: PyAutoLabs/PyAutoHands#238 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> --------- Co-authored-by: Jammy2211 <JNightingale2211@gmail.com> Co-authored-by: Claude Opus 5 <noreply@anthropic.com>
1 parent 49a8c35 commit 84c4602

2 files changed

Lines changed: 22 additions & 11 deletions

File tree

docs/installation/overview.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
# Overview
44

5-
**PyAutoLens** requires Python 3.12 - 3.13 and supports the Linux, MacOS and Windows operating systems.
5+
**PyAutoLens** requires Python 3.12 or later and supports the Linux, MacOS and Windows operating systems.
66

77
**PyAutoLens** can be installed via the Python distribution [Anaconda](https://www.anaconda.com/) or using
88
[Pypi](https://pypi.org/) to `pip install autolens` into your Python distribution.

docs/installation/pip.md

Lines changed: 21 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -3,9 +3,10 @@
33
# Installation with pip
44

55
:::{note}
6-
**PyAutoLens** requires **Python 3.12 or later**. If you are on Python
7-
3.9, 3.10, or 3.11, `pip install autolens` will fail with a "no matching
8-
distribution" error. Upgrade Python to 3.12+ before installing.
6+
**PyAutoLens** requires **Python 3.12 or later**. On Python 3.9, 3.10 or 3.11,
7+
`pip install autolens` stops with an error telling you to upgrade — it will not
8+
quietly install an older release instead. Upgrade Python to 3.12+ before
9+
installing.
910
:::
1011

1112
## JAX & GPU
@@ -119,16 +120,26 @@ it is safe not to install them initially.
119120

120121
## Legacy Python versions
121122

122-
We dropped support for Python 3.9, 3.10, and 3.11 in release `2026.4.5.3`
123-
(April 2026). Pre-`2026.4.5.3` releases on PyPI have been yanked, so they
124-
will not install via the standard `pip install autolens` command.
123+
We dropped support for Python 3.9, 3.10 and 3.11 in release `2026.7.29.2`
124+
(July 2026) — the first release published declaring `Requires-Python >=3.12`.
125125

126-
If you have an existing project that requires a pre-`2026.4.5.3` version,
127-
you can still install it explicitly by pinning the version, e.g.:
126+
Raising that floor does not retract what is already published. Releases at or
127+
below `2026.7.29.1` were published declaring `>=3.9`, and PyPI metadata is
128+
immutable, so they remain valid candidates forever. Left alone, `pip install
129+
autolens` on an older Python did not fail — it walked back to `2026.7.29.1` and
130+
installed a months-old stack without JAX, reporting nothing.
131+
132+
Release `2026.7.29.1.post1` exists to stop that. It contains no code, declares
133+
`Requires-Python <3.12`, and raises an error when pip tries to build it, so an
134+
unsupported Python gets an explanation instead of a stale install.
135+
136+
If you need a historical release, pin it exactly — that still resolves on older
137+
Pythons:
128138

129139
```bash
130140
pip install autolens==2025.10.6.1
131141
```
132142

133-
Yanked releases remain available for explicit pins; only resolver-driven
134-
fallback is blocked.
143+
One gap remains: `pip install --only-binary=:all: autolens` skips source
144+
distributions entirely, so it steps past `2026.7.29.1.post1` and installs the
145+
old wheel silently. If you use that flag, pin the version you want.

0 commit comments

Comments
 (0)