Brew Perfect Coffee Right from Your Terminal
Project description
Overview
MyCoffee is a command-line tool for coffee enthusiasts who love brewing with precision. It helps you calculate the perfect coffee-to-water ratio for various brewing methods, ensuring you brew your ideal cup every time—right from your terminal.
PyPI Counter | |
Github Stars |
Branch | main | dev |
CI |
Code Quality |
Installation
Source Code
- Download Version 0.6 or Latest Source
pip install .
PyPI
- Check Python Packaging User Guide
pip install mycoffee==0.6
Usage
⚠️ You can use mycoffee
or python -m mycoffee
to run this program
Version
> mycoffee --version
0.6
Method
> mycoffee --method=v60
__ __ _ _ ___ _____ ____ ____ ____ ____
( \/ )( \/ ) / __)( _ )( ___)( ___)( ___)( ___)
) ( \ / ( (__ )(_)( )__) )__) )__) )__)
(_/\/\_) (__) \___)(_____)(__) (__) (____)(____)
Method: `v60`
Cups: 1
Coffee: 15 g
Water: 250 g
Ratio: 3/50
Info: V60 method
- Methods List
mycoffee --methods-list
Customize
⚠️ You can run mycoffee --coffee-units-list
to view the supported coffee units
> mycoffee --method=chemex --water=20 --cups=3 --coffee-ratio=2 --water-ratio=37 --coffee-unit=g
__ __ _ _ ___ _____ ____ ____ ____ ____
( \/ )( \/ ) / __)( _ )( ___)( ___)( ___)( ___)
) ( \ / ( (__ )(_)( )__) )__) )__) )__)
(_/\/\_) (__) \___)(_____)(__) (__) (____)(____)
Method: `chemex`
Cups: 3
Coffee: 3.243 g
Water: 20 g
Ratio: 2/37
Info: Chemex method
Parameters
Parameter | Description | Type | Default |
---|---|---|---|
--method |
Specifies the coffee brewing method | String | custom |
--water |
Sets the amount of water in each cup | Float | 240 |
--cups |
Indicates the number of cups | Integer | 1 |
--coffee-ratio |
Coefficient for the coffee component in the ratio | Float | 1 |
--water-ratio |
Coefficient for the water component in the ratio | Float | 17 |
--info |
Provides information about the brewing method | String | Custom brewing method |
--digits |
Number of digits up to which the result is rounded | Integer | 3 |
--coffee-unit |
Coffee unit | String | g |
Issues & Bug Reports
Just fill an issue and describe it. We'll check it ASAP!
- Please complete the issue template
References
1- Coffee to water ratio calculator
2- V60 Brew Guide
3- How to Brew Coffee with a Chemex
4- Using French press for perfect coffee
5- How to Brew the Perfect Cup of Siphon Coffee
6- Using Espresso Brew Ratios
7- My Best Coffee Recipes of 2022
8- Auto Drip Brewing Guide
9- Guide To Cold Brew
10- Cold Brew Concentrate Recipe
11- How to Make Coffee in a Moka Pot
12- How to Make Turkish Coffee at Home
13- How to Cup Coffee
14- Tetsu Kasuya AeroPress Recipe
15- All about the intervals
16- Clever Dripper; Square Mile Coffee
17- AeroPress Product User Manuals
18- RapidTables - Weight Converter
Show Your Support
Star This Repo
Give a ⭐️ if this project helped you!
Donate to Our Project
Bitcoin
1KtNLEEeUbTEK9PdN6Ya3ZAKXaqoKUuxCyEthereum
0xcD4Db18B6664A9662123D4307B074aE968535388Litecoin
Ldnz5gMcEeV8BAdsyf8FstWDC6uyYR6pgZDoge
DDUnKpFQbBqLpFVZ9DfuVysBdr249HxVDhTron
TCZxzPZLcJHr2qR3uPUB1tXB6L3FDSSAx7Ripple
rN7ZuRG7HDGHR5nof8nu5LrsbmSB61V1qqBinance Coin
bnb1zglwcf0ac3d0s2f6ck5kgwvcru4tlctt4p5qefTether
0xcD4Db18B6664A9662123D4307B074aE968535388Dash
Xd3Yn2qZJ7VE8nbKw2fS98aLxR5M6WUU3sStellar
GALPOLPISRHIYHLQER2TLJRGUSZH52RYDK6C3HIU4PSMNAV65Q36EGNLZilliqa
zil1knmz8zj88cf0exr2ry7nav9elehxfcgqu3c5e5Coffeete
Changelog
All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog and this project adheres to Semantic Versioning.
Unreleased
0.6 - 2024-10-18
Added
show_coffee_units_list
function--coffee-unit
argument
Changed
- Test system modified
- Cups bug fixed
calc_coffee
function updatedREADME.md
updatedPython 3.13
added totest.yml
0.5 - 2024-10-08
Added
- Ratio upper limit
- Ratio lower limit
check_ratio_limits
function
Changed
- Test system modified
print_message
function renamed toprint_result
0.4 - 2024-10-01
Added
- 4 new methods
- AeroPress standard
- AeroPress concentrate
- AeroPress inverted
- Steep-and-release
--digits
argument
Changed
README.md
updated- Test system modified
filter_params
function updated
0.3 - 2024-09-24
Added
- Logo
- 4 new methods
- Ristretto
- Lungo
- Turkish
- Cupping
0.2 - 2024-09-17
Added
- 5 new methods
- Pour-over
- Auto drip
- Cold brew
- Cold brew concentrate
- Moka pot
is_int
functionfilter_params
function
Changed
README.md
updated--coffee-ratio
type changed fromint
tofloat
--water-ratio
type changed fromint
tofloat
coffee_calc
function renamed tocalc_coffee
print_message
function updated- Test system modified
0.1 - 2024-09-02
Added
- 6 new methods
- V60
- Espresso
- Chemex
- French-press
- Siphon
- Custom
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
File details
Details for the file mycoffee-0.6.tar.gz
.
File metadata
- Download URL: mycoffee-0.6.tar.gz
- Upload date:
- Size: 14.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.1 CPython/3.12.7
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 9a53c89d35f8d72d742fbe09d10400a22e64b9615c690818c9face2c910c8f33 |
|
MD5 | ed87a236a922f7618ec1453c11267073 |
|
BLAKE2b-256 | c2b070d318b433690df5d4986212df6b262a11f3d8fe56586b3d83d854ab6af2 |
File details
Details for the file mycoffee-0.6-py3-none-any.whl
.
File metadata
- Download URL: mycoffee-0.6-py3-none-any.whl
- Upload date:
- Size: 10.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.1 CPython/3.12.7
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 082ad8bce98c0b4b77b127c357cbbc3585e54bf9f0a9136288e073b08add648c |
|
MD5 | 2b63e71b8dff29dcb2975a56ceedc1d1 |
|
BLAKE2b-256 | 32c8e9ddd1d1fe3bbcabbefcd1cfb437f04f39cd8f563e69a7324bc28b5bdb8e |