Permalink
Switch branches/tags
Nothing to show
Find file Copy path
3d0561f Jan 21, 2016
@troubbble @storborg
36 lines (25 sloc) 1.13 KB

How To Package Your Python Code

This tutorial aims to put forth an opinionated and specific pattern to make trouble-free packages for community use. It doesn't describe the only way of doing things, merely one specific approach that works well.

In particular, packages should make it easy:

  • To install with pip or easy_install.
  • To specify as a dependency for another package.
  • For other users to download and run tests.
  • For other users to work on and have immediate familiary with the basic directory structure.
  • To add and distribute documentation.

We'll walk through the basic steps of building up a contrived package funniest to support these things.

.. toctree::
   :maxdepth: 1

   minimal
   dependencies
   metadata
   testing
   command-line-scripts
   non-code-files
   everything
   about

Note

At this time, this documentation focuses on Python 2.x only, and may not be as applicable to packages targeted to Python 3.x.

.. seealso::

    `Setuptools Documentation <http://peak.telecommunity.com/DevCenter/setuptools>`_
        Core setuptools documentation and API reference.