Python Packaging

Overview

Create python packages that can be distributed with pip from GitHub (and not PyPi).

Configuration

A setup config file, setup.py, in the repo root directory should contain a single call to setuptools.setup(), like so:

from setuptools import setup

setup(name='my_package',
      version='0.1',
      description='My package description',
      url='http://github.com/dbarchowsky/my-package',
      author='Damien Barchowsky',
      author_email='dbarchowsky@gmail.com',
      license='MIT',
      packages=['my_package'],
      zip_safe=False)

After which the package can be installed locally with

$ pip install .

And once installed the package can be used like this:

>>> import my_package
>>> my_package.some_routine()