Closes #220: switch to PyMySQL driver

README.md

 
 Or if you want to use MySQL as database engine
 
-    apt-get install mysql-server mysql-client libmysqlclient-dev
+    apt-get install mysql-server
 
 Or if you want to use SQLite as database engine
 
     cd tracim && python setup.py develop && cd -
     pip install -r install/requirements.txt
 
-**Note**: If you want to use MySQL database, please refer to Configuration/database schema note to install required package.
-
 ## Database Setup ##
 
 ### Minimalist introduction to PostgreSQL ###
 
 ### Minimalist introduction to MySQL ###
 
-## Create database ##
+#### Driver ####
+
+Tracim uses the PyMySQL driver between the SQLAlchemy ORM and the MySQL RDBMS.
+The only requirement is a pip installable package:
+
+    pip install PyMySQL
+
+#### Create database ####
 
 Connect to mysql with root user (password has been set at "Installation" -> "Dependencies" chapter, when installing package)
 
 
     sqlalchemy.url = postgresql://tracimuser:tracimpassword@127.0.0.1:5432/tracimdb?client_encoding=utf8
 
-There is an example value for MySQL below (please refer to Configuration/database schema note to install required package):
+There is an example value for MySQL below:
 
-    sqlalchemy.url = mysql+oursql://tracimuser:tracimpassword@127.0.0.1/tracimdb
+    sqlalchemy.url = mysql+pymysql://tracimuser:tracimpassword@127.0.0.1/tracimdb
 
 There is an example value for SQLite below :
 
 
 The last step before to run the application is to initialize the database schema. This is done through the following command:
 
-**Note**: If you want to use MySQL database, please install this pip package: ```pip install https://launchpad.net/oursql/py3k/py3k-0.9.4/+download/oursql-0.9.4.zip```
-
     cd tracim && gearbox setup-app && cd -
 
 ## Running the server ##

tracim/development.ini.base

 # invalidate the URI when specifying a SQLite db via path name
 # sqlalchemy.url=postgresql://username:password@hostname:port/databasename
 # sqlalchemy.url=mysql://username:password@hostname:port/databasename
-# sqlalchemy.url = postgresql://tracim_user:tracim_user_password@127.0.0.1:5432/tracim?client_encoding=utf8
+# sqlalchemy.url = postgresql://tracimuser:tracimpassword@127.0.0.1:5432/tracimdb?client_encoding=utf8
+# sqlalchemy.url = mysql+pymysql://tracimuser:tracimpassword@127.0.0.1/tracimdb
 sqlalchemy.url = <replace_database_uri_here>
 
 #echo shouldn't be used together with the logging module.

tracim/test.ini

 port = 8080
 
 [app:main]
-sqlalchemy.url =  postgresql://postgres:dummy@127.0.0.1:5432/tracim_test?client_encoding=utf8
+sqlalchemy.url = postgresql://tracimuser:tracimpassword@127.0.0.1:5432/tracimdb_test?client_encoding=utf8
+# sqlalchemy.url = mysql+pymysql://tracimuser:tracimpassword@127.0.0.1/tracimdb_test
 use = config:development.ini
 
 [app:main_without_authn]
 skip_authentication = True
 
 [app:ldap]
-sqlalchemy.url =  postgresql://postgres:dummy@127.0.0.1:5432/tracim_test?client_encoding=utf8
+sqlalchemy.url = postgresql://tracimuser:tracimpassword@127.0.0.1:5432/tracimdb_test?client_encoding=utf8
+# sqlalchemy.url = mysql+pymysql://tracimuser:tracimpassword@127.0.0.1/tracimdb_test
 auth_type = ldap
 ldap_url = ldap://localhost:3333
 ldap_base_dn = dc=directory,dc=fsf,dc=org
 use = config:development.ini
 
 [app:radicale]
-sqlalchemy.url =  postgresql://postgres:dummy@127.0.0.1:5432/tracim_test?client_encoding=utf8
+sqlalchemy.url = postgresql://tracimuser:tracimpassword@127.0.0.1:5432/tracimdb_test?client_encoding=utf8
+# sqlalchemy.url = mysql+pymysql://tracimuser:tracimpassword@127.0.0.1/tracimdb_test
 
 use = config:development.ini