Skip to main content
Join the official 2020 Python Developers SurveyStart the survey!

an empirical progress library

Project description

docbrown

docbrown is an empirical progress library. It determines the overall duration and progression of a process by looking at the time it took in the past.

docbrown might be an option for you, if you have one long running task which parts take very different amounts of time. It is also helpful when used in environments where you can’t inform consumers about the progress of a task out-of-band (like a WSGI request/response cycle vs a WebSocket).

Installation

pip install docbrown

This repository allows you to create a deb Package for Debian and derivatives if you’re into that kind of thing. Just run make dist-deb.

Example Usage

Record progress:

import time
from docbrown import record_progress

with record_progress('process_name', ident='my_ident') as record:
    # ident normally is random and unique, but you can override it with
    # your own id. Just make sure it is not used more than once at a time.
    print(record.ident)
    # do some stuff that takes time
    record('loading_data')
    time.sleep(4)
    record('calculating_matrices')
    time.sleep(9)
    record('rendering_structures')
    time.sleep(23)
    record('uploading_models')
    time.sleep(15)

As docbrown determines progression by looking at the past every process needs to run at least once before get_progress can return any meaningful data. This is why get_progress will just return None on the first run of the code above.

Get the progression of our process:

from docbrown import get_progress
print(get_progress('my_ident'))

Future

There are some things that would be nice, but have not been implemented yet.

  • additional storage backends apart from SQLite
  • code path detection that takes optional phases into account and updates the expected duration and progress on-the-fly

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for docbrown, version 0.5.0
Filename, size File type Python version Upload date Hashes
Filename, size docbrown-0.5.0.tar.gz (18.6 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page