A project to automate expunging qualifying criminal records. This project is done in conjunction with the Multnomah County Public Defender's Office. Learn more in the wiki.

Please read our code of conduct.

If you're interested in learning more about our project and getting involved, please join us at one of our meetup events! You can also request an invite to join our Slack channel by contacting our CodeForPDX brigade leader, Hugh: Hugh@codeforpdx.org

• Tech Overview
• Installation
• Running Components
• Testing
• Contributing
• Technical Documentation
• License

This is a web app built using React for the in-browser interface, and a backend web service implemented with the Flask web framework in Python. The backend app connects to a Postgres database.

The app is deployed on the webapp hosting service, Heroku.

Our latest dev version (this repo's latest release) is publicly viewable! See https://recordexpungpdx.herokuapp.com/

Our dev environment is entirely containerized with Docker, and no other dependencies need to be installed natively. We use Python's pipenv for maintaining backend dependencies. We use mypy to type check any optional typings and pytest to test backend code. We use NPM to develop and build the frontend code. Docker is used to build and deploy the app stack for both local development and for deployment to the web. A postgres database runs as a service within the docker stack, which exposes a connection locally for development and testing.

You can get your dev environment up and running with installing only Docker and docker-compose. The npm and backend dev servers run in docker containers, synced with source code directories so that code changes propagate on the local servers right away. If you have any trouble, don't hesitate to ask on our Slack channel!

1. Fork the repo to create a copy for your own github account, and clone your own copy.

2. Install docker

   • Mac

     • Follow installation instructions in: Getting Started -- Docker on Mac OS X

       (click on Get Docker for Mac [Stable])

   • Linux

     • First, follow: Docker Installation

     • Configure your user to run docker without sudo: https://docs.docker.com/install/linux/linux-postinstall/

   • Windows

     • Unfortunately, we don't have documentation to support development in Windows. If you use Windows, we'd love your contribution here!

3. Install docker-compose

In the project's root directory, run make dev_up. This builds the dev version of the docker images and launches the containers using docker-compose. Stop the running stack with make dev_down.

After running make dev_up, you can navigate to localhost in the browser and see the frontend running. You can now log in using either of the following credentials

• Email: admin@email.com, Password: admin
• Email: user@email.com, Password: user

If you run docker ps, you can see the frontend app running on localhost:3000, however if you try logging into this instance instead of the frontend at localhost, you will get a 500 server error.

Whenever a dependency is added to the frontend or backend, you will need to rebuild the docker images or you will get errors when trying to run the stack. To do so, take down the stack, rebuild, and restart stack with:

make dev_down
make dev_build
make dev_up

For more project documentation on Docker, some troubleshooting, and some basic commands, see: doc/docker.md

While in the directory of your local repo, run:

$ make clean

in order to remove build artifacts.

Currently using pytest for testing the backend. Run all tests by running the following command in the project root directory:

$ make dev_test

This runs a pytest command to execute all the unit tests inside the backend docker container. All of these tests should pass if you have correctly set up the backend dev environment.

There are also make targets to operate in a docker container interactively:

make bash_backend

or

make bash_frontend

which opens a bash shell inside the respective container. In the backend container, you can then run the python interactive shell with python3, or run pytest.

To run a subset of test cases without first shelling into the docker container, you can use a docker exec command, which specifies a container by name and a runnable command in the container in a single step, e.g.:

docker exec -t expungeservice pytest ./tests/[subdir]

To specify and run a subset of the test cases.

Please see CONTRIBUTING.md

• Project technical design: doc/design.md
• Additional frontend docs, mostly design patterns: src/frontend/README.md.
• Some support docs for doing development:
  • doc/development.md

TODO: Add license