xbmini-py 0.4.0

Python Toolkit for the GCDC HAM

xbmini-py

Python Toolkit for the GCDC HAM

Known Firmware Compatibility

This package is currently tested against firmware versions 1379, 2108, and 2570, compatibility with other firmware versions is not guaranteed.

Installation

Install from PyPi with your favorite pip invocation:

$ pip install xbmini-py

You can confirm proper installation via the xbmini CLI:

$ xbmini --help
Usage: xbmini [OPTIONS] COMMAND [ARGS]...

Options:
  --help  Show this message and exit.

Commands:
  merge  Combine multiple log sessions.
  trim   XBMini log trimming.

CLI Usage

xbmini merge batch

Batch combine XBM files for each logger and dump a serialized XBMLog instance to a CSV in its respective logger's directory.

Input Parameters

Parameter	Description	Type	Default
--top-dir	Path to top-level log directory to search.1	Path|None	GUI Prompt
--log-pattern	XBMini log file glob pattern.2	str	"*.CSV"
--dry-run	Show processing pipeline without processing any files.	bool	False
--skip-strs	Skip files containing any of the provided substrings.	list[str]	["processed", "trimmed", "combined"]

1. Log searching will be executed recursively starting from the top directory
2. Case sensitivity is deferred to the host OS