- Do not work on the main branch directly. Always work on branches other than the main branch.
- Git pull from main for latest changes on all files.
- Git push your changes to your working branch.
- Always submit a pull request if you want to merge the changes (from your working branch) into the main branch.
- Someone else will review your pull request and approve it.
For now we're using pipenv
for the python virtual environment for development. To build this environment:
- Clone the repo
- Move into the backend repo:
cd backend
- Assuming you have python installed etc.; user install
pipenv
withpip
:pip install --user pipenv
- Install the required python packages:
pipenv install
- Finally, activate the virtual environment:
pipenv shell
Further documentation onpipenv
may be found here
For now we're using FastAPI to build the API (surprise surprise). You run the server by running uvicorn main:app --reload
in the backend/app
directory. This will run the server on some localhost address like http://127.0.0.1:8000
. The nifty Swagger docs page can then be accessed at http://127.0.0.1:8000/docs
.