2.2.0

Updated the whole pybeerxml lib to 2026 standards:

• updated toolchain to uv, ruff, ty
• updated container classes Hop, Water, Yeast, etc to Python dataclasses
• added support for Python versions 3.10 - 3.14
• removed support for end-of-life Python versions 3.6-3.9
• expanded unit tests from 15 to 100+ cases
• added doc strings to all classes and methods
• added general documentation + API reference available at https://pybeerxml.onrender.com/
• several bug fixes

What's Changed

• Fixed import path in example. by @boralyl in #25
• Modernize the project to 2026 standards by @hotzenklotz in #27
• Fix bugs, update to dataclasses and improve signature typing by @hotzenklotz in #28
• Add Zeniscal docs + API documentation by @hotzenklotz in #29

New Contributors

• @boralyl made their first contribution in #25

Full Changelog: 2.1.2...2.2.0

2.1.2

New Features

• Added more supported attributes for Yeast(s) #23 Thanks @scheb

Bug Fixes

• None

2.1.1

New Features

• None

Bug Fixes

• Fixed an issue with yeast attenuation #22 Thanks @scheb

2.1.0

New Features

• Added feature to return IBU, OG, FG, ABV, Color from BeerXML recipe if provided. Fallback to calculated version. #20 Thanks @scheb
  • calculated properties are still available if required:

  recipe.ibu_calculated
  recipe.fg_calculated
  recipe.og_calculated
  recipe.abv_calculated
  recipe.color_calculated
  

  • Hint: This changes the behavior slightly and might not be backwards compatible
  • added event more properties/fields specified in the BeerXML spec

Bug Fixes

• Small fixed to formatting and code style

2.0.0

New Features

• Extensive refactoring of the code base
  • full conversion to Python 3 (Python >3.6, 3.7, 3.8)
  • added Type hints
  • switched to poetry for dependency management
    -use GitHub actions for CI
• Added support for parsing Equipment and a lot more recipe metadata fields #19 @scheb
• Added method to parse recipe from string #18 @scheb

  xml_as_string = load_xml_as_string
  recipes = Parser.parse_from_string(xml_as_string)
  

1.0.8

New Features

• Added parsing for Water #16 @johodh

Bug Fixes

• Bumped some dependency versions for security fixes

1.0.7

New Features

• Added new Coffee Stout recipe to unit tests

Bug Fixes

• Fixed subsequent mash steps overwriting previous mashing information #11 @jwjulien

1.0.6

New Features

• Added SRM color calculation for recipes based on the individual fermentables #10 @shouptech

Bug Fixes

• None

1.0.5

New Features

• None

Bug Fixes

• removed unnecessary print statements @shouptech

1.0.4

New Features

• Updated the package metadata ton include more information / the readme on the PyPI website