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.6.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.6-py3-none-any.whl (6.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: progressorx-0.0.6.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.6.tar.gz
Algorithm Hash digest
SHA256 26a6e2bbeb07050cca523f6606b40bc2e908b4a440c81c20052d43bf48d3ce61
MD5 d6390873aac7a84227088ff7357372bd
BLAKE2b-256 f184cf7167157692ca52457051748c5f76959dcf34355d6ac23094e580370a40

See more details on using hashes here.

File details

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

File metadata

  • Download URL: progressorx-0.0.6-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.6-py3-none-any.whl
Algorithm Hash digest
SHA256 2154a93e7bccc1e0ec5bd94a88969bb22f620d4df387860e2604d44d09b106d7
MD5 27d42a16285e73791b5451d679506206
BLAKE2b-256 17089a62fdc3f5f439a9c9924ca675f42e34f70026ae2234fbc8e3c90b85189e

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