adi_parser

This is a simple utility package, originally to parse .adi files from LoTW, but now from anywhere.

By default, adi_parser parses LoTW .adi arguments. You can optionally parse all arguments as a python dictionary.

Examples

Parsing in LoTW .adi format

from adi_parser import parse_adi

adi_header, qso_reports = parse_adi("path/to/your_data.adi")

Where adi_header: Header and qso_reports: list[QSOReport]. These are dataclasses, which are defined in adi_parser.dataclasses.

All dataclass values are assumed to be missing by default.

Both GRIDSQUARE and MY_GRIDSQUARE are converted to lat/lat with maidenhead.

Parsing all arguments from a .adi

from adi_parser import parse_adi

result = parse_adi("path/to/your_data.adi", return_type=dict)

Where the result dictionary follows this format:

result = {
    "header": {
        "full_text": str,
        "argument_1": str,
        "argument_2": str,
        ...
    },
    "qso_reports": [
        {
            "full_text": str,
            "argument_1": {
                "value": str,
                "length": int,
                "type": str | None,
                "comment": str | None,
            },
            "argument_2": {
                ...
            },
            ...
        },
        ...
    ]
}