index.rst

Python Packaging User Guide

.. toctree::
   :maxdepth: 2
   :hidden:

   overview
   tutorials/index
   guides/index
   discussions/index
   specifications/index
   key_projects
   glossary
   support
   contribute
   news

Welcome to the Python Packaging User Guide, a collection of tutorials and references to help you distribute and install Python packages with modern tools.

This guide is maintained on GitHub by the Python Packaging Authority. We happily accept any :doc:`contributions and feedback <contribute>`. 😊

Get started

Essential tools and concepts for working within the Python development ecosystem are covered in our :doc:`tutorials/index` section:

• to learn how to install packages, see the :doc:`tutorial on installing packages <tutorials/installing-packages>`.
• to learn how to manage dependencies in a version controlled project, see the :doc:`tutorial on managing application dependencies <tutorials/managing-dependencies>`.
• to learn how to package and distribute your projects, see the :doc:`tutorial on packaging and distributing <tutorials/packaging-projects>`
• to get an overview of packaging options for Python libraries and applications, see the :doc:`Overview of Python Packaging <overview>`.

Learn more

Beyond our :doc:`tutorials/index`, this guide has several other resources:

• the :doc:`guides/index` section for walk throughs, such as :doc:`guides/installing-using-linux-tools` or :doc:`guides/packaging-binary-extensions`
• the :doc:`discussions/index` section for in-depth references on topics such as :doc:`discussions/deploying-python-applications` or :doc:`discussions/pip-vs-easy-install`
• the :doc:`specifications/index` section for packaging interoperability specifications

Additionally, there is a list of :doc:`other projects <key_projects>` maintained by members of the Python Packaging Authority.