pyRegRep 12__tar.gz → 14__tar.gz

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

@@ -1,15 +1,25 @@
 Metadata-Version: 2.4
 Name: pyRegRep
-Version: 12
-Summary: Your package description
-Author: Andrey Shapovalov
-Author-email: mt.andrey@gmail.com
+Version: 14
+Summary: Бібліотека для роботи з реєстрами та репозитаріями в Україні
+Author-email: Andrii Shapovalov <mt.andrey@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/AndreyShapovalovVN/pyRegRep
+Project-URL: Repository, https://github.com/AndreyShapovalovVN/pyRegRep.git
+Project-URL: Issues, https://github.com/AndreyShapovalovVN/pyRegRep/issues
+Keywords: registry,repositories,ukraine
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: lxml>=5.2.1
 Requires-Dist: xmltodict>=0.13.0
-Dynamic: author-email
 Dynamic: license-file
 
 # pyRegRep
@@ -28,6 +38,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 +209,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 +293,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 +380,4 @@ MIT License — див. файл [LICENSE](LICENSE)
 
 ---
 
-**Версія:** 12 · **Оновлено:** 2026-04-12
+**Версія:** 13 · **Оновлено:** 2026-04-14

pyregrep-12/PKG-INFO → pyregrep-14/README.md

@@ -1,17 +1,3 @@
-Metadata-Version: 2.4
-Name: pyRegRep
-Version: 12
-Summary: Your package description
-Author: Andrey Shapovalov
-Author-email: mt.andrey@gmail.com
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: lxml>=5.2.1
-Requires-Dist: xmltodict>=0.13.0
-Dynamic: author-email
-Dynamic: license-file
-
 # pyRegRep
 
 Бібліотека Python для парсування та обробки XML документів у форматі RIM (Registry Information Model) / ebXML.
@@ -28,6 +14,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 +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
@@ -250,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() для вкладених словників
@@ -337,4 +356,4 @@ MIT License — див. файл [LICENSE](LICENSE)
 
 ---
 
-**Версія:** 12 · **Оновлено:** 2026-04-12
+**Версія:** 13 · **Оновлено:** 2026-04-14

pyregrep-12/README.md → pyregrep-14/pyRegRep.egg-info/PKG-INFO

@@ -1,3 +1,27 @@
+Metadata-Version: 2.4
+Name: pyRegRep
+Version: 14
+Summary: Бібліотека для роботи з реєстрами та репозитаріями в Україні
+Author-email: Andrii Shapovalov <mt.andrey@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/AndreyShapovalovVN/pyRegRep
+Project-URL: Repository, https://github.com/AndreyShapovalovVN/pyRegRep.git
+Project-URL: Issues, https://github.com/AndreyShapovalovVN/pyRegRep/issues
+Keywords: registry,repositories,ukraine
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: lxml>=5.2.1
+Requires-Dist: xmltodict>=0.13.0
+Dynamic: license-file
+
 # pyRegRep
 
 Бібліотека Python для парсування та обробки XML документів у форматі RIM (Registry Information Model) / ebXML.
@@ -14,6 +38,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 +209,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 +293,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 +380,4 @@ MIT License — див. файл [LICENSE](LICENSE)
 
 ---
 
-**Версія:** 12 · **Оновлено:** 2026-04-12
+**Версія:** 13 · **Оновлено:** 2026-04-14

{pyregrep-12 → pyregrep-14}/pyRegRep.egg-info/SOURCES.txt

@@ -1,7 +1,6 @@
 LICENSE
 README.md
 pyproject.toml
-setup.py
 pyRegRep.egg-info/PKG-INFO
 pyRegRep.egg-info/SOURCES.txt
 pyRegRep.egg-info/dependency_links.txt

{pyregrep-12 → pyregrep-14}/pyRegRep4/NS.py

@@ -1,6 +1,5 @@
 """Namespace management for RIM/ebXML documents."""
 
-from typing import Dict
 
 
 class NS:
@@ -13,12 +12,13 @@ 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",
     }
 
     def __init__(self):
         """Initialize namespace handling."""
-        self._ns: Dict[str, str] = self.DEFAULT_NAMESPACES.copy()  # type: ignore
+        self._ns: dict[str, str] = self.DEFAULT_NAMESPACES.copy()  # type: ignore
 
     def _tname(self, prefix: str, localname: str) -> str:
         """
@@ -36,7 +36,7 @@ class NS:
 
         return f"{{{self._ns[prefix]}}}{localname}"
 
-    def _extract_namespaces(self) -> Dict[str, str]:
+    def _extract_namespaces(self) -> dict[str, str]:
         """
         Extract namespaces from the document.
         Override this method in subclasses if needed.
@@ -47,7 +47,7 @@ class NS:
         return self._ns.copy()
 
     @property
-    def ns(self) -> Dict[str, str]:
+    def ns(self) -> dict[str, str]:
         """Get the namespace mappings."""
         return self._ns.copy()
 

{pyregrep-12 → pyregrep-14}/pyRegRep4/RIMElement.py

@@ -1,6 +1,8 @@
 import datetime
 import logging
-from typing import Any
+from abc import ABC, abstractmethod
+from collections.abc import Callable
+from typing import Any, cast
 
 from lxml import etree
 
@@ -8,14 +10,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 cast(bytes, etree.tostring(self.element, encoding="utf-8"))
+
+
+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 +54,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 +76,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 +90,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 +107,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 +130,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 +144,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}
@@ -144,7 +164,10 @@ class _InternationalStringValueType(Xml):
                     if element is not None:
                         v.append(element)
                 else:
-                    _logger.warning(f"Unsupported item type in InternationalStringValueType: {type(item)}")
+                    _logger.warning(
+                        "Unsupported item type in InternationalStringValueType: %s",
+                        type(item),
+                    )
         else:
             if isinstance(self.value, etree._Element):
                 v.append(self.value)
@@ -226,7 +249,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,
@@ -237,8 +260,72 @@ def get_slot(name: str, slot_type: str, value: Any) -> Xml:
 
     slot_class = slot_type_map.get(slot_type)
     if slot_class is None:
-        raise ValueError(f"Невідомий тип слота: {slot_type}. Підтримувані типи: {list(slot_type_map.keys())}")
+        supported_types = list(slot_type_map.keys())
+        raise ValueError(
+            f"Невідомий тип слота: {slot_type}. Підтримувані типи: {supported_types}"
+        )
 
     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