Skip to main content

Visualize metrics as text in real-time (sparklines)

Project description


Sparcli is a library for visualising metrics on the command line.

Use this library to see the shape of data during execution of data pipelines, simulators and other long-running programs. Each metric is displayed as a sparkline that updates as the data changes. Sparcli is thread-safe and non-blocking.

Build Publish Canary build


Sparcli is available on pypi:

pip install sparcli

You can wrap an iterable that produces scalars:

import sparcli, time

for y in sparcli.gen(ys, name="y"):

You can produce metrics using a context manager:

with sparcli.ctx() as ctx:
    for a, b in do_something_else():
        ctx.record(a=a, b=b)

You can also manage the context manually. Just don't forget to close it:

class MyMetricsPlugin:
    def start(self):
        self.ctx = sparcli.context()

    def callback(self, metrics: Dict[str, Real]):

    def stop(self):



pip install --user py-make poetry
poetry install
pymake all
poetry run python

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

sparcli-0.1.3.tar.gz (11.6 kB view hashes)

Uploaded source

Built Distribution

sparcli-0.1.3-py3-none-any.whl (11.8 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page