Skip to content

Commit a72e7da

Browse files
Formalise Python version support policy (#252)
In `README.md`, state that we aim to support every Python branch still supported by the PSF, and state the plugin versions that added or removed support for specific branches. The plugin versions listed here are based on when each Python version gained native-speed coverage tracing in please_pex, which is a reasonable approximation of when that version was supported by the plugin.
1 parent 3aab471 commit a72e7da

1 file changed

Lines changed: 31 additions & 0 deletions

File tree

‎README.md‎

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -78,3 +78,34 @@ UsePypi = True
7878
PipFlags = ""
7979
DisableVendorFlags = False
8080
```
81+
82+
## Compatibility
83+
84+
This plugin is compatible with the same operating systems as Please itself:
85+
86+
- Darwin (amd64, arm64)
87+
- FreeBSD (amd64)
88+
- Linux (amd64, arm64)
89+
90+
and is compatible with the following Python versions:
91+
92+
- 3.9
93+
- 3.10
94+
- 3.11 (as of python-rules v1.7.0)
95+
- 3.12 (as of python-rules v1.7.0)
96+
- 3.13 (as of python-rules v1.8.0)
97+
- 3.14 (as of python-rules v1.14.0)
98+
99+
Whenever possible, we aim to ensure the plugin works with all of the
100+
[supported Python branches](https://devguide.python.org/versions/#supported-versions). Please
101+
[report](https://github.com/please-build/cc-rules/issues) any bugs you encounter when building,
102+
testing or running Python code under one of these versions.
103+
104+
### Unsupported versions
105+
106+
The following Python versions are no longer supported by this plugin:
107+
108+
- 3.8 (last supported by python-rules v1.7.4)
109+
110+
Outputs that this plugin generates may not run correctly under these Python versions, or may run
111+
with significantly reduced performance.

0 commit comments

Comments
 (0)