Adding a dependency

This is a page about improving or modifying OpenHatch.

We call that "Hacking OpenHatch," and there is a whole category of pages about that.

Using buildout: adding a dependency

1. Find the Python package name of the dependency. This will appear in the package's own setup.py file (as a parameter called "name" passed to the setup function).
2. Edit milestone-a/setup.py.
3. Add the dependency's Python package name to "install_requires". You may optionally include a version number.
4. If you haven't already, create a tarball of the Python package as follows:
   1. cd to the package's top-level directory, where setup.py is
   2. Run `python setup.py sdist`
   3. This creates a tarball of your Python package in dist/.
5. Host a tarball of the Python package at some public URL. (This is in order to cache a copy of the package somewhere everyone can reliably reach it.)
6. Add the tarball URL to the list called "dependency_links" in milestone-a/setup.py, appending the string "#egg=the package name" to the URL.
7. Add the package name to milestone-a/buildout.cfg under "eggs".
8. Run bin/buildout