Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

strictly depend on sphinx's minor version #498

Merged
merged 1 commit into from
Apr 9, 2020

Conversation

vermeeren
Copy link
Collaborator

Breathe closely integrates with many of Sphinx's internals, especially
integration with Sphinx's C and C++ domains is rather fragile. Changes
often need to be made in both Breathe and Sphinx at the same time.

By pinning the Sphinx minor version in the dependency list it is ensured
only versions that have been (mostly) verified to be compatible with
each other are used, which prevents unexpected breakage. This is often
the case if only Breathe's or only Sphinx's version is pinned in a
project's dependency list.

Breathe closely integrates with many of Sphinx's internals, especially
integration with Sphinx's C and C++ domains is rather fragile. Changes
often need to be made in both Breathe and Sphinx at the same time.

By pinning the Sphinx minor version in the dependency list it is ensured
only versions that have been (mostly) verified to be compatible with
each other are used, which prevents unexpected breakage. This is often
the case if only Breathe's or only Sphinx's version is pinned in a
project's dependency list.
@vermeeren
Copy link
Collaborator Author

The version string specification can be found in PEP 508, see https://www.python.org/dev/peps/pep-0508/.

CICD is intentionally not changed to only use 3.0.x, as also running on 3.x serves as an early warning system during development of Breathe.

@jakobandersen can you check?

Ref: #497, specifically #497 (comment).

@vermeeren vermeeren self-assigned this Apr 8, 2020
@vermeeren vermeeren added analysis Quality assurance, CI enhancement Improvements, additions (also cosmetics) labels Apr 8, 2020
@jakobandersen
Copy link
Collaborator

Looks good to me (though my knowledge of Python packaging is somewhat limited).

@vermeeren vermeeren merged commit 240d62f into master Apr 9, 2020
@vermeeren vermeeren deleted the depend-on-sphinx-minor-version branch April 9, 2020 19:55
vermeeren added a commit that referenced this pull request Apr 9, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
analysis Quality assurance, CI enhancement Improvements, additions (also cosmetics)
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants