python-unshare
##############

This is a pure-Python module with no external dependencies for accessing libc
functions and macros needed for dealing with Linux namespaces.

Development
-----------

Development has the following dependencies:
- Tox (install from PyPI by running (:code:`pip install tox`).
- libc headers, make and GCC (On Debian/Ubuntu install by running :code:`apt
install linux-libc-dev build-essential`).

Testing is done by running :code:`tox`. Auto-generated code (for now just
:code:`unshare/constants.py`) is generated by running :code:`make all`. For Mac
developers there's a Vagrant box defined (it optionally uses
`vagrant-gatling-rsync <https://github.com/smerrill/vagrant-gatling-rsync>`_).

TODO
----

- License.
- Changelog.
- Documentation.
- Replace the GCC preprocessor for generating :code:`unshare/constants.py`
  with a Python one (`CPIP <http://cpip.sourceforge.net/>`_ or `pycparser
  <https://github.com/eliben/pycparser>`_).