Calculate blood alcohol content.
Project description
VERSION: 0.5.0
A Python module containing a couple of tools to calculate the blood alcohol content of people.
It’s at home at GitHub: https://github.com/brutus/boozelib/
Install
You can install it from PyPi, it is known as boozelib and has no dependencies:
pip install --user boozelib
Usage
The two main functions are:
get_blood_alcohol_content(age, weight, height, sex, volume, percent)
Returns the Blood Alcohol Content (raise) for a person (described by the given attributes) after a drink containing volume ml of alcohol with the given percent (vol/vol).
get_degradation(age, weight, height, sex, minutes)
Returns the alcohol degradation (per mill) of a person with the given stats in the given number of minutes.
See the documentation for more information and other probably helpful stuff. If you’re interested in the used formulas, see the source or browse the formulas online (maybe easier to read).
Examples
>>> from boozelib import get_blood_alcohol_content
>>> get_blood_alcohol_content( ... age=32, weight=96, height=186, sex=False, volume=500, percent=4.9 ... ) 0.28773587455687716
>>> get_blood_alcohol_content( ... age=32, weight=48, height=162, sex=True, volume=500, percent=4.9 ... ) 0.5480779730398769
>>> from boozelib import get_degradation
>>> get_degradation(age=32, weight=96, height=186, sex=False, minutes=60) 0.21139778538872606
>>> get_degradation(age=32, weight=48, height=162, sex=True, minutes=60) 0.20133476560648536
Testing
nox is used as a test runner (with pytest as the framework). So you need to have nox installed, before you can run the test suit like this:
nox
If you already have the development environment activated (see below), you can skip the install and just run:
make tests
If something fails, please get in touch.
Development Setup
pipenv is used to manage a virtual environment for the development setup.
A Makefile is provided, that collects some common tasks. You have to run the following once, to setup your environment:
make setup
Thanks and Contributions
Big hugs to Mathilda for hanging around and helping me figuring out all that math and biology stuff.
If you find any bugs, issues or anything, please use the issue tracker on GitHub - issues and PRs are welcome <3
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for boozelib-0.5.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0e6e8929080828c4578c0a3fd4449c1d24052701eb6642e0d86ba1b123b0db14 |
|
MD5 | b28fbdb41f944e235823f19bb2acb58d |
|
BLAKE2b-256 | 1faaa315e2975c1d7caedb3d1ce4d94bf2077e1b4864b5a2d4d6cfa9b0c47555 |