Skip to main content

Log dictionaries to file using the MessagePack serialization format.

Project description

mpacklog.py

Build Documentation Coverage Conda version PyPI version

Stream dictionaries to files or over the network using MessagePack in Python.

Installation

From conda-forge

conda install -c conda-forge mpacklog

From PyPI

pip install mpacklog

Usage

Asynchronous API

Add messages to the log using the put function, have them written to file in the separate write coroutine.

import asyncio
import mpacklog

async def main():
    logger = mpacklog.AsyncLogger("output.mpack")
    await asyncio.gather(main_loop(logger), logger.write())

async def main_loop(logger):
    for bar in range(1000):
        await asyncio.sleep(1e-3)
        await logger.put({"foo": bar, "something": "else"})
    await logger.stop()

if __name__ == "__main__":
    asyncio.run(main())

Synchronous API

The synchronous API is similar to the asynchronous API, except it doesn't provide a stop method and the put and write methods are blocking.

import mpacklog

logger = mpacklog.SyncLogger("output.mpack")

for bar in range(1000):
    logger.put({"foo": bar, "something": "else"})

# Flush all messages to the file
logger.write()

Command-line

The mpacklog utility provides commands to manipulate .mpack files.

dump

The dump command writes down a log file to newline-delimited JSON:

mpacklog dump my_log.mpack

list

This commands lists all nested dictionary keys encountered in a log file. Nested keys are separated by slashes / in the output. For instance, if some dictionaries in my_log.mpack contain values at dict["foo"]["bar"] and dict["foo"]["cbs"], the command will produce:

$ mpacklog list my_log.mpack
- foo/bar
- foo/cbs

serve

The serve command watches a log file for updates and serves the last dictionary appended to it over the network. Its argument is either a log file or a directory containing log files. In the second case, the most recent log files in the directory is opened:

$ mpacklog serve /var/log/my_mpack_logs/

You can use mpackview to connect a live plot to the server, or develop your own tool (the server API is quite simple).

See also

  • foxplot: explore and plot time-series data from MessagePack and line-delimited JSON files.
  • jq: manipulate JSON series to add, remove or extend fields.
  • mpacklog.cpp: log dictionaries to MessagePack files in C++.
  • rq: transform from/to MessagePack, JSON, YAML, TOML, etc. For instance mpacklog dump is equivalent to rq -mJ < my_log.mpack.

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

mpacklog-4.0.0.tar.gz (30.7 kB view details)

Uploaded Source

Built Distribution

mpacklog-4.0.0-py3-none-any.whl (18.7 kB view details)

Uploaded Python 3

File details

Details for the file mpacklog-4.0.0.tar.gz.

File metadata

  • Download URL: mpacklog-4.0.0.tar.gz
  • Upload date:
  • Size: 30.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: python-requests/2.31.0

File hashes

Hashes for mpacklog-4.0.0.tar.gz
Algorithm Hash digest
SHA256 00e08f48a04222172480419b9d5be80b597818b87b07d8db152128387d8784d3
MD5 d4e4bcd8386206f77e4e36009c24b4f7
BLAKE2b-256 6e4ee7e119f45279e7646a3369ae8a3719579ba5c5b1728fbf34abf83ecf6132

See more details on using hashes here.

File details

Details for the file mpacklog-4.0.0-py3-none-any.whl.

File metadata

  • Download URL: mpacklog-4.0.0-py3-none-any.whl
  • Upload date:
  • Size: 18.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: python-requests/2.31.0

File hashes

Hashes for mpacklog-4.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 83f4d61fad2c4f986ff59a77bd354058add0df094a4581d0afcd017732b87aa3
MD5 77b4b26c0bbdb6307de648beb865d477
BLAKE2b-256 fbaf698a1a5578c428d573b40f475b474fa782536fb280007649cad7fc5cc94c

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page