A project for creating petition forms based on the work of Durham Expunction and Restoration (DEAR) .
git clone git@github.com:codeforasheville/wext.git
cd wext
docker-compose up -d
docker-compose run --rm django python manage.py createsuperuser
The user facing side of the WExT Petition Generator is a React single page app (SPA).
After running docker-compose up -d
, the frontend site is available at localhost:3000
.
npm i
npm run start
The Petition Generator app uses a React frontend with a Django REST API backend. In the development environment, the React development server and Django backend will likely be hosted on different ports, and thus hosted on different urls. This causes issues when the frontend code sends API requests, such as a login request. The solution is to proxy the API requests to the url of the backend.
When the frontend is run using docker, the API_PROXY
environment variable is set to http://django:8000
.
You can override the this proxy url by setting OVERRIDE_API_PROXY
:
OVERRIDE_API_PROXY=https://TODO.herokuapp.com/ docker-compose up -d
When using npm run start
to run the frontend, the API_PROXY
environment variable is unset. The fallback proxy is set to the staging backend url.
You can set the proxy url by either setting OVERRIDE_API_PROXY
or API_PROXY
:
API_PROXY=http://localhost:8000 npm start
To run this on a Mac, use Docker for Mac.
Build the project containers:
docker-compose build
Run the containers:
docker-compose up -d django
Visit http://localhost:8000/petition/api/ in your browser.
Create a superuser:
docker-compose run --rm django python manage.py createsuperuser
Migrate DB:
docker-compose run --rm django python manage.py migrate
See detailed cookiecutter-django Docker documentation.
To restore a database dump, you can run:
docker-compose run --rm django sh
$ dropdb dear_petition
$ createdb dear_petition
$ pg_restore -Ox -d dear_petition latest.dump
$ python manage.py migrate
Run the setup_project.py script from the base directory, providing as a command line argument the directory to the related ciprs-reader project. This will set up the project in your environment.
Developing inside a virtual environment is recommended.
On Mac run the following command to set up a virtual environment:
brew install pipenv
pipenv shell
pip install -r requirements/base.txt
On Linux run the following command to set up a virtual environment:
sudo yum install python-tools
pip3 install pipenv
pipenv shell
pip install -r requirements/base.txt
While inside of the pipenv run the setup_project.py script from the base directory, providing as a command line argument the directory to the related ciprs-reader project. This will set up the project in your environment.
python3 setup-project.py <path-to-ciprs-reader>
Additional Pipenv Notes: To exit the pip environment:
(wext) bash-3.2$ exit
exit
bash-3.2$
To delete the pipenv environment:
bash-3.2$ pipenv --rm
Removing virtualenv (/Users/user/.local/share/virtualenvs/wext-fJpn7FEC)β¦
-
To create an superuser account, use this command:
$ python manage.py createsuperuser
For convenience, you can keep your normal user logged in on Chrome and your superuser logged in on Firefox (or similar), so that you can see how the site behaves for both kinds of users.
Running type checks with mypy:
$ mypy dear_petition
To run the tests, check your test coverage, and generate an HTML coverage report:
$ coverage run -m pytest
$ coverage html
$ open htmlcov/index.html
$ docker-compose run --rm django pytest
$ pytest
The wext project is now on Sentry. Visit sentry.io and make an account or sign in with Github. Reach out to an existing member for an invite to the project.