MySQL Installation Instructions
(NOTE: If you're using this test framework from a local development machine and don't plan on writing to a MySQL DB from your local test runs, you can skip this step.)
brew install MySQL
Windows: Download MySQL here
That installs the MySQL library so that you can use database commands in your code. To make that useful, you'll want to have a MySQL DB that you can connect to.
Install the MySQL-Python connector
pip install MySQL-python==1.2.5
Access your MySQL DB
If you want a visual tool to help make your MySQL life easier, try MySQL Workbench.
Prepare your MySQL DB
You can use the testcaserepository.sql file to create the necessary tables for storing test data.
If you were able to successfully install MySQL, you can now install the remaining MySQL requirements:
pip install -r requirements.txt
(NOTE: This install uses Selenium 2.53.6 rather than the usual Selenium 3+ from the standard requirements file due to compatibility issues with running browser tests on headless server machines.)
Configure your MySQL DB for SeleniumBase
You'll want to update your settings.py file with your MySQL DB credentials so that tests can write to the database when they run.
Allow tests to write to your MySQL database
--with-db_reporting argument on the command line when you want tests to write to your MySQL database.
nosetests my_first_test.py --with-db_reporting
Windows mysql-python troubleshooting:
If you're having trouble with Windows mysql-python installation using pip, you can also try the following steps to install from an alternative source:
Download the unofficial
.whlformat of MySQL-Python and Mysqlclient from here.
Open a console and then cd to where you've downloaded the MySQL-Python .whl file.
Run the command
pip install FILENAME.whl
If pip.exe is not recognized, you may find it in the "Scripts" directory from where python has been installed.