gedcom-x 0.5__py3-none-any.whl

gedcomx/Event.py

@@ -0,0 +1,195 @@
+from enum import Enum
+from typing import List, Optional
+
+from gedcomx.EvidenceReference import EvidenceReference
+from gedcomx.Identifier import Identifier
+
+from .Attribution import Attribution
+from .Conclusion import Conclusion, ConfidenceLevel
+from .Date import Date
+from .Note import Note
+from .PlaceReference import PlaceReference
+from .SourceReference import SourceReference
+from .Subject import Subject
+from .URI import URI
+
+class EventRoleType(Enum):
+    Principal = "http://gedcomx.org/Principal"
+    Participant = "http://gedcomx.org/Participant"
+    Official = "http://gedcomx.org/Official"
+    Witness = "http://gedcomx.org/Witness"
+    
+    @property
+    def description(self):
+        descriptions = {
+            EventRole.Principal: "The person is the principal person of the event. For example, the principal of a birth event is the person that was born.",
+            EventRole.Participant: "A participant in the event.",
+            EventRole.Official: "A person officiating the event.",
+            EventRole.Witness: "A witness of the event."
+        }
+        return descriptions.get(self, "No description available.")
+
+class EventRole(Conclusion):
+    identifier = 'http://gedcomx.org/v1/EventRole'
+    version = 'http://gedcomx.org/conceptual-model/v1'
+
+    def __init__(self,
+                 id: Optional[str] = None,
+                 lang: Optional[str] = 'en',
+                 sources: Optional[List[SourceReference]] = [],
+                 analysis: Optional[URI] = None,
+                 notes: Optional[List[Note]] = [],
+                 confidence: Optional[ConfidenceLevel] = None,
+                 attribution: Optional[Attribution] = None,
+                 person: URI = None,
+                 type: Optional[EventRoleType] = None,
+                 details: Optional[str] = None) -> None:
+        super().__init__(id, lang, sources, analysis, notes, confidence, attribution)
+        self.person = person
+        self.type = type
+        self.details = details
+
+class EventType(Enum):
+    Adoption = "http://gedcomx.org/Adoption"
+    AdultChristening = "http://gedcomx.org/AdultChristening"
+    Annulment = "http://gedcomx.org/Annulment"
+    Baptism = "http://gedcomx.org/Baptism"
+    BarMitzvah = "http://gedcomx.org/BarMitzvah"
+    BatMitzvah = "http://gedcomx.org/BatMitzvah"
+    Birth = "http://gedcomx.org/Birth"
+    Blessing = "http://gedcomx.org/Blessing"
+    Burial = "http://gedcomx.org/Burial"
+    Census = "http://gedcomx.org/Census"
+    Christening = "http://gedcomx.org/Christening"
+    Circumcision = "http://gedcomx.org/Circumcision"
+    Confirmation = "http://gedcomx.org/Confirmation"
+    Cremation = "http://gedcomx.org/Cremation"
+    Death = "http://gedcomx.org/Death"
+    Divorce = "http://gedcomx.org/Divorce"
+    DivorceFiling = "http://gedcomx.org/DivorceFiling"
+    Education = "http://gedcomx.org/Education"
+    Engagement = "http://gedcomx.org/Engagement"
+    Emigration = "http://gedcomx.org/Emigration"
+    Excommunication = "http://gedcomx.org/Excommunication"
+    FirstCommunion = "http://gedcomx.org/FirstCommunion"
+    Funeral = "http://gedcomx.org/Funeral"
+    Immigration = "http://gedcomx.org/Immigration"
+    LandTransaction = "http://gedcomx.org/LandTransaction"
+    Marriage = "http://gedcomx.org/Marriage"
+    MilitaryAward = "http://gedcomx.org/MilitaryAward"
+    MilitaryDischarge = "http://gedcomx.org/MilitaryDischarge"
+    Mission = "http://gedcomx.org/Mission"
+    MoveFrom = "http://gedcomx.org/MoveFrom"
+    MoveTo = "http://gedcomx.org/MoveTo"
+    Naturalization = "http://gedcomx.org/Naturalization"
+    Ordination = "http://gedcomx.org/Ordination"
+    Retirement = "http://gedcomx.org/Retirement"
+    
+    @property
+    def description(self):
+        descriptions = {
+            EventType.Adoption: "An adoption event.",
+            EventType.AdultChristening: "An adult christening event.",
+            EventType.Annulment: "An annulment event of a marriage.",
+            EventType.Baptism: "A baptism event.",
+            EventType.BarMitzvah: "A bar mitzvah event.",
+            EventType.BatMitzvah: "A bat mitzvah event.",
+            EventType.Birth: "A birth event.",
+            EventType.Blessing: "An official blessing event, such as at the hands of a clergy member or at another religious rite.",
+            EventType.Burial: "A burial event.",
+            EventType.Census: "A census event.",
+            EventType.Christening: "A christening event at birth. Note: use AdultChristening for a christening event as an adult.",
+            EventType.Circumcision: "A circumcision event.",
+            EventType.Confirmation: "A confirmation event (or other rite of initiation) in a church or religion.",
+            EventType.Cremation: "A cremation event after death.",
+            EventType.Death: "A death event.",
+            EventType.Divorce: "A divorce event.",
+            EventType.DivorceFiling: "A divorce filing event.",
+            EventType.Education: "An education or educational achievement event (e.g., diploma, graduation, scholarship, etc.).",
+            EventType.Engagement: "An engagement to be married event.",
+            EventType.Emigration: "An emigration event.",
+            EventType.Excommunication: "An excommunication event from a church.",
+            EventType.FirstCommunion: "A first communion event.",
+            EventType.Funeral: "A funeral event.",
+            EventType.Immigration: "An immigration event.",
+            EventType.LandTransaction: "A land transaction event.",
+            EventType.Marriage: "A marriage event.",
+            EventType.MilitaryAward: "A military award event.",
+            EventType.MilitaryDischarge: "A military discharge event.",
+            EventType.Mission: "A mission event.",
+            EventType.MoveFrom: "An event of a move (i.e., change of residence) from a location.",
+            EventType.MoveTo: "An event of a move (i.e., change of residence) to a location.",
+            EventType.Naturalization: "A naturalization event (i.e., acquisition of citizenship and nationality).",
+            EventType.Ordination: "An ordination event.",
+            EventType.Retirement: "A retirement event."
+        }
+        return descriptions.get(self, "No description available.")
+
+    @staticmethod
+    def guess(description):
+        keywords_to_event_type = {
+            "adoption": EventType.Adoption,
+            "christening": EventType.Christening,
+            "annulment": EventType.Annulment,
+            "baptism": EventType.Baptism,
+            "bar mitzvah": EventType.BarMitzvah,
+            "bat mitzvah": EventType.BatMitzvah,
+            "birth": EventType.Birth,
+            "blessing": EventType.Blessing,
+            "burial": EventType.Burial,
+            "census": EventType.Census,
+            "circumcision": EventType.Circumcision,
+            "confirmation": EventType.Confirmation,
+            "cremation": EventType.Cremation,
+            "death": EventType.Death,
+            "divorce": EventType.Divorce,
+            "divorce filing": EventType.DivorceFiling,
+            "education": EventType.Education,
+            "engagement": EventType.Engagement,
+            "emigration": EventType.Emigration,
+            "excommunication": EventType.Excommunication,
+            "first communion": EventType.FirstCommunion,
+            "funeral": EventType.Funeral,
+            "arrival": EventType.Immigration,
+            "immigration": EventType.Immigration,
+            "land transaction": EventType.LandTransaction,
+            "marriage": EventType.Marriage,
+            "military award": EventType.MilitaryAward,
+            "military discharge": EventType.MilitaryDischarge,
+            "mission": EventType.Mission,
+            "move from": EventType.MoveFrom,
+            "move to": EventType.MoveTo,
+            "naturalization": EventType.Naturalization,
+            "ordination": EventType.Ordination,
+            "retirement": EventType.Retirement,
+        }
+
+        description_lower = description.lower()
+
+        for keyword, event_type in keywords_to_event_type.items():
+            if keyword in description_lower:
+                return event_type
+
+        return None  # Default to UNKNOWN if no match is found
+
+class Event(Subject):
+    identifier = 'http://gedcomx.org/v1/Event'
+    version = 'http://gedcomx.org/conceptual-model/v1'
+
+    def __init__(self,
+                 id: Optional[str] = None,
+                 lang: Optional[str] = 'en',
+                 sources: Optional[List[SourceReference]] = [],
+                 analysis: Optional[URI] = None,
+                 notes: Optional[List[Note]] = [],
+                 confidence: Optional[ConfidenceLevel] = None,
+                 attribution: Optional[Attribution] = None,
+                 extracted: Optional[bool] = False,
+                 evidence: Optional[List[EvidenceReference]] = [],
+                 media: Optional[List[SourceReference]] = [],
+                 identifiers: Optional[List[Identifier]] = [],
+                 type: Optional[EventType] = None,
+                 date: Optional[Date] = None,
+                 place: Optional[PlaceReference] = None,
+                 roles: Optional[List[EventRole]] = []) -> None:
+        super().__init__(id, lang, sources, analysis, notes, confidence, attribution, extracted, evidence, media, identifiers)

gedcomx/EvidenceReference.py

@@ -0,0 +1,11 @@
+from typing import Optional
+
+from .Attribution import Attribution
+from .URI import URI
+
+class EvidenceReference:
+    identifier = 'http://gedcomx.org/v1/EvidenceReference'
+    version = 'http://gedcomx.org/conceptual-model/v1'
+
+    def __init__(self, resource: URI, attribution: Optional[Attribution]) -> None:
+        pass

gedcomx/Fact.py

@@ -0,0 +1,462 @@
+import difflib
+import re
+
+from datetime import datetime
+from enum import Enum
+from typing import List, Optional
+
+from .Attribution import Attribution
+from .Conclusion import ConfidenceLevel
+from .Date import Date
+from .Note import Note
+from .PlaceReference import PlaceReference
+from .SourceReference import SourceReference
+from .URI import URI
+
+from .Conclusion import Conclusion
+from .Qualifier import Qualifier
+
+from enum import Enum
+
+
+class FactType(Enum):
+    # Person Fact Types
+    Adoption = "http://gedcomx.org/Adoption"
+    AdultChristening = "http://gedcomx.org/AdultChristening"
+    Amnesty = "http://gedcomx.org/Amnesty"
+    AncestralHall = "http://gedcomx.org/AncestralHall"
+    AncestralPoem = "http://gedcomx.org/AncestralPoem"
+    Apprenticeship = "http://gedcomx.org/Apprenticeship"
+    Arrest = "http://gedcomx.org/Arrest"
+    Award = "http://gedcomx.org/Award"
+    Baptism = "http://gedcomx.org/Baptism"
+    BarMitzvah = "http://gedcomx.org/BarMitzvah"
+    BatMitzvah = "http://gedcomx.org/BatMitzvah"
+    Birth = "http://gedcomx.org/Birth"
+    BirthNotice = "http://gedcomx.org/BirthNotice"
+    Blessing = "http://gedcomx.org/Blessing"
+    Branch = "http://gedcomx.org/Branch"
+    Burial = "http://gedcomx.org/Burial"
+    Caste = "http://gedcomx.org/Caste"
+    Census = "http://gedcomx.org/Census"
+    Christening = "http://gedcomx.org/Christening"
+    Circumcision = "http://gedcomx.org/Circumcision"
+    Clan = "http://gedcomx.org/Clan"
+    Confirmation = "http://gedcomx.org/Confirmation"
+    Court = "http://gedcomx.org/Court"
+    Cremation = "http://gedcomx.org/Cremation"
+    Death = "http://gedcomx.org/Death"
+    Education = "http://gedcomx.org/Education"
+    EducationEnrollment = "http://gedcomx.org/EducationEnrollment"
+    Emigration = "http://gedcomx.org/Emigration"
+    Enslavement = "http://gedcomx.org/Enslavement"
+    Ethnicity = "http://gedcomx.org/Ethnicity"
+    Excommunication = "http://gedcomx.org/Excommunication"
+    FirstCommunion = "http://gedcomx.org/FirstCommunion"
+    Funeral = "http://gedcomx.org/Funeral"
+    GenderChange = "http://gedcomx.org/GenderChange"
+    GenerationNumber = "http://gedcomx.org/GenerationNumber"
+    Graduation = "http://gedcomx.org/Graduation"
+    Heimat = "http://gedcomx.org/Heimat"
+    Immigration = "http://gedcomx.org/Immigration"
+    Imprisonment = "http://gedcomx.org/Imprisonment"
+    Inquest = "http://gedcomx.org/Inquest"
+    LandTransaction = "http://gedcomx.org/LandTransaction"
+    Language = "http://gedcomx.org/Language"
+    Living = "http://gedcomx.org/Living"
+    MaritalStatus = "http://gedcomx.org/MaritalStatus"
+    Medical = "http://gedcomx.org/Medical"
+    MilitaryAward = "http://gedcomx.org/MilitaryAward"
+    MilitaryDischarge = "http://gedcomx.org/MilitaryDischarge"
+    MilitaryDraftRegistration = "http://gedcomx.org/MilitaryDraftRegistration"
+    MilitaryInduction = "http://gedcomx.org/MilitaryInduction"
+    MilitaryService = "http://gedcomx.org/MilitaryService"
+    Mission = "http://gedcomx.org/Mission"
+    MoveFrom = "http://gedcomx.org/MoveFrom"
+    MoveTo = "http://gedcomx.org/MoveTo"
+    MultipleBirth = "http://gedcomx.org/MultipleBirth"
+    NationalId = "http://gedcomx.org/NationalId"
+    Nationality = "http://gedcomx.org/Nationality"
+    Naturalization = "http://gedcomx.org/Naturalization"
+    NumberOfChildren = "http://gedcomx.org/NumberOfChildren"
+    NumberOfMarriages = "http://gedcomx.org/NumberOfMarriages"
+    Obituary = "http://gedcomx.org/Obituary"
+    OfficialPosition = "http://gedcomx.org/OfficialPosition"
+    Occupation = "http://gedcomx.org/Occupation"
+    Ordination = "http://gedcomx.org/Ordination"
+    Pardon = "http://gedcomx.org/Pardon"
+    PhysicalDescription = "http://gedcomx.org/PhysicalDescription"
+    Probate = "http://gedcomx.org/Probate"
+    Property = "http://gedcomx.org/Property"
+    Race = "http://gedcomx.org/Race"
+    Religion = "http://gedcomx.org/Religion"
+    Residence = "http://gedcomx.org/Residence"
+    Retirement = "http://gedcomx.org/Retirement"
+    Stillbirth = "http://gedcomx.org/Stillbirth"
+    TaxAssessment = "http://gedcomx.org/TaxAssessment"
+    Tribe = "http://gedcomx.org/Tribe"
+    Will = "http://gedcomx.org/Will"
+    Visit = "http://gedcomx.org/Visit"
+    Yahrzeit = "http://gedcomx.org/Yahrzeit"
+
+    # Couple Relationship Fact Types
+    Annulment = "http://gedcomx.org/Annulment"
+    CommonLawMarriage = "http://gedcomx.org/CommonLawMarriage"
+    CivilUnion = "http://gedcomx.org/CivilUnion"
+    Divorce = "http://gedcomx.org/Divorce"
+    DivorceFiling = "http://gedcomx.org/DivorceFiling"
+    DomesticPartnership = "http://gedcomx.org/DomesticPartnership"
+    Engagement = "http://gedcomx.org/Engagement"
+    Marriage = "http://gedcomx.org/Marriage"
+    MarriageBanns = "http://gedcomx.org/MarriageBanns"
+    MarriageContract = "http://gedcomx.org/MarriageContract"
+    MarriageLicense = "http://gedcomx.org/MarriageLicense"
+    MarriageNotice = "http://gedcomx.org/MarriageNotice"
+    Separation = "http://gedcomx.org/Separation"
+
+    # Parent-Child Relationship Fact Types
+    AdoptiveParent = "http://gedcomx.org/AdoptiveParent"
+    BiologicalParent = "http://gedcomx.org/BiologicalParent"
+    ChildOrder = "http://gedcomx.org/ChildOrder"
+    EnteringHeir = "http://gedcomx.org/EnteringHeir"
+    ExitingHeir = "http://gedcomx.org/ExitingHeir"
+    FosterParent = "http://gedcomx.org/FosterParent"
+    GuardianParent = "http://gedcomx.org/GuardianParent"
+    StepParent = "http://gedcomx.org/StepParent"
+    SociologicalParent = "http://gedcomx.org/SociologicalParent"
+    SurrogateParent = "http://gedcomx.org/SurrogateParent"
+    Unknown = 'null'
+
+    @classmethod
+    def from_value(cls, value: str):
+        for member in cls:
+            if member.value == value:
+                return member
+        return FactType.Unknown
+    
+    @property
+    def description(self):
+        descriptions = {
+            FactType.Adoption: "A fact of a person's adoption.",
+            FactType.AdultChristening: "A fact of a person's christening or baptism as an adult.",
+            FactType.Amnesty: "A fact of a person's amnesty.",
+            FactType.AncestralHall: "A fact of a person's ancestral hall.",
+            FactType.AncestralPoem: "A fact of a person's ancestral poem.",
+            FactType.Apprenticeship: "A fact of a person's apprenticeship.",
+            FactType.Arrest: "A fact of a person's arrest.",
+            FactType.Award: "A fact of a person's award (medal, honor).",
+            FactType.Baptism: "A fact of a person's baptism.",
+            FactType.BarMitzvah: "A fact of a person's bar mitzvah.",
+            FactType.BatMitzvah: "A fact of a person's bat mitzvah.",
+            FactType.Birth: "A fact of a person's birth.",
+            FactType.BirthNotice: "A fact of a person's birth notice.",
+            FactType.Blessing: "A fact of an official blessing received by a person.",
+            FactType.Branch: "A fact of a person's branch within an extended clan.",
+            FactType.Burial: "A fact of the burial of a person's body after death.",
+            FactType.Caste: "A fact of a person's caste.",
+            FactType.Census: "A fact of a person's participation in a census.",
+            FactType.Christening: "A fact of a person's christening at birth.",
+            FactType.Circumcision: "A fact of a person's circumcision.",
+            FactType.Clan: "A fact of a person's clan.",
+            FactType.Confirmation: "A fact of a person's confirmation.",
+            FactType.Court: "A fact of the appearance of a person in a court proceeding.",
+            FactType.Cremation: "A fact of the cremation of a person's body.",
+            FactType.Death: "A fact of the death of a person.",
+            FactType.Education: "A fact of a person's education or educational achievement.",
+            FactType.EducationEnrollment: "A fact of a person's enrollment in an educational program.",
+            FactType.Emigration: "A fact of the emigration of a person.",
+            FactType.Enslavement: "A fact of the enslavement of a person.",
+            FactType.Ethnicity: "A fact of a person's ethnicity.",
+            FactType.Excommunication: "A fact of a person's excommunication.",
+            FactType.FirstCommunion: "A fact of a person's first communion.",
+            FactType.Funeral: "A fact of a person's funeral.",
+            FactType.GenderChange: "A fact of a person's gender change.",
+            FactType.GenerationNumber: "A fact of a person's generation number.",
+            FactType.Graduation: "A fact of a person's graduation.",
+            FactType.Heimat: "A fact of a person's heimat.",
+            FactType.Immigration: "A fact of a person's immigration.",
+            FactType.Imprisonment: "A fact of a person's imprisonment.",
+            FactType.Inquest: "A legal inquest, often after a suspicious death.",
+            FactType.LandTransaction: "A fact of a land transaction by a person.",
+            FactType.Language: "A fact of a language spoken by a person.",
+            FactType.Living: "A fact of a record of a person's living for a period.",
+            FactType.MaritalStatus: "A fact of a person's marital status.",
+            FactType.Medical: "A fact of a person's medical record.",
+            FactType.MilitaryAward: "A fact of a person's military award.",
+            FactType.MilitaryDischarge: "A fact of a person's military discharge.",
+            FactType.MilitaryDraftRegistration: "A fact of a person's draft registration.",
+            FactType.MilitaryInduction: "A fact of a person's military induction.",
+            FactType.MilitaryService: "A fact of a person's military service.",
+            FactType.Mission: "A fact of a person's church mission.",
+            FactType.MoveFrom: "A fact of a person's move from a location.",
+            FactType.MoveTo: "A fact of a person's move to a new location.",
+            FactType.MultipleBirth: "A fact of a person's birth as part of a multiple birth.",
+            FactType.NationalId: "A fact of a person's national ID.",
+            FactType.Nationality: "A fact of a person's nationality.",
+            FactType.Naturalization: "A fact of a person's naturalization.",
+            FactType.NumberOfChildren: "A fact of the number of children.",
+            FactType.NumberOfMarriages: "A fact of a person's number of marriages.",
+            FactType.Obituary: "A fact of a person's obituary.",
+            FactType.OfficialPosition: "A fact of a person's official government position.",
+            FactType.Occupation: "A fact of a person's occupation.",
+            FactType.Ordination: "A fact of a person's ordination.",
+            FactType.Pardon: "A fact of a person's legal pardon.",
+            FactType.PhysicalDescription: "A fact of a person's physical description.",
+            FactType.Probate: "A fact of a person's probate receipt.",
+            FactType.Property: "A fact of a person's property.",
+            FactType.Race: "A fact of a person's race.",
+            FactType.Religion: "A fact of a person's religion.",
+            FactType.Residence: "A fact of a person's residence.",
+            FactType.Retirement: "A fact of a person's retirement.",
+            FactType.Stillbirth: "A fact of a person's stillbirth.",
+            FactType.TaxAssessment: "A fact of a person's tax assessment.",
+            FactType.Tribe: "A fact of a person's tribe.",
+            FactType.Will: "A fact of a person's will.",
+            FactType.Visit: "A fact of a person's visit to a place.",
+            FactType.Yahrzeit: "A fact of a person's yahrzeit.",
+            FactType.AdoptiveParent: "A fact about an adoptive relationship.",
+            FactType.BiologicalParent: "A fact about the biological relationship.",
+            FactType.ChildOrder: "A fact about the child order.",
+            FactType.EnteringHeir: "A fact about an entering heir relationship.",
+            FactType.ExitingHeir: "A fact about an exiting heir relationship.",
+            FactType.FosterParent: "A fact about a foster relationship.",
+            FactType.GuardianParent: "A fact about legal guardianship.",
+            FactType.StepParent: "A fact about the step relationship.",
+            FactType.SociologicalParent: "A fact about a sociological relationship.",
+            FactType.SurrogateParent: "A fact about a surrogate relationship.",
+            FactType.Annulment: "A fact of an annulment of marriage.",
+            FactType.CommonLawMarriage: "A fact of marriage by common law.",
+            FactType.CivilUnion: "A fact of a civil union.",
+            FactType.DomesticPartnership: "A fact of a domestic partnership.",
+            FactType.Engagement: "A fact of an engagement to marry.",
+            FactType.MarriageBanns: "A fact of marriage banns.",
+            FactType.MarriageContract: "A fact of a marriage contract.",
+            FactType.MarriageLicense: "A fact of a marriage license.",
+            FactType.MarriageNotice: "A fact of a marriage notice.",
+            FactType.Separation: "A fact of a couple's separation."
+        }
+        return descriptions.get(self, "No description available.")
+    
+    @staticmethod
+    def guess(description):
+        keywords_to_fact_type = {
+            # Person Fact Types
+            "adoption": FactType.Adoption,
+            "adult christening": FactType.AdultChristening,
+            "amnesty": FactType.Amnesty,
+            "ancestral hall": FactType.AncestralHall,
+            "ancestral poem": FactType.AncestralPoem,
+            "apprenticeship": FactType.Apprenticeship,
+            "arrest": FactType.Arrest,
+            "award": FactType.Award,
+            "baptism": FactType.Baptism,
+            "bar mitzvah": FactType.BarMitzvah,
+            "bat mitzvah": FactType.BatMitzvah,
+            "birth": FactType.Birth,
+            "birth notice": FactType.BirthNotice,
+            "blessing": FactType.Blessing,
+            "branch": FactType.Branch,
+            "burial": FactType.Burial,
+            "caste": FactType.Caste,
+            "census": FactType.Census,
+            "christening": FactType.Christening,
+            "circumcision": FactType.Circumcision,
+            "clan": FactType.Clan,
+            "confirmation": FactType.Confirmation,
+            "court": FactType.Court,
+            "cremation": FactType.Cremation,
+            "death": FactType.Death,
+            "education": FactType.Education,
+            "education enrollment": FactType.EducationEnrollment,
+            "emigration": FactType.Emigration,
+            "enslavement": FactType.Enslavement,
+            "ethnicity": FactType.Ethnicity,
+            "excommunication": FactType.Excommunication,
+            "first communion": FactType.FirstCommunion,
+            "funeral": FactType.Funeral,
+            "gender change": FactType.GenderChange,
+            "generation number": FactType.GenerationNumber,
+            "graduation": FactType.Graduation,
+            "heimat": FactType.Heimat,
+            "immigration": FactType.Immigration,
+            "imprisonment": FactType.Imprisonment,
+            "inquest": FactType.Inquest,
+            "land transaction": FactType.LandTransaction,
+            "language": FactType.Language,
+            "living": FactType.Living,
+            "marital status": FactType.MaritalStatus,
+            "medical": FactType.Medical,
+            "military award": FactType.MilitaryAward,
+            "military discharge": FactType.MilitaryDischarge,
+            "military draft registration": FactType.MilitaryDraftRegistration,
+            "military induction": FactType.MilitaryInduction,
+            "military service": FactType.MilitaryService,
+            "mission": FactType.Mission,
+            "move from": FactType.MoveFrom,
+            "move to": FactType.MoveTo,
+            "multiple birth": FactType.MultipleBirth,
+            "national id": FactType.NationalId,
+            "nationality": FactType.Nationality,
+            "naturalization": FactType.Naturalization,
+            "number of children": FactType.NumberOfChildren,
+            "number of marriages": FactType.NumberOfMarriages,
+            "obituary": FactType.Obituary,
+            "official position": FactType.OfficialPosition,
+            "occupation": FactType.Occupation,
+            "ordination": FactType.Ordination,
+            "pardon": FactType.Pardon,
+            "physical description": FactType.PhysicalDescription,
+            "probate": FactType.Probate,
+            "property": FactType.Property,
+            "race": FactType.Race,
+            "religion": FactType.Religion,
+            "residence": FactType.Residence,
+            "retirement": FactType.Retirement,
+            "stillbirth": FactType.Stillbirth,
+            "tax assessment": FactType.TaxAssessment,
+            "tribe": FactType.Tribe,
+            "will": FactType.Will,
+            "visit": FactType.Visit,
+            "yahrzeit": FactType.Yahrzeit,
+
+            # Couple Relationship Fact Types
+            "annulment": FactType.Annulment,
+            "common law marriage": FactType.CommonLawMarriage,
+            "civil union": FactType.CivilUnion,
+            "divorce": FactType.Divorce,
+            "divorce filing": FactType.DivorceFiling,
+            "domestic partnership": FactType.DomesticPartnership,
+            "engagement": FactType.Engagement,
+            "marriage": FactType.Marriage,
+            "marriage banns": FactType.MarriageBanns,
+            "marriage contract": FactType.MarriageContract,
+            "marriage license": FactType.MarriageLicense,
+            "marriage notice": FactType.MarriageNotice,
+            "couple number of children": FactType.NumberOfChildren,
+            "separation": FactType.Separation,
+
+            # Parent-Child Relationship Fact Types
+            "adoptive parent": FactType.AdoptiveParent,
+            "biological parent": FactType.BiologicalParent,
+            "child order": FactType.ChildOrder,
+            "entering heir": FactType.EnteringHeir,
+            "exiting heir": FactType.ExitingHeir,
+            "foster parent": FactType.FosterParent,
+            "guardian parent": FactType.GuardianParent,
+            "step parent": FactType.StepParent,
+            "sociological parent": FactType.SociologicalParent,
+            "surrogate parent": FactType.SurrogateParent
+        }
+
+
+        description_lower = description.lower()
+    
+        # Replace any non-alphanumeric characters with a space
+        description_clean = re.sub(r'[^a-z0-9\s]', ' ', description_lower)
+        
+        # Get a list of words in the cleaned description
+        words = description_clean.split()
+
+        # Check for the best matching keyword in the description
+        for word in words:
+            matches = difflib.get_close_matches(word, keywords_to_fact_type.keys(), n=1, cutoff=0.8)
+            if matches:
+                print(f"Guessed '{description} to be of fact type: {keywords_to_fact_type[matches[0]]}")
+                return keywords_to_fact_type[matches[0]]
+        return None
+
+
+class FactQualifier(Enum):
+    Age = "http://gedcomx.org/Age"
+    Cause = "http://gedcomx.org/Cause"
+    Religion = "http://gedcomx.org/Religion"
+    Transport = "http://gedcomx.org/Transport"
+    NonConsensual = "http://gedcomx.org/NonConsensual"
+    
+    @property
+    def description(self):
+        descriptions = {
+            FactQualifier.Age: "The age of a person at the event described by the fact.",
+            FactQualifier.Cause: "The cause of the fact, such as the cause of death.",
+            FactQualifier.Religion: "The religion associated with a religious event such as a baptism or excommunication.",
+            FactQualifier.Transport: "The name of the transport associated with an event that indicates a move.",
+            FactQualifier.NonConsensual: "An indicator that the event occurred non-consensually, e.g., under enslavement."
+        }
+        return descriptions.get(self, "No description available.")
+
+
+class Fact(Conclusion):
+    identifier = 'http://gedcomx.org/v1/Fact'
+    version = 'http://gedcomx.org/conceptual-model/v1'
+
+    def __init__(self,
+                 id: str = None,
+                 lang: str = 'en',
+                 sources: Optional[List[SourceReference]] = [],
+                 analysis: URI = None,
+                 notes: Optional[List[Note]] = [],
+                 confidence: ConfidenceLevel = None,
+                 attribution: Attribution = None,
+                 type: FactType = None,
+                 date: Optional[Date] = None,
+                 place: Optional[PlaceReference] = None,
+                 value: Optional[str] = None,
+                 qualifiers  = []) -> None:       #qualifiers: Optional[List[FactQualifier]] = []) -> None:
+        super().__init__(id, lang, sources, analysis, notes, confidence, attribution)
+        self.type = type
+        self.date = date
+        self.place = place
+        self.value = value
+        self.qualifiers = qualifiers
+    
+    @property
+    def _as_dict_(self):
+        def _serialize(value):
+            if isinstance(value, (str, int, float, bool, type(None))):
+                return value
+            elif isinstance(value, dict):
+                return {k: _serialize(v) for k, v in value.items()}
+            elif isinstance(value, (list, tuple, set)):
+                return [_serialize(v) for v in value]
+            elif hasattr(value, "_as_dict_"):
+                return value._as_dict_
+            else:
+                return str("UKN " + value)  # fallback for unknown objects
+
+        # Only add Relationship-specific fields
+        fact_fields = {
+            'type': self.type.value if self.type else None,
+            'date': self.date._prop_dict() if self.date else None,
+            'place': self.place._as_dict_ if self.place else None,
+            'value': self.value,
+            'qualifiers': [q.value for q in self.qualifiers] if self.qualifiers else []
+        }
+
+        # Serialize and exclude None values
+        for key, value in fact_fields.items():
+            if value is not None:
+                                fact_fields[key] = _serialize(value)
+
+        
+        return fact_fields
+
+def ensure_list(val):
+    if val is None:
+        return []
+    return val if isinstance(val, list) else [val]
+# Fact
+Fact._from_json_ = classmethod(lambda cls, data: cls(
+    id=data.get('id'),
+    lang=data.get('lang', 'en'),
+    sources=[SourceReference._from_json_(s) for s in ensure_list(data.get('sources'))],
+    analysis=URI._from_json_(data['analysis']) if data.get('analysis') else None,
+    notes=[Note._from_json_(n) for n in ensure_list(data.get('notes'))],
+    confidence=ConfidenceLevel._from_json_(data['confidence']) if data.get('confidence') else None,
+    attribution=Attribution._from_json_(data['attribution']) if data.get('attribution') else None,
+    type=FactType.from_value(data['type']) if data.get('type') else None,
+    date=Date._from_json_(data['date']) if data.get('date') else None,
+    place=PlaceReference._from_json_(data['place']) if data.get('place') else None,
+    value=data.get('value'),
+    qualifiers=[Qualifier._from_json_(q) for q in ensure_list(data.get('qualifiers'))]
+))
+