python-common: Add small Readme

Signed-off-by: Sebastian Wagner <sebastian.wagner@suse.com>

diff --git a/src/python-common/README.rst b/src/python-common/README.rst
new file mode 100644 (file)
index 0000000..7bd424f
--- /dev/null
+++ b/src/python-common/README.rst
@@ -0,0 +1,27 @@
+ceph-python-common
+==================
+
+This library is meant to be used to keep common data structures and
+functions usable throughout the Ceph project.
+
+Like for example:
+
+-  All different Cython bindings
+-  MGR modules
+-  ``ceph`` command line interface and other Ceph tools.
+-  Also external tools
+
+Requirements
+============
+
+-  ``python-six``
+
+Usage
+=====
+
+From within the Ceph git, just import it:
+
+.. code:: python
+
+    from ceph.deployment_utils import DriveGroupSpec
+    from ceph.exceptions import OSError

diff --git a/src/python-common/setup.py b/src/python-common/setup.py
index 9d357baa44874c2230ea15e77310cd9e171bcae9..cf1f661cfd46557169def22ffc2ddfcc14310d52 100644 (file)
--- a/src/python-common/setup.py
+++ b/src/python-common/setup.py
@@ -1,6 +1,10 @@
 from setuptools import setup, find_packages
 
 
+with open("README.rst", "r") as fh:
+    long_description = fh.read()
+
+
 setup(
     name='ceph',
     version='1.0.0',
@@ -8,6 +12,7 @@ setup(
     author='',
     author_email='dev@ceph.io',
     description='Ceph common library',
+    long_description=long_description,
     license='LGPLv2+',
     keywords='ceph',
     url="https://github.com/ceph/ceph",