Python Packaging without the Pain

About This Tutorial

This tutorial takes the FRIGHT out of Python packaging.

We’ll cover all the steps, including creating a Python package, putting the documentation on Read The Docs, implementing a continuous integration test suite, and deploying your package to the Python Package Index.

We’ll rely on the wonderful Cookiecutter tool to make our life a lot easier during the packaging process, taking your module, function or snippet of Python code and turning it into a Python package, getting around the finicky installation hassles.

Once your project is on PyPI, you can add more tests, documentation, and even get some help on your code by collaborating with other open source developers on enhancements and bug fixes.

If you’re a Pythonista or Djangonaut with a module, function, or even a small code snippet that would be useful as a Python package, this tutorial is for you!

Some things we’ll cover:

• Installing Cookiecutter and using it to generate Python package boilerplate.
• Adding Python code into the package and adding at least two useful tests.
• Creating an account on PyPI and uploading the Python package.
• Using Tox to test the project against multiple versions of Python.
• Implementing continuous integration: running tests via Travis CI and uploading documentation into Read the Docs.

You’ll walk out of this tutorial knowing how to package a Python project and with bonus material for making installable Django packages!