Closes #220: switch to PyMySQL driver

README.md

@@ -138,7 +138,7 @@ If you want use PostgreSQL as database engine:
 
 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
 
@@ -178,8 +178,6 @@ To install tracim and it's dependencies:
     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 ###
@@ -257,7 +255,14 @@ In this case, delete the user and database you previously created (using pgtool)
 
 ### 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)
 
@@ -304,9 +309,9 @@ Configure database in the development.ini file. This is defined as sqlalchemy.ur
 
     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 :
 
@@ -421,8 +426,6 @@ or
 
 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

@@ -94,7 +94,8 @@ beaker.session.validate_key = 3283411b-1904-4554-b0e1-883863b53080
 # 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

@@ -22,7 +22,8 @@ host = 127.0.0.1
 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]
@@ -30,7 +31,8 @@ use = main
 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
@@ -49,7 +51,8 @@ resetpassword.smtp_passwd =  fake
 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