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