gedcom-x 0.5.7__py3-none-any.whl → 0.5.9__py3-none-any.whl

gedcomx/gedcom7/g7interop.py

@@ -0,0 +1,205 @@
+from .. import *
+
+g7toX = {
+  "ABBR": "https://gedcom.io/terms/v7/ABBR",
+  "ADDR": "https://gedcom.io/terms/v7/ADDR",
+  "ADOP": "https://gedcom.io/terms/v7/ADOP",
+  "ADOP-FAMC": "https://gedcom.io/terms/v7/ADOP-FAMC",
+  "ADR1": "https://gedcom.io/terms/v7/ADR1",
+  "ADR2": "https://gedcom.io/terms/v7/ADR2",
+  "ADR3": "https://gedcom.io/terms/v7/ADR3",
+  "AGE": "https://gedcom.io/terms/v7/AGE",
+  "AGNC": "https://gedcom.io/terms/v7/AGNC",
+  "ALIA": "https://gedcom.io/terms/v7/ALIA",
+  "ANCI": "https://gedcom.io/terms/v7/ANCI",
+  "ANUL": "https://gedcom.io/terms/v7/ANUL",
+  "ASSO": "https://gedcom.io/terms/v7/ASSO",
+  "AUTH": "https://gedcom.io/terms/v7/AUTH",
+  "BAPL": "https://gedcom.io/terms/v7/BAPL",
+  "BAPM": "https://gedcom.io/terms/v7/BAPM",
+  "BARM": "https://gedcom.io/terms/v7/BARM",
+  "BASM": "https://gedcom.io/terms/v7/BASM",
+  "BIRT": "https://gedcom.io/terms/v7/BIRT",
+  "BLES": "https://gedcom.io/terms/v7/BLES",
+  "BURI": "https://gedcom.io/terms/v7/BURI",
+  "CALN": "https://gedcom.io/terms/v7/CALN",
+  "CAST": "https://gedcom.io/terms/v7/CAST",
+  "CAUS": "https://gedcom.io/terms/v7/CAUS",
+  "CENS": "https://gedcom.io/terms/v7/CENS",
+  "CHAN": "https://gedcom.io/terms/v7/CHAN",
+  "CHIL": "https://gedcom.io/terms/v7/CHIL",
+  "CHR": "https://gedcom.io/terms/v7/CHR",
+  "CHRA": "https://gedcom.io/terms/v7/CHRA",
+  "CITY": "https://gedcom.io/terms/v7/CITY",
+  "CONF": "https://gedcom.io/terms/v7/CONF",
+  "CONL": "https://gedcom.io/terms/v7/CONL",
+  "CONT": "https://gedcom.io/terms/v7/CONT",
+  "COPR": "https://gedcom.io/terms/v7/COPR",
+  "CORP": "https://gedcom.io/terms/v7/CORP",
+  "CREA": "https://gedcom.io/terms/v7/CREA",
+  "CREM": "https://gedcom.io/terms/v7/CREM",
+  "CROP": "https://gedcom.io/terms/v7/CROP",
+  "CTRY": "https://gedcom.io/terms/v7/CTRY",
+  "DATA": "https://gedcom.io/terms/v7/DATA",
+  "DATA-EVEN": "https://gedcom.io/terms/v7/DATA-EVEN",
+  "DATA-EVEN-DATE": "https://gedcom.io/terms/v7/DATA-EVEN-DATE",
+  "DATE": "https://gedcom.io/terms/v7/DATE",
+  "DATE-exact": "https://gedcom.io/terms/v7/DATE-exact",
+  "DEAT": "https://gedcom.io/terms/v7/DEAT",
+  "DESI": "https://gedcom.io/terms/v7/DESI",
+  "DEST": "https://gedcom.io/terms/v7/DEST",
+  "DIV": "https://gedcom.io/terms/v7/DIV",
+  "DIVF": "https://gedcom.io/terms/v7/DIVF",
+  "DSCR": "https://gedcom.io/terms/v7/DSCR",
+  "EDUC": "https://gedcom.io/terms/v7/EDUC",
+  "EMAIL": "https://gedcom.io/terms/v7/EMAIL",
+  "EMIG": "https://gedcom.io/terms/v7/EMIG",
+  "ENDL": "https://gedcom.io/terms/v7/ENDL",
+  "ENGA": "https://gedcom.io/terms/v7/ENGA",
+  "EVEN": "https://gedcom.io/terms/v7/EVEN",
+  "EXID": "https://gedcom.io/terms/v7/EXID",
+  "EXID-TYPE": "https://gedcom.io/terms/v7/EXID-TYPE",
+  "FACT": "https://gedcom.io/terms/v7/FACT",
+  "FAM": "https://gedcom.io/terms/v7/FAM",
+  "FAM-CENS": "https://gedcom.io/terms/v7/FAM-CENS",
+  "FAM-EVEN": "https://gedcom.io/terms/v7/FAM-EVEN",
+  "FAM-FACT": "https://gedcom.io/terms/v7/FAM-FACT",
+  "FAM-HUSB": "https://gedcom.io/terms/v7/FAM-HUSB",
+  "FAM-NCHI": "https://gedcom.io/terms/v7/FAM-NCHI",
+  "FAM-RESI": "https://gedcom.io/terms/v7/FAM-RESI",
+  "FAM-WIFE": "https://gedcom.io/terms/v7/FAM-WIFE",
+  "FAMC": "https://gedcom.io/terms/v7/FAMC",
+  "FAMC-ADOP": "https://gedcom.io/terms/v7/FAMC-ADOP",
+  "FAMC-STAT": "https://gedcom.io/terms/v7/FAMC-STAT",
+  "FAMS": "https://gedcom.io/terms/v7/FAMS",
+  "FAX": "https://gedcom.io/terms/v7/FAX",
+  "FCOM": "https://gedcom.io/terms/v7/FCOM",
+  "FILE": "https://gedcom.io/terms/v7/FILE",
+  "FILE-TRAN": "https://gedcom.io/terms/v7/FILE-TRAN",
+  "FORM": "https://gedcom.io/terms/v7/FORM",
+  "GEDC": "https://gedcom.io/terms/v7/GEDC",
+  "GEDC-VERS": "https://gedcom.io/terms/v7/GEDC-VERS",
+  "GIVN": "https://gedcom.io/terms/v7/GIVN",
+  "GRAD": "https://gedcom.io/terms/v7/GRAD",
+  "HEAD": "https://gedcom.io/terms/v7/HEAD",
+  "HEAD-DATE": "https://gedcom.io/terms/v7/HEAD-DATE",
+  "HEAD-LANG": "https://gedcom.io/terms/v7/HEAD-LANG",
+  "HEAD-PLAC": "https://gedcom.io/terms/v7/HEAD-PLAC",
+  "HEAD-PLAC-FORM": "https://gedcom.io/terms/v7/HEAD-PLAC-FORM",
+  "HEAD-SOUR": "https://gedcom.io/terms/v7/HEAD-SOUR",
+  "HEAD-SOUR-DATA": "https://gedcom.io/terms/v7/HEAD-SOUR-DATA",
+  "HEIGHT": "https://gedcom.io/terms/v7/HEIGHT",
+  "HUSB": "https://gedcom.io/terms/v7/HUSB",
+  "IDNO": "https://gedcom.io/terms/v7/IDNO",
+  "IMMI": "https://gedcom.io/terms/v7/IMMI",
+  "INDI": "https://gedcom.io/terms/v7/INDI",
+  "INDI-CENS": "https://gedcom.io/terms/v7/INDI-CENS",
+  "INDI-EVEN": "https://gedcom.io/terms/v7/INDI-EVEN",
+  "INDI-FACT": "https://gedcom.io/terms/v7/INDI-FACT",
+  "INDI-FAMC": "https://gedcom.io/terms/v7/INDI-FAMC",
+  "INDI-NAME": "https://gedcom.io/terms/v7/INDI-NAME",
+  "INDI-NCHI": "https://gedcom.io/terms/v7/INDI-NCHI",
+  "INDI-RELI": "https://gedcom.io/terms/v7/INDI-RELI",
+  "INDI-RESI": "https://gedcom.io/terms/v7/INDI-RESI",
+  "INDI-TITL": "https://gedcom.io/terms/v7/INDI-TITL",
+  "INIL": "https://gedcom.io/terms/v7/INIL",
+  "LANG": "https://gedcom.io/terms/v7/LANG",
+  "LATI": "https://gedcom.io/terms/v7/LATI",
+  "LEFT": "https://gedcom.io/terms/v7/LEFT",
+  "LONG": "https://gedcom.io/terms/v7/LONG",
+  "MAP": "https://gedcom.io/terms/v7/MAP",
+  "MARB": "https://gedcom.io/terms/v7/MARB",
+  "MARC": "https://gedcom.io/terms/v7/MARC",
+  "MARL": "https://gedcom.io/terms/v7/MARL",
+  "MARR": "https://gedcom.io/terms/v7/MARR",
+  "MARS": "https://gedcom.io/terms/v7/MARS",
+  "MEDI": "https://gedcom.io/terms/v7/MEDI",
+  "MIME": "https://gedcom.io/terms/v7/MIME",
+  "NAME": "https://gedcom.io/terms/v7/NAME",
+  "NAME-TRAN": "https://gedcom.io/terms/v7/NAME-TRAN",
+  "NAME-TYPE": "https://gedcom.io/terms/v7/NAME-TYPE",
+  "NATI": "https://gedcom.io/terms/v7/NATI",
+  "NATU": "https://gedcom.io/terms/v7/NATU",
+  "NCHI": "https://gedcom.io/terms/v7/NCHI",
+  "NICK": "https://gedcom.io/terms/v7/NICK",
+  "NMR": "https://gedcom.io/terms/v7/NMR",
+  "NO": "https://gedcom.io/terms/v7/NO",
+  "NO-DATE": "https://gedcom.io/terms/v7/NO-DATE",
+  "NOTE": "https://gedcom.io/terms/v7/NOTE",
+  "NOTE-TRAN": "https://gedcom.io/terms/v7/NOTE-TRAN",
+  "NPFX": "https://gedcom.io/terms/v7/NPFX",
+  "NSFX": "https://gedcom.io/terms/v7/NSFX",
+  "OBJE": "https://gedcom.io/terms/v7/OBJE",
+  "OCCU": "https://gedcom.io/terms/v7/OCCU",
+  "ORDN": "https://gedcom.io/terms/v7/ORDN",
+  "PAGE": "https://gedcom.io/terms/v7/PAGE",
+  "PEDI": "https://gedcom.io/terms/v7/PEDI",
+  "PHON": "https://gedcom.io/terms/v7/PHON",
+  "PHRASE": "https://gedcom.io/terms/v7/PHRASE",
+  "PLAC": "https://gedcom.io/terms/v7/PLAC",
+  "PLAC-FORM": "https://gedcom.io/terms/v7/PLAC-FORM",
+  "PLAC-TRAN": "https://gedcom.io/terms/v7/PLAC-TRAN",
+  "POST": "https://gedcom.io/terms/v7/POST",
+  "PROB": "https://gedcom.io/terms/v7/PROB",
+  "PROP": "https://gedcom.io/terms/v7/PROP",
+  "PUBL": "https://gedcom.io/terms/v7/PUBL",
+  "QUAY": "https://gedcom.io/terms/v7/QUAY",
+  "REFN": "https://gedcom.io/terms/v7/REFN",
+  "RELI": "https://gedcom.io/terms/v7/RELI",
+  "REPO": "https://gedcom.io/terms/v7/REPO",
+  "RESI": "https://gedcom.io/terms/v7/RESI",
+  "RESN": "https://gedcom.io/terms/v7/RESN",
+  "RETI": "https://gedcom.io/terms/v7/RETI",
+  "ROLE": "https://gedcom.io/terms/v7/ROLE",
+  "SCHMA": "https://gedcom.io/terms/v7/SCHMA",
+  "SDATE": "https://gedcom.io/terms/v7/SDATE",
+  "SEX": "https://gedcom.io/terms/v7/SEX",
+  "SLGC": "https://gedcom.io/terms/v7/SLGC",
+  "SLGS": "https://gedcom.io/terms/v7/SLGS",
+  "SNOTE": "https://gedcom.io/terms/v7/SNOTE",
+  "SOUR": "https://gedcom.io/terms/v7/SOUR",
+  "SOUR-DATA": "https://gedcom.io/terms/v7/SOUR-DATA",
+  "SOUR-EVEN": "https://gedcom.io/terms/v7/SOUR-EVEN",
+  "SPFX": "https://gedcom.io/terms/v7/SPFX",
+  "SSN": "https://gedcom.io/terms/v7/SSN",
+  "STAE": "https://gedcom.io/terms/v7/STAE",
+  "STAT": "https://gedcom.io/terms/v7/STAT",
+  "SUBM": "https://gedcom.io/terms/v7/SUBM",
+  "SUBM-LANG": "https://gedcom.io/terms/v7/SUBM-LANG",
+  "SURN": "https://gedcom.io/terms/v7/SURN",
+  "TAG": "https://gedcom.io/terms/v7/TAG",
+  "TEMP": "https://gedcom.io/terms/v7/TEMP",
+  "TEXT": "https://gedcom.io/terms/v7/TEXT",
+  "TIME": "https://gedcom.io/terms/v7/TIME",
+  "TITL": "https://gedcom.io/terms/v7/TITL",
+  "TOP": "https://gedcom.io/terms/v7/TOP",
+  "TRAN": "https://gedcom.io/terms/v7/TRAN",
+  "TRLR": "https://gedcom.io/terms/v7/TRLR",
+  "TYPE": "https://gedcom.io/terms/v7/TYPE",
+  "UID": "https://gedcom.io/terms/v7/UID",
+  "VERS": "https://gedcom.io/terms/v7/VERS",
+  "WIDTH": "https://gedcom.io/terms/v7/WIDTH",
+  "WIFE": "https://gedcom.io/terms/v7/WIFE",
+  "WILL": "https://gedcom.io/terms/v7/WILL",
+  "WWW": "https://gedcom.io/terms/v7/WWW",
+  "enumset-ADOP": "https://gedcom.io/terms/v7/enumset-ADOP",
+  "enumset-EVEN": "https://gedcom.io/terms/v7/enumset-EVEN",
+  "enumset-EVENATTR": "https://gedcom.io/terms/v7/enumset-EVENATTR",
+  "enumset-FAMC-STAT": "https://gedcom.io/terms/v7/enumset-FAMC-STAT",
+  "enumset-MEDI": "https://gedcom.io/terms/v7/enumset-MEDI",
+  "enumset-NAME-TYPE": "https://gedcom.io/terms/v7/enumset-NAME-TYPE",
+  "enumset-PEDI": "https://gedcom.io/terms/v7/enumset-PEDI",
+  "enumset-QUAY": "https://gedcom.io/terms/v7/enumset-QUAY",
+  "enumset-RESN": "https://gedcom.io/terms/v7/enumset-RESN",
+  "enumset-ROLE": "https://gedcom.io/terms/v7/enumset-ROLE",
+  "enumset-SEX": "https://gedcom.io/terms/v7/enumset-SEX",
+  "ord-STAT": "https://gedcom.io/terms/v7/ord-STAT",
+  "record-FAM": "https://gedcom.io/terms/v7/record-FAM",
+  "record-INDI": "https://gedcom.io/terms/v7/record-INDI",
+  "record-OBJE": "https://gedcom.io/terms/v7/record-OBJE",
+  "record-REPO": "https://gedcom.io/terms/v7/record-REPO",
+  "record-SNOTE": "https://gedcom.io/terms/v7/record-SNOTE",
+  "record-SOUR": "https://gedcom.io/terms/v7/record-SOUR",
+  "record-SUBM": "https://gedcom.io/terms/v7/record-SUBM"
+}
+

gedcomx/gedcom7/gedcom7.py

@@ -0,0 +1,160 @@
+
+from __future__ import annotations
+from typing import Any, Dict, List, Optional, Union, Iterable
+from collections import defaultdict
+
+
+from .GedcomStructure import GedcomStructure
+from . import Specification as g7specs
+from .logger import get_logger
+
+
+from typing import Dict, List, Optional
+
+
+
+class Gedcom7:
+    def __init__(self, filepath: Optional[str] = None):
+        self.persons: List[Any] = []
+        self.families: List[Any] = []
+        self.sources: List[Any] = []
+        self.records: List['GedcomStructure'] = []
+        self._tag_index: Dict[str, List[int]] = defaultdict(list)  # tag -> list of record indices
+
+    # ---- indexing helpers -------------------------------------------------
+    @staticmethod
+    def _norm_tag(tag: str) -> str:
+        return tag.upper()
+
+    def _rebuild_index(self) -> None:
+        self._tag_index.clear()
+        for i, rec in enumerate(self.records):
+            if getattr(rec, "tag", None):
+                self._tag_index[self._norm_tag(rec.tag)].append(i)
+
+    # Optional: keep index in sync if you append records elsewhere
+    def _append_record(self, rec: 'GedcomStructure') -> None:
+        self.records.append(rec)
+        if getattr(rec, "tag", None):
+            self._tag_index[self._norm_tag(rec.tag)].append(len(self.records) - 1)
+
+    # ---- Python container protocol ----------------------------------------
+    def __len__(self) -> int:
+        return len(self.records)
+
+    def __iter__(self) -> Iterable['GedcomStructure']:
+        return iter(self.records)
+
+    def __contains__(self, key: Union[str, 'GedcomStructure']) -> bool:
+        if isinstance(key, str):
+            return self._norm_tag(key) in self._tag_index
+        return key in self.records
+
+    def __getitem__(self, key: Union[int, slice, str, tuple]) -> Union['GedcomStructure', List['GedcomStructure']]:
+        # by position
+        if isinstance(key, (int, slice)):
+            return self.records[key]
+
+        # by tag
+        if isinstance(key, str):
+            idxs = self._tag_index.get(self._norm_tag(key), [])
+            return [self.records[i] for i in idxs]
+
+        # combo: ('INDI', 0) or ('INDI', 0:5)
+        if isinstance(key, tuple) and len(key) == 2 and isinstance(key[0], str):
+            tag, sub = key
+            items = self[tag]  # list for that tag
+            if isinstance(sub, int) or isinstance(sub, slice):
+                return items[sub]
+            raise TypeError(f"Unsupported sub-key type: {type(sub)!r}")
+
+        raise TypeError(f"Unsupported key type: {type(key)!r}")
+
+    # ---- your existing methods (trimmed) ----------------------------------
+    @staticmethod   
+    def parse_gedcom_line(line: str) -> Optional[Dict[str, Any]]:
+                
+        line = line.lstrip('\ufeff').rstrip('\r\n')
+        if not line:
+            return None
+
+        parts = line.split(maxsplit=3)
+        if len(parts) < 2:
+            return None  # not even "0 HEAD"
+
+        # 1) Level
+        try:
+            level = int(parts[0])
+        except ValueError:
+            return None
+
+        # 2) Is parts[1] an XREF?
+        xref = None
+        if parts[1].startswith('@') and parts[1].endswith('@'):
+            xref = parts[1]
+
+        # 3) Where is the tag?
+        if xref:
+            # must have at least ["0", "@X@", "TAG"]
+            if len(parts) < 3:
+                return None
+            tag = parts[2]
+            # everything after index 2 is the value
+            value_parts = parts[3:]  # could be empty or one-element
+        else:
+            tag = parts[1]
+            # everything after index 1 is the value
+            value_parts = parts[2:]  # could be empty, one- or two-element
+            
+
+        # 4) re-assemble the full value
+        value = " ".join(value_parts)  # empty string if value_parts == []
+        if value.startswith('@') and value.endswith('@'):
+            xref = parts[1]
+
+        if tag == 'TAG':
+            xtag, uri = value.split()
+            g7specs.structure_specs[xtag] = uri
+            g7specs.structure_specs[uri] = {'label': 'Extension_' + xtag}
+            
+        return {
+            "level": level,
+            "xref": xref,
+            "tag": tag,
+            "value": value
+        }
+
+
+    def loadfile(self, filepath: str) -> None:
+        log = get_logger('importlog')
+        context: Dict[int, GedcomStructure] = {}
+        records: List[GedcomStructure] = []
+
+        with open(filepath, 'r', encoding='utf8') as file:
+            for lineno, raw in enumerate(file, start=1):
+                record = Gedcom7.parse_gedcom_line(raw)
+                if record is None:
+                    log.error(f'empty line at {lineno}: {raw}')
+                    continue
+
+                level = int(record["level"])
+                if record["tag"] == g7specs.CONT:
+                    context[level - 1].value += "\n" + record["value"]
+                    continue
+
+                structure = GedcomStructure(
+                    level=level,
+                    tag=record["tag"],
+                    xref=record["xref"],
+                    text=record["value"],
+                    parent=context[level - 1] if level > 0 else None,
+                    line_num=lineno
+                )
+
+                if level == 0:
+                    records.append(structure)
+
+                context[level] = structure
+
+        self.records = records
+        self._rebuild_index()  # <-- build fast tag index once

gedcomx/gedcom7/logger.py

@@ -0,0 +1,19 @@
+import logging
+
+def get_logger(name=None):
+    logger = logging.getLogger(name)
+    if not logger.handlers:
+        logger.setLevel(logging.DEBUG)
+
+        formatter = logging.Formatter('[%(asctime)s] %(levelname)s - %(name)s - %(message)s')
+
+        console_handler = logging.StreamHandler()
+        console_handler.setFormatter(formatter)
+        logger.addHandler(console_handler)
+
+        # Optional: file logging
+        file_handler = logging.FileHandler(f"{name}.log", encoding="utf-8")
+        file_handler.setFormatter(formatter)
+        logger.addHandler(file_handler)
+
+    return logger