pyRegRep 10__tar.gz → 12__tar.gz

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

@@ -1,12 +1,14 @@
 Metadata-Version: 2.4
 Name: pyRegRep
-Version: 10
+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
 
@@ -28,6 +30,7 @@ Dynamic: license-file
 - ✅ Фабрика слотів `get_slot()` — програмне створення RIM-слотів за типом
 - ✅ Серіалізація `AnyValueType` через `xmltodict` (параметр `any_type=True`)
 - ✅ Підтримка вкладених колекцій та складних структур
+- ✅ Безпечний доступ до вкладених даних через `deep_get()`
 
 ## Вимоги
 
@@ -44,11 +47,10 @@ pip install pyRegRep
 
 # З локального джерела (editable)
 pip install -e .
-
-# Залежності вручну
-pip install -r requirements.txt
 ```
 
+Під час встановлення через `pip install pyRegRep` або `pip install -e .` runtime-залежності (`lxml`, `xmltodict`) встановлюються автоматично.
+
 ## Швидкий старт
 
 ### Парсування XML документу
@@ -67,6 +69,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-слотів
@@ -190,6 +198,43 @@ except ValueError as e:
 
 ---
 
+### Функція `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.
@@ -208,11 +253,13 @@ pyRegRep/
 │   ├── __init__.py          # Експорт: get_slot та типи слотів
 │   ├── 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
@@ -290,4 +337,4 @@ MIT License — див. файл [LICENSE](LICENSE)
 
 ---
 
-**Версія:** 10 · **Оновлено:** 2026-03-11
+**Версія:** 12 · **Оновлено:** 2026-04-12

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

@@ -1,15 +1,3 @@
-Metadata-Version: 2.4
-Name: pyRegRep
-Version: 10
-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
-Dynamic: author-email
-Dynamic: license-file
-
 # pyRegRep
 
 Бібліотека Python для парсування та обробки XML документів у форматі RIM (Registry Information Model) / ebXML.
@@ -28,6 +16,7 @@ Dynamic: license-file
 - ✅ Фабрика слотів `get_slot()` — програмне створення RIM-слотів за типом
 - ✅ Серіалізація `AnyValueType` через `xmltodict` (параметр `any_type=True`)
 - ✅ Підтримка вкладених колекцій та складних структур
+- ✅ Безпечний доступ до вкладених даних через `deep_get()`
 
 ## Вимоги
 
@@ -44,11 +33,10 @@ pip install pyRegRep
 
 # З локального джерела (editable)
 pip install -e .
-
-# Залежності вручну
-pip install -r requirements.txt
 ```
 
+Під час встановлення через `pip install pyRegRep` або `pip install -e .` runtime-залежності (`lxml`, `xmltodict`) встановлюються автоматично.
+
 ## Швидкий старт
 
 ### Парсування XML документу
@@ -67,6 +55,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-слотів
@@ -190,6 +184,43 @@ except ValueError as e:
 
 ---
 
+### Функція `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.
@@ -208,11 +239,13 @@ pyRegRep/
 │   ├── __init__.py          # Експорт: get_slot та типи слотів
 │   ├── 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
@@ -290,4 +323,4 @@ MIT License — див. файл [LICENSE](LICENSE)
 
 ---
 
-**Версія:** 10 · **Оновлено:** 2026-03-11
+**Версія:** 12 · **Оновлено:** 2026-04-12

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

@@ -1,3 +1,17 @@
+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.
@@ -16,6 +30,7 @@
 - ✅ Фабрика слотів `get_slot()` — програмне створення RIM-слотів за типом
 - ✅ Серіалізація `AnyValueType` через `xmltodict` (параметр `any_type=True`)
 - ✅ Підтримка вкладених колекцій та складних структур
+- ✅ Безпечний доступ до вкладених даних через `deep_get()`
 
 ## Вимоги
 
@@ -32,11 +47,10 @@ pip install pyRegRep
 
 # З локального джерела (editable)
 pip install -e .
-
-# Залежності вручну
-pip install -r requirements.txt
 ```
 
+Під час встановлення через `pip install pyRegRep` або `pip install -e .` runtime-залежності (`lxml`, `xmltodict`) встановлюються автоматично.
+
 ## Швидкий старт
 
 ### Парсування XML документу
@@ -55,6 +69,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-слотів
@@ -178,6 +198,43 @@ except ValueError as e:
 
 ---
 
+### Функція `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.
@@ -196,11 +253,13 @@ pyRegRep/
 │   ├── __init__.py          # Експорт: get_slot та типи слотів
 │   ├── 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
@@ -278,4 +337,4 @@ MIT License — див. файл [LICENSE](LICENSE)
 
 ---
 
-**Версія:** 10 · **Оновлено:** 2026-03-11
+**Версія:** 12 · **Оновлено:** 2026-04-12

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

@@ -5,11 +5,14 @@ setup.py
 pyRegRep.egg-info/PKG-INFO
 pyRegRep.egg-info/SOURCES.txt
 pyRegRep.egg-info/dependency_links.txt
+pyRegRep.egg-info/requires.txt
 pyRegRep.egg-info/top_level.txt
 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-12/pyRegRep.egg-info/requires.txt

@@ -0,0 +1,2 @@
+lxml>=5.2.1
+xmltodict>=0.13.0

{pyregrep-10 → pyregrep-12}/pyRegRep4/RIMParsing.py

@@ -73,12 +73,20 @@ class Parsing:
         # Витягування основних елементів
         try:
             self.query = self.doc.find(".//query:Query", namespaces=self._ns)
-            self.exception = self.doc.find(".//rs:Exception", namespaces=self._ns)
-            self.objects = self.doc.findall(".//rim:RegistryObject", namespaces=self._ns)
-        except KeyError as e:
+        except Exception as e:
             _logger.warning(f"Namespace не знайдено: {e}")
             self.query = None
+
+        try:
+            self.exception = self.doc.find(".//rs:Exception", namespaces=self._ns)
+        except Exception as e:
+            _logger.warning(f"Namespace не знайдено: {e}")
             self.exception = None
+
+        try:
+            self.objects = self.doc.findall(".//rim:RegistryObject", namespaces=self._ns)
+        except Exception as e:
+            _logger.warning(f"Namespace не знайдено: {e}")
             self.objects = []
 
         # Кешований результат

{pyregrep-10 → pyregrep-12}/pyRegRep4/__init__.py

@@ -19,6 +19,7 @@ from pyRegRep4.RIMElement import (
     _AnyValueType,
     _InternationalStringValueType,
 )
+from pyRegRep4.utils import deep_get
 
 __all__ = [
     "get_slot",
@@ -29,8 +30,9 @@ __all__ = [
     "_CollectionValueType",
     "_AnyValueType",
     "_InternationalStringValueType",
+    "deep_get",
 ]
 
-__version__ = "10"
+__version__ = "12"
 __author__ = "Andrey Shapovalov"
 

pyregrep-12/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-10 → pyregrep-12}/pyproject.toml

@@ -4,12 +4,15 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pyRegRep"
-version = "10"
+version = "12"
 description = "Your package description"
 authors = [{ name="Andrey Shapovalov" }]
 readme = "README.md"
 requires-python = ">=3.10"
-dependencies = []
+dependencies = [
+	"lxml>=5.2.1",
+	"xmltodict>=0.13.0",
+]
 
 [tool.pytest.ini_options]
 pythonpath = ["."]

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

@@ -2,12 +2,15 @@ from setuptools import setup, find_packages
 
 setup(
     name="pyRegRep",
-    version="10",
+    version="12",
     description="Бібліотека для роботи з реєстрами та репозитаріями в Україні",
     packages=find_packages(),
     license="MIT",
     author="Andrii Shapovalov",
     author_email="mt.andrey@gmail.com",
     include_package_data=True,
-    install_requires=[],
+    install_requires=[
+        "lxml>=5.2.1",
+        "xmltodict>=0.13.0",
+    ],
 )

pyregrep-12/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
+