mycoffee 1.3

Brew Perfect Coffee Right from Your Terminal

MyCoffee: Brew Perfect Coffee Right from Your Terminal

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 1.3 or Latest Source
• pip install .

PyPI

• Check Python Packaging User Guide
• pip install mycoffee==1.3

Usage

ℹ️ You can use mycoffee or python -m mycoffee to run this program

Version

> mycoffee --version

1.3

Method

> mycoffee --method=v60
 __  __  _  _   ___  _____  ____  ____  ____  ____
(  \/  )( \/ ) / __)(  _  )( ___)( ___)( ___)( ___)
 )    (  \  / ( (__  )(_)(  )__)  )__)  )__)  )__)
(_/\/\_) (__)  \___)(_____)(__)  (__)  (____)(____)



Method: `v60`

Cups: 1

Coffee: 15 g

Water: 250 g

Ratio: 3/50

Grind: 550 um

Info: V60 method

• Methods List
• mycoffee --methods-list

Customize

ℹ️ You can run mycoffee --coffee-units-list to view the supported coffee units

ℹ️ You can run mycoffee --water-units-list to view the supported water units

> mycoffee --method=chemex --water=20 --cups=3 --coffee-ratio=2 --water-ratio=37 --coffee-unit="t oz" --water-unit="fl oz" --grind=750

 __  __  _  _   ___  _____  ____  ____  ____  ____
(  \/  )( \/ ) / __)(  _  )( ___)( ___)( ___)( ___)
 )    (  \  / ( (__  )(_)(  )__)  )__)  )__)  )__)
(_/\/\_) (__)  \___)(_____)(__)  (__)  (____)(____)



Method: `chemex`

Cups: 3

Coffee: 3.084 t oz

Water: 20 fl oz

Ratio: 2/37

Grind: 750 um

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
--grind	Grind size (um)	Integer	700
--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
--water-unit	Water 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

19- Whole bean to ground coffee calculator

20- Weight to Volume Converter for Recipes

21- How Much Coffee per Cup?

22- Weight Calculator

23- Volume Conversion Calculator - Inch Calculator

24- Metric Conversion Charts and Calculators

25- Coffee grind size chart

Show Your Support

Star This Repo

Give a ⭐️ if this project helped you!

Donate to Our Project

Bitcoin

1KtNLEEeUbTEK9PdN6Ya3ZAKXaqoKUuxCy

Ethereum

0xcD4Db18B6664A9662123D4307B074aE968535388

Litecoin

Ldnz5gMcEeV8BAdsyf8FstWDC6uyYR6pgZ

Doge

DDUnKpFQbBqLpFVZ9DfuVysBdr249HxVDh

Tron

TCZxzPZLcJHr2qR3uPUB1tXB6L3FDSSAx7

Ripple

rN7ZuRG7HDGHR5nof8nu5LrsbmSB61V1qq

Binance Coin

bnb1zglwcf0ac3d0s2f6ck5kgwvcru4tlctt4p5qef

Tether

0xcD4Db18B6664A9662123D4307B074aE968535388

Dash

Xd3Yn2qZJ7VE8nbKw2fS98aLxR5M6WUU3s

Stellar

GALPOLPISRHIYHLQER2TLJRGUSZH52RYDK6C3HIU4PSMNAV65Q36EGNL

Zilliqa

zil1knmz8zj88cf0exr2ry7nav9elehxfcgqu3c5e5

Coffeete

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

1.3 - 2025-01-31

Added

• get_grind_type function
• validate_positive_int function
• validate_positive_float function

Changed

• README.md updated
• check_ratio_limits function bug fixed
• String templates modified
• Test system modified

1.2 - 2025-01-13

Added

• 2 new water units
  1. Troy Pounds (t lb)
  2. Pennyweight (dwt)
• 2 new coffee units
  1. Troy Pounds (t lb)
  2. Pennyweight (dwt)
• --grind argument
• Grind upper limit
• Grind lower limit
• check_grind_limits function

Changed

• README.md updated
• METHODS.md updated

1.1 - 2025-01-02

Added

• 5 new water units
  1. Troy Ounce (t oz)
  2. Grain (gr)
  3. Carats (ct)
  4. Cubic Centimeters (cc)
  5. Centiliters (cl)
• 3 new coffee units
  1. Troy Ounce (t oz)
  2. Grain (gr)
  3. Carats (ct)

Changed

• README.md updated

1.0 - 2024-12-17

Added

• 3 new water units
  1. Pint (pt)
  2. Quart (qt)
  3. Fluid Ounce (fl oz)

Changed

• README.md updated

0.9 - 2024-12-06

Added

• 4 new water units
  1. Tablespoon (tbsp)
  2. Teaspoon (tsp)
  3. Dessertspoon (dsp)
  4. Cup (cup)

0.8 - 2024-11-29

Added

• 1 new coffee unit
  1. Cup (cup)
• 6 new water units
  1. Milliliter (ml)
  2. Liter (l)
  3. Ounce (oz)
  4. Pound (lb)
  5. Milligram (mg)
  6. Kilogram (kg)
• convert_water function
• show_water_units_list function
• --water-unit argument

Changed

• Test system modified
• README.md updated

0.7 - 2024-11-21

Added

• 4 new coffee units
  1. Coffee beans (cb)
  2. Tablespoon (tbsp)
  3. Teaspoon (tsp)
  4. Dessertspoon (dsp)
• convert_coffee function

Changed

• GitHub actions are limited to the dev and main branches

0.6 - 2024-10-18

Added

• show_coffee_units_list function
• --coffee-unit argument

Changed

• Test system modified
• Cups bug fixed
• calc_coffee function updated
• README.md updated
• Python 3.13 added to test.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 to print_result

0.4 - 2024-10-01

Added

• 4 new methods
  1. AeroPress standard
  2. AeroPress concentrate
  3. AeroPress inverted
  4. 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
  1. Ristretto
  2. Lungo
  3. Turkish
  4. Cupping

0.2 - 2024-09-17

Added

• 5 new methods
  1. Pour-over
  2. Auto drip
  3. Cold brew
  4. Cold brew concentrate
  5. Moka pot
• is_int function
• filter_params function

Changed

• README.md updated
• --coffee-ratio type changed from int to float
• --water-ratio type changed from int to float
• coffee_calc function renamed to calc_coffee
• print_message function updated
• Test system modified

0.1 - 2024-09-02

Added

• 6 new methods
  1. V60
  2. Espresso
  3. Chemex
  4. French-press
  5. Siphon
  6. Custom