Название: Publishing Python Packages: Test, share, and automate your projects (Final Release)
Автор: Dane Hillard
Издательство: Manning Publications
Год: 2023
Страниц: 250
Язык: английский
Формат: pdf (true)
Размер: 14.8 MB

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.

Everyone starts their Python journey in a different place. Regardless of how you start, you’ll eventually start working your way upstream to experience new sights and sounds. As the river narrows and the trees thicken, you may even start to think about how to deliver a Python application to others. There you find hulls of shattered projects around the entrance to a hidden cavern at the river's headwaters. Suddenly you hear a hollow voice ask, “What’s your favorite packaging tool?” right before you’re flung into a chasm.

Python has something for everyone—and you’ll usually find it on the Python Package Index. PyPI brings about new challenges as you start to worry about installation, dependencies, environments, and other important matters related to using your software in the real world. This is where new open source packages are created and maintained. This is the starting point for this much-needed book. A quiet secret of most Python books is that nobody really wants to talk much about packaging (and I speak from experience).

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