projects: A Python repository from Office of Digital Excellence, State of Rhode Island - Office of Digital Excellence, State of Rhode Island

ODE Projects Dashboard

We are now creating a way to surface and discover the projects that ODE and ETSS work on. You will be able to easily find how each engagement and repo works, who works on it, and how to contact the team that created it.

This is an ongoing work in progress!!! 18F's Wiki contains research notes and drafts that you might find helpful if you're also thinking about discovery.

Dependencies

Python 3.5.0 - see requirements.txt for all Python dependencies.
Postgresql
Basscss (kinda)
Skull (Basscss Theme)
Ionicons

Running Locally

$ virtualenv -p python3.5 venv
$ source venv/bin/activate
$ pip install -r requirements.txt

$ createdb etssprojects

$ python manage.py migrate
$ python manage.py runserver

Loading Data

Fixtures containing possible State clients are included in: projects/fixtures/ri-agencies.json.

Project categories are included in: projects/fixtures/categories.json.

Funding Source Categories are included in: projects/fixtures/funding_sources.json.

To load them:

$ python manage.py loaddata projects/fixtures/*.json

We recommend the excellent jsonlint from Zach Carter to validate your .json files before loading them into postgresql.

Sample project data may also be imported from a CSV file. Importation template forthcoming. See Issue #10

$ python manage.py import_projects filename.csv

Using Docker (optional)

A Docker setup potentially makes development and deployment easier.

To use it, install Docker and Docker Compose. (If you're on OS X or Windows, you'll also have to explicitly start the Docker Quickstart Terminal, at least until Docker goes native.)

Then run:

docker-compose run app python manage.py migrate

Once the above command is successful, run:

docker-compose up

This will start up all required servers in containers and output their log information to stdout. If you're on Linux, you should be able to visit http://localhost:8000/ directly to access the site. If you're on OS X or Windows, you'll likely have to visit port 8000 on the IP address given to you by docker-machine ip default. (Note that this hassle will go away once Docker goes native for OS X/Windows.)

Accessing the app container

You'll likely want to run manage.py to do other things at some point. To do this, it's probably easiest to run:

docker-compose run app bash

This will run an interactive bash session inside the main app container. In this container, the /projects directory is mapped to the root of the repository on your host; you can run manage.py from there.

Note that if you don't have Django installed on your host system, you can just run python manage.py directly from outside the container--the manage.py script has been modified to run itself in a Docker container if it detects that Django isn't installed.

Public domain

This project is in the worldwide public domain. As stated in CONTRIBUTING:

This project is in the public domain within the United States, and copyright and related rights in the work worldwide are waived through the CC0 1.0 Universal public domain dedication.

All contributions to this project will be released under the CC0 dedication. By submitting a pull request, you are agreeing to comply with this waiver of copyright interest.

401ode/projects