/wouso

World of USO - the Official Repository

Primary LanguagePythonOtherNOASSERTION

World of USO

World of USO is a quiz game framework. It has been used since 2007 as a support game for the Introduction to Operating Systems class (USO) for the 1st year of study at the Faculty of Automatic Control and Computers, University POLITEHNICA of Bucharest.

Hacking on WoUSO

Make sure you have [Vagrant](http://www.vagrantup.com/), then run vagrant up.

You can now find a deployed version of WoUSO at [http://localhost:8000](http://localhost:8000).

All the code is shared with the VM, which you can access with vagrant ssh. From there you can find the project files and interact with the django project as usual.

If you prefer to set up a local copy (not in the VM), read along.

Requirements

The following packages need to be installed:

* python2.7
* python-pip
* python-django
* python-dev
* python-virtualenv
* libldap2-dev
* libsasl2-dev

Installing WoUSO

  1. Fork/Clone the WoUSO repository from GitHub.

  2. Browse to the Git repository and activate the virtualenv:

    cd $PATH_TO_WOUSO_REPOSITORY
    virtualenv -p python2.7 sandbox
    echo '*' > sandbox/.gitignore
    . sandbox/bin/activate
    

$PATH_TO_WOUSO_REPOSITORY is the location of the clone of the WoUSO repository.

  1. Install pip requirements:

    pip install -r requirements-pip       # optional, the same command with: requirements-extra
    
  2. Install django-piston (by hand, because of a weird bug):

    curl 'https://pypi.python.org/packages/source/d/django-piston/django-piston-0.2.3.tar.gz' | tar xzf -
    cd django-piston-0.2.3; python setup.py install
    cd ..; rm -r django-piston-0.2.3
    
  1. Go to wouso subfolder, run everything from there:

    cd wouso
    
  2. Copy the default settings:

    cp settings.py.example settings.py
    
  3. Create database tables and load initial data:

    ./manage.py wousoctl --setup
    
  4. Run the server:

    ./manage.py runserver