Crate astrogram 

astrogram

Astrology data-format conversion library.

astrogram reduces transcription errors when moving chart data between astrology platforms. It reads structured chart exports from one platform and writes them in the format expected by another, removing the manual copy-paste step where mistakes happen.

Supported formats

• Read: Solar Fire .SFcht binary, Astrodatabank XML, AAF (Astrolog Ascii Format), Zeus .zdb.
• Write: Solar Fire .SFcht binary, Astrodatabank XML, Zeus .zdb.
• Extract (authenticated web): lunaastrology.com, astro.com.

Deferred formats (Quick*Chart, Solar Fire text export, JZOD, Nechepso, TimeCycles, SQL/SQLite) and additional extractors are tracked in docs/backlog.md at the repository root.

Canonical chart type

chart::Chart is the in-memory representation every reader produces and every writer consumes. Sign-convention mismatches between formats (Solar Fire’s +West longitude vs. ISO 6709’s +East, etc.) are resolved at the format boundary — never inside Chart.

Format specifications

Authoritative format docs and a Kaitai Struct definition for .SFcht are in the research/ directory at the repository root (symlinked from the external research archive). Reference Python prototypes live there too; treat them as oracles, not as source material to transliterate.

Modules

aaf

AAF (Astrolog Ascii Format) parser.

adbxml

Astrodatabank XML reader (export_format 160715).

astro

astro.com HTTP API helpers.

chart

Canonical in-memory chart representation.

consolidate

Chart consolidation: merge multiple collections, surfacing duplicate candidates for user decision.

decision_log

Durable per-keystroke log of consolidation decisions.

error

Error types shared across astrogram parsers.

luna

LUNA® Astrology web-application extractor and writer.

normalize

Character-set normalization for cp1252-target string fields.

sfcht

Solar Fire .SFcht binary chart-collection format.

util

Timestamp and calendar utilities.

zeus

Zeus .zdb chart-database text format.