Skip to main content

Lightweight task progress tracking with pluggable storage backends

Project description

progressorx

progressor — lightweight progress-tracking package for long-running tasks.

Features:

  • report_progress(task_id, progress=None, increase=None) — set or increment progress (0..100).
  • get_progress(task_id) — get current progress and status.
  • Pluggable backends: InMemory, Redis, SQLAlchemy (SQLite/Postgres).
  • Thread/process/distributed safe when using a proper backend (Redis/SQL).

Quick example

from progressorx import ProgressManager
from progressorx.backends.memory import InMemoryStore


store = InMemoryStore()
mgr = ProgressManager(store)


mgr.report_progress('task-1', progress=10)
mgr.report_progress('task-1', increase=5)
print(mgr.get_progress('task-1')) # {'task_id': 'task-1', 'progress': 15, 'status': 'in_progress'}

See examples/fastapi_example.py for how to integrate with FastAPI.

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

progressorx-0.0.4.tar.gz (41.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

progressorx-0.0.4-py3-none-any.whl (6.0 kB view details)

Uploaded Python 3

File details

Details for the file progressorx-0.0.4.tar.gz.

File metadata

  • Download URL: progressorx-0.0.4.tar.gz
  • Upload date:
  • Size: 41.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.7

File hashes

Hashes for progressorx-0.0.4.tar.gz
Algorithm Hash digest
SHA256 1556f0f449dda006d36e5d466b9656e97f1dd022e5dcdad20652b9ec67f8cd70
MD5 6ef62b7b99039dc98abf7eef7a52970a
BLAKE2b-256 e6c962749d6f283d4a5a8aebc090d1ce72986f134c2d27e7ab2a07febd989a0f

See more details on using hashes here.

File details

Details for the file progressorx-0.0.4-py3-none-any.whl.

File metadata

  • Download URL: progressorx-0.0.4-py3-none-any.whl
  • Upload date:
  • Size: 6.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.7

File hashes

Hashes for progressorx-0.0.4-py3-none-any.whl
Algorithm Hash digest
SHA256 05c577ceae9415beb078ebb328f0305376d71dbe35afb51200a705282114023c
MD5 5ae063f3c98f63a25d445ef3a5a93d66
BLAKE2b-256 82221270259924650dbf0d8476b8086798782bc675630d9058391d2efeacda69

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