Skip to content

Python 3.14 support#229

Open
rozyczko wants to merge 2 commits intodevelopfrom
python_314_rebased
Open

Python 3.14 support#229
rozyczko wants to merge 2 commits intodevelopfrom
python_314_rebased

Conversation

@rozyczko
Copy link
Copy Markdown
Member

rebased against current develop
h5py with 3.14 support is already on pypi, so this should be straightforward.

@rozyczko rozyczko added [scope] maintenance Code/tooling cleanup, no feature or bugfix (major.minor.PATCH) [priority] high Should be prioritized soon labels Mar 30, 2026
@rozyczko rozyczko changed the title rebased against current develop Python 3.14 support Mar 30, 2026
@rozyczko
Copy link
Copy Markdown
Member Author

rozyczko commented Mar 30, 2026

Still fails!
This time, some obscure dependency of one of the modules fails to build properly on 3.14
untokenize fails.
It's known and reported myint/untokenize#4

This dependency is pulled by docformatter, used in dev environment, so quite pervasive.
docformatter is also aware of this issue PyCQA/docformatter#327 which they apparently fixed but not yet released.

@rozyczko
Copy link
Copy Markdown
Member Author

Can we replace docformatter with ruff format?
just add docstring-code-format = true

@rozyczko
Copy link
Copy Markdown
Member Author

From @AndrewSazonov:

Ruff format is not really a replacement for docformatter - the latter handles some more important docstring-specific formatting checks.
I’m aware of the current issue with docformatter and its dependency not supporting Python 3.14. Also, docformatter doesn’t handle Args and Returns sections in Google-style docstrings.
Because of that, I started looking into alternatives. It turns out that Google style is not that well supported in general, while NumPy style has much better support.
I tested this in the templates (in a separate branch) and found NumPy style to be better covered. So I switched to another package, format-docstring, instead of docformatter. It has good support for NumPy-style docstrings.
This means that moving to Python 3.14 should be possible by parallel switching the docstring formatter and reformatting docstrings to a better-supported style.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

[priority] high Should be prioritized soon [scope] maintenance Code/tooling cleanup, no feature or bugfix (major.minor.PATCH)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant