Skip to main content

tqdmio

tqdmio is a tiny IO wrapper for tqdm. Use it to wrap any IO object tqdmio(open(path)) to display a progress bar while reading or writing files.

Use the convenience function tqdmio.open(path) to open a file with a progress bar. When reading files, it will automatically detect the file size using pathlib.Path.stat().st_size.

By default, the progress will be shown in kb/s, Mb/s, Gb/s, etc.

You can customize the progress bar by passing tqdm arguments to the tqdmio constructor.

When wrapping compressed files, use tqdmio.open(file, "rb") or wrap the raw IO[bytes] using tqdmio(open(file, "rb")) and pass it to the reader, e.g.:

import gzip
from tqdmio import tqdmio

with tqdmio.open("file.txt", "rt") as fp:
    for line in fp:
        pass

with tqdmio.open("file.gz", "rb") as fgz:
    for line in gzip.open(fgz, "rt"):
        pass

Metadata

Release files for tqdmio 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for tqdmio 0.1.0
File Size Uploaded
tqdmio-0.1.0.tar.gz 42.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for tqdmio 0.1.0
File Interpreter ABI Platform
tqdmio-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 47.1 kB

Release files / tqdmio-0.1.0.tar.gz

Download URL tqdmio-0.1.0.tar.gz
Size 42.5 kB
Tags Source
SHA-256 checksum
How to use checksums
8ea0fa0e5b374e86cd735893a5d7ac5cacb3ae7f27807975f4c91faee04b9434
BLAKE2b-256 checksum
How to use checksums
0b6df0fd09c6a6b9e00c91ef996ff187c88c641f57a8df909f4292df879a1e8e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.0.1 CPython/3.13.2

Release files / tqdmio-0.1.0-py3-none-any.whl

Download URL tqdmio-0.1.0-py3-none-any.whl
Size 4.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
6c7d12d2fd321c0277903e4d268a24084805205fac33694fa36e6f494f1e2cb4
BLAKE2b-256 checksum
How to use checksums
1973a824e60cfa99d670408232af59328a291d99126f8b575a4cef6b324177c3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.0.1 CPython/3.13.2

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page