- 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
pipenvwithpip:pip install --user pipenv - Install the required python packages:
pipenv install - Finally, activate the virtual environment:
pipenv shellFurther documentation onpipenvmay 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.