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

gedcom_x-0.5.6.dist-info/METADATA

@@ -0,0 +1,144 @@
+Metadata-Version: 2.4
+Name: gedcom-x
+Version: 0.5.6
+Summary: Python implimentation of gedcom-x standard
+Author-email: "David J. Cartwright" <davidcartwright@hotmail.com>
+License: MIT
+Keywords: gedcom,gedcomx,ged
+Classifier: Development Status :: 4 - Beta
+Classifier: Programming Language :: Python :: 3
+Classifier: Environment :: Console
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Utilities
+Classifier: Topic :: Software Development :: User Interfaces
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+Dynamic: requires-python
+
+# GEDCOM-X Python Toolkit (gedcom-x beta 0.5.5)
+
+A lightweight, class-based Python implementation of the [GEDCOM-X data model](https://github.com/FamilySearch/gedcomx).  
+
+## ⚠️ Project Status
+
+This project is currently in **beta**.  
+While the core GEDCOM-X classes and serialization are functional, some features may not be fully implemented or may not behave exactly as expected.  
+
+- Certain GEDCOM 7 tags are not yet mapped  
+- Some classes may be missing methods or fields  
+- Error handling and validation are still evolving  
+- Backward compatibility is **not guaranteed** until the first stable release  
+
+### ✅ What You Can Do
+- Create and manipulate GEDCOM-X objects in Python  
+- Serialize and deserialize data to/from JSON  
+- Experimentally convert GEDCOM 5x & 7 files into GEDCOM-X JSON  
+- Extend the classes to handle new GEDCOM tags or custom attributes  
+- Use the library as a foundation for genealogy-related tooling or RAG pipelines  
+
+### ❌ What You Can’t Do (Yet)
+- Rely on complete coverage of all GEDCOM 7 tags  
+- Expect perfect compliance with the GEDCOM-X specification  
+- Assume strong validation or error recovery on malformed input  
+- Use it as a drop-in replacement for production genealogy software  
+- Write GEDCOM-X to GEDCOM 5x / 7
+- Create Graphs from Genealogies
+
+Contributors and testers are welcome — feedback will help stabilize the library!
+
+---
+
+This library aims to provide:
+
+- Python classes for every GEDCOM-X type (Person, Fact, Source, etc.)
+- Extensibility, with current GEDCOM RS etc, extension built in
+- Serialization and Deserialization to/from GEDCOM-X JSON
+- Utilities to convert GEDCOM 5x & 7 GEDCOM Files into GEDCOM-X and back
+- Type-safe field definitions and extensibility hooks for future tags
+
+---
+
+## Features
+
+- **Complete GEDCOM-X Class Coverage**  
+  Each GEDCOM-X type is represented as a Python class with fields and types.
+
+- **Serialization / Deserialization**  
+  Every class can serialize to JSON and reconstruct from JSON via `_as_dict_()` and `_from_json()` methods.
+
+- **Type Checking & Enum Validation**  
+  Uses Python type hints and enums to ensure correct values (e.g. FactType, EventType, ConfidenceLevel).
+
+- **Composable / Nestable Classes**  
+  Nested objects (e.g. Person → Name → NameForm → TextValue) are constructed and validated recursively.
+
+- **GEDCOM 7 → GEDCOM-X Conversion**  
+  Experimental parser to read GEDCOM 7 files and convert them into structured GEDCOM-X JSON.
+
+---
+
+## Installation
+
+Clone the repository and install dependencies:
+
+```bash
+git clone https://github.com/yourusername/gedcom-x.git
+cd gedcom-x
+pip install -r requirements.txt
+```
+or
+```
+pip install gedcom-x
+```
+---
+
+## Examples
+
+<details>
+
+<summary>Create a Person Gedcom-X Type</summary>
+
+```python
+import json
+from gedcomx import Person, Name, NameForm, TextValue
+
+person = Person(
+    id="P-123",
+    names=[Name(
+        nameForms=[NameForm(
+            fullText=TextValue(value="John Doe")
+        )]
+    )]
+)
+
+print(json.dumps(person._as_dict_,indent=4))
+```
+result
+```text
+{
+    "id": "P-123",
+    "lang": "en",
+    "private": false,
+    "living": false,
+    "gender": {
+        "lang": "en",
+        "type": "http://gedcomx.org/Unknown"
+    },
+    "names": [
+        {
+            "lang": "en",
+            "nameForms": [
+                {
+                    "lang": "en",
+                    "fullText": {
+                        "lang": "en",
+                        "value": "John Doe"
+                    }
+                }
+            ]
+        }
+    ]
+}
+
+</details>

gedcom_x-0.5.6.dist-info/RECORD

@@ -0,0 +1,45 @@
+gedcomx/Address.py,sha256=FDBic6oQB30eKMWM7-6_YVPHaJdPhziU5LybwE5TY5Q,4855
+gedcomx/Agent.py,sha256=C-tzfqcjuU22iJ2LjoatKdCbI_i0xskpmZsuj58K6WY,8555
+gedcomx/Attribution.py,sha256=2bcl2UNsMPn10kDrA080qFRzxK-KYqZBgmPGNBZ2M4Y,2608
+gedcomx/Conclusion.py,sha256=t8n8FuWwzinFTPHp9D2Umu93-4A12I9L5fCx510mfqA,8414
+gedcomx/Coverage.py,sha256=BVlB3kWDoOP2j86j67hNJLC4LqoLwqs3N93z0ZbXYTw,1227
+gedcomx/Date.py,sha256=cv2UeyOcTHuH2CVHq9EjTnj3FR-r4_OVuPiuc8sbOPc,2130
+gedcomx/Document.py,sha256=32nWfDNVWkPK2_I0-hhcNQkrjH3ssdbtw-II3QMMelw,2957
+gedcomx/Event.py,sha256=BHhmO2UlxbkSzB5htdMRf2h-WNuJQsWfrSC8tNGQ6Mg,10375
+gedcomx/EvidenceReference.py,sha256=WXZpmcKzwb3lYQmGVf-TY2IsbNG3fIInPY1khRjtOSg,348
+gedcomx/Exceptions.py,sha256=0OdPM3euhBMgX8o61ZwPuKeN8zPuSuuDcSBFflVGFqk,587
+gedcomx/ExtensibleEnum.py,sha256=DftCZLMBNul3C9hwh-rf0GE3SVdvylvyd5mt7bX_l6o,6535
+gedcomx/Fact.py,sha256=-Zz321xeFd93riaX4C4i7gIPwpqdArAYZDlWRoXA1Uk,24444
+gedcomx/Gedcom.py,sha256=l_BuLBynQacDtpLjhs2Afrabfiqt2Opoo_5_7myI7Z4,1709
+gedcomx/Gedcom5x.py,sha256=ZaMqvmDTn684m4uSDRy3uxgKk442K5WZjDy_0s2ga-8,22459
+gedcomx/GedcomX.py,sha256=mFviKVvk8dSn4tHPd1hkHBxoTOMNKlBv7gH3Q1n87IU,63666
+gedcomx/Gender.py,sha256=AV125vECC5JSgvNJRmotjDEt-A3cFzth6pcSLFwJBEE,2328
+gedcomx/Group.py,sha256=VNI_cI_-YnJ9cHzwMmHD8qwDNMe89kEocPuQ67rwStA,1606
+gedcomx/Identifier.py,sha256=pJB8DlMF1k5DNR0Lha6rGTTiOtwe0joVLRLQCuoXtIw,8507
+gedcomx/Logging.py,sha256=vBDOjawVXc4tCge1laYjy6_2Ves-fnGzG0m6NnLZejE,624
+gedcomx/LoggingHub.py,sha256=lOeMP_0hFPydVNuMcUC31FMBRHtRMP02pBMM8TuhsNg,7143
+gedcomx/Mutations.py,sha256=idhQsnikCTovmNEGAhDsOe97V0L9AnFTRaufzUPm64w,6298
+gedcomx/Name.py,sha256=en_VkGjpZPP_Dbl9HSq2h2JCtLS2NMzmLvis5RdBPeM,12913
+gedcomx/Note.py,sha256=cvV4-fCZ0oh2zXfzD-YYoIM_WTox-fk2_bfl3i4CoNc,2251
+gedcomx/OnlineAccount.py,sha256=P24o98IXo_8XQoICYZPgALjdzS0q8t2l4DU3Od9KxyI,291
+gedcomx/Person.py,sha256=LyGPCZh6rZU_dE3GCJE92x1lLk41c_Edr_Po9smhPLc,7321
+gedcomx/PlaceDescription.py,sha256=TRHIkDiErHa_mlx_x8gYCF6UnQ-XgT08uSmYmFNa4u0,3255
+gedcomx/PlaceReference.py,sha256=3NyEYq0FaMI8m3l4H6-Ov-n9NUq_m751iYVxofqtv30,870
+gedcomx/Qualifier.py,sha256=mZ_GWT3gca8g9nWidlXIRTN5dEtf_rmnLHYl1jJkQYs,728
+gedcomx/Relationship.py,sha256=oyT501vR5jvWxqEYy3KvW9egD4CPL5JaAYWJmlNy9Ig,3599
+gedcomx/Resource.py,sha256=bZ2dV-OdpvmDRCppyfHJXiarIKL7-OcofwvYRnpOJW0,2324
+gedcomx/Serialization.py,sha256=ubtmrvi-nKmVUCK1XGwuLijrPMggNJe--kkCIC-87Ds,18580
+gedcomx/SourceCitation.py,sha256=aW-lEb7bT9QU49GiBjJppFMBvtisR6fhVVuXjr5y4vQ,742
+gedcomx/SourceDescription.py,sha256=zOkXo-fy-uCl_EGU8B-c6pzhlMk3nYNHn13ln1AkYk0,11914
+gedcomx/SourceReference.py,sha256=swVzZ5A0jt5yFYJNJvMnQZtb7d-2YEAQPxp2a4lEY1k,5071
+gedcomx/Subject.py,sha256=znee3SxYKk99JLP6KmZHkXs5hIOGu_jeLwxagENNfXs,3298
+gedcomx/TextValue.py,sha256=6B0wMxL0nigFNzhXZDhbTONvFGbnM2t2NcDZiZuu4Zw,1112
+gedcomx/TopLevelTypeCollection.py,sha256=nvTO6GwFwEZk9jX4fVqhy75ygsshomNb20tnlExKqyY,1495
+gedcomx/Translation.py,sha256=NWa1NtTOC_VgQ-EGwWG06zUpddRxdKFSLPP6066JFaA,12485
+gedcomx/URI.py,sha256=S2pFsu_VyKgOsRdHIj8pjnh6_tdA3OjAYiIugoEd70k,4271
+gedcomx/Zip.py,sha256=lBxcv-Vip45884EHj56wZJJ5I36Q38UuHUidDxQBoS8,14
+gedcomx/__init__.py,sha256=O8LkNk9b8BHIN3mf0RowfR9M2HdKYhF8Fgi3qxW2RSs,1660
+gedcom_x-0.5.6.dist-info/METADATA,sha256=rNO-ZyEC3th_8iML9XtfJOQcnPJI1uksyWz2MB9DAV8,4332
+gedcom_x-0.5.6.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+gedcom_x-0.5.6.dist-info/top_level.txt,sha256=smVBF4nxSU-mzCd6idtRYTbYjPICMMi8pTqewEmqF8Y,8
+gedcom_x-0.5.6.dist-info/RECORD,,

gedcomx/Address.py

@@ -61,6 +61,8 @@ class Address:
     
     @value.setter
     def value(self,value: str):
+        self._value = value
+        return
         raise NotImplementedError("Parsing of a full address is not implimented.")
     
     def _append(self,value):

gedcomx/Agent.py

@@ -139,6 +139,14 @@ class Agent:
         }
         return Serialization.serialize_dict(type_as_dict)
     
+    @classmethod
+    def _from_json_(cls, data: dict):
+        """
+        Create a Person instance from a JSON-dict (already parsed).
+        """
+        type_as_dict = Serialization.get_class_fields('Agent')
+        return Serialization.deserialize(data, type_as_dict)
+    
     def __str__(self):
         """
         Return a human-readable string representation of the Agent.
@@ -179,8 +187,7 @@ class Agent:
             self.uri == other.uri
         )
         '''
-        print(other)
-        print(self)
+        
         self_names = {n.value for n in self.names if hasattr(n, "value")}
         other_names = {n.value for n in other.names if hasattr(n, "value")}
         if self_names & other_names:  # intersection not empty

gedcomx/Attribution.py

@@ -10,11 +10,11 @@ class Attribution:
     """Attribution Information for a Genealogy, Conclusion, Subject and child classes
 
     Args:
-        contributor (Agent):            Contributor to object being attributed.
-        modified (timestamp):           timestamp for when this record was modified.
-        changeMessage (str):            Birth date (YYYY-MM-DD).
+        contributor (Agent, optional):            Contributor to object being attributed.
+        modified (timestamp, optional):           timestamp for when this record was modified.
+        changeMessage (str, optional):            Birth date (YYYY-MM-DD).
         creator (Agent, optional):      Creator of object being attributed.
-        created (timestamp):            timestamp for when this record was created
+        created (timestamp, optional):            timestamp for when this record was created
 
     Raises:
         
@@ -56,45 +56,9 @@ class Attribution:
         """
         # contributor
         
-        contrib = None
-        if 'contributor' in data:
-            contrib_data = data['contributor']
-            
-            contrib = Resource(contrib_data['resource'],contrib_data['resourceId'])
-
-        # creator
-        creat = None
-        if 'creator' in data:
-            raw = data['creator']
-            if isinstance(raw, dict):
-                creat = Resource._from_json_(raw)
-            elif isinstance(raw, str):
-                creat = Resource(uri=raw)
-
-        # parse created date
-        raw_created = data.get('created')
-        if isinstance(raw_created, (int, float)):
-            created_dt = datetime.fromtimestamp(raw_created / 1000.0)
-        elif isinstance(raw_created, str):
-            created_dt = datetime.fromisoformat(raw_created)
-        else:
-            created_dt = None
-
-        # parse modified date
-        raw_modified = data.get('modified')
-        if isinstance(raw_modified, (int, float)):
-            modified_dt = datetime.fromtimestamp(raw_modified / 1000.0)
-        elif isinstance(raw_modified, str):
-            modified_dt = datetime.fromisoformat(raw_modified)
-        else:
-            modified_dt = None
-
-        change_msg = data.get('changeMessage')
-
-        return cls(
-            contributor=contrib,
-            created=created_dt,
-            creator=creat,
-            modified=modified_dt,
-            changeMessage=change_msg
-        )
+        """
+        Create a Person instance from a JSON-dict (already parsed).
+        """
+        from .Serialization import Serialization
+        
+        return Serialization.deserialize(data, Attribution)

gedcomx/Conclusion.py

@@ -11,7 +11,7 @@ from .Qualifier import Qualifier
 from .Serialization import Serialization
 from .SourceReference import SourceReference
 from .Resource import Resource, URI
-from ._Links import _LinkList, _Link
+from .Extensions.rs10.rsLink import _rsLinkList, rsLink
 
 from collections.abc import Sized
 
@@ -19,15 +19,72 @@ class ConfidenceLevel(Qualifier):
     High = "http://gedcomx.org/High"
     Medium = "http://gedcomx.org/Medium"
     Low = "http://gedcomx.org/Low"
-    
+
+    _NAME_TO_URI = {
+        "high": High,
+        "medium": Medium,
+        "low": Low,
+    }
+
+    @classmethod
+    def _from_json_(cls, data):
+        """
+        Accepts:
+          - "High" | "Medium" | "Low"
+          - "http://gedcomx.org/High" | ".../Medium" | ".../Low"
+          - {"type": "..."} or {"value": "..."} or {"confidence": "..."} or {"level": "..."} or {"uri": "..."}
+          - existing ConfidenceLevel instance
+        Returns:
+          ConfidenceLevel instance with .value set to the canonical URI.
+        """
+        if data is None:
+            return None
+
+        if isinstance(data, cls):
+            return data
+
+        # Extract token from dicts or use the raw scalar
+        if isinstance(data, dict):
+            token = (
+                data.get("confidence")
+                or data.get("type")
+                or data.get("value")
+                or data.get("level")
+                or data.get("uri")
+            )
+        else:
+            token = data
+
+        if token is None:
+            return None
+
+        token_str = str(token).strip()
+
+        # Normalize to canonical URI
+        if token_str.lower() in cls._NAME_TO_URI:
+            uri = cls._NAME_TO_URI[token_str.lower()]
+        elif token_str in (cls.High, cls.Medium, cls.Low):
+            uri = token_str
+        else:
+            raise ValueError(f"Unknown ConfidenceLevel: {token!r}")
+
+        # Create a ConfidenceLevel instance without invoking Qualifier.__init__
+        obj = cls.__new__(cls)
+        # store the canonical URI on the instance; used by description and (optionally) serialization
+        obj.value = uri
+        return obj
+
     @property
     def description(self):
         descriptions = {
-            ConfidenceLevel.High: "The contributor has a high degree of confidence that the assertion is true.",
-            ConfidenceLevel.Medium: "The contributor has a medium degree of confidence that the assertion is true.",
-            ConfidenceLevel.Low: "The contributor has a low degree of confidence that the assertion is true."
+            self.High: "The contributor has a high degree of confidence that the assertion is true.",
+            self.Medium: "The contributor has a medium degree of confidence that the assertion is true.",
+            self.Low: "The contributor has a low degree of confidence that the assertion is true."
         }
-        return descriptions.get(self, "No description available.")
+        # Works whether the instance holds .value or (edge-case) if `self` is compared directly
+        key = getattr(self, "value", self)
+        return descriptions.get(key, "No description available.")
+
     
 class Conclusion:
     """
@@ -53,13 +110,7 @@ class Conclusion:
         uri (Resource, optional): A URI reference for the conclusion. Defaults to a 
             URI with the fragment set to the `id`.
         links (_LinkList, optional): A list of links associated with the conclusion. 
-            Defaults to an empty `_LinkList`.
-
-    Methods:
-        add_note(note_to_add): Adds a note if it is not a duplicate and does not 
-            exceed the maximum allowed notes.
-        add_source(source_to_add): Adds a source reference if it is not already present.
-        add_link(link): Adds a link to the `_LinkList`.
+            Defaults to an empty `_LinkList`.  
     """
     identifier = 'http://gedcomx.org/v1/Conclusion'
     version = 'http://gedcomx.org/conceptual-model/v1'
@@ -75,20 +126,20 @@ class Conclusion:
         return short_uuid
     
     def __init__(self,
-                 id: Optional[str],
+                 id: Optional[str] = None,
                  lang: Optional[str] = 'en',
                  sources: Optional[List[SourceReference]] = None,
                  analysis: Optional[object | Resource] = None,
-                 notes: Optional[List[Note]] = [],
+                 notes: Optional[List[Note]] = None,
                  confidence: Optional[ConfidenceLevel] = None,
                  attribution: Optional[Attribution] = None,
                  uri: Optional[Resource] = None,
                  _max_note_count: int = 20,
-                 links: Optional[_LinkList] = None) -> None:
+                 links: Optional[_rsLinkList] = None) -> None:
         
         self._id_generator = Conclusion.default_id_generator
 
-        self.id = id if id else self._id_generator()
+        self.id = id if id else None
         self.lang = lang
         self.sources = sources if sources else []
         self.analysis = analysis
@@ -96,8 +147,8 @@ class Conclusion:
         self.confidence = confidence
         self.attribution = attribution
         self.max_note_count = _max_note_count
-        self.uri = uri if uri else URI(fragment=id)
-        self.links = links if links else _LinkList()    #NOTE This is not in specification, following FS format
+        self.uri = uri if uri else URI(fragment=id if id else self.id)
+        self.links = links if links else _rsLinkList()    #NOTE This is not in specification, following FS format
     
     def add_note(self,note_to_add: Note):
         if self.notes and len(self.notes) >= self.max_note_count:
@@ -118,9 +169,22 @@ class Conclusion:
         else:
             raise ValueError()
         
-    def add_link(self,link: _Link):
-        if link and isinstance(link,_Link):
+    def add_link(self,link: rsLink) -> bool:
+        """
+        Adds a link to the Conclusion link list.
+
+        Args:
+            link (rsLink): The link to be added.
+
+        Returns:
+            bool: The return value. True for success, False otherwise.
+        
+        Note: Duplicate checking not impimented at this level
+        """
+        if link and isinstance(link,rsLink):
             self.links.add(link)
+            return True
+        return False
     
     @property
     def _as_dict_(self):

gedcomx/Coverage.py

@@ -2,6 +2,7 @@ from typing import Optional
 
 from .Date import Date
 from .PlaceReference import PlaceReference
+from .Serialization import Serialization
 
 class Coverage:
     identifier = 'http://gedcomx.org/v1/Coverage'
@@ -13,6 +14,15 @@ class Coverage:
     
     # ...existing code...
 
+    @property
+    def _as_dict_(self):
+        type_as_dict = {
+            'spatial': self.spatial if self.spatial else None,
+            'temporal': self. temporal if self.temporal else None
+        }
+
+        return Serialization.serialize_dict(type_as_dict) 
+
     @classmethod
     def _from_json_(cls, data: dict):
         """

gedcomx/Date.py

@@ -21,7 +21,8 @@ class Date:
 
         self.normalized: DateNormalization | None = normalized if normalized else None
     
-    def _prop_dict(self):
+    @property
+    def _as_dict_(self):
         return {'original': self.orginal,
                 'formal': self.formal}
 
@@ -33,12 +34,6 @@ class Date:
         return Date(original=original,formal=formal)
         
 
-Date._to_dict_ = lambda self: {
-    'original': self.orginal,
-    'formal': self.formal}  
-
-
-
 
 def date_to_timestamp(date_str: str, assume_utc_if_naive: bool = True, print_definition: bool = True):
     """

gedcomx/Document.py

@@ -1,13 +1,13 @@
 from enum import Enum
 from typing import Optional, List
 
-from gedcomx.Attribution import Attribution
-#from gedcomx.Conclusion import ConfidenceLevel
-from gedcomx.Note import Note
-from gedcomx.SourceReference import SourceReference
-from gedcomx.Resource import Resource
+from .Attribution import Attribution
+from .Note import Note
+from .SourceReference import SourceReference
+from .Resource import Resource
 
 from .Conclusion import Conclusion
+from .Serialization import Serialization
 
 class DocumentType(Enum):
     Abstract = "http://gedcomx.org/Abstract"
@@ -49,4 +49,25 @@ class Document(Conclusion):
         self.type = type
         self.extracted = extracted
         self.textType = textType
-        self.text = text
+        self.text = text
+    
+    @property
+    def _as_dict(self):
+        type_as_dict = super()._as_dict_
+        if self.type:
+            type_as_dict['type'] = self.type.value
+        if self.extracted is not None:
+            type_as_dict['extracted'] = self.extracted
+        if self.textType:
+            type_as_dict['textType'] = self.textType.value
+        if self.text:
+            type_as_dict['text'] = self.text
+        return Serialization.serialize_dict(type_as_dict)
+    
+    @classmethod
+    def _from_json_(cls, data: dict):
+        """
+        Create a Person instance from a JSON-dict (already parsed).
+        """
+        type_as_dict = Serialization.get_class_fields('Document')
+        return Serialization.deserialize(data, type_as_dict)

gedcomx/Event.py

@@ -9,6 +9,7 @@ from .Conclusion import Conclusion, ConfidenceLevel
 from .Date import Date
 from .Note import Note
 from .PlaceReference import PlaceReference
+from .Serialization import Serialization
 from .SourceReference import SourceReference
 from .Subject import Subject
 from .Resource import Resource
@@ -84,6 +85,7 @@ class EventType(Enum):
     Naturalization = "http://gedcomx.org/Naturalization"
     Ordination = "http://gedcomx.org/Ordination"
     Retirement = "http://gedcomx.org/Retirement"
+    MarriageSettlment = 'https://gedcom.io/terms/v7/MARS'
     
     @property
     def description(self):
@@ -192,4 +194,21 @@ class Event(Subject):
                  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)
+        super().__init__(id, lang, sources, analysis, notes, confidence, attribution, extracted, evidence, media, identifiers)
+
+        self.type = type if type and isinstance(type, EventType) else None
+        self.date = date if date and isinstance(date, Date) else None               
+        self.place = place if place and isinstance(place, PlaceReference) else None
+        self.roles = roles if roles and isinstance(roles, list) else []
+    
+    @property
+    def _as_dict_(self):
+        raise NotImplementedError("Not implemented yet")
+    
+    @classmethod
+    def _from_json_(cls, data: dict):
+        """
+        Create a Person instance from a JSON-dict (already parsed).
+        """
+        type_as_dict = Serialization.get_class_fields('Event')
+        return Serialization.deserialize(data, type_as_dict)

gedcomx/Exceptions.py

@@ -3,6 +3,12 @@
 class GedcomXError(Exception):
     """Base for all app-specific errors."""
 
+class GedcomClassAttributeError(GedcomXError):
+    def __init__(self, *args: object) -> None:
+        msg = f"This class need more information to be created: {args}"
+        super().__init__(msg)
+
+
 class TagConversionError(GedcomXError):
     def __init__(self, record,levelstack):
         msg = f"Cannot convert: #{record.line} TAG: {record.tag} {record.xref if record.xref else ''} Value:{record.value} STACK: {type(levelstack[record.level-1]).__name__}"