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

gedcomx/Translation.py

@@ -1,6 +1,6 @@
 from . import *
 from .Mutations import GedcomXEventOrFact
-
+import re
 '''
 {'type': 'Object | Objects | Propertyof',
     'Object': 'Class',
@@ -217,3 +217,978 @@ g7toXtable = {
     "https://gedcom.io/terms/v7/record-SUBM": {'type':'Object','Object':Resource,'Args':{'Id':'xref'}},
 }
 
+class Translater():
+    def __init__(self,gedcom: Gedcom5x) -> None:
+        self.handlers = {}
+        self.gedcom: Gedcom = gedcom
+        self.gedcomx = GedcomX()
+        
+        self.object_stack = []
+        self.object_map = {}
+        self.missing_handler_count = {}
+
+        self.translate()
+
+
+    gedcom_even_to_fact = {
+    # Person Fact Types
+    "ADOP": FactType.Adoption,
+    "CHR": FactType.AdultChristening,
+    "EVEN": FactType.Amnesty,  # and other FactTypes with no direct GEDCOM tag
+    "BAPM": FactType.Baptism,
+    "BARM": FactType.BarMitzvah,
+    "BASM": FactType.BatMitzvah,
+    "BIRT": FactType.Birth,
+    "BIRT, CHR": FactType.Birth,
+    "BLES": FactType.Blessing,
+    "BURI": FactType.Burial,
+    "CAST": FactType.Caste,
+    "CENS": FactType.Census,
+    "CIRC": FactType.Circumcision,
+    "CONF": FactType.Confirmation,
+    "CREM": FactType.Cremation,
+    "DEAT": FactType.Death,
+    "EDUC": FactType.Education,
+    "EMIG": FactType.Emigration,
+    "FCOM": FactType.FirstCommunion,
+    "GRAD": FactType.Graduation,
+    "IMMI": FactType.Immigration,
+    "MIL": FactType.MilitaryService,
+    "NATI": FactType.Nationality,
+    "NATU": FactType.Naturalization,
+    "OCCU": FactType.Occupation,
+    "ORDN": FactType.Ordination,
+    "DSCR": FactType.PhysicalDescription,
+    "PROB": FactType.Probate,
+    "PROP": FactType.Property,
+    "RELI": FactType.Religion,
+    "RESI": FactType.Residence,
+    "WILL": FactType.Will,
+
+    # Couple Relationship Fact Types
+    "ANUL": FactType.Annulment,
+    "DIV": FactType.Divorce,
+    "DIVF": FactType.DivorceFiling,
+    "ENGA": FactType.Engagement,
+    "MARR": FactType.Marriage,
+    "MARB": FactType.MarriageBanns,
+    "MARC": FactType.MarriageContract,
+    "MARL": FactType.MarriageLicense,
+    "SEPA": FactType.Separation,
+
+    # Parent-Child Relationship Fact Types
+    # (Note: Only ADOPTION has a direct GEDCOM tag, others are under "EVEN")
+    "ADOP": FactType.AdoptiveParent
+}
+    
+    gedcom_even_to_evnt = {
+    # Person Fact Types
+    "ADOP": EventType.Adoption,
+    "CHR": EventType.AdultChristening,
+    "BAPM": EventType.Baptism,
+    "BARM": EventType.BarMitzvah,
+    "BASM": EventType.BatMitzvah,
+    "BIRT": EventType.Birth,
+    "BIRT, CHR": EventType.Birth,
+    "BLES": EventType.Blessing,
+    "BURI": EventType.Burial,
+    
+    "CENS": EventType.Census,
+    "CIRC": EventType.Circumcision,
+    "CONF": EventType.Confirmation,
+    "CREM": EventType.Cremation,
+    "DEAT": EventType.Death,
+    "EDUC": EventType.Education,
+    "EMIG": EventType.Emigration,
+    "FCOM": EventType.FirstCommunion,
+    
+    "IMMI": EventType.Immigration,
+    
+    "NATU": EventType.Naturalization,
+    
+    "ORDN": EventType.Ordination,
+    
+
+    # Couple Relationship Fact Types
+    "ANUL": EventType.Annulment,
+    "DIV": EventType.Divorce,
+    "DIVF": EventType.DivorceFiling,
+    "ENGA": EventType.Engagement,
+    "MARR": EventType.Marriage
+    
+}
+    
+    @staticmethod
+    def clean_str(text: str) -> str | None:
+        # Regular expression to match HTML/XML tags
+        if text is None or text.strip() == '':
+            return None
+        clean_text = re.sub(r'<[^>]+>', '', text)
+        
+        return clean_text
+
+    def translate(self):
+        for n, repository in enumerate(self.gedcom.repositories):
+            print(f"Parsing Repository {n}")
+            self.parse_record(repository)
+        print(f"Translated {len(self.gedcomx.agents)} 'REPO' records to Agents")
+        for source in self.gedcom.sources:
+            self.parse_record(source)
+        print(f"Translated {len(self.gedcomx.source_descriptions)} 'SOUR' records to SourceDescription")
+
+        for object in self.gedcom.objects:
+            self.parse_record(object)
+        print(f"Translated {len(self.gedcom.objects)} 'OBJE' records to SourceDescriptions")
+
+        for individual in self.gedcom.individuals:
+            self.parse_record(individual)
+        print(f"Translated {len(self.gedcomx.persons)} 'INDI' records to Persons")
+
+        for key in self.missing_handler_count:
+            print(f"{key}: {self.missing_handler_count[key]}")
+
+        
+
+        fam_count = len(self.gedcom.families)
+        for family in self.gedcom.families:
+            self.handle_fam(family)
+        print(f"Translated {fam_count} 'FAM' records to {len(self.gedcomx.relationships)} Relationship")
+        
+        print(f"Translated {len(self.gedcomx.events)} 'EVEN' records to Events")
+
+    def find_urls(self,text: str):
+        # Regular expression pattern to match URLs
+        url_pattern = re.compile(r'https?://[^\s]+')
+        # Find all URLs using the pattern
+        urls = url_pattern.findall(text)
+        return urls
+
+    @property
+    def event_type_conversion_table(self):
+        return {'BIRT':EventType.Birth,
+                'OBIT':FactType.Obituary}
+       
+    def parse_record(self,record: Gedcom5xRecord):
+                
+        handler_name = 'handle_' + record.tag.lower()
+        
+        if hasattr(self,handler_name): 
+            convert_log.info(f'Parsing Record: {record.describe()}')         
+            handler = getattr(self,handler_name)            
+            handler(record)
+        else:
+            if record.tag in self.missing_handler_count:
+                self.missing_handler_count[record.tag] += 1
+            else:
+                self.missing_handler_count[record.tag] = 1
+            
+            convert_log.error(f'Failed Parsing Record: {record.describe()}')
+        for sub_record in record.subRecords():
+            self.parse_record(sub_record)
+    
+    def handle__apid(self, record: Gedcom5xRecord):
+        if isinstance(self.object_map[record.level-1], SourceReference):
+            self.object_map[record.level-1].description.add_identifier(Identifier(value=URI.from_url('APID://' + record.value)))
+        elif isinstance(self.object_map[record.level-1], SourceDescription):
+            self.object_map[record.level-1].add_identifier(Identifier(value=URI.from_url('APID://' + record.value)))
+        else:
+            raise ValueError(f"Could not handle '_APID' tag in record {record.describe()}, last stack object {type(self.object_map[record.level-1])}")
+
+    def handle__meta(self, record: Gedcom5xRecord):
+        if isinstance(self.object_map[record.level-1], SourceDescription):
+            gxobject = Note(text=Translater.clean_str(record.value))
+            self.object_map[record.level-1].add_note(gxobject)
+            self.object_stack.append(gxobject)
+            self.object_map[record.level] = gxobject
+        else:
+            raise ValueError(f"Could not handle 'WWW' tag in record {record.describe()}, last stack object {self.object_map[record.level-1]}")
+
+    def handle__wlnk(self, record: Gedcom5xRecord):
+        return self.handle_sour(record)
+
+    def handle_addr(self, record: Gedcom5xRecord):
+        if isinstance(self.object_map[record.level-1], Agent):
+            # TODO CHeck if URL?
+            if Translater.clean_str(record.value):
+                gxobject = Address(value=Translater.clean_str(record.value))
+            else:
+                gxobject = Address()
+            self.object_map[record.level-1].address = gxobject
+            self.object_stack.append(gxobject)
+            self.object_map[record.level] = gxobject
+        else:
+            raise ValueError(f"I do not know how to handle an 'ADDR' tag for a {type(self.object_map[record.level-1])}")
+    
+    def handle_adr1(self, record: Gedcom5xRecord):
+        if isinstance(self.object_map[record.level-1], Address):
+            if Translater.clean_str(record.value):
+                self.object_map[record.level-1].street = Translater.clean_str(record.value)        
+        else:
+            raise ValueError(f"I do not know how to handle an 'ADR1' tag for a {type(self.object_map[record.level-1])}")
+    
+    def handle_adr2(self, record: Gedcom5xRecord):
+        if isinstance(self.object_map[record.level-1], Address):
+            if Translater.clean_str(record.value):
+                self.object_map[record.level-1].street2 = Translater.clean_str(record.value)        
+        else:
+            raise ValueError(f"I do not know how to handle an 'ADR2' tag for a {type(self.object_map[record.level-1])}")
+    
+    def handle_adr3(self, record: Gedcom5xRecord):
+        if isinstance(self.object_map[record.level-1], Address):
+            if Translater.clean_str(record.value):
+                self.object_map[record.level-1].street3 = Translater.clean_str(record.value)        
+        else:
+            raise ValueError(f"I do not know how to handle an 'ADR3' tag for a {type(self.object_map[record.level-1])}")
+    
+    def handle_adr4(self, record: Gedcom5xRecord):
+        if isinstance(self.object_map[record.level-1], Address):
+            if Translater.clean_str(record.value):
+                self.object_map[record.level-1].street4 = Translater.clean_str(record.value)        
+        else:
+            raise ValueError(f"I do not know how to handle an 'ADR4' tag for a {type(self.object_map[record.level-1])}")
+    
+    def handle_adr5(self, record: Gedcom5xRecord):
+        if isinstance(self.object_map[record.level-1], Address):
+            if Translater.clean_str(record.value):
+                self.object_map[record.level-1].street5 = Translater.clean_str(record.value)        
+        else:
+            raise ValueError(f"I do not know how to handle an 'ADR5' tag for a {type(self.object_map[record.level-1])}")
+    
+    def handle_adr6(self, record: Gedcom5xRecord):
+        if isinstance(self.object_map[record.level-1], Address):
+            if Translater.clean_str(record.value):
+                self.object_map[record.level-1].street5 = Translater.clean_str(record.value)        
+        else:
+            raise ValueError(f"I do not know how to handle an 'ADR6' tag for a {type(self.object_map[record.level-1])}")
+        
+    def handle_phon(self, record: Gedcom5xRecord):
+        if isinstance(self.object_map[record.level-1], Agent):
+            if Translater.clean_str(record.value):
+                self.object_map[record.level-1].phones.append(Translater.clean_str(record.value))        
+        else:
+            raise ValueError(f"I do not know how to handle an '{record.tag}' tag for a {type(self.object_map[record.level-1])}")
+    
+    def handle_email(self, record: Gedcom5xRecord):
+        if isinstance(self.object_map[record.level-1], Agent):
+            if Translater.clean_str(record.value):
+                self.object_map[record.level-1].emails.append(Translater.clean_str(record.value))        
+        else:
+            raise ValueError(f"I do not know how to handle an '{record.tag}' tag for a {type(self.object_map[record.level-1])}")
+    
+    def handle_fax(self, record: Gedcom5xRecord):
+        if isinstance(self.object_map[record.level-1], Agent):
+            if Translater.clean_str(record.value):
+                self.object_map[record.level-1].emails.append('FAX:' + Translater.clean_str(record.value))        
+        else:
+            raise ValueError(f"I do not know how to handle an '{record.tag}' tag for a {type(self.object_map[record.level-1])}")
+
+    def handle_adop(self, record: Gedcom5xRecord):
+        if isinstance(self.object_map[record.level-1], Person):
+            gxobject = Fact(type=FactType.Adoption)
+            self.object_map[record.level-1].add_fact(gxobject)
+
+            self.object_stack.append(gxobject)
+            self.object_map[record.level] = gxobject
+        else:
+            raise TagConversionError(record=record,levelstack=self.object_map)
+
+    def handle_auth(self, record: Gedcom5xRecord):
+        if isinstance(self.object_map[record.level-1], SourceDescription):
+            if self.gedcomx.agents.byName(record.value):
+                gxobject = self.gedcomx.agents.byName(record.value)[0]
+            else:
+                gxobject = Agent(names=[TextValue(record.value)])
+                self.gedcomx.add_agent(gxobject)
+            
+            self.object_map[record.level-1].author = gxobject
+            self.object_stack.append(gxobject)
+            self.object_map[record.level] = gxobject
+        else:
+            raise TagConversionError(record=record,levelstack=self.object_map)
+
+    def handle_bapm(self, record: Gedcom5xRecord):
+        if isinstance(self.object_map[record.level-1], Person):
+            gxobject = Fact(type=FactType.Baptism)
+            self.object_map[record.level-1].add_fact(gxobject)
+
+            self.object_stack.append(gxobject)
+            self.object_map[record.level] = gxobject
+        else:
+            raise TagConversionError(record=record,levelstack=self.object_map)
+
+    def handle_birt(self, record: Gedcom5xRecord):
+        if isinstance(self.object_map[record.level-1], Person):
+            #gxobject = Event(type=EventType.BIRTH, roles=[EventRole(person=self.object_map[record.level-1], type=EventRoleType.Principal)])
+            gxobject = Fact(type=FactType.Birth)
+            #self.gedcomx.add_event(gxobject)
+            self.object_map[record.level-1].add_fact(gxobject)
+
+            self.object_stack.append(gxobject)
+            self.object_map[record.level] = gxobject
+        else:
+            raise TagConversionError(record=record,levelstack=self.object_map)
+
+    def handle_buri(self, record: Gedcom5xRecord):
+        if isinstance(self.object_map[record.level-1], Person):
+            gxobject = Fact(type=FactType.Burial)
+            self.object_map[record.level-1].add_fact(gxobject)
+
+            self.object_stack.append(gxobject)
+            self.object_map[record.level] = gxobject
+        else:
+            raise TagConversionError(record=record,levelstack=self.object_map)
+
+    def handle_caln(self, record: Gedcom5xRecord):
+        if isinstance(self.object_map[record.level-1], SourceReference):
+            self.object_map[record.level-1].description.add_identifier(Identifier(value=URI.from_url('Call Number:' + record.value)))
+        elif isinstance(self.object_map[record.level-1], SourceDescription):
+            self.object_map[record.level-1].add_identifier(Identifier(value=URI.from_url('Call Number:' + record.value)))
+        elif isinstance(self.object_map[record.level-1], Agent):
+            pass
+            # TODO Why is GEDCOM so shitty? A callnumber for a repository?
+        else:
+            raise ValueError(f"Could not handle 'CALN' tag in record {record.describe()}, last stack object {type(self.object_map[record.level-1])}")
+
+    def handle_chan(self, record: Gedcom5xRecord):
+        if isinstance(self.object_map[record.level-1], SourceDescription):
+            self.object_map[record.level-1].created = Date(record.subRecord('DATE'))
+        elif isinstance(self.object_map[record.level-1], Agent):
+            if self.object_map[record.level-1].attribution is None:
+                gxobject = Attribution()
+                self.object_map[record.level-1].attribution = gxobject
+                self.object_stack.append(gxobject)
+                self.object_map[record.level] = gxobject
+        else:
+            raise ValueError()
+
+    def handle_chr(self, record: Gedcom5xRecord):
+        if isinstance(self.object_map[record.level-1], Person):
+            gxobject = Fact(type=FactType.Christening)
+            self.object_map[record.level-1].add_fact(gxobject)
+
+            self.object_stack.append(gxobject)
+            self.object_map[record.level] = gxobject
+        else:
+            raise TagConversionError(record=record,levelstack=self.object_map)
+
+    def handle_city(self, record: Gedcom5xRecord):
+        if isinstance(self.object_map[record.level-1], Address):
+            self.object_map[record.level-1].city = Translater.clean_str(record.value)
+        else:
+            raise ValueError(f"I do not know how to handle an 'CITY' tag for a {type(self.object_map[record.level-1])}")
+        
+    def handle_conc(self, record: Gedcom5xRecord):
+        if isinstance(self.object_map[record.level-1], Note):
+            gxobject = Translater.clean_str(str(record.value))
+            self.object_map[record.level-1].append(gxobject)
+        elif isinstance(self.object_map[record.level-1], Agent):
+            gxobject = str(record.value)
+            self.object_map[record.level-1]._append_to_name(gxobject)
+        elif isinstance(self.object_map[record.level-1], Qualifier):
+            gxobject = str(record.value)
+            self.object_map[record.level-2].append(gxobject)
+        elif isinstance(self.object_map[record.level-1], TextValue):
+            #gxobject = TextValue(value=Translater.clean_str(record.value))
+            self.object_map[record.level-1]._append_to_value(record.value)
+        elif isinstance(self.object_map[record.level-1], SourceReference):
+            self.object_map[record.level-1].append(record.value)
+        elif isinstance(self.object_map[record.level-1], Fact):
+            self.object_map[record.level-1].notes[0].text += record.value
+            
+        else:
+            raise TagConversionError(record=record,levelstack=self.object_map)
+
+    def handle_cont(self, record: Gedcom5xRecord):
+        if isinstance(self.object_map[record.level-1], Note):
+            gxobject = str("\n" + record.value if record.value else '')
+            self.object_map[record.level-1].append(gxobject)
+        elif isinstance(self.object_map[record.level-1], Agent):
+            gxobject = str("\n" + record.value if record.value else '')
+        elif isinstance(self.object_map[record.level-1], Qualifier):
+            gxobject = str("\n" + record.value if record.value else '')
+            self.object_map[record.level-1].append(gxobject)
+        elif isinstance(self.object_map[record.level-1], TextValue):
+            #gxobject = TextValue(value="\n" + record.value)
+            self.object_map[record.level-1]._append_to_value(record.value if record.value else '\n')
+        elif isinstance(self.object_map[record.level-1], SourceReference):
+            self.object_map[record.level-1].append(record.value)
+        elif isinstance(self.object_map[record.level-1], Address):
+            self.object_map[record.level-1]._append(record.value)
+        else:
+            raise TagConversionError(record=record,levelstack=self.object_map)
+    
+    def handle_crea(self, record: Gedcom5xRecord):
+        if isinstance(self.object_map[record.level-1], SourceDescription):
+            self.object_map[record.level-1].created = Date(original=record.subRecord('DATE'))
+            
+        elif isinstance(self.object_map[record.level-1], Agent):
+            if self.object_map[record.level-1].attribution is None:
+                gxobject = Attribution()
+                self.object_map[record.level-1].attribution = gxobject
+                self.object_stack.append(gxobject)
+                self.object_map[record.level] = gxobject
+            else:
+                convert_log.info(f"[{record.tag}] Attribution already exists for SourceDescription with id: {self.object_map[record.level-1].id}")
+        else:
+            raise ValueError(f"Could not handle '{record.tag}' tag in record {record.describe()}, last stack object {self.object_map[record.level-1]}")
+    
+    def handle_ctry(self, record: Gedcom5xRecord):
+        if isinstance(self.object_map[record.level-1], Address):
+            self.object_map[record.level-1].country = Translater.clean_str(record.value)
+        else:
+            raise ValueError(f"I do not know how to handle an '{record.tag}' tag for a {type(self.object_map[record.level-1])}")
+     
+    def handle_data(self, record: Gedcom5xRecord) -> None:
+        if record.value != '' and record.value == 'None':
+            assert False
+        self.object_map[record.level] = self.object_map[record.level-1]
+
+    def handle_date(self, record: Gedcom5xRecord):
+        if record.parent.tag == 'PUBL':
+            #gxobject = Date(original=record.value) #TODO Make a parser for solid timestamps
+            #self.object_map[0].published = gxobject
+            #self.object_map[0].published = date_to_timestamp(record.value) if record.value else None 
+            self.object_map[0].published = record.value    
+            #self.object_stack.append(gxobject)
+            #self.object_map[record.level] = gxobject
+        elif isinstance(self.object_map[record.level-1], Event):
+            self.object_map[record.level-1].date = Date(original=record.value)
+        elif isinstance(self.object_map[record.level-1], Fact):
+            self.object_map[record.level-1].date = Date(original=record.value)
+        elif record.parent.tag == 'DATA' and isinstance(self.object_map[record.level-2], SourceReference):
+            gxobject = Note(text='Date: ' + record.value)
+            self.object_map[record.level-2].description.add_note(gxobject)
+            self.object_stack.append(gxobject)
+            self.object_map[record.level] = gxobject
+        elif isinstance(self.object_map[record.level-1], SourceDescription):
+            
+            self.object_map[record.level-1].ctreated = record.value #TODO String to timestamp
+        elif isinstance(self.object_map[record.level-1], Attribution):
+            if record.parent.tag == 'CREA':
+                self.object_map[record.level-1].created = record.value #TODO G7
+            elif record.parent.tag == "CHAN":
+                self.object_map[record.level-1].modified = record.value #TODO G7
+        elif record.parent.tag in ['CREA','CHAN']:
+            pass
+
+        else:
+            raise TagConversionError(record=record,levelstack=self.object_map)
+
+    def handle_deat(self, record: Gedcom5xRecord):
+        if isinstance(self.object_map[record.level-1], Person):
+            gxobject = Fact(type=FactType.Death)
+            self.object_map[record.level-1].add_fact(gxobject)
+
+            self.object_stack.append(gxobject)
+            self.object_map[record.level] = gxobject
+        else:
+            raise TagConversionError(record=record,levelstack=self.object_map)
+
+    def handle_even(self, record: Gedcom5xRecord):
+        # TODO If events in a @S, check if only 1 person matches?
+        if record.value and (not record.value.strip() == ''):
+            values = [value.strip() for value in record.value.split(",")]
+            for value in values:
+                if value in Translater.gedcom_even_to_fact.keys():
+                    if isinstance(self.object_map[record.level-1], Person):
+                        gxobject = Fact(type=Translater.gedcom_even_to_fact[value])
+                        self.object_map[record.level-1].add_fact(gxobject)
+
+                        self.object_stack.append(gxobject)
+                        self.object_map[record.level] = gxobject
+
+                    elif isinstance(self.object_map[record.level-1], SourceDescription):
+                        gxobject = Event(type=Translater.gedcom_even_to_evnt[value],sources=[self.object_map[record.level-1]])
+                        self.gedcomx.add_event(gxobject)
+                        self.object_stack.append(gxobject)
+                        self.object_map[record.level] = gxobject
+                    else:
+                        convert_log.warning(f"Could not convert EVEN '{value}' for object of type {type(self.object_map[record.level-1])} in record {record.describe()}")
+                        return
+                        raise TagConversionError(record=record,levelstack=self.object_map)
+                        assert False
+                        # TODO: Fix, this. making an event to cacth subtags, why are these fact tied to a source? GEDCOM is horrible
+                        gxobject = Event(type=EventType.UNKNOWN)
+                        self.object_stack.append(gxobject)
+                        self.object_map[record.level] = gxobject
+                else:
+                    raise TagConversionError(record=record,levelstack=self.object_map)
+
+        else:
+            possible_fact = FactType.guess(record.subRecord('TYPE')[0].value)
+            if possible_fact:
+                gxobject = Fact(type=possible_fact)
+                self.object_map[record.level-1].add_fact(gxobject)
+
+                self.object_stack.append(gxobject)
+                self.object_map[record.level] = gxobject
+                return
+            elif EventType.guess(record.subRecord('TYPE')[0].value):
+                if isinstance(self.object_map[record.level-1], Person):
+                    gxobject = Event(type=EventType.guess(record.subRecord('TYPE')[0].value), roles=[EventRole(person=self.object_map[record.level-1], type=EventRoleType.Principal)])
+                    self.gedcomx.add_event(gxobject)
+                    self.object_stack.append(gxobject)
+                    self.object_map[record.level] = gxobject
+                return
+            else:
+                if isinstance(self.object_map[record.level-1], Person):
+                    gxobject = Event(type=None, roles=[EventRole(person=self.object_map[record.level-1], type=EventRoleType.Principal)])
+                    gxobject.add_note(Note(subject='Event', text=record.value))
+                    self.gedcomx.add_event(gxobject)
+                    self.object_stack.append(gxobject)
+                    self.object_map[record.level] = gxobject
+                    return
+                    
+                else:
+                    assert False
+
+    def handle_exid(self,record: Gedcom5xRecord):
+        gxobject = Identifier(type=IdentifierType.External,value=[record.value])
+        self.object_map[record.level-1].add_identifier(gxobject)
+
+        self.object_stack.append(gxobject)
+        self.object_map[record.level] = gxobject
+
+    def handle_fam(self, record: Gedcom5xRecord) -> None:
+        if record.tag != 'FAM' or record.level != 0:
+            raise ValueError("Invalid record: Must be a level 0 FAM record")
+
+        husband, wife, children = None, None, []
+
+        husband_record = record.subRecords('HUSB')
+        if husband_record:
+            husband = self.gedcomx.get_person_by_id(husband_record[0].xref)
+
+        wife_record = record.subRecords('WIFE')
+        if wife_record:
+            wife = self.gedcomx.get_person_by_id(wife_record[0].xref)
+
+        children_records = record.subRecords('CHIL')
+        if children_records:
+            for child_record in children_records:
+                child = self.gedcomx.get_person_by_id(child_record.xref)
+                if child:
+                    children.append(child)
+
+        if husband:
+            for child in children:
+                relationship = Relationship(person1=husband, person2=child, type=RelationshipType.ParentChild)
+                self.gedcomx.add_relationship(relationship)
+        if wife:
+            for child in children:
+                relationship = Relationship(person1=wife, person2=child, type=RelationshipType.ParentChild)
+                self.gedcomx.add_relationship(relationship)
+        if husband and wife:
+            relationship = Relationship(person1=husband, person2=wife, type=RelationshipType.Couple)
+            self.gedcomx.add_relationship(relationship)
+
+    def handle_famc(self, record: Gedcom5xRecord) -> None:
+        return
+
+    def handle_fams(self, record: Gedcom5xRecord) -> None:
+        return
+
+    def handle_file(self, record: Gedcom5xRecord):
+        if record.value and record.value.strip() != '':
+            #raise ValueError(f"I did not expect the 'FILE' tag to have a value: {record.value}")
+            #TODO Handle files referenced here
+            ...
+        elif isinstance(self.object_map[record.level-1], SourceDescription):
+            ...
+        self.object_map[record.level-1].resourceType = ResourceType.DigitalArtifact
+           
+    def handle_form(self, record: Gedcom5xRecord):
+        if record.parent.tag == 'FILE' and isinstance(self.object_map[record.level-2], SourceDescription):
+            if record.value and record.value.strip() != '':
+                mime_type, _ = mimetypes.guess_type('placehold.' + record.value)
+                if mime_type:
+                    self.object_map[record.level-2].mediaType = mime_type
+                else:
+                    print(f"Could not determing mime type from {record.value}")
+        elif isinstance(self.object_map[record.level-1], PlaceDescription):
+            self.object_map[record.level-1].names.append(TextValue(value=record.value))
+        elif record.parent.tag == 'TRAN':
+            pass #TODO
+        else:
+            convert_log.error(f"raise TagConversionError(record=record,levelstack=self.object_map")
+
+    def handle_givn(self, record: Gedcom5xRecord):
+        if isinstance(self.object_map[record.level-1], Name):
+            given_name = NamePart(value=record.value, type=NamePartType.Given)
+            self.object_map[record.level-1]._add_name_part(given_name)
+        else:
+            raise TagConversionError(record=record,levelstack=self.object_map)
+
+    def handle_indi(self, record: Gedcom5xRecord):
+        person = Person(id=record.xref.replace('@',''))
+        self.gedcomx.add_person(person)
+        self.object_stack.append(person)
+        self.object_map[record.level] = person
+
+    def handle_immi(self, record: Gedcom5xRecord):
+        if isinstance(self.object_map[record.level-1], Person):
+            gxobject = Fact(type=FactType.Immigration)
+            self.object_map[record.level-1].add_fact(gxobject)
+
+            self.object_stack.append(gxobject)
+            self.object_map[record.level] = gxobject
+        else:
+            raise TagConversionError(record=record,levelstack=self.object_map)
+
+    def handle_marr(self, record: Gedcom5xRecord):
+        if isinstance(self.object_map[record.level-1], Person):
+            gxobject = Fact(type=FactType.Marriage)
+            self.object_map[record.level-1].add_fact(gxobject)
+
+            self.object_stack.append(gxobject)
+            self.object_map[record.level] = gxobject
+        else:
+            raise TagConversionError(record=record,levelstack=self.object_map)
+
+    def handle_name(self, record: Gedcom5xRecord):
+        if isinstance(self.object_map[record.level-1], Person):
+            gxobject = Name.simple(record.value)
+            #gxobject = Name(nameForms=[NameForm(fullText=record.value)], type=NameType.BirthName)
+            self.object_map[record.level-1].add_name(gxobject)
+
+            self.object_stack.append(gxobject)
+            self.object_map[record.level] = gxobject
+        elif isinstance(self.object_map[record.level-1], Agent):
+            gxobject = TextValue(value=record.value)
+            self.object_map[record.level-1].add_name(gxobject)
+        else:
+            raise TagConversionError(record=record,levelstack=self.object_map)
+
+    def handle_note(self, record: Gedcom5xRecord):
+        if isinstance(self.object_map[record.level-1], SourceDescription):
+            gxobject = Note(text=Translater.clean_str(record.value))
+            self.object_map[record.level-1].add_note(gxobject)
+
+            self.object_stack.append(gxobject)
+            self.object_map[record.level] = gxobject
+        elif isinstance(self.object_map[record.level-1], SourceReference):
+            gxobject = Note(text=Translater.clean_str(record.value))
+            self.object_map[record.level-1].description.add_note(gxobject)
+
+            self.object_stack.append(gxobject)
+            self.object_map[record.level] = gxobject
+        elif isinstance(self.object_map[record.level-1], Conclusion):
+            gxobject = Note(text=record.value)
+            self.object_map[record.level-1].add_note(gxobject)
+
+            self.object_stack.append(gxobject)
+            self.object_map[record.level] = gxobject
+        elif isinstance(self.object_map[record.level-1], Agent):
+            gxobject = Note(text=record.value)
+            self.object_map[record.level-1].add_note(gxobject)
+
+            self.object_stack.append(gxobject)
+            self.object_map[record.level] = gxobject
+        elif isinstance(self.object_map[record.level-1], Attribution):
+            if self.object_map[record.level-1].changeMessage is None:
+                self.object_map[record.level-1].changeMessage = record.value
+            else:
+                self.object_map[record.level-1].changeMessage = self.object_map[record.level-1].changeMessage + '' + record.value
+        elif isinstance(self.object_map[record.level-1], Note):
+            gxobject = Note(text=Translater.clean_str(record.value))
+            self.object_map[record.level-2].add_note(gxobject)
+
+            self.object_stack.append(gxobject)
+            self.object_map[record.level] = gxobject
+
+        else:
+            raise ValueError(f"Could not handle 'NOTE' tag in record {record.describe()}, last stack object {type(self.object_map[record.level-1])}")
+            assert False
+
+    def handle_nsfx(self, record: Gedcom5xRecord):
+        if isinstance(self.object_map[record.level-1], Name):
+            surname = NamePart(value=record.value, type=NamePartType.Suffix)
+            self.object_map[record.level-1]._add_name_part(surname)
+        else:
+            raise TagConversionError(record=record,levelstack=self.object_map)
+
+    def handle_occu(self, record: Gedcom5xRecord):
+        if isinstance(self.object_map[record.level-1], Person):
+            gxobject = Fact(type=FactType.Occupation)
+            self.object_map[record.level-1].add_fact(gxobject)
+
+            self.object_stack.append(gxobject)
+            self.object_map[record.level] = gxobject
+        else:
+            raise TagConversionError(record=record,levelstack=self.object_map)
+
+    def handle_obje(self, record: Gedcom5xRecord):
+        self.handle_sour(record)
+
+    def handle_page(self, record: Gedcom5xRecord):
+        if isinstance(self.object_map[record.level-1], SourceReference):
+            self.object_map[record.level-1].descriptionId = record.value
+            self.object_map[record.level-1].add_qualifier(KnownSourceReference(name=str(KnownSourceReference.Page),value=record.value))
+            
+            #self.object_stack.append(gxobject)
+            #self.object_map[record.level] = gxobject
+            self.object_map[record.level] = self.object_map[record.level-1]
+        else:
+            raise ValueError(f"Could not handle 'PAGE' tag in record {record.describe()}, last stack object {self.object_map[record.level-1]}")
+
+    def handle_plac(self, record: Gedcom5xRecord):
+        if isinstance(self.object_map[record.level-1], Agent):
+            gxobject = Address(value=record.value)
+            self.object_map[record.level-1].add_address(gxobject)
+
+            self.object_stack.append(gxobject)
+            self.object_map[record.level] = gxobject
+        elif isinstance(self.object_map[record.level-1], Event):
+            if self.gedcomx.places.byName(record.value):
+                self.object_map[record.level-1].place = PlaceReference(original=record.value, description=self.gedcomx.places.byName(record.value)[0])
+            else:
+                place_des = PlaceDescription(names=[TextValue(value=record.value)])
+                self.gedcomx.add_place_description(place_des)
+                self.object_map[record.level-1].place = PlaceReference(original=record.value, description=place_des)
+                if len(record.subRecords()) > 0:
+                    self.object_map[record.level]= place_des
+
+        elif isinstance(self.object_map[record.level-1], Fact):
+            if self.gedcomx.places.byName(record.value):
+                self.object_map[record.level-1].place = PlaceReference(original=record.value, description=self.gedcomx.places.byName(record.value)[0])
+            else:
+                place_des = PlaceDescription(names=[TextValue(value=record.value)])
+                self.gedcomx.add_place_description(place_des)
+                self.object_map[record.level-1].place = PlaceReference(original=record.value, description=place_des)
+        elif isinstance(self.object_map[record.level-1], SourceDescription):
+            gxobject = Note(text='Place: ' + record.value)
+            self.object_map[record.level-1].add_note(gxobject)
+            self.object_stack.append(gxobject)
+            self.object_map[record.level] = gxobject
+        else:
+            raise TagConversionError(record=record,levelstack=self.object_map)
+
+    def handle_post(self, record: Gedcom5xRecord):
+        if isinstance(self.object_map[record.level-1], Address):
+            self.object_map[record.level-1].postalCode = Translater.clean_str(record.value)
+        else:
+            raise ValueError(f"I do not know how to handle an 'POST' tag for a {type(self.object_map[record.level-1])}")   
+    
+    def handle_publ(self, record: Gedcom5xRecord):
+        if isinstance(self.object_map[record.level-1], SourceDescription):
+            if record.value and self.gedcomx.agents.byName(record.value):
+                gxobject = self.gedcomx.agents.byName(record.value)[0]
+            else:
+                gxobject = Agent(names=[TextValue(record.value)])
+                self.gedcomx.add_agent(gxobject)
+            self.object_map[record.level-1].publisher = gxobject
+
+            self.object_stack.append(gxobject)
+            self.object_map[record.level] = gxobject
+        else:
+            raise TagConversionError(record=record,levelstack=self.object_map)
+
+    def handle_prob(self, record: Gedcom5xRecord):
+        if isinstance(self.object_map[record.level-1], Person):
+            gxobject = Fact(type=FactType.Probate)
+            self.object_map[record.level-1].add_fact(gxobject)
+
+            self.object_stack.append(gxobject)
+            self.object_map[record.level] = gxobject
+        else:
+            raise TagConversionError(record=record,levelstack=self.object_map)
+
+    def handle_uid(self, record: Gedcom5xRecord):
+        if isinstance(self.object_map[record.level-1], Agent):
+            gxobject = Identifier(value=['UID:' + record.value],type=IdentifierType.Primary)
+            self.object_map[record.level-1].add_identifier(gxobject) #NOTE GC7
+            self.object_stack.append(gxobject)
+            self.object_map[record.level] = gxobject
+
+    def handle_refn(self, record: Gedcom5xRecord):
+        if isinstance(self.object_map[record.level-1], Person) or isinstance(self.object_map[record.level-1], SourceDescription):
+            gxobject = Identifier(value=[URI.from_url('Reference Number:' + record.value)])
+            self.object_map[record.level-1].add_identifier(gxobject)
+            self.object_stack.append(gxobject)
+            self.object_map[record.level] = gxobject
+        elif isinstance(self.object_map[record.level-1], Agent):
+            gxobject = Identifier(value=['Reference Number:' + record.value])
+            self.object_map[record.level-1].add_identifier(gxobject) #NOTE GC7
+            self.object_stack.append(gxobject)
+            self.object_map[record.level] = gxobject
+        else:
+            raise ValueError(f"Could not handle 'REFN' tag in record {record.describe()}, last stack object {type(self.object_map[record.level-1])}")
+
+    def handle_repo(self, record: Gedcom5xRecord):
+
+        if record.level == 0:
+            
+            gxobject = Agent(id=record.xref)
+            self.gedcomx.add_agent(gxobject)
+            self.object_stack.append(gxobject)
+            self.object_map[record.level] = gxobject
+            
+        elif isinstance(self.object_map[record.level-1], SourceDescription):
+            if self.gedcomx.agents.byId(record.xref) is not None:
+                
+                # TODO WHere and what to add this to?
+                gxobject = self.gedcomx.agents.byId(record.xref)
+                self.object_map[record.level-1].repository = gxobject
+                self.object_map[record.level] = gxobject
+
+            else:
+                print(record.describe())
+                raise ValueError()
+                gxobject = Agent(names=[TextValue(record.value)])
+        else:
+            raise ValueError(f"I do not know how to handle 'REPO' tag that is not a top-level, or sub-tag of {type(self.object_map[record.level-1])}")
+            
+
+        self.object_stack.append(gxobject)
+        self.object_map[record.level] = gxobject
+
+    def handle_resi(self, record: Gedcom5xRecord):
+        if isinstance(self.object_map[record.level-1], Person):
+            gxobject = Fact(type=FactType.Residence)
+            if record.value and record.value.strip() != '':
+                gxobject.add_note(Note(text=record.value))
+            self.object_map[record.level-1].add_fact(gxobject)
+
+            self.object_stack.append(gxobject)
+            self.object_map[record.level] = gxobject
+        else:
+            raise TagConversionError(record=record,levelstack=self.object_map)
+
+    def handle_rin(self, record: Gedcom5xRecord):
+        if isinstance(self.object_map[record.level-1], SourceDescription):
+            self.object_map[record.level-1].id = record.value
+            self.object_map[record.level-1].add_note(Note(text=f"Source had RIN: of {record.value}"))
+
+        else:
+            raise ValueError(f"Could not handle 'RIN' tag in record {record.describe()}, last stack object {type(self.object_map[record.level-1])}")
+        
+    def handle_sex(self, record: Gedcom5xRecord):
+        
+        if isinstance(self.object_map[record.level-1], Person):
+            if record.value == 'M':
+                gxobject = Gender(type=GenderType.Male)
+            elif record.value == 'F':
+                gxobject = Gender(type=GenderType.Female)
+            else:
+                gxobject = Gender(type=GenderType.Unknown)
+            self.object_map[record.level-1].gender = gxobject
+            
+            self.object_stack.append(gxobject)
+            self.object_map[record.level] = gxobject
+        else:
+            assert False
+
+    def handle_sour(self, record: Gedcom5xRecord):
+        if record.level == 0 or record.tag == '_WLNK' or (record.level == 0 and record.tag == 'OBJE'):
+            source_description = SourceDescription(id=record.xref.replace('@','') if record.xref else None)
+            self.gedcomx.add_source_description(source_description)
+            self.object_stack.append(source_description)
+            self.object_map[record.level] = source_description
+        else:
+            # This 'SOUR' is a SourceReference
+            if record.xref and record.xref.strip() == '':
+                import_log.warning(f"SOUR points to nothing: {record.describe()}")
+                return False
+            if self.gedcomx.source_descriptions.byId(record.xref):
+                gxobject = SourceReference(descriptionId=record.xref, description=self.gedcomx.source_descriptions.byId(record.xref))
+            else:
+                import_log.warning(f'Could not find source with id: {record.xref}')
+                source_description = SourceDescription(id=record.xref)
+                gxobject = SourceReference(descriptionId=record.value, description=source_description)
+            if isinstance(self.object_map[record.level-1],SourceReference):
+                self.object_map[record.level-1].description.add_source(gxobject)
+            elif record.parent.tag in ['NOTE']:
+                pass
+            else:
+                self.object_map[record.level-1].add_source(gxobject)
+            self.object_stack.append(gxobject)
+            self.object_map[record.level] = gxobject
+          
+    def handle_stae(self, record: Gedcom5xRecord):
+        if isinstance(self.object_map[record.level-1], Address):
+            self.object_map[record.level-1].stateOrProvince = Translater.clean_str(record.value)
+        else:
+            raise ValueError(f"I do not know how to handle an 'STAE' tag for a {type(self.object_map[record.level-1])}")
+        
+    def handle_surn(self, record: Gedcom5xRecord):
+        if isinstance(self.object_map[record.level-1], Name):
+            surname = NamePart(value=record.value, type=NamePartType.Surname)
+            self.object_map[record.level-1]._add_name_part(surname)
+        else:
+            raise TagConversionError(record=record,levelstack=self.object_map)
+
+    def handle_text(self, record: Gedcom5xRecord):
+        if record.parent.tag == 'DATA':
+            if isinstance(self.object_map[record.level-2], SourceReference):
+                gxobject = TextValue(value=record.value)
+                self.object_map[record.level-2].description.add_description(gxobject)
+                self.object_stack.append(gxobject)
+                self.object_map[record.level] = gxobject
+        elif isinstance(self.object_map[record.level-1], SourceDescription):
+            gxobject = Document(text=record.value)
+            self.object_map[record.level-1].analysis = gxobject
+        else:
+            assert False
+
+    def handle_titl(self, record: Gedcom5xRecord):
+        if isinstance(self.object_map[record.level-1], SourceDescription):
+            
+            gxobject = TextValue(value=Translater.clean_str(record.value))
+            self.object_map[record.level-1].add_title(gxobject)
+
+            self.object_stack.append(gxobject)
+            self.object_map[record.level] = gxobject
+        
+        elif record.parent.tag == 'FILE' and isinstance(self.object_map[record.level-2], SourceDescription):
+            gxobject = TextValue(value=record.value)
+            self.object_map[record.level-2].add_title(gxobject)
+
+            self.object_stack.append(gxobject)
+            self.object_map[record.level] = gxobject
+        elif self.object_map[record.level] and isinstance(self.object_map[record.level], Name):
+            gxobject = NamePart(value=record.value, qualifiers=[NamePartQualifier.Title])
+
+            self.object_map[record.level]._add_name_part(gxobject)
+        else:
+            convert_log.error(f"raise TagConversionError(record=record,levelstack=self.object_map)")
+
+    def handle_tran(self, record: Gedcom5xRecord):
+        pass
+
+    def handle_type(self, record: Gedcom5xRecord):
+        # peek to see if event or fact
+        if isinstance(self.object_map[record.level-1], Event):
+            if EventType.guess(record.value):
+                self.object_map[record.level-1].type = EventType.guess(record.value)                
+            else:              
+                self.object_map[record.level-1].type = None
+            self.object_map[record.level-1].add_note(Note(text=Translater.clean_str(record.value)))
+        elif isinstance(self.object_map[record.level-1], Fact):
+            if not self.object_map[record.level-1].type:
+                self.object_map[0].type = FactType.guess(record.value)
+        elif isinstance(self.object_map[record.level-1], Identifier):
+            
+            self.object_map[record.level-1].values.append(Translater.clean_str(record.value))
+            self.object_map[record.level-1].type = IdentifierType.Other
+
+        elif record.parent.tag == 'FORM':
+            if not self.object_map[0].mediaType:
+                self.object_map[0].mediaType = record.value
+
+        else:
+            raise ValueError(f"I do not know how to handle 'TYPE' tag for {type(self.object_map[record.level-1])}")
+
+    def handle__url(self, record: Gedcom5xRecord):
+        if isinstance(self.object_map[record.level-2], SourceDescription):
+            self.object_map[record.level-2].about = URI.from_url(record.value)
+        else:
+            raise ValueError(f"Could not handle '_URL' tag in record {record.describe()}, last stack object {self.object_map[record.level-1]}")
+            
+    def handle_www(self, record: Gedcom5xRecord):
+        if isinstance(self.object_map[record.level-1], Agent):
+            self.object_map[record.level-1].homepage = Translater.clean_str(record.value)
+        elif isinstance(self.object_map[record.level-2], SourceReference):
+            self.object_map[record.level-2].description.add_identifier(Identifier(value=URI.from_url(record.value)))
+        else:
+            raise ValueError(f"Could not handle 'WWW' tag in record {record.describe()}, last stack object {self.object_map[record.level-1]}")
+