Skip to content

Modernize packaging and improve Sphinx 9 compatibility#214

Closed
dprada wants to merge 2 commits intoexecutablebooks:mainfrom
uibcdf:upstream/sphinx9-compat
Closed

Modernize packaging and improve Sphinx 9 compatibility#214
dprada wants to merge 2 commits intoexecutablebooks:mainfrom
uibcdf:upstream/sphinx9-compat

Conversation

@dprada
Copy link
Contributor

@dprada dprada commented Mar 3, 2026

Summary

This PR applies a minimal, backward-compatible update to improve installation and Sphinx 9 compatibility:

  • Add pyproject.toml with setuptools.build_meta (PEP 517/660 editable installs)
  • Avoid deprecated BuildEnvironment.app access in directives (Sphinx 9 deprecation path to Sphinx 11)
  • Make the rinohtype PDF test skip gracefully when Tex Gyre Heros is not available in the environment

Why

  • Prevent legacy editable install issues (setup.py develop) with modern setuptools/pip
  • Remove Sphinx 9 deprecation warnings caused by self.env.app
  • Keep the test suite robust across environments that do not include optional PDF fonts

Validation

  • sphinx-build -nW --keep-going -b html docs/ ... with Sphinx 9.1
  • pytest -q locally (with test dependencies installed)

Additional note (fork-only validation)

As an additional validation step in my fork, I published a conda package to the uibcdf channel with version v3.4.8 to verify the end-to-end packaging/install flow.
This conda release workflow/devtools setup is fork-specific and not part of this upstream PR.

@bsipocz
Copy link
Member

bsipocz commented Mar 3, 2026

Could you enable edits my maintainers here, please?

I got to this package in my circle of releasing sphinx9 compatible versions and don't want to repeat your work, but some adjustments are needed here and for the sake of efficiency I would like to just directly work with it.

@bsipocz
Copy link
Member

bsipocz commented Mar 3, 2026

I'm closing this as a sphinx related changes has been cherry-picked into another PR and I'm cutting a release now.

Next time, please enable maintainer access to your branch, so failures can be fixed and things can be merged from the PR.

@bsipocz bsipocz closed this Mar 3, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants