Metadata-Version: 2.4
Name: quelware-tools
Version: 0.1.3
Summary: Command-line tools and diagnostics for QuEL systems.
Project-URL: Repository, https://github.com/quel-inc/quelware-client
Project-URL: Documentation, https://quel-inc.github.io/quelware-client/
Project-URL: Changelog, https://github.com/quel-inc/quelware-client/blob/main/quelware-tools/CHANGELOG.md
Author-email: quelware Authors <opensource@quel-inc.com>
License-Expression: Apache-2.0
License-File: LICENSE
Requires-Python: >=3.10
Requires-Dist: numpy
Requires-Dist: quelware-client>=0.5.0
Requires-Dist: typer>=0.21.1
Provides-Extra: plot
Requires-Dist: matplotlib; extra == 'plot'
Description-Content-Type: text/markdown

# quelware-tools

Command-line tools and diagnostics for QuEL systems, built on `quelware-client`.

They run against an already-running manager + edge server (endpoint + PAT); they
start nothing themselves.

## Commands

- `quel-tone-test` — per-port tone test: put the unit's monitor into loopback,
  emit a tone on every tx/trx port, and check it appears in the monitor capture.
  A post-update health check. Exits non-zero if any port fails.
- `quel-measure-delay` — per-port path delay: put the monitor into loopback and,
  one tx/trx port at a time, emit a pulse while capturing from t=0 and time its
  arrival. With `--verify`, deskew all ports onto a common pulse comb, emit them
  together, and check each pulse lands where intended. Needs an admin PAT and an
  idle unit.
- `quel-unit-config` — `show` / `set` a unit's configuration controls.
  `set` needs an admin PAT and an idle unit.
- `quel-echo-test` — emit a pulse on a TRX port and capture the echoed response
  (optionally plotting the I/Q trace; install with the `plot` extra).

## Install

```
pip install quelware-tools          # tools only
pip install "quelware-tools[plot]"  # + matplotlib for quel-echo-test plots
```
