pdehaye/open-humans

Powering openhumans.org

open-humans

This repository contains the code for the Open Humans Website.

The local development environment

dependencies

• python >=2.7.11
• pip
• virtualenv (pip install virtualenv)
• nodejs 6.x
• npm 3.x
• libffi (apt-get install libffi-dev in Debian/Ubuntu or brew install libffi in OSX)
• libpq (apt-get install libpq in Debian/Ubuntu or brew install libpq in OSX)
• postgres (apt-get install libpq-dev python-dev and apt-get install postgresql postgresql-contrib in Debian/Ubuntu)
• memcached (apt-get install memcached libmemcached-dev or brew install memcached)
• ChromeDriver for Selenium tests

virtualenv

For the following commands, you'll also want to set up virtualenvwrapper:

• pip install virtualenvwrapper
• Follow setup instructions here (e.g. modify your .bashrc as needed): http://virtualenvwrapper.readthedocs.io/en/latest/install.html

Create a virtualenv:

• mkvirtualenv open-humans
• pip install -r requirements.txt -r dev-requirements.txt

In the future, start the virtual environment with:

• workon open-humans

And update it after pulling updated code by repeating:

• pip install -r requirements.txt -r dev-requirements.txt

node.js dependencies (primarily for gulp)

• npm install -g gulp
• npm install

Update after pulling updated code by repeating:

• npm install

create your postgres database

Running this site requires a PostgreSQL database (even for local development).

• In Debian/Ubuntu
  • Become the postgres user: sudo su - postgres
  • Create a database (example name 'mydb'): createdb mydb
  • Create a user (example user 'jdoe'): createuser -P jdoe
  • Enter the password at prompt (example password: 'pa55wd')
  • run PostgreSQL command line: psql
    • Give this user privileges on this database, e.g.:
      GRANT ALL PRIVILEGES ON DATABASE mydb TO jdoe;
    • Also allow this user to create new databases (needed for running tests), e.g.:
      ALTER USER jdoe CREATEDB;
    • Quit: \q
  • Exit postgres user login: exit

Set up environment settings

Use env.example as a starting point. Copy this to .env and modify with your own settings.

Initialize or update the database

Do this at the beginning, and update when pulling updated code by running:

• ./manage.py migrate

Additional setup

For additional setup information see docs/SETUP.md.

Running the development server

• ./manage.py runserver

Running tests

You need to process static files before you can run tests.

1. ./manage.py collectstatic
2. ./manage.py test

Linting

• flake8
• pep256
• pylint
• eslint (npm install -g eslint)