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.0.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.0-py3-none-any.whl (4.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: brewbar-1.1.0.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.0.tar.gz
Algorithm Hash digest
SHA256 20ae05fbe2792514b7938e57a3ed76b338a77c1151d53ffbece794ca18eb0f99
MD5 a5795ee04acafe9509502d1dd55ab13d
BLAKE2b-256 c23a5c38566a18521ef930ab61be7c97f813719d922628b18fd75dc8b898de29

See more details on using hashes here.

File details

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

File metadata

  • Download URL: brewbar-1.1.0-py3-none-any.whl
  • Upload date:
  • Size: 4.1 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.0-py3-none-any.whl
Algorithm Hash digest
SHA256 e3d550636821011a42d0afb3a86638293986ea0c8aa60a48e4a6d868743903a5
MD5 026860a170060ac4671fc16be9929088
BLAKE2b-256 6f3af84123de611df283e9026f06d2296402a5cb416702fd19cbfd5e8a40b8c3

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