The full documentation is available at http://hhs.github.io/pillbox-engine/
This is the new Pillbox Engine, A local web-based application for downloading and management of DailyMed SPL Data.
If PillBox Engine is already installed, run this to update:
$ fab update
Mac OSX Requirements
If you use Mac OSX We assume you have the following installed:
If you don't, you can follow these steps to setup pip and virtualenv:
$ curl https://bootstrap.pypa.io/ez_setup.py -o - | sudo python $ sudo easy_install pip $ sudo easy_install virtualenv
To start a virtualenv simply run:
$ virtualenv --no-site-packages name_of_the_environment $ source name_of_the_environment/bin/activate
To deactivate run:
You should also consider using a database engine such Postgres or MySQL with this application. Pillbox Engine supports Sqlite3, Postgres and MySQL, however, we highly recommend using Postgres. This program is primarily tested with Postgres.
To setup Postgres on MacOSX, download postgres app.
If you downloaded and installed the Postgres from the link provided above, you should make sure postgres is known to your system path. To achieve this, follow these steps:
$ PATH="/Applications/Postgres.app/Contents/Versions/9.3/bin:$PATH" $ export PGHOST=localhost
For best result, add above command to your .bash_profile.
Ubuntu 14 Requirements
If using Ubuntu 14, to prepare the system run:
$ sudo apt-get update $ sudo apt-get install ruby $ sudo apt-get install python-pip libxml2-dev libxslt-dev python-dev lib32z1-dev git
To install Postgres, run:
$ sudo apt-get install postgresql
Make sure to create and activate a virtualenv, then open a terminal at the project root and install the requirements for local development:
$ git clone https://github.com/developmentseed/pillbox-engine.git $ cd pillbox-engine $ pip install -r requirements.txt
If you use Postgres or MySql, make sure the database engine is started.
You also need to setup a database for pillbox. For postgres, run these commands:
$ createdb -h localhost pillbox_db
Replace pillbox_db with your preferred name. If you use Postgres.app, your username will be your system username and the password is blank.
To setup the intital database, run this command:
$ fab initial_setup
To run the application run:
$ fab serve
The admin panel is accessible at: http://localhost:5000/
The default username and password is pillbox/PillBox.
The admin username and password is admin/admin
You can download the latest version of Pillbox Images from here.
You should unzip and copy the content of this image zip file to
Pillbox Existing Data
Download the latest master data from here. Then use the Graphic Interface to import the data to the system.
Development Version Setup
First make sure to create and activate a virtualenv, then open a terminal at the project root and install the requirements for local development:
$ pip install -r requirements/local.txt
You can now run the usual Django
$ python pillbox-engine/manage.py runserver
To setup database run:
$ python manage.py syncdb $ python manage.py migrate
Live reloading and Sass CSS compilation
If you'd like to take advantage of live reloading and Sass / Compass CSS compilation you can do so with the included Grunt task.
Make sure that nodejs is installed. Then in the project root run:
$ npm install grunt
Now you just need:
$ grunt serve
The base app will now run as it would with the usual
manage.py runserver but with live reloading and Sass compilation enabled.
To get live reloading to work you'll probably need to install an appropriate browser extension
It's time to write the code!!!