Skip to main content

Brew Perfect Coffee Right from Your Terminal

Project description

MyCoffee: Brew Perfect Coffee Right from Your Terminal


built with Python3 PyPI version

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 CodeFactor codebeat badge

Installation

Source Code

PyPI

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

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

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

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

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

mycoffee-0.6.tar.gz (14.5 kB view details)

Uploaded Source

Built Distribution

mycoffee-0.6-py3-none-any.whl (10.2 kB view details)

Uploaded Python 3

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

Hashes for mycoffee-0.6.tar.gz
Algorithm Hash digest
SHA256 9a53c89d35f8d72d742fbe09d10400a22e64b9615c690818c9face2c910c8f33
MD5 ed87a236a922f7618ec1453c11267073
BLAKE2b-256 c2b070d318b433690df5d4986212df6b262a11f3d8fe56586b3d83d854ab6af2

See more details on using hashes here.

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

Hashes for mycoffee-0.6-py3-none-any.whl
Algorithm Hash digest
SHA256 082ad8bce98c0b4b77b127c357cbbc3585e54bf9f0a9136288e073b08add648c
MD5 2b63e71b8dff29dcb2975a56ceedc1d1
BLAKE2b-256 32c8e9ddd1d1fe3bbcabbefcd1cfb437f04f39cd8f563e69a7324bc28b5bdb8e

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page