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.7

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
19- Whole bean to ground coffee calculator
20- Weight to Volume Converter for Recipes
21- How Much Coffee per Cup?

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.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

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.7.tar.gz (15.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mycoffee-0.7-py3-none-any.whl (10.6 kB view details)

Uploaded Python 3

File details

Details for the file mycoffee-0.7.tar.gz.

File metadata

  • Download URL: mycoffee-0.7.tar.gz
  • Upload date:
  • Size: 15.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for mycoffee-0.7.tar.gz
Algorithm Hash digest
SHA256 847facd262578182ad4fa7d9850b02dfc9e81ab4dcd7e640df4bcec53367d9a3
MD5 525a1db35fed1ec7bf9123a06908c64c
BLAKE2b-256 095fd8462450608fc5691bad69222f9516eed42ac3709e244c0784b786e1c6f4

See more details on using hashes here.

File details

Details for the file mycoffee-0.7-py3-none-any.whl.

File metadata

  • Download URL: mycoffee-0.7-py3-none-any.whl
  • Upload date:
  • Size: 10.6 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.7-py3-none-any.whl
Algorithm Hash digest
SHA256 1fc147c95ab4e9a6e6ff360edfe4c9223e5dc2924dc41637b717fc4cfdf44d71
MD5 ef12e1b5f7837c4a6d9d550811a0300e
BLAKE2b-256 44da212726591ca366ca8bbd9c4e4096c28362601cc114996e76ec52884c102a

See more details on using hashes here.

Supported by

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