sysnet-pyutils 1.7.11__tar.gz → 1.8.0__tar.gz

{sysnet_pyutils-1.7.11/sysnet_pyutils.egg-info → sysnet_pyutils-1.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sysnet-pyutils
-Version: 1.7.11
+Version: 1.8.0
 Summary: SYSNET Python Utilities - kompletní sada nástrojů pro Python aplikace
 Author-email: Data Developer <info@sysnet.cz>
 Maintainer-email: SYSNET Development Team <info@sysnet.cz>
@@ -729,7 +729,8 @@ Knihovna obsahuje základní, v aplikacích hojně používané, utility pro Pyt
 
 [![Python](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
-[![Tests](https://img.shields.io/badge/tests-passing-brightgreen.svg)](tests/)
+[![Verze](https://img.shields.io/badge/version-1.8.0-blue.svg)](https://pypi.org/project/sysnet-pyutils/1.8.0/)
+[![Tests](https://github.com/SYSNET-CZ/pyutils/actions/workflows/ci.yml/badge.svg)](https://github.com/SYSNET-CZ/pyutils/actions/workflows/ci.yml)
 [![Coverage](https://img.shields.io/badge/coverage-90%25-brightgreen.svg)](tests/)
 
 ---
@@ -753,6 +754,7 @@ Knihovna obsahuje základní, v aplikacích hojně používané, utility pro Pyt
 - [Volitelné závislosti](#volitelné-závislosti)
 - [Testování](#testování)
 - [Vývoj](#vývoj)
+  - [CI/CD](#cicd)
 - [Systémové proměnné](#systémové-proměnné)
 - [Changelog](#changelog)
 - [Podpora](#podpora)
@@ -864,6 +866,26 @@ if config.loaded:
     db_url = config.config['database']
 ```
 
+Chování `Config`:
+
+- **Soubor:** ukládá se atomicky (dočasný soubor + přejmenování), čitelně (diakritika bez `\u` escape) a v pořadí klíčů z paměti. Nový soubor má práva 600 a chybějící adresáře
+  se vytvoří s právy 700; práva existujícího souboru se nemění a volnější než 600 se při načtení zalogují jako varování.
+- **Výchozí cesta:** nezadáte-li `config_path`, použije se proměnná prostředí `PYUTILS_CONFIG_PATH`. Bez ní platí dosavadní
+  umístění `conf/config.yml` vedle modulu (s varováním); není-li zapisovatelné, vyhodí se `ConfigError` s radou.
+- **Chyby:** poškozený YAML vyhodí `ConfigParseError` (podtřída `ConfigError` i `yaml.YAMLError`) s cestou, popisem a
+  řádkem, nikdy s obsahem souboru; soubor zůstane nepřepsaný.
+- **Nové výchozí hodnoty:** s existujícím souborem se `config_dict` ignoruje. Chcete-li po upgradu aplikace doplnit chybějící
+  klíče, použijte `Config(config_path=..., config_dict=..., merge_defaults=True)`: doplní se jen to, co v souboru chybí
+  (vnořené slovníky do hloubky, seznamy ne) a hodnoty ze souboru se nikdy nepřepíšou.
+- **Secrets:** hodnotu v YAML lze zadat odkazem `${env:NAZEV}` nebo `${file:/absolutni/cesta}` (i uvnitř textu, např.
+  `mongodb://u:${env:MONGO_PASSWORD}@h`); rozliší se při načtení na `Secret` (podtřída `str`, `repr` a log maskované,
+  `reveal()` vrací čistý `str`). Chybějící zdroj je `ConfigError`, nikdy tichý prázdný řetězec. `store()` zapisuje
+  zpět odkaz, nikdy hodnotu. `config.redacted()` vrací kopii pro health a debug, `config.audit()` cesty k heslům
+  v otevřené podobě. Doslovné `${` zapište jako `$${`. Viz `docs/adr/0001-config-secrets.md`.
+- **Vstup:** `config_dict` se při inicializaci zkopíruje; pozdější změny `config` neovlivní slovník volajícího a naopak.
+- **Opakované volání:** `Config(...)` vrací stále tutéž instanci; odlišná cesta nebo `config_dict` se ignoruje a zaloguje
+  se varování.
+
 #### Context a autentizace
 
 ```python
@@ -1203,26 +1225,26 @@ print(str(log_item))  # "2023-05-15 10:00:00 [SYSTEM] Dokument autorizován"
 Sjednocený formát pro sledování zdraví služby (health check).
 
 ```python
-from sysnet_pyutils.models.general import InfoType, InfoComponentType, InfoStatusEnum
+from sysnet_pyutils import InfoType, InfoComponentType, InfoStatusEnum, calculate_status
 
 info = InfoType(name="My Service", version="1.0.0")
 
 # Přidání komponenty (např. MongoDB)
 info.components.append(InfoComponentType(
-    code="mongo",
+    name="mongo",
     status=InfoStatusEnum.GREEN,
-    info="Connected to localhost:27017"
+    message="Connected to localhost:27017"
 ))
 
 # Přidání další komponenty s chybou
 info.components.append(InfoComponentType(
-    code="storage",
+    name="storage",
     status=InfoStatusEnum.RED,
-    info="Disk space low"
+    message="Disk space low"
 ))
 
 # Automatický výpočet celkového statusu (RED > YELLOW > GREEN)
-info.update_status()
+info.status = calculate_status([component.status for component in info.components])
 print(info.status)  # RED
 ```
 
@@ -1250,19 +1272,19 @@ Knihovna obsahuje komplexní sadu testů s >90% pokrytím kódu.
 
 ```bash
 # Z kořenového adresáře projektu
-cd D:\development\git\pyutils
+cd ~/projects/pyutils
 
 # Všechny testy
-venv\Scripts\python.exe -m pytest tests/
+.venv/bin/python -m pytest tests/
 
 # S podrobným výstupem
-venv\Scripts\python.exe -m pytest tests/ -v
+.venv/bin/python -m pytest tests/ -v
 
 # S pokrytím kódu
-venv\Scripts\python.exe -m pytest tests/ --cov=sysnet_pyutils --cov-report=html
+.venv/bin/python -m pytest tests/ --cov=sysnet_pyutils --cov-report=html
 
 # Konkrétní modul
-venv\Scripts\python.exe -m pytest tests/test_utils.py -v
+.venv/bin/python -m pytest tests/test_utils.py -v
 ```
 
 ### Testovací soubory
@@ -1287,6 +1309,9 @@ venv\Scripts\python.exe -m pytest tests/test_utils.py -v
 
 ```
 pyutils/
+├── .github/workflows/       # GitHub Actions CI/CD
+│   ├── ci.yml               # Syntax check, pytest, ruff
+│   └── release.yml          # Ověření verze, testy, build a publikace na PyPI
 ├── sysnet_pyutils/          # Hlavní balíček
 │   ├── __init__.py          # Veřejné API
 │   ├── utils.py             # Hlavní utility modul
@@ -1316,8 +1341,7 @@ pyutils/
 ├── logs/                    # Adresář pro logy
 ├── pyproject.toml           # Build a nástroje
 ├── requirements.txt         # Závislosti (legacy)
-├── upload.ps1               # Skript pro publikaci na PyPI
-├── upload.cmd               # Skript pro publikaci (cmd)
+├── CHANGELOG.md             # Přehled změn a vydání
 └── LICENSE
 ```
 
@@ -1326,8 +1350,45 @@ pyutils/
 1. Implementujte funkci v příslušném modulu
 2. Exportujte ji v `sysnet_pyutils/__init__.py`
 3. Napište testy v `tests/test_<modul>.py`
-4. Spusťte testy: `venv\Scripts\python.exe -m pytest tests/`
-5. Aktualizujte `README.md` a `REVIZE_PROJEKTU.md`
+4. Spusťte testy: `.venv/bin/python -m pytest tests/`
+5. Aktualizujte `README.md` a `CHANGELOG.md`
+
+### CI/CD
+
+Automatizaci zajišťují GitHub Actions na self-hosted runneru s Pythonem 3.11:
+
+| Workflow | Spuštění | Kroky |
+|----------|----------|-------|
+| [`.github/workflows/ci.yml`](.github/workflows/ci.yml) | Každý push na `main` a pull request do `main` | Kontrola syntaxe (`compileall`), testy (`pytest`) a lint (`ruff`) |
+| [`.github/workflows/release.yml`](.github/workflows/release.yml) | Push tagu `v*` | Ověření verze, kontrola syntaxe a testy, build balíčku a publikace na PyPI |
+
+Obě workflow používají čistý checkout, před instalací mažou pip cache a pro testy
+instalují `.[dev,cron,mongodb]`, včetně potřebných volitelných závislostí.
+Ruff je v CI zatím **informativní** (`ruff check sysnet_pyutils/ || true`);
+chyby syntaxe a testů naopak workflow zastaví.
+
+Release workflow porovnává tag bez prefixu `v` s verzí v `pyproject.toml`.
+Při nesouladu nebo selhání testů se nepublikuje. Po úspěšných kontrolách
+vytvoří distribuční balíčky pomocí `python -m build` a nahraje je přes `twine`.
+GitHub secret **`PYPI_API_TOKEN` je nastaven v repozitáři** a poskytuje token pro PyPI;
+token nepatří do zdrojového kódu.
+
+#### Vydání nové verze
+
+1. Změňte `version` v `pyproject.toml` (například na `1.8.0`) a aktualizujte dokumentaci včetně changelogu a badge.
+2. Commitněte změny a dostaňte je na `main`; před vytvořením tagu ověřte úspěšné CI a správný release commit.
+3. Na tomto commitu vytvořte a odešlete odpovídající tag:
+
+   ```bash
+   git tag v1.8.0 && git push origin v1.8.0
+   ```
+
+4. GitHub Actions automaticky provedou kontroly, build a publikaci.
+   Výsledek sledujte v [Release workflow](https://github.com/SYSNET-CZ/pyutils/actions/workflows/release.yml).
+
+Původní ruční postup (`python -m build` a `twine upload`, dříve i Windows skripty
+`upload.ps1` a `upload.cmd`, odstraněné ve verzi 1.7.12) je nahrazen touto pipeline;
+při běžném vydání již lokálně nic nenahrávejte na PyPI.
 
 ---
 
@@ -1346,6 +1407,38 @@ pyutils/
 
 ## 📚 Changelog
 
+Podrobnosti nových změn jsou v [CHANGELOG.md](CHANGELOG.md).
+
+### Verze 1.8.0 (2026-10-27)
+
+- 🔐 `Config`: ochrana secrets. Hodnotu v YAML lze zadat odkazem `${env:NAZEV}` nebo `${file:/absolutni/cesta}`; rozlišuje se při načtení na nový typ `Secret` (maskovaný `repr`, `str` a log), `store()` zapisuje zpět odkaz, nikdy hodnotu. Nově `Config.redacted()` a `Config.audit()`. Viz `docs/adr/0001-config-secrets.md`.
+- 💾 `Config.store()` a `replace()` zapisují atomicky (dočasný soubor + přejmenování); nový soubor má práva 600, chybějící adresáře se vytvoří s právy 700.
+- ⚠️ `Config` bez `config_dict` má `config == {}` místo `None` a nezapisuje `null`; `config_dict` se při inicializaci kopíruje; YAML se ukládá čitelně (diakritika) a v pořadí klíčů z paměti. První `store()` po upgradu přepíše soubor v novém formátu.
+- ✅ `ConfigParseError` pro poškozený YAML (i `yaml.YAMLError`), výchozí cesta z `PYUTILS_CONFIG_PATH`, opt-in `merge_defaults=True`, varování při ignorovaných parametrech opakovaného `Config(...)`.
+
+Podrobnosti a dopady na stávající aplikace jsou v [CHANGELOG.md](CHANGELOG.md).
+
+### Verze 1.7.12 (2026-10-27)
+
+- ✅ GitHub Actions CI/CD: kontrola syntaxe, pytest a ruff při push/PR na `main`; ověření verze, testy, build a publikace na PyPI při tagu `v*`.
+- ✅ Opraveny starší chyby v `tests/test_models_general.py`: `InfoComponentType(code=...)` → `name=...`, neexistující `update_status()` → funkce `calculate_status()`.
+- ✅ Doplněny veřejné exporty `InfoComponentType`, `InfoStatusEnum`, `InfoType` a `calculate_status` v `sysnet_pyutils/__init__.py`.
+- ✅ Ukázka Info/Health výše odpovídá aktuálnímu API (`name`, `message`, `calculate_status`).
+
+- 🧹 Odstraněny sledované pomocné soubory (`mypy_*.txt`, `upload.cmd`, `upload.ps1`, `run_pytest.py`, `REVIZE_PROJEKTU.md`); Windows cesty v README a `CLAUDE.md` nahrazeny linuxovými.
+
+### Verze 1.7.11 (2026-09-25)
+
+- ✅ `MetadataEssentialType.creator: str | None` — sjednocení s `MetadataTypeBase`, výchozí hodnota `None` (#10229).
+
+### Verze 1.7.10 (2026-09-25)
+
+- ✅ `MetadataEssentialType.creator_organization: LinkedType | None` — organizace tvůrce i v základních metadatech, výchozí hodnota `None` (#10229).
+
+### Verze 1.7.9 (2026-09-25)
+
+- ✅ `MetadataTypeBase.creator_organization: LinkedType | None` — organizace tvůrce dokumentu, výchozí hodnota `None` (#10229).
+
 ### Verze 1.7.6 (2026-06-19)
 
 **Nové funkce:**
@@ -1462,6 +1555,6 @@ Tento projekt je licencován pod MIT licencí — viz [LICENSE](LICENSE) soubor.
  
  **Vytvořeno s ❤️ týmem SYSNET**
  
--*Verze: 1.7.6*  
-+*Verze: 1.7.6*
- *Datum: 2026-06-19*
+*Verze: 1.8.0*
+
+*Datum: 2026-10-27*

{sysnet_pyutils-1.7.11 → sysnet_pyutils-1.8.0}/README.md

@@ -6,7 +6,8 @@ Knihovna obsahuje základní, v aplikacích hojně používané, utility pro Pyt
 
 [![Python](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
-[![Tests](https://img.shields.io/badge/tests-passing-brightgreen.svg)](tests/)
+[![Verze](https://img.shields.io/badge/version-1.8.0-blue.svg)](https://pypi.org/project/sysnet-pyutils/1.8.0/)
+[![Tests](https://github.com/SYSNET-CZ/pyutils/actions/workflows/ci.yml/badge.svg)](https://github.com/SYSNET-CZ/pyutils/actions/workflows/ci.yml)
 [![Coverage](https://img.shields.io/badge/coverage-90%25-brightgreen.svg)](tests/)
 
 ---
@@ -30,6 +31,7 @@ Knihovna obsahuje základní, v aplikacích hojně používané, utility pro Pyt
 - [Volitelné závislosti](#volitelné-závislosti)
 - [Testování](#testování)
 - [Vývoj](#vývoj)
+  - [CI/CD](#cicd)
 - [Systémové proměnné](#systémové-proměnné)
 - [Changelog](#changelog)
 - [Podpora](#podpora)
@@ -141,6 +143,26 @@ if config.loaded:
     db_url = config.config['database']
 ```
 
+Chování `Config`:
+
+- **Soubor:** ukládá se atomicky (dočasný soubor + přejmenování), čitelně (diakritika bez `\u` escape) a v pořadí klíčů z paměti. Nový soubor má práva 600 a chybějící adresáře
+  se vytvoří s právy 700; práva existujícího souboru se nemění a volnější než 600 se při načtení zalogují jako varování.
+- **Výchozí cesta:** nezadáte-li `config_path`, použije se proměnná prostředí `PYUTILS_CONFIG_PATH`. Bez ní platí dosavadní
+  umístění `conf/config.yml` vedle modulu (s varováním); není-li zapisovatelné, vyhodí se `ConfigError` s radou.
+- **Chyby:** poškozený YAML vyhodí `ConfigParseError` (podtřída `ConfigError` i `yaml.YAMLError`) s cestou, popisem a
+  řádkem, nikdy s obsahem souboru; soubor zůstane nepřepsaný.
+- **Nové výchozí hodnoty:** s existujícím souborem se `config_dict` ignoruje. Chcete-li po upgradu aplikace doplnit chybějící
+  klíče, použijte `Config(config_path=..., config_dict=..., merge_defaults=True)`: doplní se jen to, co v souboru chybí
+  (vnořené slovníky do hloubky, seznamy ne) a hodnoty ze souboru se nikdy nepřepíšou.
+- **Secrets:** hodnotu v YAML lze zadat odkazem `${env:NAZEV}` nebo `${file:/absolutni/cesta}` (i uvnitř textu, např.
+  `mongodb://u:${env:MONGO_PASSWORD}@h`); rozliší se při načtení na `Secret` (podtřída `str`, `repr` a log maskované,
+  `reveal()` vrací čistý `str`). Chybějící zdroj je `ConfigError`, nikdy tichý prázdný řetězec. `store()` zapisuje
+  zpět odkaz, nikdy hodnotu. `config.redacted()` vrací kopii pro health a debug, `config.audit()` cesty k heslům
+  v otevřené podobě. Doslovné `${` zapište jako `$${`. Viz `docs/adr/0001-config-secrets.md`.
+- **Vstup:** `config_dict` se při inicializaci zkopíruje; pozdější změny `config` neovlivní slovník volajícího a naopak.
+- **Opakované volání:** `Config(...)` vrací stále tutéž instanci; odlišná cesta nebo `config_dict` se ignoruje a zaloguje
+  se varování.
+
 #### Context a autentizace
 
 ```python
@@ -480,26 +502,26 @@ print(str(log_item))  # "2023-05-15 10:00:00 [SYSTEM] Dokument autorizován"
 Sjednocený formát pro sledování zdraví služby (health check).
 
 ```python
-from sysnet_pyutils.models.general import InfoType, InfoComponentType, InfoStatusEnum
+from sysnet_pyutils import InfoType, InfoComponentType, InfoStatusEnum, calculate_status
 
 info = InfoType(name="My Service", version="1.0.0")
 
 # Přidání komponenty (např. MongoDB)
 info.components.append(InfoComponentType(
-    code="mongo",
+    name="mongo",
     status=InfoStatusEnum.GREEN,
-    info="Connected to localhost:27017"
+    message="Connected to localhost:27017"
 ))
 
 # Přidání další komponenty s chybou
 info.components.append(InfoComponentType(
-    code="storage",
+    name="storage",
     status=InfoStatusEnum.RED,
-    info="Disk space low"
+    message="Disk space low"
 ))
 
 # Automatický výpočet celkového statusu (RED > YELLOW > GREEN)
-info.update_status()
+info.status = calculate_status([component.status for component in info.components])
 print(info.status)  # RED
 ```
 
@@ -527,19 +549,19 @@ Knihovna obsahuje komplexní sadu testů s >90% pokrytím kódu.
 
 ```bash
 # Z kořenového adresáře projektu
-cd D:\development\git\pyutils
+cd ~/projects/pyutils
 
 # Všechny testy
-venv\Scripts\python.exe -m pytest tests/
+.venv/bin/python -m pytest tests/
 
 # S podrobným výstupem
-venv\Scripts\python.exe -m pytest tests/ -v
+.venv/bin/python -m pytest tests/ -v
 
 # S pokrytím kódu
-venv\Scripts\python.exe -m pytest tests/ --cov=sysnet_pyutils --cov-report=html
+.venv/bin/python -m pytest tests/ --cov=sysnet_pyutils --cov-report=html
 
 # Konkrétní modul
-venv\Scripts\python.exe -m pytest tests/test_utils.py -v
+.venv/bin/python -m pytest tests/test_utils.py -v
 ```
 
 ### Testovací soubory
@@ -564,6 +586,9 @@ venv\Scripts\python.exe -m pytest tests/test_utils.py -v
 
 ```
 pyutils/
+├── .github/workflows/       # GitHub Actions CI/CD
+│   ├── ci.yml               # Syntax check, pytest, ruff
+│   └── release.yml          # Ověření verze, testy, build a publikace na PyPI
 ├── sysnet_pyutils/          # Hlavní balíček
 │   ├── __init__.py          # Veřejné API
 │   ├── utils.py             # Hlavní utility modul
@@ -593,8 +618,7 @@ pyutils/
 ├── logs/                    # Adresář pro logy
 ├── pyproject.toml           # Build a nástroje
 ├── requirements.txt         # Závislosti (legacy)
-├── upload.ps1               # Skript pro publikaci na PyPI
-├── upload.cmd               # Skript pro publikaci (cmd)
+├── CHANGELOG.md             # Přehled změn a vydání
 └── LICENSE
 ```
 
@@ -603,8 +627,45 @@ pyutils/
 1. Implementujte funkci v příslušném modulu
 2. Exportujte ji v `sysnet_pyutils/__init__.py`
 3. Napište testy v `tests/test_<modul>.py`
-4. Spusťte testy: `venv\Scripts\python.exe -m pytest tests/`
-5. Aktualizujte `README.md` a `REVIZE_PROJEKTU.md`
+4. Spusťte testy: `.venv/bin/python -m pytest tests/`
+5. Aktualizujte `README.md` a `CHANGELOG.md`
+
+### CI/CD
+
+Automatizaci zajišťují GitHub Actions na self-hosted runneru s Pythonem 3.11:
+
+| Workflow | Spuštění | Kroky |
+|----------|----------|-------|
+| [`.github/workflows/ci.yml`](.github/workflows/ci.yml) | Každý push na `main` a pull request do `main` | Kontrola syntaxe (`compileall`), testy (`pytest`) a lint (`ruff`) |
+| [`.github/workflows/release.yml`](.github/workflows/release.yml) | Push tagu `v*` | Ověření verze, kontrola syntaxe a testy, build balíčku a publikace na PyPI |
+
+Obě workflow používají čistý checkout, před instalací mažou pip cache a pro testy
+instalují `.[dev,cron,mongodb]`, včetně potřebných volitelných závislostí.
+Ruff je v CI zatím **informativní** (`ruff check sysnet_pyutils/ || true`);
+chyby syntaxe a testů naopak workflow zastaví.
+
+Release workflow porovnává tag bez prefixu `v` s verzí v `pyproject.toml`.
+Při nesouladu nebo selhání testů se nepublikuje. Po úspěšných kontrolách
+vytvoří distribuční balíčky pomocí `python -m build` a nahraje je přes `twine`.
+GitHub secret **`PYPI_API_TOKEN` je nastaven v repozitáři** a poskytuje token pro PyPI;
+token nepatří do zdrojového kódu.
+
+#### Vydání nové verze
+
+1. Změňte `version` v `pyproject.toml` (například na `1.8.0`) a aktualizujte dokumentaci včetně changelogu a badge.
+2. Commitněte změny a dostaňte je na `main`; před vytvořením tagu ověřte úspěšné CI a správný release commit.
+3. Na tomto commitu vytvořte a odešlete odpovídající tag:
+
+   ```bash
+   git tag v1.8.0 && git push origin v1.8.0
+   ```
+
+4. GitHub Actions automaticky provedou kontroly, build a publikaci.
+   Výsledek sledujte v [Release workflow](https://github.com/SYSNET-CZ/pyutils/actions/workflows/release.yml).
+
+Původní ruční postup (`python -m build` a `twine upload`, dříve i Windows skripty
+`upload.ps1` a `upload.cmd`, odstraněné ve verzi 1.7.12) je nahrazen touto pipeline;
+při běžném vydání již lokálně nic nenahrávejte na PyPI.
 
 ---
 
@@ -623,6 +684,38 @@ pyutils/
 
 ## 📚 Changelog
 
+Podrobnosti nových změn jsou v [CHANGELOG.md](CHANGELOG.md).
+
+### Verze 1.8.0 (2026-10-27)
+
+- 🔐 `Config`: ochrana secrets. Hodnotu v YAML lze zadat odkazem `${env:NAZEV}` nebo `${file:/absolutni/cesta}`; rozlišuje se při načtení na nový typ `Secret` (maskovaný `repr`, `str` a log), `store()` zapisuje zpět odkaz, nikdy hodnotu. Nově `Config.redacted()` a `Config.audit()`. Viz `docs/adr/0001-config-secrets.md`.
+- 💾 `Config.store()` a `replace()` zapisují atomicky (dočasný soubor + přejmenování); nový soubor má práva 600, chybějící adresáře se vytvoří s právy 700.
+- ⚠️ `Config` bez `config_dict` má `config == {}` místo `None` a nezapisuje `null`; `config_dict` se při inicializaci kopíruje; YAML se ukládá čitelně (diakritika) a v pořadí klíčů z paměti. První `store()` po upgradu přepíše soubor v novém formátu.
+- ✅ `ConfigParseError` pro poškozený YAML (i `yaml.YAMLError`), výchozí cesta z `PYUTILS_CONFIG_PATH`, opt-in `merge_defaults=True`, varování při ignorovaných parametrech opakovaného `Config(...)`.
+
+Podrobnosti a dopady na stávající aplikace jsou v [CHANGELOG.md](CHANGELOG.md).
+
+### Verze 1.7.12 (2026-10-27)
+
+- ✅ GitHub Actions CI/CD: kontrola syntaxe, pytest a ruff při push/PR na `main`; ověření verze, testy, build a publikace na PyPI při tagu `v*`.
+- ✅ Opraveny starší chyby v `tests/test_models_general.py`: `InfoComponentType(code=...)` → `name=...`, neexistující `update_status()` → funkce `calculate_status()`.
+- ✅ Doplněny veřejné exporty `InfoComponentType`, `InfoStatusEnum`, `InfoType` a `calculate_status` v `sysnet_pyutils/__init__.py`.
+- ✅ Ukázka Info/Health výše odpovídá aktuálnímu API (`name`, `message`, `calculate_status`).
+
+- 🧹 Odstraněny sledované pomocné soubory (`mypy_*.txt`, `upload.cmd`, `upload.ps1`, `run_pytest.py`, `REVIZE_PROJEKTU.md`); Windows cesty v README a `CLAUDE.md` nahrazeny linuxovými.
+
+### Verze 1.7.11 (2026-09-25)
+
+- ✅ `MetadataEssentialType.creator: str | None` — sjednocení s `MetadataTypeBase`, výchozí hodnota `None` (#10229).
+
+### Verze 1.7.10 (2026-09-25)
+
+- ✅ `MetadataEssentialType.creator_organization: LinkedType | None` — organizace tvůrce i v základních metadatech, výchozí hodnota `None` (#10229).
+
+### Verze 1.7.9 (2026-09-25)
+
+- ✅ `MetadataTypeBase.creator_organization: LinkedType | None` — organizace tvůrce dokumentu, výchozí hodnota `None` (#10229).
+
 ### Verze 1.7.6 (2026-06-19)
 
 **Nové funkce:**
@@ -739,6 +832,6 @@ Tento projekt je licencován pod MIT licencí — viz [LICENSE](LICENSE) soubor.
  
  **Vytvořeno s ❤️ týmem SYSNET**
  
--*Verze: 1.7.6*  
-+*Verze: 1.7.6*
- *Datum: 2026-06-19*
+*Verze: 1.8.0*
+
+*Datum: 2026-10-27*

{sysnet_pyutils-1.7.11 → sysnet_pyutils-1.8.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "sysnet-pyutils"
-version = "1.7.11"
+version = "1.8.0"
 description = "SYSNET Python Utilities - kompletní sada nástrojů pro Python aplikace"
 readme = "README.md"
 license = { file = "LICENSE" }

{sysnet_pyutils-1.7.11 → sysnet_pyutils-1.8.0}/sysnet_pyutils/__init__.py

@@ -123,9 +123,11 @@ from sysnet_pyutils.utils import (  # API klíče; Konverze; Hashe; Base64; Vali
     Config,
     ConfigError,
     ConfigFlag,
+    ConfigParseError,
     Context,
     Log,
     LoggedObject,
+    Secret,
     Singleton,
     api_key_generate,
     api_key_next,