Publishing Python Packages: Test, Share, and Automate Your Projects

Create masterful, maintainable Python packages! This book includes pro tips for design, automation, testing, deployment, and even release as an open source project!

In Publishing Python Packages you will learn how to:

Build extensions and console script commands
Use tox to automate packaging, installing, and testing
Build a continuous integration pipeline using GitHub Actions
Improve code quality and reduce manual review using black, mypy, and flake8
Create published documentation for your packages
Keep packages up to date with pyupgrade and Dependabot
Foster an open source community using GitHub features

Publishing Python Packages teaches you how to easily share your Python code with your team and the outside world. Learn a repeatable and highly automated process for package maintenance that’s based on the best practices, tools, and standards of Python packaging. This book walks you through creating a complete package, including a C extension, and guides you all the way to publishing on the Python Package Index. Whether you’re entirely new to Python packaging or looking for optimal ways to maintain and scale your packages, this fast-paced and engaging guide is for you.

Foreword by David Beazley.

About the technology
Successful Python packages install easily, run flawlessly, and stay reliably up to date. Publishing perfect Python packages requires a rigorous process that supports systematic testing and review, along with excellent documentation. Fortunately, the Python ecosystem includes tools and techniques to automate package creation and publishing.

About the book
Publishing Python Packages presents a practical process for sharing Python code in an automated and scalable way. Get hands-on experience with the latest packaging tools, and learn the ins and outs of package testing and continuous integration. You’ll even get pro tips for setting up a maintainable open source project, including licensing, documentation, and nurturing a community of contributors.

What's inside

Build extensions and console script commands
Improve code quality with automated review and testing
Create excellent documentation
Keep packages up to date with pyupgrade and Dependabot

About the reader
For intermediate Python programmers.

About the author
Dane Hillard has spent the majority of his development career using Python to build web applications.

Table of Contents
PART 1 FOUNDATIONS
1 The what and why of Python packages
2 Preparing for package development
3 The anatomy of a minimal Python package
PART 2 CREATING A VIABLE PACKAGE
4 Handling package dependencies, entry points, and extensions
5 Building and maintaining a test suite
6 Automating code quality tooling
PART 3 GOING PUBLIC
7 Automating work through continuous integration
8 Authoring and maintaining documentation
9 Making a package evergreen
10 Scaling and solidifying your practices
11 Building a community

Dane Hillard has spent the majority of his development career using Python to build web applications. During his career, he has worked across the intelligence research, personalized medicine, and academic publishing fields and now works as a technical architect and technical advisor.