Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
JavaScript Python
branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
dashboard
doc
.gitignore
.gitmodules
README.md
requirements.txt

README.md

CARE Dashboard

Introduction

This is the code repository for the widget dashboard for use by CARE. This document, along with the documents in doc/, aim to explain the development environment, technical decisions, design decisions, and code layout of this project.

Dependencies

To set-up the build environment, you will need:

  • python2 >= 2.4
  • pip
  • virtualenv (can be installed via pip: pip install virtualenv)

The remaining dependencies are described in the requirements.txt, and are automatically downloaded into a sandbox by virtualenv and pip.

Setting up the development environment

Clone the repository with git:

$ git clone git@github.com:thelastnode/care-dashboard.git
Cloning into 'care-dashboard'...
...

First, we will create the virtualenv (sandbox) in the env folder:

$ cd care-dashboard/
$ virtualenv -p python env/
Running virtualenv with interpreter /usr/bin/python2
New python executable in env/bin/python2
Also creating executable in env/bin/python
Installing setuptools............................done.
Installing pip...............done.

On some systems (Arch Linux, for example), the python binary (specified by the -p flag) for python 2.x is python2 instead of python.

Then we activate the virtualenv:

$ . env/bin/activate
(env) $

Next, we install the dependencies for the project:

(env) $ pip install -r requirements.txt

Now, with the virtualenv activated, we can setup the development SQLite3 database:

(env) $ cd dashboard/
(env) $ python manage.py syncdb
Creating tables ...
Creating table auth_permission
Creating table auth_group_permissions
Creating table auth_group
...

You will also be prompted to create a superuser, which will let you log in. You can also create a superuser manually with:

(env) $ python manage.py createsuperuser
Username (Leave blank to use 'ankit'): 
...

Finally, you can run the server with:

(env) $ python manage.py runserver

By default, the application can be accessed at http://localhost:8000/.

Adding a feature

For details on how to add a new feature, look at ./doc/feature.md

Something went wrong with that request. Please try again.