Skip to content
/ xbmini-py Public
generated from sco1/py-template

Python Toolkit for the GCDC HAM

License

Notifications You must be signed in to change notification settings

sco1/xbmini-py

Repository files navigation

xbmini-py

PyPI - Python Version PyPI PyPI - License pre-commit.ci status

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