Python packaging cleanup.

Updates Python package conventions. Does some setup so that setup
tools can use the current version of libswiftnav in the repository.

/cc @mfine @fnoble @benjamin0

Author: mookerji

python/.gitignore

@@ -1,11 +1,62 @@
 RELEASE-VERSION
-*.c
-*.pyc
-build/
-docs/_build/
-.DS_Store
-*.egg*
-*.so
 docs/libswiftnav.tag
 docs/swiftnav.rst
-distribute*.tar.gz
+swiftnav/*.c
+
+.DS_Store
+*.*~
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+env/
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.coverage
+.cache
+nosetests.xml
+coverage.xml
+
+# Translations
+*.mo
+*.pot
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Virtual Envs
+/*env

python/MANIFEST.in

@@ -0,0 +1,17 @@
+include *.cfg
+include *.md
+include *.rst
+include *.py
+include *.sh
+include *.txt
+include .coveragerc
+include .gitignore
+include LICENSE
+include LICENSE.GPLv3
+include tox.ini
+recursive-include libswiftnav/ *
+prune libswiftnav/build/
+recursive-include swiftnav/ *.py
+recursive-include swiftnav/ *.pyx
+recursive-include swiftnav/ *.pyd
+prune docs/_build

python/README.rst

@@ -0,0 +1,61 @@
+==================
+libswiftnav-python
+==================
+
+Python bindings to the `libswiftnav
+<http://github.com/swift-nav/libswiftnav>`_ GNSS library. Full
+documentation is available online at
+http://docs.swift-nav.com/libswiftnav-python.
+
+Installation
+============
+
+Obtaining the source
+--------------------
+
+The libswiftnav-python source and release tarballs are available from
+GitHub, https://github.com/swift-nav/libswiftnav-python. The latest
+development version of libswiftnav-python can be cloned from github
+using this command::
+
+   $ git clone git://github.com/swift-nav/libswiftnav-python.git
+
+Requirements
+--------------------
+
+libswiftnav-python requires libswiftnav C libary available at
+`libswiftnav <https://github.com/swift-nav/libswiftnav>`_.
+
+The Python dependencies are included in ``requirements.txt``, which
+you can install via::
+
+    $ (sudo) pip install -r requirements
+
+Building and Installing
+-----------------------
+
+To install libswiftnav-python (from the root of the source tree)::
+
+    $ python setup.py build
+    $ (sudo) python setup.py install
+
+Building Documentation
+----------------------
+
+Building the documentation requires the libswiftnav-python source code
+and some additional packages:
+
+    - `Sphinx <http://sphinx.pocoo.org>`_ (and its dependencies) 1.0 or later
+    - `numpydoc <http://pypi.python.org/pypi/numpydoc>`_ 0.4 or later
+    - `matplotlib <http://matplotlib.org/>`_ 1.1 or later
+    - `IPython <http://ipython.org/>`_ 0.13.1 or later
+    - `sphinx-doxylink <http://pypi.python.org/pypi/sphinxcontrib-doxylink>`_
+      1.3 or later
+
+To build the libswiftnav-python documentation, execute the following commands::
+
+    $ cd docs
+    $ make html
+
+The documentation will be built in the ``docs/_build/html`` directory, and can
+be read by pointing a web browser to ``docs/_build/html/index.html``.