Skip to main content

Python Toolkit for the GCDC HAM

Project description

xbmini-py

PyPI - Python Version PyPI PyPI - License pre-commit.ci status Code style: black

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:
  batch-combine  Batch combine XBM files for each logger and dump a...
  dash           Dash UI launchers

CLI Usage

xbmini batch-combine

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

xbmini dash

A series of helper UIs are provided by Dash. Running the CLI commands will start a local server for the user to interact with.

WARNING: These apps are intended for use on a development server only. Do not use them in a production environment.

A list of available UIs can be accessed via the command line:

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

  Dash UI launchers

Options:
  --help  Show this message and exit.

Commands:
  trim  Helper UI for trimming serialized XBMLog CSVs.

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

xbmini_py-0.3.0.tar.gz (16.9 kB view hashes)

Uploaded Source

Built Distribution

xbmini_py-0.3.0-py3-none-any.whl (17.8 kB view hashes)

Uploaded Python 3

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