https://github.com/sralloza/meal-planner

Meal planning microservice
https://github.com/sralloza/meal-planner

api fastapi meal-planning rest-api

Last synced: about 10 hours ago
JSON representation

Meal planning microservice

• Host: GitHub
• URL: https://github.com/sralloza/meal-planner
• Owner: sralloza
• License: other
• Created: 2021-10-07T22:22:33.000Z (about 3 years ago)
• Default Branch: master
• Last Pushed: 2023-02-08T20:03:17.000Z (almost 2 years ago)
• Last Synced: 2023-03-09T04:32:34.167Z (over 1 year ago)
• Topics: api, fastapi, meal-planning, rest-api
• Language: Python
• Homepage:
• Size: 238 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Meal Planner

Meal planning microservice.

Features:

- Rest API (FastAPI)

- Cron scripts to:

  - Update menu in Notion everyday

  - Add tasks to Todoist if some meal needs unfreezing the day before

  - Dabatase backup to AWS

- Notion integration.

- Todoist integration.

## Deploy

Deployment is done via docker.

**Note: these are the commands to create a release manually on your computer. You don't have to do this. The docker images are compiled with github actions, in the [publish workflow](.github/workflows/publish.yml).**

```shell

# Build and push it to dockerhub

docker buildx build -t sralloza/meal-planner:$VERSION --platform=linux/arm/v7,linux/amd64,linux/arm64 --push .

# Build without pushing it to dockerhub

docker buildx build -t sralloza/meal-planner:$VERSION --platform=linux/arm/v7,linux/amd64,linux/arm64 --load .

```

### Environment

You need to supply the following environment variables (required ones are marked with 🚩). Settings are grouped in categories.

#### Server

- 🚩 **API_TOKEN** (`str`): token of the API. In order to use the API, users will have to provide this token in their requests via the `X-TOKEN` header.

- **ENABLE_PROMETHEUS** (`bool`): if `True`, the API will enable the prometheus endpoint `/metrics`. Defaults to `False`.

- **PRODUCTION** (`bool`): if `True` the server will run on production environment. Defaults to `False`.

- **DISABLE_CRON_INTEGRATION** (`bool`) if `True`, the server will not launch cron jobs. It is useful to launch replicas, enabling cron integration in only one of them. It is also useful to deploy on Kubernetes, as the cron jobs can be implemented via `CronJob`.

#### AWS

- 🚩 **AWS_ACCESS_KEY_ID** (`str`): AWS access key id.

- 🚩 **AWS_SECRET_ACCESS_KEY** (`str`): AWS secret access key.

- 🚩 **S3_BUCKET_NAME** (`str`): name of the S3 bucket to save the backups.

- **S3_FILE_NAME** (`str`): filename to save the backups in the AWS S3 Bucket. Defaults to `meals.json`.

#### Notion

- **NOTION_ADD_DAY_AFTER_TOMORROW** (`bool`): if `True`, the meals of the day after tomorrow will also be added to Notion. Defaults to `True`.

- 🚩 **NOTION_BLOCK_ID** (`uuid`): id of the notion block where the meals will be showed.

- 🚩 **NOTION_KEY** (`str`): notion key to use the notion API.

#### Todoist

- 🚩 **TODOIST_PROJECT_ID** (`int`): todoist project id where the tasks will be added.

- 🚩 **TODOIST_TOKEN** (`str`): todoist token to use the todoist API.

#### Database

- 🚩 **MYSQL_DATABASE** (`str`): database name.

- 🚩 **MYSQL_HOST** (`str`): mysql host.

- 🚩 **MYSQL_PASSWORD** (`str`): mysql password.

- 🚩 **MYSQL_PORT** (`str`): mysql port.

- 🚩 **MYSQL_USER** (`str`): mysql user.

- **WAIT_FOR_IT_ADDRESS** (`str`): if is set, it will wait for the database to be ready for max 120 seconds. Must be set to `$MYSQL_HOST:$MYSQL_PORT`. This switch should not be used in Kubernetes deployments, as `initContainers` are designed to cover this exact use case.

#### Other

- **LOCALE_WEEKDAY_NAMES** (`list(str)`): weekday names, starting with Monday and ending with Sunday. Must contain 7 elements (one for each week day).

- **NULL_STR** (`str`): string to represent an empty `lunch1` or `dinner`. Defaults to `N/A`.

- **VARIABLE_STR** (`str`): string to represent a variable meal. Defaults to `Variable`. It's used in the `/shift` endpoint, where all meals which are equal to `VARIABLE_STR` will be treated as empty meals.

## Future

AWS and notion settings are currently needed. If you want to use this app without one of them (or both) add an issue and I'll make it optional and configurable.