{"id":14959585,"url":"https://github.com/wirg/stqdm","last_synced_at":"2025-05-15T06:05:51.548Z","repository":{"id":37202902,"uuid":"316936210","full_name":"Wirg/stqdm","owner":"Wirg","description":"stqdm is the simplest way to handle a progress bar in streamlit app.","archived":false,"fork":false,"pushed_at":"2025-01-02T01:18:44.000Z","size":719,"stargazers_count":270,"open_issues_count":8,"forks_count":4,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-05-15T06:05:02.439Z","etag":null,"topics":["eta","progress","progressbar","progressmeter","streamlit","tqdm"],"latest_commit_sha":null,"homepage":"https://github.com/Wirg/stqdm","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Wirg.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-11-29T11:29:36.000Z","updated_at":"2025-05-07T01:33:29.000Z","dependencies_parsed_at":"2023-12-31T07:21:17.146Z","dependency_job_id":"8ecb10ec-631e-41fe-8ab4-7797eafc3624","html_url":"https://github.com/Wirg/stqdm","commit_stats":{"total_commits":131,"total_committers":4,"mean_commits":32.75,"dds":"0.23664122137404575","last_synced_commit":"3062b6b00802f171be1919aa2baa8bf098049b66"},"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Wirg%2Fstqdm","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Wirg%2Fstqdm/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Wirg%2Fstqdm/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Wirg%2Fstqdm/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Wirg","download_url":"https://codeload.github.com/Wirg/stqdm/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254283339,"owners_count":22045140,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["eta","progress","progressbar","progressmeter","streamlit","tqdm"],"created_at":"2024-09-24T13:20:05.163Z","updated_at":"2025-05-15T06:05:46.537Z","avatar_url":"https://github.com/Wirg.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# stqdm\n![Tests](https://github.com/Wirg/stqdm/workflows/Tests/badge.svg)\n[![codecov](https://codecov.io/gh/Wirg/stqdm/branch/main/graph/badge.svg?token=YeHnzpfMty)](https://codecov.io/gh/Wirg/stqdm)\n[![CodeQL](https://github.com/Wirg/stqdm/actions/workflows/codeql-analysis.yml/badge.svg)](https://github.com/Wirg/stqdm/actions/workflows/codeql-analysis.yml)\n[![Downloads](https://static.pepy.tech/personalized-badge/stqdm?period=month\u0026units=international_system\u0026left_color=grey\u0026right_color=brightgreen\u0026left_text=downloads/month)](https://pepy.tech/project/stqdm)\n![Supported Python Versions](https://img.shields.io/pypi/pyversions/stqdm)\n![pypi version](https://img.shields.io/pypi/v/stqdm)\n\nstqdm is the simplest way to handle a progress bar in streamlit app.\n\n![demo gif](https://raw.githubusercontent.com/Wirg/stqdm/main/assets/demo.gif)\n\n## How to install\n\n```sh\npip install stqdm\n```\n\n## How to use\n\nYou can find some examples in `examples/`\n\n### Use stqdm in main\n```python\nfrom time import sleep\nfrom stqdm import stqdm\n\nfor _ in stqdm(range(50)):\n    sleep(0.5)\n```\n\n### Use stqdm in sidebar\n```python\nfrom time import sleep\nimport streamlit as st\nfrom stqdm import stqdm\n\nfor _ in stqdm(range(50), st_container=st.sidebar):\n    sleep(0.5)\n```\n\n### Customize the bar with tqdm parameters\n\n![demo gif](https://raw.githubusercontent.com/Wirg/stqdm/main/assets/demo_with_custom_params.gif)\n\n```python\nfrom time import sleep\nfrom stqdm import stqdm\n\nfor _ in stqdm(range(50), desc=\"This is a slow task\", mininterval=1):\n    sleep(0.5)\n```\n\n### Display a progress bar during pandas Dataframe \u0026 Series operations\nSTqdm inherits from tqdm, you can call stqdm.pandas() in a similar way. See [tqdm docs](https://github.com/tqdm/tqdm#pandas-integration).\n```python\nfrom time import sleep\n\nimport pandas as pd\nfrom stqdm import stqdm\n\nstqdm.pandas()\n\npd.Series(range(50)).progress_map(lambda x: sleep(1))\npd.Dataframe({\"a\": range(50)}).progress_apply(lambda x: sleep(1), axis=1)\n```\n\n### Display the progress bar only in the frontend or the backend\n\n```python\nfrom time import sleep\n\nfrom stqdm import stqdm\n\n# Default to frontend only\nfor i in stqdm(range(50), backend=False, frontend=True):\n    sleep(0.5)\n\n\nfor i in stqdm(range(50), backend=True, frontend=False):\n    sleep(0.5)\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwirg%2Fstqdm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwirg%2Fstqdm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwirg%2Fstqdm/lists"}