Gentoo Python Guide¶
- Author
Michał Górny
- License
Contents:
- Preface
- Python interpreters
- Choosing between Python eclasses
- Common basics
- python-any-r1 — build-time dependency
- python-single-r1 — single-impl packages
- python-r1 — multi-impl packages
- distutils-r1 — standard Python build systems
- The PEP 517 and legacy modes
- Basic use (PEP 517 mode)
- Source archives
- Dependencies
- python-single-r1 variant
- PEP 517 build systems
- Deprecated PEP 517 backends
- setuptools_scm and snapshots
- Packages using Cython
- Parallel build race conditions
- Sub-phase functions
- Passing arguments to setup.py
- Calling custom setup.py commands
- Preventing test directory from being installed
- Enabling tests
- Building documentation via Sphinx
- Packages with optional Python build system usage
- Packages with Rust extensions (using Cargo)
- distutils-r1 legacy concepts
- Common helper functions
- Advanced dependencies
- Resolving test suite problems
- pytest recipes
- Skipping tests based on markers
- Skipping tests based on paths/names
- Avoiding the dependency on pytest-runner
- Using pytest-xdist to run tests in parallel
- Avoiding dependencies on other pytest plugins
- Explicitly disabling automatic pytest plugins
- Expert: disabling plugin autoloading entirely
- TypeError: _make_test_flaky() got an unexpected keyword argument ‘reruns’
- ImportPathMismatchError
- fixture ‘…’ not found
- Warnings
- Advanced concepts
- Expert python-r1 usage
- Integration with build systems written in Python
- Porting tips
- Migration guides
- Python package maintenance
- Maintenance of Python implementations