https://github.com/chrisgilmerproj/brewday
Tools for the home brewer
https://github.com/chrisgilmerproj/brewday
alcohol beer brew brewing grains hops recipe yeast
Last synced: 3 months ago
JSON representation
Tools for the home brewer
- Host: GitHub
- URL: https://github.com/chrisgilmerproj/brewday
- Owner: chrisgilmerproj
- License: mit
- Created: 2016-06-17T15:46:44.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2022-12-08T04:49:39.000Z (almost 3 years ago)
- Last Synced: 2024-12-06T09:15:33.662Z (10 months ago)
- Topics: alcohol, beer, brew, brewing, grains, hops, recipe, yeast
- Language: Python
- Size: 1.01 MB
- Stars: 25
- Watchers: 3
- Forks: 2
- Open Issues: 16
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.txt
Awesome Lists containing this project
README
[](https://pypi.python.org/pypi/brewday/1.0.0)
[](https://img.shields.io/pypi/pyversions/brewday.svg)
[](https://travis-ci.org/chrisgilmerproj/brewday)
[](http://brewday.readthedocs.org/en/latest/?badge=latest)
[](https://opensource.org/licenses/MIT)
# Brew Day
This repositiory is a set of utilities for the homebrewer. It should help in
constructing and analyzing recipes. There are also command line utilities for
brew day.
The hope is to help improve your planning and execution when making beer.
# Recipe Examples
To see examples of this library in action check out the `examples/` directory or
read the [Example README.md](./examples/README.md) for more information.
# Tools
To be helpful a few tools have been included. Run them thusly:
```sh
$ PYTHONPATH=$PYTHONPATH: python bin/abv -h
$ PYTHONPATH=$PYTHONPATH: python bin/gv -h
$ PYTHONPATH=$PYTHONPATH: python bin/sugar -h
$ PYTHONPATH=$PYTHONPATH: python bin/temp -h
$ PYTHONPATH=$PYTHONPATH: python bin/yeast -h
```
# Charts
In an attempt to understand the data as it is presented in various brewing
books and websites the `charts/` directory attempts to reproduce them using
the tools of this library. Credit is given as best as possible to the
original author. Corrections are made where possible to make the charts as
accurate as possible.
## A note on Graphs
Importantly these charts are generally lists of numbers and NOT graphs.
To limit the required dependencies of this library any graphs are kept
in the [BrewSci](https://github.com/chrisgilmerproj/brewsci) repo.
# Data
To parse or build recipes you will need a directory that holds data for the
following types:
- cereals
- hops
- water
- yeast
To help with this you can use the [BrewData](https://github.com/chrisgilmerproj/brewdata) repo.
# Units
The standard for this repository at the moment is to use Imperial Units. This
is because most of the equations used as reference use Imperial Units. As
tests are updated units may change to SI Units (metric).
# Percentages
A fair number of methods require input values as a percentage. To avoid confusion
all percentages are expected to be in decimal form between the number 0.0
and 1.0.
Percentages will be displayed in percentage format as opposed to decimal
format to avoid confusion and for ease of reading.
# Documentation
Change to the `docs` directory. Then do the following:
```sh
$ cd docs/
$ virtualenv .venv
$ source .venv/bin/activate
(.venv) $ pip install -r requirements.txt
(.venv) $ pip install -r requirements-local.txt --upgrade
(.venv) $ make html
(.venv) $ open build/index.html
```
It's important that the current version of the library be installed in order
to generate the API docs. To insure this insure to install from
`requirements-local.txt` with the `--upgrade` flag every time. Example:
```sh
$ source .venv/bin/activate
(.venv) $ pip install -r requirements-local.txt --upgrade && make clean html
```