Basic commands for web development

After you clone this repository, run make. It will download, locally install and setup virtualenv and pip, and then locally install all required packages from requirements.txt.

When working with the code, always use the binaries in ./bin/, such as bin/pip, bin/python, ... never the global python, pip, ... Use make and ./manage.py for most things.

Use git.

Make commands

• make install (or make) - locally install and setup virtualpy, install required packages. Ran again installs missing packages. Run after changing requirements.txt.

• make clean - remove local python packages.

• make veryclean - remove local packages and virtualpy enviroment and binaries.

• make run - runs "./manage.py runserver_plus"

• make push_test - pushes the last commited version to test location. Only git-commited changes are pushed! Rest is re-generated from scratch. At test server, the media data and database are kept the same. Everything else not in .gitignore is deleted/overwritten on the test server.

./manage.py commands

• ./manage.py migrate - update the database schema, initialise the database. You need to run this in the beginning.

• ./manage.py runserver_plus - run a debugging server for the web. Slightly enhanced compared to ./manage.py runserver. Open 127.0.0.1:8000.

• ./manage.py test - run the tests.

Configurations

• mamweb/settings_common.py contains most configuration options.
• mamweb/settings.py is used only for local development.
• mamweb/settings_test.py is used for testing on atrey.
• mamweb/settings_prod.py is used in production deployment.

These are automatically switched by make.