gedcom7

Read and write GEDCOM 7 files in Python — a format for exchanging genealogical data between family history applications.

Background

Reading and writing are both based on regular expressions generated directly from the ABNF grammar via abnf-to-regexp, and on the structure and payload tables extracted from the specification. The library targets FamilySearch GEDCOM 7.0.18: it does not attempt to parse files that are not standards compliant, and raises rather than writing malformed lines.

Installation

python -m pip install gedcom7

Usage

import gedcom7

with open("my_gedcom.ged", "rb") as f:
    records = gedcom7.load(f)

with open("out.ged", "wb") as f:
    gedcom7.dump(records, f)

Each record is a GedcomStructure with a tag, an optional xref and pointer, the raw text payload, and children. Its value property casts the payload to the data type the specification gives that structure type.

loads and dumps are the string equivalents. Non-conforming input raises GedcomParseError, a ValueError carrying line_number.

Development

python -m pip install --group dev --editable .
pytest && mypy && ruff check . && ruff format --check .

The version is derived from git tags by setuptools-scm. To release, push a vX.Y.Z tag and publish a GitHub release for it.

Credits

Inspiration was drawn from the Javascript parser.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

gedcom7-1.0.0.tar.gz (40.2 kB view details)

Uploaded Aug 12, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

gedcom7-1.0.0-py3-none-any.whl (21.6 kB view details)

Uploaded Aug 12, 2026 Python 3

File details

Details for the file gedcom7-1.0.0.tar.gz.

File metadata

Download URL: gedcom7-1.0.0.tar.gz
Upload date: Aug 12, 2026
Size: 40.2 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for gedcom7-1.0.0.tar.gz
Algorithm	Hash digest
SHA256	`f5de714b4f3a1fbf2a79517caeb355e5086656fa3841ad95415eb00d8f3f4cbf`
MD5	`6ad617a8be87a2536f323fd93bc94805`
BLAKE2b-256	`dce8a4edc8f7c5e36cfec107392c10111e856c6346d19b864174eec2a8328e83`

See more details on using hashes here.

Provenance

The following attestation bundles were made for gedcom7-1.0.0.tar.gz:

Publisher: pypi.yml on DavidMStraub/python-gedcom7

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: gedcom7-1.0.0.tar.gz
- Subject digest: f5de714b4f3a1fbf2a79517caeb355e5086656fa3841ad95415eb00d8f3f4cbf
- Sigstore transparency entry: 2440214475
- Sigstore integration time: Aug 12, 2026
Source repository:
- Permalink: DavidMStraub/python-gedcom7@695b1006ea1fef493f32cc21af0187ef16a35147
- Branch / Tag: refs/tags/v1.0.0
- Owner: https://github.com/DavidMStraub
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: pypi.yml@695b1006ea1fef493f32cc21af0187ef16a35147
- Trigger Event: release