xmlsec · bgaifullin · Feb 14, 2017 · Feb 14, 2017
diff --git a/MANIFEST.in b/MANIFEST.in
@@ -1,5 +1,4 @@
 include src/*
-include README.md
 include requirements*.txt
 include LICENSE

diff --git a/README.md b/README.md
diff --git a/README.rst b/README.rst
@@ -0,0 +1,166 @@
+python-xmlsec
+=============
+
+.. image:: https://travis-ci.org/mehcode/python-xmlsec.png?branch=master
+    :target: https://travis-ci.org/mehcode/python-xmlsec
+.. image:: https://img.shields.io/pypi/v/xmlsec.svg
+    :target: https://pypi.python.org/pypi/xmlsec
+.. image:: https://img.shields.io/pypi/dm/xmlsec.svg
+    :target: https://pypi.python.org/pypi/xmlsec
+
+
+Python bindings for the XML Security Library.
+
+******
+Usage
+******
+
+Check the `examples <https://github.com/mehcode/python-xmlsec/tree/master/tests/examples>`_ to see various examples of signing and verifying using the library.
+
+************
+Requirements
+************
+- libxml2 >= 2.9.1
+- libxmlsec1 >= 1.2.14
+
+*******
+Install
+*******
+
+Pre-Install
+-----------
+
+Linux (Debian)
+^^^^^^^^^^^^^^
+
+.. code-block:: bash
+
+   apt-get install libxml2-dev libxmlsec1-dev libxmlsec1-opensssl
+
+
+Note: There is no required version of libxml2 for ubuntu precise,
+so need to dowload and install it manually.
+
+.. code-block:: bash
+
+    wget http://xmlsoft.org/sources/libxml2-2.9.1.tar.gz
+    tar -xvf libxml2-2.9.1.tar.gz
+    cd libxml2-2.9.1
+    ./configure && make && make install
+
+
+Linux (CentOS)
+^^^^^^^^^^^^^^
+
+.. code-block:: bash
+
+    yum install libxml2-devel xmlsec1-devel xmlsec1-openssl-devel libtool-ltdl-devel
+
+
+Mac
+^^^
+
+.. code-block:: bash
+
+    brew install libxml2 libxmlsec1
+
+
+Automated
+---------
+1. **xmlsec** can be installed through `easy_install` or `pip`.
+
+.. code-block:: bash
+
+    pip install xmlsec
+
+
+Mac
+^^^
+
+If you get any fatal errors about missing .h files, update your C_INCLUDE_PATH environment variable to
+include the appropriate files from the libxml2 and libxmlsec1 libraries.
+
+Manual
+------
+
+1. Clone the **xmlsec** repository to your local computer.
+
+.. code-block:: bash
+
+    git clone git://github.com/mehcode/python-xmlsec.git
+
+2. Change into the **xmlsec** root directory.
+
+.. code-block:: bash
+
+    cd /path/to/xmlsec
+
+
+3. Install the project and all its dependencies using `pip`.
+
+.. code-block:: bash
+
+    pip install .
+
+
+************
+Contributing
+************
+
+Setting up your environment
+---------------------------
+
+1. Follow steps 1 and 2 of the [manual installation instructions][].
+
+[manual installation instructions]: #manual
+
+2. Initialize a virtual environment to develop in.
+   This is done so as to ensure every contributor is working with
+   close-to-identicial versions of packages.
+
+.. code-block:: bash
+
+    mkvirtualenv xmlsec
+
+
+   The `mkvirtualenv` command is available from `virtualenvwrapper` which
+   can be installed by following: http://virtualenvwrapper.readthedocs.org/en/latest/install.html#basic-installation
+
+3. Install **xmlsec** in development mode with testing enabled.
+   This will download all dependencies required for running the unit tests.
+
+.. code-block:: bash
+
+    pip install -r requirements-test.txt
+    pip install -e "."
+
+
+Running the test suite
+----------------------
+
+1. [Set up your environment](#setting-up-your-environment).
+
+2. Run the unit tests.
+
+.. code-block:: bash
+
+    py.test tests
+
+
+******************
+Versions of python
+******************
+
+The following versions of python is supported:
+
+ - python2.7
+ - python3.4
+ - python3.5 (required libxmlsec1 >=  1.2.18 and libxml2 >= 2.9.1)
+ - python3.6 (required libxmlsec1 >=  1.2.18 and libxml2 >= 2.9.1)
+
+*******
+License
+*******
+
+Unless otherwise noted, all files contained within this project are liensed under the MIT opensource license.
+See the included file LICENSE or visit `opensource.org <http://opensource.org/licenses/MIT>`_ for more information.
diff --git a/setup.cfg b/setup.cfg
@@ -1,5 +1,5 @@
 [metadata]
-description-file = README.md
+description-file = README.rst

 [bdist_rpm]
 release = 1