pybeerxml¶

pybeerxml is a Python library for parsing BeerXML recipe files. It reads all recipes from a .beerxml file and returns structured Recipe objects — including ingredients, style metadata, and automatically calculated values for OG, FG, ABV, IBU, and colour.

Features¶

• Parse BeerXML files or XML strings
• Access hops, fermentables, yeasts, miscs, mash steps, equipment, and style
• Automatic calculation of OG, FG, ABV, IBU, and colour when not provided in the XML
• Supports both Tinseth and Rager IBU formulas
• Gravity values available in both SG and degrees Plato

Quick Example¶

from pybeerxml import Parser

parser = Parser()
recipes = parser.parse("/path/to/recipe.beerxml")

for recipe in recipes:
    print(recipe.name)       # "Simcoe IPA"
    print(recipe.og)         # 1.0756
    print(recipe.ibu)        # 64.3
    print(recipe.abv)        # 6.8

    for hop in recipe.hops:
        print(hop.name, hop.alpha)

    for fermentable in recipe.fermentables:
        print(fermentable.name, fermentable.amount)

Installation¶

pip install pybeerxml

See Getting Started for a full walkthrough.