pyRegRep 11__tar.gz → 13__tar.gz

{pyregrep-11 → pyregrep-13}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyRegRep
-Version: 11
+Version: 13
 Summary: Your package description
 Author: Andrey Shapovalov
 Author-email: mt.andrey@gmail.com
@@ -28,8 +28,10 @@ Dynamic: license-file
 - ✅ Обробка всіх типів значень: Boolean, String, Integer, DateTime, Collection, InternationalString, AnyValue
 - ✅ Серіалізація даних у зручний Python-формат (`dict`)
 - ✅ Фабрика слотів `get_slot()` — програмне створення RIM-слотів за типом
+- ✅ Builder-класи для елементів `RegistryObject`, `RepositoryItemRef`, `QueryResponse`, `Classification`
 - ✅ Серіалізація `AnyValueType` через `xmltodict` (параметр `any_type=True`)
 - ✅ Підтримка вкладених колекцій та складних структур
+- ✅ Безпечний доступ до вкладених даних через `deep_get()`
 
 ## Вимоги
 
@@ -68,6 +70,12 @@ print(parser.serialize())
 
 # Серіалізація з обробкою AnyValueType в dict
 print(parser.serialize(any_type=True))
+
+from pyRegRep4 import deep_get
+
+# Безпечний доступ до вкладених ключів
+spec_id = deep_get(parser.serialize(), "doc", "SpecificationIdentifier", default="unknown")
+print(spec_id)
 ```
 
 ### Програмне створення RIM-слотів
@@ -191,6 +199,75 @@ except ValueError as e:
 
 ---
 
+### Builder-класи XML елементів (`pyRegRep4.RIMElement`)
+
+Публічні класи для побудови типових елементів RIM/query:
+
+- `RegistryObject`
+- `RepositoryItemRef`
+- `QueryResponse`
+- `Classification`
+
+Усі класи мають однаковий базовий контракт:
+- `element` — повертає `etree._Element` (або `ValueError`, якщо елемент ще не створено)
+- `text` — серіалізований XML (`bytes`)
+- `create_element(...)` — будує XML елемент і повертає `self` (chain-style)
+
+```python
+from pyRegRep4.RIMElement import RepositoryItemRef, QueryResponse
+
+ref = RepositoryItemRef().create_element(
+    "https://example.org/document.xml",
+    "Document",
+)
+print(ref.text)
+
+response = QueryResponse().create_element(
+    "urn:oasis:names:tc:ebxml-regrep:ResponseStatusType:Success",
+    "req-1",
+)
+print(response.element.tag)
+```
+
+---
+
+### Функція `deep_get()` (`pyRegRep4.utils`)
+
+```python
+deep_get(data: dict, *keys, default=None)
+```
+
+Безпечно дістає значення з вкладеного `dict` за послідовністю ключів.
+
+| Параметр | Тип | Опис |
+|----------|-----|------|
+| `data` | `dict` | Джерело даних |
+| `*keys` | `Any` | Шлях ключів для проходу по вкладеному словнику |
+| `default` | `Any` | Значення за замовчуванням, якщо шлях не знайдено |
+
+**Поведінка:**
+- якщо на будь-якому кроці значення не є `dict` — повертається `default`
+- якщо кінцеве значення `None` — повертається `default`
+- якщо `keys` не передані — повертається `data`
+
+```python
+from pyRegRep4 import deep_get
+
+data = {
+    "doc": {
+        "Procedure": [{"lang": "en", "value": "GetBirthCertificate"}]
+    }
+}
+
+value = deep_get(data, "doc", "Procedure", 0, "value", default="n/a")
+print(value)  # n/a (бо deep_get працює тільки з dict-ланцюжком)
+
+procedure = deep_get(data, "doc", "Procedure", default=[])
+print(procedure)  # [{"lang": "en", "value": "GetBirthCertificate"}]
+```
+
+---
+
 ### Клас `NS` (`pyRegRep4.NS`)
 
 Базовий клас для управління RIM namespace. Надає метод `_tname(prefix, localname)` для генерування кваліфікованих імен тегів у нотації Clark.
@@ -206,14 +283,16 @@ except ValueError as e:
 ```
 pyRegRep/
 ├── pyRegRep4/
-│   ├── __init__.py          # Експорт: get_slot та типи слотів
+│   ├── __init__.py          # Експорт: get_slot, deep_get, Parsing, serialize_any_value_type
 │   ├── RIMElement.py        # Класи слотів + фабрика get_slot()
 │   ├── RIMParsing.py        # Парсер Parsing + serialize()
+│   ├── utils.py             # deep_get() для вкладених словників
 │   └── NS.py                # Базовий клас для namespace
 ├── tests/
 │   ├── conftest.py          # sys.path для CI
 │   ├── test_rim_parsing.py  # Тести парсера
 │   ├── test_rim_element.py  # Тести get_slot() та типів слотів
+│   ├── test_utils.py        # Тести deep_get()
 │   ├── EDM_Ferst_Request.xml
 │   ├── EDM_Ferst_Response.xml
 │   ├── EDM_Second_Request.xml
@@ -291,4 +370,4 @@ MIT License — див. файл [LICENSE](LICENSE)
 
 ---
 
-**Версія:** 11 · **Оновлено:** 2026-03-11
+**Версія:** 13 · **Оновлено:** 2026-04-14

{pyregrep-11 → pyregrep-13}/README.md

@@ -14,8 +14,10 @@
 - ✅ Обробка всіх типів значень: Boolean, String, Integer, DateTime, Collection, InternationalString, AnyValue
 - ✅ Серіалізація даних у зручний Python-формат (`dict`)
 - ✅ Фабрика слотів `get_slot()` — програмне створення RIM-слотів за типом
+- ✅ Builder-класи для елементів `RegistryObject`, `RepositoryItemRef`, `QueryResponse`, `Classification`
 - ✅ Серіалізація `AnyValueType` через `xmltodict` (параметр `any_type=True`)
 - ✅ Підтримка вкладених колекцій та складних структур
+- ✅ Безпечний доступ до вкладених даних через `deep_get()`
 
 ## Вимоги
 
@@ -54,6 +56,12 @@ print(parser.serialize())
 
 # Серіалізація з обробкою AnyValueType в dict
 print(parser.serialize(any_type=True))
+
+from pyRegRep4 import deep_get
+
+# Безпечний доступ до вкладених ключів
+spec_id = deep_get(parser.serialize(), "doc", "SpecificationIdentifier", default="unknown")
+print(spec_id)
 ```
 
 ### Програмне створення RIM-слотів
@@ -177,6 +185,75 @@ except ValueError as e:
 
 ---
 
+### Builder-класи XML елементів (`pyRegRep4.RIMElement`)
+
+Публічні класи для побудови типових елементів RIM/query:
+
+- `RegistryObject`
+- `RepositoryItemRef`
+- `QueryResponse`
+- `Classification`
+
+Усі класи мають однаковий базовий контракт:
+- `element` — повертає `etree._Element` (або `ValueError`, якщо елемент ще не створено)
+- `text` — серіалізований XML (`bytes`)
+- `create_element(...)` — будує XML елемент і повертає `self` (chain-style)
+
+```python
+from pyRegRep4.RIMElement import RepositoryItemRef, QueryResponse
+
+ref = RepositoryItemRef().create_element(
+    "https://example.org/document.xml",
+    "Document",
+)
+print(ref.text)
+
+response = QueryResponse().create_element(
+    "urn:oasis:names:tc:ebxml-regrep:ResponseStatusType:Success",
+    "req-1",
+)
+print(response.element.tag)
+```
+
+---
+
+### Функція `deep_get()` (`pyRegRep4.utils`)
+
+```python
+deep_get(data: dict, *keys, default=None)
+```
+
+Безпечно дістає значення з вкладеного `dict` за послідовністю ключів.
+
+| Параметр | Тип | Опис |
+|----------|-----|------|
+| `data` | `dict` | Джерело даних |
+| `*keys` | `Any` | Шлях ключів для проходу по вкладеному словнику |
+| `default` | `Any` | Значення за замовчуванням, якщо шлях не знайдено |
+
+**Поведінка:**
+- якщо на будь-якому кроці значення не є `dict` — повертається `default`
+- якщо кінцеве значення `None` — повертається `default`
+- якщо `keys` не передані — повертається `data`
+
+```python
+from pyRegRep4 import deep_get
+
+data = {
+    "doc": {
+        "Procedure": [{"lang": "en", "value": "GetBirthCertificate"}]
+    }
+}
+
+value = deep_get(data, "doc", "Procedure", 0, "value", default="n/a")
+print(value)  # n/a (бо deep_get працює тільки з dict-ланцюжком)
+
+procedure = deep_get(data, "doc", "Procedure", default=[])
+print(procedure)  # [{"lang": "en", "value": "GetBirthCertificate"}]
+```
+
+---
+
 ### Клас `NS` (`pyRegRep4.NS`)
 
 Базовий клас для управління RIM namespace. Надає метод `_tname(prefix, localname)` для генерування кваліфікованих імен тегів у нотації Clark.
@@ -192,14 +269,16 @@ except ValueError as e:
 ```
 pyRegRep/
 ├── pyRegRep4/
-│   ├── __init__.py          # Експорт: get_slot та типи слотів
+│   ├── __init__.py          # Експорт: get_slot, deep_get, Parsing, serialize_any_value_type
 │   ├── RIMElement.py        # Класи слотів + фабрика get_slot()
 │   ├── RIMParsing.py        # Парсер Parsing + serialize()
+│   ├── utils.py             # deep_get() для вкладених словників
 │   └── NS.py                # Базовий клас для namespace
 ├── tests/
 │   ├── conftest.py          # sys.path для CI
 │   ├── test_rim_parsing.py  # Тести парсера
 │   ├── test_rim_element.py  # Тести get_slot() та типів слотів
+│   ├── test_utils.py        # Тести deep_get()
 │   ├── EDM_Ferst_Request.xml
 │   ├── EDM_Ferst_Response.xml
 │   ├── EDM_Second_Request.xml
@@ -277,4 +356,4 @@ MIT License — див. файл [LICENSE](LICENSE)
 
 ---
 
-**Версія:** 11 · **Оновлено:** 2026-03-11
+**Версія:** 13 · **Оновлено:** 2026-04-14

{pyregrep-11 → pyregrep-13}/pyRegRep.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyRegRep
-Version: 11
+Version: 13
 Summary: Your package description
 Author: Andrey Shapovalov
 Author-email: mt.andrey@gmail.com
@@ -28,8 +28,10 @@ Dynamic: license-file
 - ✅ Обробка всіх типів значень: Boolean, String, Integer, DateTime, Collection, InternationalString, AnyValue
 - ✅ Серіалізація даних у зручний Python-формат (`dict`)
 - ✅ Фабрика слотів `get_slot()` — програмне створення RIM-слотів за типом
+- ✅ Builder-класи для елементів `RegistryObject`, `RepositoryItemRef`, `QueryResponse`, `Classification`
 - ✅ Серіалізація `AnyValueType` через `xmltodict` (параметр `any_type=True`)
 - ✅ Підтримка вкладених колекцій та складних структур
+- ✅ Безпечний доступ до вкладених даних через `deep_get()`
 
 ## Вимоги
 
@@ -68,6 +70,12 @@ print(parser.serialize())
 
 # Серіалізація з обробкою AnyValueType в dict
 print(parser.serialize(any_type=True))
+
+from pyRegRep4 import deep_get
+
+# Безпечний доступ до вкладених ключів
+spec_id = deep_get(parser.serialize(), "doc", "SpecificationIdentifier", default="unknown")
+print(spec_id)
 ```
 
 ### Програмне створення RIM-слотів
@@ -191,6 +199,75 @@ except ValueError as e:
 
 ---
 
+### Builder-класи XML елементів (`pyRegRep4.RIMElement`)
+
+Публічні класи для побудови типових елементів RIM/query:
+
+- `RegistryObject`
+- `RepositoryItemRef`
+- `QueryResponse`
+- `Classification`
+
+Усі класи мають однаковий базовий контракт:
+- `element` — повертає `etree._Element` (або `ValueError`, якщо елемент ще не створено)
+- `text` — серіалізований XML (`bytes`)
+- `create_element(...)` — будує XML елемент і повертає `self` (chain-style)
+
+```python
+from pyRegRep4.RIMElement import RepositoryItemRef, QueryResponse
+
+ref = RepositoryItemRef().create_element(
+    "https://example.org/document.xml",
+    "Document",
+)
+print(ref.text)
+
+response = QueryResponse().create_element(
+    "urn:oasis:names:tc:ebxml-regrep:ResponseStatusType:Success",
+    "req-1",
+)
+print(response.element.tag)
+```
+
+---
+
+### Функція `deep_get()` (`pyRegRep4.utils`)
+
+```python
+deep_get(data: dict, *keys, default=None)
+```
+
+Безпечно дістає значення з вкладеного `dict` за послідовністю ключів.
+
+| Параметр | Тип | Опис |
+|----------|-----|------|
+| `data` | `dict` | Джерело даних |
+| `*keys` | `Any` | Шлях ключів для проходу по вкладеному словнику |
+| `default` | `Any` | Значення за замовчуванням, якщо шлях не знайдено |
+
+**Поведінка:**
+- якщо на будь-якому кроці значення не є `dict` — повертається `default`
+- якщо кінцеве значення `None` — повертається `default`
+- якщо `keys` не передані — повертається `data`
+
+```python
+from pyRegRep4 import deep_get
+
+data = {
+    "doc": {
+        "Procedure": [{"lang": "en", "value": "GetBirthCertificate"}]
+    }
+}
+
+value = deep_get(data, "doc", "Procedure", 0, "value", default="n/a")
+print(value)  # n/a (бо deep_get працює тільки з dict-ланцюжком)
+
+procedure = deep_get(data, "doc", "Procedure", default=[])
+print(procedure)  # [{"lang": "en", "value": "GetBirthCertificate"}]
+```
+
+---
+
 ### Клас `NS` (`pyRegRep4.NS`)
 
 Базовий клас для управління RIM namespace. Надає метод `_tname(prefix, localname)` для генерування кваліфікованих імен тегів у нотації Clark.
@@ -206,14 +283,16 @@ except ValueError as e:
 ```
 pyRegRep/
 ├── pyRegRep4/
-│   ├── __init__.py          # Експорт: get_slot та типи слотів
+│   ├── __init__.py          # Експорт: get_slot, deep_get, Parsing, serialize_any_value_type
 │   ├── RIMElement.py        # Класи слотів + фабрика get_slot()
 │   ├── RIMParsing.py        # Парсер Parsing + serialize()
+│   ├── utils.py             # deep_get() для вкладених словників
 │   └── NS.py                # Базовий клас для namespace
 ├── tests/
 │   ├── conftest.py          # sys.path для CI
 │   ├── test_rim_parsing.py  # Тести парсера
 │   ├── test_rim_element.py  # Тести get_slot() та типів слотів
+│   ├── test_utils.py        # Тести deep_get()
 │   ├── EDM_Ferst_Request.xml
 │   ├── EDM_Ferst_Response.xml
 │   ├── EDM_Second_Request.xml
@@ -291,4 +370,4 @@ MIT License — див. файл [LICENSE](LICENSE)
 
 ---
 
-**Версія:** 11 · **Оновлено:** 2026-03-11
+**Версія:** 13 · **Оновлено:** 2026-04-14

{pyregrep-11 → pyregrep-13}/pyRegRep.egg-info/SOURCES.txt

@@ -11,6 +11,8 @@ pyRegRep4/NS.py
 pyRegRep4/RIMElement.py
 pyRegRep4/RIMParsing.py
 pyRegRep4/__init__.py
+pyRegRep4/utils.py
 tests/test_get_slot_simple.py
 tests/test_rim_element.py
-tests/test_rim_parsing.py
+tests/test_rim_parsing.py
+tests/test_utils.py

{pyregrep-11 → pyregrep-13}/pyRegRep4/NS.py

@@ -13,6 +13,7 @@ class NS:
         "rs": "urn:oasis:names:tc:ebxml-regrep:xsd:rs:4.0",
         "xsi": "http://www.w3.org/2001/XMLSchema-instance",
         "xsd": "http://www.w3.org/2001/XMLSchema",
+        "xlink": "http://www.w3.org/1999/xlink",
         "xml": "http://www.w3.org/XML/1998/namespace",
     }
 

{pyregrep-11 → pyregrep-13}/pyRegRep4/RIMElement.py

@@ -1,6 +1,7 @@
 import datetime
 import logging
-from typing import Any
+from abc import ABC, abstractmethod
+from typing import Any, Callable
 
 from lxml import etree
 
@@ -8,14 +9,41 @@ from pyRegRep4.NS import NS
 
 _logger = logging.getLogger(__name__)
 
+__all__ = [
+    "get_slot",
+    "RegistryObject",
+    "RepositoryItemRef",
+    "QueryResponse",
+    "Classification"
+]
+
+
+class _ElementContainer(NS):
+    """Internal base for simple classes that wrap a single XML element."""
+
+    def __init__(self) -> None:
+        super().__init__()
+        self._element: etree._Element | None = None
+
+    @property
+    def element(self) -> etree._Element:
+        if self._element is None:
+            raise ValueError("XML element is not initialized")
+        return self._element
+
+    @property
+    def text(self) -> bytes:
+        return etree.tostring(self.element)
+
+
+class Xml(ABC, _ElementContainer):
+    """Base class for slot-like XML objects that carry value and name."""
 
-class Xml(NS):
     def __init__(self, value: Any):
         super().__init__()
         self._name: str = ""
         self.value: Any = value
-        self._element: etree._Element | None = None
-        self._create_element()
+        self.create_element()
 
     @property
     def name(self) -> str:
@@ -25,24 +53,15 @@ class Xml(NS):
     def name(self, value: str) -> None:
         self._name = value
         if self._element is not None:
-            self._create_element()
+            self.create_element()
 
-    def _create_element(self):
+    @abstractmethod
+    def create_element(self):
         ...
 
-    @property
-    def element(self) -> etree._Element:
-        if self._element is None:
-            raise ValueError("XML element is not initialized")
-        return self._element
-
-    @property
-    def text(self) -> bytes:
-        return etree.tostring(self.element)
-
 
 class _BooleanValueType(Xml):
-    def _create_element(self):
+    def create_element(self):
         self._element = etree.Element(
             self._tname("rim", "Slot"), nsmap=self._ns,
             attrib={"name": self.name}
@@ -56,7 +75,7 @@ class _BooleanValueType(Xml):
 
 
 class _StringValueType(Xml):
-    def _create_element(self):
+    def create_element(self):
         self._element = etree.Element(
             self._tname("rim", "Slot"), nsmap=self._ns,
             attrib={"name": self.name}
@@ -70,7 +89,7 @@ class _StringValueType(Xml):
 
 
 class _TimeStamp(Xml):
-    def _create_element(self):
+    def create_element(self):
         self._element = etree.Element(
             self._tname("rim", "Slot"), nsmap=self._ns,
             attrib={"name": self.name}
@@ -87,7 +106,7 @@ class _TimeStamp(Xml):
 
 
 class _CollectionValueType(Xml):
-    def _create_element(self):
+    def create_element(self):
         self._element = etree.Element(
             self._tname("rim", "Slot"), nsmap=self._ns,
             attrib={"name": self.name}
@@ -110,7 +129,7 @@ class _CollectionValueType(Xml):
 
 
 class _AnyValueType(Xml):
-    def _create_element(self):
+    def create_element(self):
         self._element = etree.Element(
             self._tname("rim", "Slot"), nsmap=self._ns,
             attrib={"name": self.name}
@@ -124,7 +143,7 @@ class _AnyValueType(Xml):
 
 
 class _InternationalStringValueType(Xml):
-    def _create_element(self):
+    def create_element(self):
         self._element = etree.Element(
             self._tname("rim", "Slot"), nsmap=self._ns,
             attrib={"name": self.name}
@@ -226,7 +245,7 @@ def get_slot(name: str, slot_type: str, value: Any) -> Xml:
         ... except ValueError as e:
         ...     print(f"Error: {e}")
     """
-    slot_type_map = {
+    slot_type_map: dict[str, Callable[[Any], Xml]] = {
         "StringValueType": _StringValueType,
         "BooleanValueType": _BooleanValueType,
         "DateTimeValueType": _TimeStamp,
@@ -242,3 +261,64 @@ def get_slot(name: str, slot_type: str, value: Any) -> Xml:
     slot = slot_class(value)
     slot.name = name
     return slot
+
+
+class RegistryObject(_ElementContainer):
+    """Builder for rim:RegistryObject elements."""
+
+    def create_element(self, type: str, id: str):
+        self._element = etree.Element(
+            self._tname("rim", "RegistryObject"),
+            nsmap=self._ns,
+            attrib={
+                self._tname("xsi", "type"): type,
+                "id": id
+            }
+        )
+        return self
+
+
+class RepositoryItemRef(_ElementContainer):
+    """Builder for rim:RepositoryItemRef elements."""
+
+    def create_element(self, href: str, title: str | None = None):
+        attr = {self._tname("xlink", "href"): href}
+        if title is not None:
+            attr["title"] = title
+
+        self._element = etree.Element(
+            self._tname("rim", "RepositoryItemRef"),
+            nsmap=self._ns,
+            attrib=attr
+        )
+        return self
+
+
+class QueryResponse(_ElementContainer):
+    """Builder for query:QueryResponse elements."""
+
+    def create_element(self, status: str, request_id: str):
+        self._element = etree.Element(
+            self._tname("query", "QueryResponse"), nsmap=self._ns,
+            attrib={
+                'status': status,
+                'requestId': request_id,
+            }
+        )
+        return self
+
+
+class Classification(_ElementContainer):
+    """Builder for rim:Classification elements."""
+
+    def create_element(self, id: str, classification_scheme: str, classification_node: str):
+        self._element = etree.Element(
+            self._tname("rim", "Classification"),
+            nsmap=self._ns,
+            attrib={
+                "id": id,
+                "classificationScheme": classification_scheme,
+                "classificationNode": classification_node
+            }
+        )
+        return self

{pyregrep-11 → pyregrep-13}/pyRegRep4/__init__.py

@@ -10,27 +10,26 @@ Main Components:
 """
 
 from pyRegRep4.RIMElement import (
+    Classification,
+    QueryResponse,
+    RegistryObject,
+    RepositoryItemRef,
     get_slot,
-    Xml,
-    _StringValueType,
-    _BooleanValueType,
-    _TimeStamp,
-    _CollectionValueType,
-    _AnyValueType,
-    _InternationalStringValueType,
 )
+from pyRegRep4.utils import deep_get
+from pyRegRep4.RIMParsing import Parsing, serialize_any_value_type
 
 __all__ = [
     "get_slot",
-    "Xml",
-    "_StringValueType",
-    "_BooleanValueType",
-    "_TimeStamp",
-    "_CollectionValueType",
-    "_AnyValueType",
-    "_InternationalStringValueType",
+    "RepositoryItemRef",
+    "RegistryObject",
+    "Classification",
+    "QueryResponse",
+    "deep_get",
+    "Parsing",
+    "serialize_any_value_type",
 ]
 
-__version__ = "11"
+__version__ = "13"
 __author__ = "Andrey Shapovalov"
 

pyregrep-13/pyRegRep4/utils.py

@@ -0,0 +1,23 @@
+"""Utility helpers for working with nested dictionaries."""
+
+from typing import Any
+
+
+def deep_get(data: dict[Any, Any], *keys: str, default: Any = None) -> Any:
+    """Safely read nested keys from a dictionary.
+
+    Args:
+        data: Source dictionary.
+        *keys: Sequence of keys to traverse.
+        default: Value returned when the key path is missing or the intermediate value is not a dict.
+
+    Returns:
+        Value by key path or "default" when the path cannot be resolved.
+    """
+    current: Any = data
+    for key in keys:
+        if not isinstance(current, dict):
+            return default
+        current = current.get(key)
+    return current if current is not None else default
+

{pyregrep-11 → pyregrep-13}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pyRegRep"
-version = "11"
+version = "13"
 description = "Your package description"
 authors = [{ name="Andrey Shapovalov" }]
 readme = "README.md"

{pyregrep-11 → pyregrep-13}/setup.py

@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
 
 setup(
     name="pyRegRep",
-    version="11",
+    version="13",
     description="Бібліотека для роботи з реєстрами та репозитаріями в Україні",
     packages=find_packages(),
     license="MIT",

{pyregrep-11 → pyregrep-13}/tests/test_rim_element.py

@@ -18,6 +18,10 @@ from pyRegRep4.RIMElement import (
     _CollectionValueType,
     _AnyValueType,
     _InternationalStringValueType,
+    RegistryObject,
+    RepositoryItemRef,
+    QueryResponse,
+    Classification,
 )
 
 
@@ -468,3 +472,38 @@ class TestSlotElementGeneration:
         assert slot.element.attrib.get("name") == test_name
 
 
+class TestSimpleElementContainers:
+    """Regression tests for classes sharing common element/text behavior."""
+
+    @pytest.mark.parametrize(
+        "obj",
+        [RegistryObject(), RepositoryItemRef(), QueryResponse(), Classification()],
+    )
+    def test_element_raises_before_create(self, obj):
+        with pytest.raises(ValueError, match="XML element is not initialized"):
+            _ = obj.element
+
+    def test_registry_object_create_and_serialize(self):
+        obj = RegistryObject()
+        assert obj.create_element("rim:ExtrinsicObject", "urn:uuid:test") is obj
+        assert b"RegistryObject" in obj.text
+
+    def test_repository_item_ref_create_and_serialize(self):
+        obj = RepositoryItemRef()
+        assert obj.create_element("https://example.org/doc.xml", "Doc") is obj
+        assert b"RepositoryItemRef" in obj.text
+        assert b"xlink:href" in obj.text
+
+    def test_query_response_create_and_serialize(self):
+        obj = QueryResponse()
+        assert obj.create_element(
+            "urn:oasis:names:tc:ebxml-regrep:ResponseStatusType:Success", "req-1"
+        ) is obj
+        assert b"QueryResponse" in obj.text
+
+    def test_classification_create_and_serialize(self):
+        obj = Classification()
+        assert obj.create_element("urn:uuid:cls", "urn:scheme", "Annex") is obj
+        assert b"Classification" in obj.text
+
+

pyregrep-13/tests/test_utils.py

@@ -0,0 +1,33 @@
+"""Unit tests for helper utilities."""
+
+from pyRegRep4 import deep_get
+
+
+class TestDeepGet:
+    """Tests for deep_get utility function."""
+
+    def test_returns_nested_value(self):
+        data = {"doc": {"meta": {"id": "ABC-123"}}}
+
+        assert deep_get(data, "doc", "meta", "id") == "ABC-123"
+
+    def test_returns_default_when_key_missing(self):
+        data = {"doc": {"meta": {"id": "ABC-123"}}}
+
+        assert deep_get(data, "doc", "meta", "missing", default="n/a") == "n/a"
+
+    def test_returns_default_when_intermediate_is_not_dict(self):
+        data = {"doc": {"meta": "plain-text"}}
+
+        assert deep_get(data, "doc", "meta", "id", default=None) is None
+
+    def test_returns_default_when_value_is_none(self):
+        data = {"doc": {"meta": {"id": None}}}
+
+        assert deep_get(data, "doc", "meta", "id", default="fallback") == "fallback"
+
+    def test_returns_root_data_when_keys_not_provided(self):
+        data = {"doc": {"meta": {"id": "ABC-123"}}}
+
+        assert deep_get(data) == data
+