.. image:: https://requires.io/github/caktus/ultimatetictactoe/requirements.svg?branch=master :target: https://requires.io/github/caktus/ultimatetictactoe/requirements/?branch=master :alt: Requirements Status

Tictactoe

Below you will find basic setup and deployment instructions for the tictactoe project. To begin you should have the following applications installed on your local development system:

• Python >= 2.7
• pip <http://www.pip-installer.org/>_ >= 1.5
• virtualenv <http://www.virtualenv.org/>_ >= 1.10
• virtualenvwrapper <http://pypi.python.org/pypi/virtualenvwrapper>_ >= 3.0
• Postgres >= 9.1
• postgresql-server-dev >= 9.1
• git >= 1.7

Getting Started

To setup your local environment you should create a virtualenv and install the necessary requirements::

mkvirtualenv tictactoe
$VIRTUAL_ENV/bin/pip install -r $PWD/requirements/dev.txt

Then create a local settings file and set your DJANGO_SETTINGS_MODULE to use it::

cp tictactoe/settings/local.example.py tictactoe/settings/local.py
echo "export DJANGO_SETTINGS_MODULE=tictactoe.settings.local" >> $VIRTUAL_ENV/bin/postactivate
echo "unset DJANGO_SETTINGS_MODULE" >> $VIRTUAL_ENV/bin/postdeactivate

Exit the virtualenv and reactivate it to activate the settings just changed::

deactivate
workon tictactoe

Create the Postgres database and run the initial syncdb/migrate::

createdb -E UTF-8 tictactoe
python manage.py syncdb
python manage.py migrate

You should now be able to run the development server::

python manage.py runserver

Installation on the Caktus Booth Device

To set up on the Raspberry Pi in preparation for use at a conference, first install Ansible in your virtualenv ::

pip install ansible

Then, run the setup playbook using the provided inventory file ::

ansible-playbook -i deployment/inventory deployment/setup.yml

Note that this assumes that the Raspberry Pi is at the assigned IP address 172.20.1.141, which will be the case at the Caktus office. If this is not the case, the inventory file will have to be adjusted to match or a new one created and used.