gedcom-x 0.5.2__tar.gz → 0.5.6__tar.gz

gedcom_x-0.5.6/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,126 @@
+# 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/gedcom_x.egg-info/PKG-INFO

@@ -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.2 → gedcom_x-0.5.6}/gedcom_x.egg-info/SOURCES.txt

@@ -1,3 +1,4 @@
+README.md
 pyproject.toml
 setup.py
 gedcom_x.egg-info/PKG-INFO
@@ -14,13 +15,17 @@ gedcomx/Document.py
 gedcomx/Event.py
 gedcomx/EvidenceReference.py
 gedcomx/Exceptions.py
+gedcomx/ExtensibleEnum.py
 gedcomx/Fact.py
 gedcomx/Gedcom.py
+gedcomx/Gedcom5x.py
 gedcomx/GedcomX.py
 gedcomx/Gender.py
 gedcomx/Group.py
 gedcomx/Identifier.py
 gedcomx/Logging.py
+gedcomx/LoggingHub.py
+gedcomx/Mutations.py
 gedcomx/Name.py
 gedcomx/Note.py
 gedcomx/OnlineAccount.py
@@ -37,8 +42,7 @@ gedcomx/SourceReference.py
 gedcomx/Subject.py
 gedcomx/TextValue.py
 gedcomx/TopLevelTypeCollection.py
+gedcomx/Translation.py
 gedcomx/URI.py
 gedcomx/Zip.py
-gedcomx/_Links.py
-gedcomx/__init__.py
-gedcomx/g7interop.py
+gedcomx/__init__.py

{gedcom_x-0.5.2 → gedcom_x-0.5.6}/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):

{gedcom_x-0.5.2 → gedcom_x-0.5.6}/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

{gedcom_x-0.5.2 → gedcom_x-0.5.6}/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)