pyRegRep 11__tar.gz → 12__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyRegRep
-Version: 11
+Version: 12
 Summary: Your package description
 Author: Andrey Shapovalov
 Author-email: mt.andrey@gmail.com
@@ -30,6 +30,7 @@ Dynamic: license-file
 - ✅ Фабрика слотів `get_slot()` — програмне створення RIM-слотів за типом
 - ✅ Серіалізація `AnyValueType` через `xmltodict` (параметр `any_type=True`)
 - ✅ Підтримка вкладених колекцій та складних структур
+- ✅ Безпечний доступ до вкладених даних через `deep_get()`
 
 ## Вимоги
 
@@ -68,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-слотів
@@ -191,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.
@@ -209,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
@@ -291,4 +337,4 @@ MIT License — див. файл [LICENSE](LICENSE)
 
 ---
 
-**Версія:** 11 · **Оновлено:** 2026-03-11
+**Версія:** 12 · **Оновлено:** 2026-04-12

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

@@ -16,6 +16,7 @@
 - ✅ Фабрика слотів `get_slot()` — програмне створення RIM-слотів за типом
 - ✅ Серіалізація `AnyValueType` через `xmltodict` (параметр `any_type=True`)
 - ✅ Підтримка вкладених колекцій та складних структур
+- ✅ Безпечний доступ до вкладених даних через `deep_get()`
 
 ## Вимоги
 
@@ -54,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-слотів
@@ -177,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.
@@ -195,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
@@ -277,4 +323,4 @@ MIT License — див. файл [LICENSE](LICENSE)
 
 ---
 
-**Версія:** 11 · **Оновлено:** 2026-03-11
+**Версія:** 12 · **Оновлено:** 2026-04-12

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyRegRep
-Version: 11
+Version: 12
 Summary: Your package description
 Author: Andrey Shapovalov
 Author-email: mt.andrey@gmail.com
@@ -30,6 +30,7 @@ Dynamic: license-file
 - ✅ Фабрика слотів `get_slot()` — програмне створення RIM-слотів за типом
 - ✅ Серіалізація `AnyValueType` через `xmltodict` (параметр `any_type=True`)
 - ✅ Підтримка вкладених колекцій та складних структур
+- ✅ Безпечний доступ до вкладених даних через `deep_get()`
 
 ## Вимоги
 
@@ -68,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-слотів
@@ -191,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.
@@ -209,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
@@ -291,4 +337,4 @@ MIT License — див. файл [LICENSE](LICENSE)
 
 ---
 
-**Версія:** 11 · **Оновлено:** 2026-03-11
+**Версія:** 12 · **Оновлено:** 2026-04-12

{pyregrep-11 → pyregrep-12}/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-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__ = "11"
+__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-11 → pyregrep-12}/pyproject.toml

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

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

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

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
+