whisper

library1.1.10pypypi✓ verified 80d ago

Whisper is a fixed-size round-robin database library for storing time-series data, originally part of Graphite. The current version is 1.1.10, with irregular releases tied to the Graphite project. It provides a simple, file-based storage format for numeric data at fixed intervals.

database observability

pip install whisper

package ↗homepage ↗

INSTALL

IMPORT

SIG · WHISPER

whisper

databasepythonv1.1.10

Install

2.5s avg

Import

—

Disk

17MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v1.1.10 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.000s · 19.3MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 2.5s · import 0.000s · 20MB

17MB installed

● package 17MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

WhisperException

✓ from whisper import WhisperException

✗ from whisper import WhisperDB

aggregate

✓ from whisper import aggregate

CorruptWhisperFile

✓ from whisper import CorruptWhisperFile

Creates a new whisper database, updates it with a data point, and fetches the data.

from whisper import create, update, fetch import time # Create a whisper database with 1 hour of 1-minute archives path = '/tmp/test.wsp' create(path, [(1, 60)]) # 1 second precision, 60 points # Update with a value now = int(time.time()) update(path, now, 42.0) # Fetch data (fetch_info, data) = fetch(path, now - 60, now) print(data)

whisper-create --version

Debug

Known issues

gotchaWhisper uses fixed-size archives. If you specify too few retention points, old data is silently overwritten (round-robin behavior). There is no warning.

fix

Plan archive sizes carefully to avoid losing data unexpectedly.

affects: all

gotchaTimestamps must be integers (Unix timestamps). Passing a float or datetime object will raise a TypeError or produce incorrect results.

fix

Always convert to int: `int(time.time())`.

affects: all

deprecatedThe `whisper.py` script (command-line tool) is not actively maintained and may have bugs. Use programmatic API instead.

fix

Use Python API (e.g., `from whisper import ...`) instead of shelling out.

affects: 1.1.x

Upgrade

Version history

1.1.10latest on PyPI · released May 22, 2022

Audit

Dependencies

No dependency data recorded yet.

Agent activity

85 hits · last 30 days

node

OpenAI (training)

Resources

packagehttps://pypi.org/project/whisper/ ↗

homepagehttp://graphiteapp.org/ ↗