smartbar 1.0.4

Smartbar

SmartBar

SmartBar is a powerful, automatic, and extensible progress bar library for Python, built with smart I/O tracking and multi-threading support.
It provides real-time progress, ETA, speed tracking, and works seamlessly with file and network I/O using with blocks — no manual .update() needed.

Features

• Thread-safe and concurrent
• Supports multiple bars simultaneously
• Automatically wraps open() and requests.get() to track progress
• Works with both reading and writing
• Smart ETA and speed calculation
• Custom bar styles and position control
• Pause, resume and ignore support
• Friendly with context manager usage

Installation

pip install smartbar

Example Usages

from smartbar import SmartBar
import requests

with SmartBar("Downloading", length=40) as bar:
    r = requests.get("https://example.com/file", stream=True)
    for chunk in r.iter_content(1024):
        pass  # progress auto-tracked

from smartbar import SmartBar
import requests
import time

BAR1 = f"%(DESC). \033[48;5;214m[%(BAR)]\033[0m %(CUR)/%(TOTAL) (%(PERCENT)%) | %(SPEED) | ETA: %(ETA)"
BAR2 = f"%(DESC).. \033[48;5;214m[%(BAR)]\033[0m %(CUR)/%(TOTAL) (%(PERCENT)%) | %(SPEED) | ETA: %(ETA)"
BAR3 = f"%(DESC)... \033[48;5;214m[%(BAR)]\033[0m %(CUR)/%(TOTAL) (%(PERCENT)%) | %(SPEED) | ETA: %(ETA)" 

url = "https://download.samplelib.com/mp4/sample-20s.mp4"

with SmartBar("Downloading", custom_bar_output=BAR1) as bar:
    response = requests.get(url, stream=True)
    with open("video.mp4", "wb") as f:
        stime = time.time()
        for chunk in response.iter_content(chunk_size=8192):
            if chunk:
                f.write(chunk)
            if time.time() - stime > 1:
                if bar.custom_bar_output == BAR1:
                    bar.custom_bar_output = BAR2
                elif bar.custom_bar_output == BAR2:
                    bar.custom_bar_output = BAR3
                else:
                    bar.custom_bar_output = BAR1
                stime = time.time()

Disable auto-track

import time

BAR1 = "%(DESC). {} SEC \033[48;5;214m[%(BAR)]\033[0m %(CUR)/%(TOTAL) (%(PERCENT)%) | %(SPEED) | ETA: %(ETA)"
BAR2 = "%(DESC).. {} SEC \033[48;5;214m[%(BAR)]\033[0m %(CUR)/%(TOTAL) (%(PERCENT)%) | %(SPEED) | ETA: %(ETA)"
BAR3 = "%(DESC)... {} SEC \033[48;5;214m[%(BAR)]\033[0m %(CUR)/%(TOTAL) (%(PERCENT)%) | %(SPEED) | ETA: %(ETA)" 

SEC = 10

with SmartBar("Waiting", auto_bar=False, mode="items") as bar: # Manuel bar
    STIME = time.time()
    ctime = time.time()
    bar.total = SEC
    while True:
        if time.time() - ctime > 1:
            if bar.custom_bar_output == BAR1:
                bar.custom_bar_output = BAR2.format(max(0, abs(int(time.time() - STIME) - 10)))
            elif bar.custom_bar_output == BAR2:
                bar.custom_bar_output = BAR3.format(max(0, abs(int(time.time() - STIME) - 10)))
            else:
                bar.custom_bar_output = BAR1.format(max(0, abs(int(time.time() - STIME) - 10)))
            bar.add(time.time() - ctime)
            ctime = time.time()
            

Pause, Resume & Ignore

bar.pause()
# some time later...
bar.resume()

bar.ignore(r)  # disables tracking for a specific response or file

Author

lama2923
GitHub: https://github.com/lama2923

License

This project is licensed under the MIT License.