Python 3 support (thanks @Lupino, closes #15)

* Changed riemann_client.riemann_pb2 to wrap py2 and py3 modules
* Changed setup.py to dynamically select a protobuf dependency

* Docs use version and author from module
* Tests updated to work on Python 3
* Tests run on py33 and py34
* Tests run coverage and flake8 under py26 and py34

Author: borntyping

README.rst

@@ -58,18 +58,26 @@ The ``QueuedClient`` class modifies the ``event()`` method to add events to a qu
 Installation
 ------------
 
-``riemann-client`` requires Python 2.6 or 2.7, and can be installed with ``pip install riemann-client``. Python 3 is not supported due to the dependency on the Google `protobuf <https://pypi.python.org/pypi/protobuf>`_ package. You can also use the provided makefile to build and distribute an RPM using `fpm <https://github.com/jordansissel/fpm>`_.
+``riemann-client`` requires Python 2.6 or above, and can be installed with ``pip install riemann-client``. It will use Google's `protobuf <https://pypi.python.org/pypi/protobuf>`_ library when running under Python 2, and `GreatFruitOmsk <https://github.com/GreatFruitOmsk>`_'s `protobuf-py3 <https://pypi.python.org/pypi/protobuf-py3>`_ when running under Python 3. Python 3 support is experimental and is likley to use Google's `protobuf` once it supports Python 3 fully.
 
 Requirements
 ^^^^^^^^^^^^
 
 * `click <http://click.pocoo.org/>`_
-* `protobuf <https://pypi.python.org/pypi/protobuf>`_
+* `protobuf <https://pypi.python.org/pypi/protobuf>`_ (when using Python 2)
+* `protobuf <https://pypi.python.org/pypi/protobuf-py3>`_ (when using Python 3)
 
 Changelog
 ---------
 
-Version 5.x.x
+Version 5.1.0
+^^^^^^^^^^^^^
+
+* Added Python 3 support
+* Changed ``riemann_client.riemann_pb2`` to wrap ``_py2`` and ``_py3`` modules
+* Changed ``setup.py`` to dynamically select a ``protobuf`` dependency
+
+Version 5.0.x
 ^^^^^^^^^^^^^
 
 * Added API documentation (`riemann-client.readthedocs.org <http://riemann-client.readthedocs.org/en/latest/>`_)

docs/conf.py

@@ -2,6 +2,8 @@
 
 import os
 
+import riemann_client
+
 if not os.environ.get('READTHEDOCS', None):
     import sphinx_rtd_theme
     html_theme = 'sphinx_rtd_theme'
@@ -12,9 +14,8 @@
 
 # General information about the project.
 project = u'riemann-client'
-copyright = u'2014, Sam Clements'
-version = '5.0'
-release = '5.0.0-dev'
+copyright = u'2014, ' + riemann_client.__author__
+version = release = riemann_client.__version__
 
 # Add any Sphinx extension module names here, as strings. They can be
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom ones.

riemann_client/__init__.py

@@ -1,4 +1,4 @@
 """A Python Riemann client and command line tool"""
 
-__version__ = '5.0.1'
+__version__ = '5.1.0'
 __author__ = 'Sam Clements <sam.clements@datasift.com>'