pyRegRep 12__tar.gz → 13__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyRegRep
-Version: 12
+Version: 13
 Summary: Your package description
 Author: Andrey Shapovalov
 Author-email: mt.andrey@gmail.com
@@ -28,6 +28,7 @@ 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()`
@@ -198,6 +199,38 @@ 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
@@ -250,7 +283,7 @@ print(procedure)  # [{"lang": "en", "value": "GetBirthCertificate"}]
 ```
 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() для вкладених словників
@@ -337,4 +370,4 @@ MIT License — див. файл [LICENSE](LICENSE)
 
 ---
 
-**Версія:** 12 · **Оновлено:** 2026-04-12
+**Версія:** 13 · **Оновлено:** 2026-04-14

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

@@ -14,6 +14,7 @@
 - ✅ Обробка всіх типів значень: Boolean, String, Integer, DateTime, Collection, InternationalString, AnyValue
 - ✅ Серіалізація даних у зручний Python-формат (`dict`)
 - ✅ Фабрика слотів `get_slot()` — програмне створення RIM-слотів за типом
+- ✅ Builder-класи для елементів `RegistryObject`, `RepositoryItemRef`, `QueryResponse`, `Classification`
 - ✅ Серіалізація `AnyValueType` через `xmltodict` (параметр `any_type=True`)
 - ✅ Підтримка вкладених колекцій та складних структур
 - ✅ Безпечний доступ до вкладених даних через `deep_get()`
@@ -184,6 +185,38 @@ 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
@@ -236,7 +269,7 @@ print(procedure)  # [{"lang": "en", "value": "GetBirthCertificate"}]
 ```
 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() для вкладених словників
@@ -323,4 +356,4 @@ MIT License — див. файл [LICENSE](LICENSE)
 
 ---
 
-**Версія:** 12 · **Оновлено:** 2026-04-12
+**Версія:** 13 · **Оновлено:** 2026-04-14

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyRegRep
-Version: 12
+Version: 13
 Summary: Your package description
 Author: Andrey Shapovalov
 Author-email: mt.andrey@gmail.com
@@ -28,6 +28,7 @@ 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()`
@@ -198,6 +199,38 @@ 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
@@ -250,7 +283,7 @@ print(procedure)  # [{"lang": "en", "value": "GetBirthCertificate"}]
 ```
 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() для вкладених словників
@@ -337,4 +370,4 @@ MIT License — див. файл [LICENSE](LICENSE)
 
 ---
 
-**Версія:** 12 · **Оновлено:** 2026-04-12
+**Версія:** 13 · **Оновлено:** 2026-04-14

{pyregrep-12 → 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-12 → 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-12 → pyregrep-13}/pyRegRep4/__init__.py

@@ -10,29 +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__ = "12"
+__version__ = "13"
 __author__ = "Andrey Shapovalov"
 

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

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

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

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

{pyregrep-12 → 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
+
+