This API concerns sales of yummy doughnuts from the Northcoders bakery.
The code should be deployable in any Unix-like OS. The build process outlined below requires Python
be installed along with GNU Make. MacOS users can get access
to the make
command via Homebrew or MacOS Command Line Tools.
To run the API locally:
- Fork and clone the repo.
- Ensure that your Python interpreter is Python at least 3.11.x - you may use a tool like
pyenv
. - In the root of the project, create the run environment with:
make requirements
- Set up the required dev tools:
make dev-setup
- Run the tests.
make run-checks
- Start the server by running:
make start-server
- In your browser, navigate to
localhost:8000/docs/
to view the API documentation page. - Then you can navigate to the endpoint of your choice, e.g.
localhost:8000/api/doughnuts
.
API logs are available in logs/app.log
.