{"id":13936236,"url":"https://github.com/chrisgilmerproj/brewday","last_synced_at":"2025-07-06T21:35:20.233Z","repository":{"id":50194480,"uuid":"61384865","full_name":"chrisgilmerproj/brewday","owner":"chrisgilmerproj","description":"Tools for the home brewer","archived":false,"fork":false,"pushed_at":"2022-12-08T04:49:39.000Z","size":1057,"stargazers_count":25,"open_issues_count":16,"forks_count":2,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-12-06T09:15:33.662Z","etag":null,"topics":["alcohol","beer","brew","brewing","grains","hops","recipe","yeast"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/chrisgilmerproj.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-06-17T15:46:44.000Z","updated_at":"2024-10-14T01:31:42.000Z","dependencies_parsed_at":"2023-01-24T11:15:12.095Z","dependency_job_id":null,"html_url":"https://github.com/chrisgilmerproj/brewday","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chrisgilmerproj%2Fbrewday","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chrisgilmerproj%2Fbrewday/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chrisgilmerproj%2Fbrewday/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chrisgilmerproj%2Fbrewday/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chrisgilmerproj","download_url":"https://codeload.github.com/chrisgilmerproj/brewday/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252569637,"owners_count":21769515,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["alcohol","beer","brew","brewing","grains","hops","recipe","yeast"],"created_at":"2024-08-07T23:02:30.563Z","updated_at":"2025-05-05T20:02:46.404Z","avatar_url":"https://github.com/chrisgilmerproj.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"[![PyPI](https://img.shields.io/pypi/v/brewday.svg)](https://pypi.python.org/pypi/brewday/1.0.0)\n[![Versions](https://img.shields.io/pypi/pyversions/brewday.svg)](https://img.shields.io/pypi/pyversions/brewday.svg)\n[![Build Status](https://travis-ci.org/chrisgilmerproj/brewday.svg?branch=master)](https://travis-ci.org/chrisgilmerproj/brewday) \n[![Documentation Status](https://readthedocs.org/projects/brewday/badge/?version=latest)](http://brewday.readthedocs.org/en/latest/?badge=latest)\n[![License](https://img.shields.io/pypi/l/brewday.svg)](https://opensource.org/licenses/MIT)\n\n# Brew Day\n\nThis repositiory is a set of utilities for the homebrewer.  It should help in\nconstructing and analyzing recipes.  There are also command line utilities for\nbrew day.\n\nThe hope is to help improve your planning and execution when making beer.\n\n# Recipe Examples\n\nTo see examples of this library in action check out the `examples/` directory or\nread the [Example README.md](./examples/README.md) for more information.\n\n# Tools\n\nTo be helpful a few tools have been included.  Run them thusly:\n\n```sh\n$ PYTHONPATH=$PYTHONPATH: python bin/abv -h\n$ PYTHONPATH=$PYTHONPATH: python bin/gv -h\n$ PYTHONPATH=$PYTHONPATH: python bin/sugar -h\n$ PYTHONPATH=$PYTHONPATH: python bin/temp -h\n$ PYTHONPATH=$PYTHONPATH: python bin/yeast -h\n```\n\n# Charts\n\nIn an attempt to understand the data as it is presented in various brewing\nbooks and websites the `charts/` directory attempts to reproduce them using\nthe tools of this library.  Credit is given as best as possible to the\noriginal author.  Corrections are made where possible to make the charts as\naccurate as possible.\n\n## A note on Graphs\n\nImportantly these charts are generally lists of numbers and NOT graphs.\nTo limit the required dependencies of this library any graphs are kept\nin the [BrewSci](https://github.com/chrisgilmerproj/brewsci) repo.\n\n# Data\n\nTo parse or build recipes you will need a directory that holds data for the\nfollowing types:\n\n- cereals\n- hops\n- water\n- yeast\n\nTo help with this you can use the [BrewData](https://github.com/chrisgilmerproj/brewdata) repo.\n\n# Units\n\nThe standard for this repository at the moment is to use Imperial Units.  This\nis because most of the equations used as reference use Imperial Units.  As\ntests are updated units may change to SI Units (metric).\n\n# Percentages\n\nA fair number of methods require input values as a percentage.  To avoid confusion\nall percentages are expected to be in decimal form between the number 0.0\nand 1.0.\n\nPercentages will be displayed in percentage format as opposed to decimal\nformat to avoid confusion and for ease of reading.\n\n# Documentation\n\nChange to the `docs` directory.  Then do the following:\n\n```sh\n$ cd docs/\n$ virtualenv .venv\n$ source .venv/bin/activate\n(.venv) $ pip install -r requirements.txt\n(.venv) $ pip install -r requirements-local.txt --upgrade\n(.venv) $ make html\n(.venv) $ open build/index.html\n```\n\nIt's important that the current version of the library be installed in order\nto generate the API docs.  To insure this insure to install from\n`requirements-local.txt` with the `--upgrade` flag every time.  Example:\n\n```sh\n$ source .venv/bin/activate\n(.venv) $ pip install -r requirements-local.txt --upgrade \u0026\u0026 make clean html\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchrisgilmerproj%2Fbrewday","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchrisgilmerproj%2Fbrewday","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchrisgilmerproj%2Fbrewday/lists"}