Skip to main content

A progress bar for Python that brews beer while your code runs

Project description

🍺 brewbar

A progress bar for Python that brews beer while your code runs

No configuration | No dependencies | Just beer


🍻 Demo

from brewbar import bar
import time

for _ in bar(range(50)):
    time.sleep(0.05)

Output:

🍺🍺🍺🍺░░░░  50%  fermenting

brewbar demo

As progress increases, the beer fills and the brew stage changes:

  • mashing
  • boiling
  • fermenting
  • conditioning
  • cheers 🍻

📦 Installation

pip install brewbar

🍺 Usage

from brewbar import bar
import time

for _ in bar(range(100)):
    time.sleep(0.1)

✨ Features

  • 🍺 Beer-brewing themed progress bar
  • 🧠 Simple API (bar(iterable))
  • ⚡ Lightweight (no dependencies)
  • 🖥 Works in standard terminals
  • 🎭 Meme-friendly, screenshot-ready

🛠 Requirements

  • Python 3.8+

❓ Why brewbar?

Because sometimes you don't want:

  • 20 configuration options
  • nested progress bars
  • noisy output

You just want to know when your code is done…
and have a beer while waiting. 🍻

⏱ Timing Metrics (v1.1.0)

brewbar can optionally show:

  • ETA (estimated time remaining)
  • Elapsed runtime
  • Processing speed (items/sec)
  • ASCII fallback for CI / logs
  • Disable output entirely (disable=True)
  • Write to a different stream (file=sys.stderr)
from brewbar import bar
import time

for _ in bar(
    range(200),
    eta=True,
    elapsed=True,
    rate=True,
    ascii=True,
):
    time.sleep(0.05)

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

brewbar-1.1.1.tar.gz (402.2 kB view details)

Uploaded Source

Built Distribution

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

brewbar-1.1.1-py3-none-any.whl (4.2 kB view details)

Uploaded Python 3

File details

Details for the file brewbar-1.1.1.tar.gz.

File metadata

  • Download URL: brewbar-1.1.1.tar.gz
  • Upload date:
  • Size: 402.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.10.19

File hashes

Hashes for brewbar-1.1.1.tar.gz
Algorithm Hash digest
SHA256 c9e15e24d5d0bce932a0f8d2ddcf9839e986816955f51fe61151abeea5d8d3e0
MD5 c82d4a2a57a2e839de668c0359bc7348
BLAKE2b-256 07dd5652bdbddd8398364534bb37953c09ad2e29d398e4d3a564b0faefcf7eab

See more details on using hashes here.

File details

Details for the file brewbar-1.1.1-py3-none-any.whl.

File metadata

  • Download URL: brewbar-1.1.1-py3-none-any.whl
  • Upload date:
  • Size: 4.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.10.19

File hashes

Hashes for brewbar-1.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 8dd9f1beca227a41856dad45aca469427a68d1e1c41de6b06af34b5ea2059a16
MD5 7ef42d85ad234635d783709c4d02c057
BLAKE2b-256 47f50443dea804bb06afb6c2a4d2ca7bd4baa1aa1d7c7f669d45c134f8d9e826

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