Skip to content

Commit

Permalink
Updated Readme
Browse files Browse the repository at this point in the history
  • Loading branch information
mghaznav committed Jul 9, 2024
1 parent 1c369c2 commit eeb2044
Showing 1 changed file with 45 additions and 1 deletion.
46 changes: 45 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -1 +1,45 @@
# recipe-api
# Recipe API

## Introduction
This is an API that supports an app where users can create, and save different recipes. This API handles user authentication, ingredient management and recipe management.

## Prerequisites
- Docker

## Running

To build the docker image, cd in to the recipe-api directory and run:

```bash
docker compose build
```

Now it should be ready to run.

To run the image, simply use the Docker command:

```bash
docker compose up
```

This will launch the django server and map it to port 8000 on your machine. The local server can be accessed at [http://localhost:8000](http://localhost:8000).

## Stopping

Press Ctrl + c to stop (yes, its Ctrl + c even on Mac)

## Testing

Unit tests can be run on the application with the following command:

```bash
docker compose run --rm app sh -c "python manage.py test"
```

## Linting

Linting can be run on the application with the following command:

```bash
docker compose run --rm app sh -c "flake8"
```

0 comments on commit eeb2044

Please sign in to comment.