Publishing Python Packages

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. Whats 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