Skip to main content

Easy progress bar for streamlit based on the awesome streamlit.progress and tqdm

Project description

stqdm

Tests codecov CodeQL

stqdm is the simplest way to handle a progress bar in streamlit app.

demo gif

How to install

pip install stqdm

How to use

You can find some examples in examples/

Use stqdm in main

from time import sleep
from stqdm import stqdm

for _ in stqdm(range(50)):
    sleep(0.5)

Use stqdm in sidebar

from time import sleep
import streamlit as st
from stqdm import stqdm

for _ in stqdm(range(50), st_container=st.sidebar):
    sleep(0.5)

Customize the bar with tqdm parameters

demo gif

from time import sleep
from stqdm import stqdm

for _ in stqdm(range(50), desc="This is a slow task", mininterval=1):
    sleep(0.5)

Display a progress bar during pandas Dataframe & Series operations

STqdm inherits from tqdm, you can call stqdm.pandas() in a similar way. See tqdm docs.

from time import sleep

import pandas as pd
from stqdm import stqdm

stqdm.pandas()

pd.Series(range(50)).progress_map(lambda x: sleep(1))
pd.Dataframe({"a": range(50)}).progress_apply(lambda x: sleep(1), axis=1)

Display the progress bar only in the frontend or the backend

from time import sleep

from stqdm import stqdm

# Default to frontend only
for i in stqdm(range(50), backend=False, frontend=True):
    sleep(0.5)


for i in stqdm(range(50), backend=True, frontend=False):
    sleep(0.5)

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

stqdm-0.0.5.tar.gz (7.4 kB view details)

Uploaded Source

Built Distribution

stqdm-0.0.5-py3-none-any.whl (11.1 kB view details)

Uploaded Python 3

File details

Details for the file stqdm-0.0.5.tar.gz.

File metadata

  • Download URL: stqdm-0.0.5.tar.gz
  • Upload date:
  • Size: 7.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.3.1 CPython/3.10.6 Linux/5.15.0-1024-azure

File hashes

Hashes for stqdm-0.0.5.tar.gz
Algorithm Hash digest
SHA256 1bed78e60068da3afc7c6d87a5388006036633aa2fe2e19fa7db46483ef1227e
MD5 25ffbbda9e698d3fe36d43c04c3c500c
BLAKE2b-256 6bf4770b463dd67fb3bd0204bd3d35423c838e58a5f78f97bf98730b9b1cb991

See more details on using hashes here.

File details

Details for the file stqdm-0.0.5-py3-none-any.whl.

File metadata

  • Download URL: stqdm-0.0.5-py3-none-any.whl
  • Upload date:
  • Size: 11.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.3.1 CPython/3.10.6 Linux/5.15.0-1024-azure

File hashes

Hashes for stqdm-0.0.5-py3-none-any.whl
Algorithm Hash digest
SHA256 3177858c1ce5244821f13cc7cbd88a6dc8f154ef1bd12d2fa3342f2a9caf8843
MD5 48d5104823c064fb5d4c57e3e0b7246c
BLAKE2b-256 08e363cf2a221dc4c5894c2e42a7916ddcde8e5846f9551c2e9ed83024934fa3

See more details on using hashes here.

Supported by

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