Hypermodern Python Tooling

Installing Projects from Source
Project Layout
Managing Packages with Rye
Wheels and Sdists
Project Metadata
Naming Projects
Versioning Projects
Dynamic Fields
Entry-Point Scripts
Entry Points
Authors and Maintainers
The Description and README
Keywords and Classifiers
The Project URLs
The License
The Required Python Version
Dependencies and Optional Dependencies
Summary

4. Dependency Management
Adding Dependencies to the Example Application
Consuming an API with HTTPX
Console Output with Rich
Specifying Dependencies for a Project
Version Specifiers
Extras
Environment Markers
Development Dependencies
An Example: Testing with pytest
Optional Dependencies
Requirements Files
Locking Dependencies
Freezing Requirements with pip and uv
Compiling Requirements with pip-tools and uv
Summary

5. Managing Projects with Poetry
Installing Poetry
Creating a Project
The Project Metadata
The Package Contents
The Source Code
Managing Dependencies
Caret Constraints
Extras and Environment Markers
The Lock File
Updating Dependencies
Managing Environments
Dependency Groups
Package Repositories
Publishing Packages to Package Repositories
Fetching Packages from Package Sources
Extending Poetry with Plugins
Generating Requirements Files with the Export Plugin
Deploying Environments with the Bundle Plugin
The Dynamic Versioning Plugin
Summary

III. Testing and Static Analysis
6. Testing with pytest
Writing a Test
Managing Test Dependencies
Designing for Testability
Fixtures and Parameterization
Advanced Techniques for Fixtures
Extending pytest with Plugins
The pytest-httpserver Plugin
The pytest-xdist Plugin
The factory-boy and faker Libraries
Other Plugins
Summary

7. Measuring Coverage with Coverage.py
Using Coverage.py
Branch Coverage
Testing in Multiple Environments
Parallel Coverage
Measuring in Subprocesses
What Coverage to Aim For
Summary

8. Automation with Nox
First Steps with Nox
Working with Sessions
Working with Multiple Python Interpreters
Session Arguments
Automating Coverage
Session Notification
Automating Coverage in Subprocesses
Parameterizing Sessions
Session Dependencies
Using Nox with Poetry Projects
Locking Dependencies with nox-poetry
Summary

9. Linting with Ruff and pre-commit
Linting Basics
The Ruff Linter
Pyflakes and pycodestyle
Fantastic Linters and Where to Find Them
Disabling Rules and Warnings
Automation with Nox
The pre-commit Framework
First Steps with pre-commit
A Hook Up Close
Automatic Fixes
Running pre-commit from Nox
Running pre-commit from Git
The Ruff Formatter
Approaches to Code Formatting: autopep8
Approaches to Code Formatting: YAPF
An Uncompromising Code Formatter
The Black Code Style
Formatting Code with Ruff
Summary

10. Using Types for Safety and Inspection
Benefits and Costs of Type Annotations
A Brief Tour of Python’s Typing Language
Variable Annotations
The Subtype Relation
Union Types
Gradual Typing
Function Annotations
Annotating Classes
Type Aliases
Generics
Protocols
Compatibility with Older Python Versions
Static Type Checking with mypy
First Steps with mypy
Revisiting the Wikipedia Example
Strict Mode
Automating mypy with Nox
Distributing Types with Python Packages
Type Checking the Tests
Inspecting Type Annotations at Runtime
Writing a @dataclass Decorator
Runtime Type Checking
Serialization and Deserialization with cattrs
Runtime Type Checking with Typeguard
Summary

Index
About the Author