Skip to content

Automatically generate your shopping list for a selected number of recipes. Import or manually add recipes to a locally stored database

License

Notifications You must be signed in to change notification settings

montymi/LazyGrocer

Repository files navigation

Contributors Forks Stargazers Issues MIT License


🛒 LazyGrocer

Created for: CS3200 Database Design Final Project

Github Actions


Table of Contents
  1. About The Project
  2. Getting Started
  3. Usage
  4. Structure
  5. Tasks
  6. Contributing
  7. License
  8. Contact
  9. Acknowledgments

About The Project

Automatically generate your shopping list for a selected number of recipes. Import or manually add recipes to a locally stored database.

Built With

Python Docker Docker Compose MySQL

(back to top)

Getting Started

Clone and navigate into the repository:

git clone git@github.com:montymi/LazyGrocer && cd LazyGrocer

On Unix Systems:

chmod +x ./start.sh
./start.sh -i

On Windows:

./start.sh

(back to top)

Usage

Once the application is started in interactive mode, a container will startup, connect to the local mysql volume and prompt you with ID navigation through this menu:

Select Service:
1. Create
2. Read
3. Update
4. Delete
5. Quit
Service ID: _

(back to top)

Structure

LazyGrocer/
├── .github/
│   └── workflows/
│       └── python-app.yml
├── scripts/
│   └── init.sql
├── src/
│   ├── controller/
│   │   ├── dataControllerv2.py
│   │   └── __init__.py
│   ├── model/
│   │   ├── enums/
│   │   │   ├── scripts.py
│   │   │   ├── tables.py
│   │   │   └── __init__.py
│   │   └── __init__.py
│   ├── testing/
│   │   ├── test_data_inserts.py
│   │   ├── test_data_selects.py
│   │   └── __init__.py
│   ├── main.py
│   ├── requirements.txt
│   └── __init__.py
├── docker-compose.yml
├── Dockerfile
├── start.sh
├── README.md
└── LICENSE.txt

(back to top)

Tasks

  • add exporting recipes as JSON
  • add installation instructions
  • add Structure section
  • add Sanay and Colby information in Contact section
  • containerize for reproducibility
  • add passive start in detached mode
  • add APIs with FastAPI
  • add CLI support when started in detached mode

See the open issues for a full list of issues and proposed features.

(back to top)

Contributing

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

(back to top)

License

Distributed under the GPL License. See LICENSE.txt for more information.

(back to top)

Contact

Michael Montanaro

LinkedIn GitHub

Colby Hegarty

LinkedIn GitHub

Sanay Doshi

LinkedIn

(back to top)

Acknowledgments

(back to top)

About

Automatically generate your shopping list for a selected number of recipes. Import or manually add recipes to a locally stored database

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published