justinmklam / recipe-converter

Library and webapp to convert recipes from volumetric to weight measurements.

Metric Recipe Converter

Web app to convert recipes from imperial volume to metric weight units.

Link to live project: recipe-converter-app.herokuapp.com

Features

• Convert cups, tablespoons, and teaspoons of common ingredients to grams
• Scale the recipe to any value
• Option to load recipe from URL (if website is supported)
• Reader view for distraction-free viewing (no ads or other fluff!)

Documentation is available on recipe-converter.readthedocs.io

Built With

• Recipe Scrapers library (thanks hhursev)
• Flask backend
• Spectre frontend
• Heroku hosting

Getting Started

General

To install the package:

pip install -e .

To run the web app:

cd app/
flask run

For Developers

To install dependencies:

pip install -r requirements-dev.txt
pip install -r docs/requirements.txt

To run development tasks:

# Run the tests
pytest tests/

# Build the docs
cd docs
make html

Usage

Example usage of the module is shown below.

import recipeconverter
rc = recipeconverter.RecipeConverter()

rc.convert_volume_to_mass("1 cup flour")
# 142 g flour

rc.convert_volume_to_mass("1 tsp sugar")
# 4.2 g sugar

recipe = """2/3 cup butter
1 cup sugar
3 bananas
1/2 teaspoon salt"""

rc.convert_recipe(recipe, multiplier=2.0)
# 302.7 g butter
# 396 g sugar
# 6 bananas
# 5 g salt

rc.convert_recipe_from_url("https://www.allrecipes.com/recipe/20144/banana-banana-bread/")
# 284 g all-purpose flour
# 6 g baking soda
# 1.2 g salt
# 113.5 g butter
# 148.5 g brown sugar
# 2 eggs, beaten
# 2.3 cup mashed overripe bananas