added more documentation

AUTHORS.rst

@@ -7,6 +7,13 @@ Development Lead
 
 * Holger Frey <frey@imtek.de>
 
+
+Original PHP Version
+--------------------
+
+* Sebastian Sebald (@sebald on github)
+
+
 Contributors
 ------------
 

HISTORY.rst

@@ -2,7 +2,13 @@
 History
 =======
 
+0.1.0 (2017-10-05, branch php2python)
+-------------------------------------
+
+* first working version of the PHP to Python rewrite
+
+
 0.0.1 (2017-09-26)
 ------------------
 
-* First release on PyPI.
+* setup of the project

README.rst

@@ -1,10 +1,43 @@
-===========================
-Ordr2 - CPI Ordering System
-===========================
+==============================================
+Ordr2 - CPI Ordering System, php2python branch
+==============================================
 
+This is a rewrite in Python of the original Ordr system by Sebastian Sebald
+that can still be found here: https://github.com/sebald/Ordr
 
-Features
+
+Installation
+------------
+
+Installation consists of three steps:
+
+1. clone the project and checkout the php2python branch
+    > git clone https://git.cpi.imtek.uni-freiburg.de/holgi/ordr2
+    > cd ordr2
+    > git checkout php2pyton
+
+2. create a python virtual environment and activate it
+    > python3 -m venv ordr-venv
+    > source ordr-venv/bin/activate
+
+3. install the cloned package and deactivate the environment
+    (ordr-venv) > pip install .
+    > deactivate
+
+
+Updating
 --------
 
-* TODO
+updating consists of three steps:
+
+1. Update the source code
+    > cd ordr2
+    > git pull origin php2python
+
+2. activate the python virtual environment
+    > source ordr-venv/bin/activate
+
+3. install the new version and deactivate the environment
+    (ordr-venv) > pip install .
+    > deactivate
 

setup.py

@@ -17,15 +17,15 @@ requirements = [
     'pyramid_debugtoolbar',
     'pyramid_tm',
     'pyramid_mailer',
-    'SQLAlchemy',
-    'transaction',
-    'zope.sqlalchemy',
-    'waitress',
     'bcrypt',
     'deform',
     'PyYAML',
+    'SQLAlchemy',
     'tqdm',
+    'transaction',
+    'waitress',
     'XlsxWriter',
+    'zope.sqlalchemy',
 ]
 
 setup_requirements = [

tests/test_ordr2.py

@@ -1,25 +0,0 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
-
-''' Tests for `ordr2` package. '''
-
-import pytest
-
-
-import ordr2
-
-
-@pytest.fixture
-def response():
-    ''' Sample pytest fixture.
-
-    See more at: http://doc.pytest.org/en/latest/fixture.html
-    '''
-    # import requests
-    # return requests.get('https://github.com/audreyr/cookiecutter-pypackage')
-
-
-def test_content(response):
-    ''' Sample pytest test function with the pytest fixture as an argument. '''
-    # from bs4 import BeautifulSoup
-    # assert 'GitHub' in BeautifulSoup(response.content).title.string