Skip to main content

qso-graph-lib

PyPI Python License: GPL v3

The code QSO Graph's Python packages share, in one place, so it is written and tested once. Standard library only: no dependencies.

What's in it

Module What
qso_graph_lib.jt.protocol WSJT-X's UDP messages, encoded and decoded: Heartbeat, Status, Decode, WSPRDecode, Clear, Close, Replay and the rest, schema 3, written to WSJT-X's own Network/NetworkMessage.hpp. That is the JT family's protocol: any program that speaks it (JTDX, MSHV, WSJT-X Improved) is read the same way
qso_graph_lib.jt.alltxt WSJT-X's ALL.TXT, the log of every decode, read into cycles

Used by qso-graph-sim and jt-mcp.

Install

uv add qso-graph-lib

Or pip install qso-graph-lib. It has no command of its own; it is imported.

Example

from qso_graph_lib.jt import protocol

message = protocol.parse(datagram)          # ValueError if it isn't a WSJT-X message
if message.kind == protocol.MessageType.DECODE:
    print(message.sender, message.fields["snr"], message.fields["message"])

Unknown message types, and fields past the ones it knows, are ignored, as WSJT-X's protocol requires. A message cut short inside a field it needs is refused.

Development

git clone https://github.com/qso-graph/qso-graph-lib.git
cd qso-graph-lib
uv sync --group dev
uv run pytest

Part of QSO-Graph

This package is part of qso-graph, tools for amateur radio. See qso-graph.io for documentation.

License

GPLv3

Metadata

Release files for qso-graph-lib 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for qso-graph-lib 0.1.0
File Size Uploaded Provenance Actions
qso_graph_lib-0.1.0.tar.gz 60.2 kB With provenance Details for qso_graph_lib-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for qso-graph-lib 0.1.0
File Interpreter ABI Platform Actions
qso_graph_lib-0.1.0-py3-none-any.whl Python 3 none any Details for qso_graph_lib-0.1.0-py3-none-any.whl

Total release size: 82.4 kB

Release files / qso_graph_lib-0.1.0.tar.gz

Download URL qso_graph_lib-0.1.0.tar.gz
Size 60.2 kB
Tags Source
SHA-256 checksum
How to use checksums
c3fcbe2c13f893e0d9613a02aba665509004f6720b83622b294fc1d5d0c3ed31
BLAKE2b-256 checksum
How to use checksums
6fe7d81d8048e55280fb2a52d8fe78c265836e92121853df6a4e544d7333f56a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 29, 2026.

Transparency log

Release files / qso_graph_lib-0.1.0-py3-none-any.whl

Download URL qso_graph_lib-0.1.0-py3-none-any.whl
Size 22.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
aa3cf3543c17fef8eec552948e4c948b7c49b234c4341862f78f526f22d5b3d7
BLAKE2b-256 checksum
How to use checksums
29e0b6526a9d271dd910b4f739f2d9a20c3099a0cc0af49449cae61499231009
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 29, 2026.

Transparency log

Security for qso-graph-lib 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for qso_graph_lib-0.1.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 29, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page