release 1.3.1 (#79)

Release 1.3.1

Author: schizza

.github/workflows/ci.yml

@@ -2,7 +2,7 @@ name: CI
 
 on:
   push:
-    branches: [main]
+    branches: [main, dev]
   pull_request:
 
 jobs:
@@ -19,12 +19,16 @@ jobs:
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip
-          pip install pytest pytest-asyncio pytest-homeassistant-custom-component ruff
+          pip install pytest pytest-asyncio pytest-homeassistant-custom-component ruff basedpyright
           pip install -e .
           # HA runtime pro testy (minimální):
           pip install homeassistant==2025.9.4
-          pip install async-bakalari-api==0.6.0
+          pip install async-bakalari-api==0.7.0
       - name: Ruff (lint)
         run: ruff check .
+      - name: Ruff (format)
+        run: ruff format --check .
+      - name: basedpyright
+        run: basedpyright
       - name: Tests
         run: pytest -q

.github/workflows/release-drafter.yml

@@ -1,11 +1,9 @@
 name: Release Drafter (dev)
 
 on:
-  push:
-    branches: [ dev ]
   pull_request:
     branches: [ dev ]
-    types: [opened, reopened, synchronize, labeled, unlabeled, edited, closed]
+    types: [closed]
 
 permissions:
   contents: write

.github/workflows/sync-labels.yml

@@ -16,4 +16,4 @@ jobs:
         with:
           github-token: ${{ secrets.GITHUB_TOKEN }}
           yaml-file: .github/labels.yml
-          prune: true   # smaže labely, co nejsou v YAML
+          prune: true

.gitignore

@@ -213,3 +213,4 @@ __marimo__/
 .zed/debug.json
 
 .zed/settings.json
+struct.md

.pre-commit-config.yaml

@@ -17,3 +17,10 @@ repos:
         entry: script/validate_version.py
         language: system
         pass_filenames: false
+  - repo: local
+    hooks:
+      - id: basedpyright
+        name: Check pyRight
+        entry: basedpyright --outputjson | script/pretty_basedpyright.py
+        language: system
+        pass_filenames: true

CHANGELOG.md

@@ -1,6 +1,53 @@
-# Changelog
+# # Changelog
 
-# v1.2.0
+## v1.3.1
+
+## ✨ Nové funkce
+
+- Přidány senzory pro jednotlivé předměty
+  - Původní senzor `all-marks` nyní drří pouze metadata k senzorům známek pro využití v Lovelace
+  - každý senzor pro `Předmět` nyní má svá metadata a drží všechny známky z daného předmětu
+  - senzor pro `Předmět` uvádí jako `native_value` celkový počet známek
+  - zrušen limit pro 30 posledních známek v předmětu
+- Nový `snapshot` API pro známky
+  - agregace známek: celkové statistiky (počty, průměr, vážený průměr) a detailní rozpad dle předmětů.
+  - Pomocné atributy pro jednodušší využití agregovaných dat.
+  - Dynamická tvorba senzorů pro jednotlivé předměty na základě dostupných dat z `Bakalářů`
+- Zjednodušené volání API odstraněním generické funkce `_api_call` a zavedením přímých volání knihovny `async_bakalari_api.`
+  
+## 🐛 Opravy chyb
+
+- ošetřeno generování `unique_id`
+- opravena chyba, kdy se senzory generovaly pouze pro poslední díte v seznamu
+- aktualizace agregační funkce, aby užívala již získaná data a zabránilo se opětovnému volání `get_items_for_child`
+
+## 🧹 Refaktoring / Údržba
+
+- Nahrazení několika asynchronních volání jediným voláním pro načtení známek (rychlejší a spolehlivější)
+- Interní zpracování známek přepracováno tak, aby lépe podporovalo agregace a odvozené informace
+- Sledování aktualizací koordinátoru: při objevení nových předmětů se senzory automaticky doplní bez potřeby plného reloadu
+- Odstraněn zastaralý kód související s původním způsobem inicializace senzorů
+- přidán `basedpyright` do CI kontroly i lokální `make all` kontroly
+- přepracováno zpracování agregace známek u podřízených entit, přejmenování a přesunutí agregační funkce, aby byla struktura kódu přehlednější a lépe udržovatelná.
+- vylepšeno zpracování událostí kalendáře díky konzistentnímu nakládání s časovými zónami
+- ošetření okrajových případů, kdy chyběl koncový čas události. Jako výchozí hodnota je použit čas začátku
+- přidány `unity_testy` k ověření `api_calls`
+  - správné chování, při chybějící knihovně
+  - chyby autentizace
+  - obecné chyby
+  - serializace `lock`
+- logovací zprávy nyní mají název modulu a třídy, což zpřehlední výstup a usnadňuje dohledání původu zprávy
+
+---
+
+## 📦 Technické
+
+- Verze integrace: `v1.3.0`
+- Minimální verze Home Assistant: `2025.9+`
+- Předchozí tag: `v1.2.0`
+- Autoři přispěli: @schizza
+
+## v1.2.0
 
 ## ✨ Nové funkce
 
@@ -10,15 +57,18 @@
 ## 🧹 Refaktoring / Údržba
 
 - bump verze verze API na 0.6.0
+
 ---
+
 ## 📦 Technické
+
 - Verze integrace: `v1.2.0`
 - Vyžaduje API verzi `0.6.0+`
 - Minimální verze Home Assistant: `2025.9+`
 - Předchozí tag: `v1.1.0`
 - Autoři přispěli: @schizza
 
-# v1.1.0
+## v1.1.0
 
 ## ✨ Nové funkce
 
@@ -75,7 +125,7 @@ Podpora migrace jedinečného ID do nového formátu založeného na ID konfigur
 - Předchozí tag: `v1.0.0`
 - Autoři přispěli: @schizza
 
-# 1.0.0
+## 1.0.0
 
 ## ✨ Nové funkce
 
@@ -97,49 +147,54 @@ Podpora migrace jedinečného ID do nového formátu založeného na ID konfigur
 - Zachovává zpětnou kompatibilitu ponecháním starých entit.
 
 ---
+
 ## 📦 Technické
+
 - Verze integrace: `v1.0.0`
 - Vyžaduje API verze: `0.5.0`
 - Minimální verze Home Assistant: `2025.9+`
 - Předchozí tag: `v0.1.1`
 - Autoři přispěli: @schizza
 
-# 0.1.1
+## 0.1.1
 
 ## ✨ Nové funkce
 
 Podpora Rozvrhu `Timetable module`
-  -   V API přidána možnost stažení aktuálního a permanentního rozvrhu.
+- V API přidána možnost stažení aktuálního a permanentního rozvrhu.
 
 ## Breaking changes
 
  Karty Lovelace přesunuty do vlastního repozitáře  (schizza/bakalari-ha-frontend)
- - smazan www/bakalari-cards.js
- - karty pro Lovelace se nyní instalují přes HACS ve vlastním repozitáři
+
+- smazan www/bakalari-cards.js
+- karty pro Lovelace se nyní instalují přes HACS ve vlastním repozitáři
 
 ## 🐛 Opravy chyb
 
- - funkce pro `timetable_actual` stahuje v módu dnes +- 7 dní (reálně tedy 3 týdny rozvrhu)
+- funkce pro `timetable_actual` stahuje v módu dnes +- 7 dní (reálně tedy 3 týdny rozvrhu)
 
 ## 🧹 Refaktoring / Údržba
 
 - Fix: Struktura ZIP souboru pro release
 
 - Chore/download counts (#34) (#35) @schizza
 
-  * Enable zip_release for Bakaláři HA
-  * Add GitHub Actions workflow for ZIP asset release
+  - Enable zip_release for Bakaláři HA
+  - Add GitHub Actions workflow for ZIP asset release
 
 Added download badges for total and latest releases.
 
-* Add commitish and filter-by-commitish options
-* Update release drafter configuration for versioning
-* Add commitish and filter-by-commitish to workflow
-* Add initial changelog file
-* Add workflow to update CHANGELOG on release
+- Add commitish and filter-by-commitish options
+- Update release drafter configuration for versioning
+- Add commitish and filter-by-commitish to workflow
+- Add initial changelog file
+- Add workflow to update CHANGELOG on release
 
 ---
+
 ## 📦 Technické
+
 - Verze integrace: `v0.1.1`
 - Minimální verze Home Assistant: `2025.9+`
 - Předchozí tag: `v0.1.0`

Makefile

@@ -11,7 +11,7 @@ PYTEST := $(PYTHON) -m pytest
 
 # Verze / cesty
 HA_VERSION := 2025.9.4
-BAKALARI_VERSION := 0.6.0
+BAKALARI_VERSION := 0.7.0
 HA_CONFIG := ./config
 COMPONENT_PATH := custom_components/bakalari
 
@@ -71,7 +71,8 @@ install: venv
 		ruff pre-commit \
 		pytest pytest-asyncio pytest-homeassistant-custom-component \
 		async-bakalari-api==$(BAKALARI_VERSION) \
-		bump-my-version PyTurboJPEG
+		bump-my-version PyTurboJPEG \
+		basedpyright
 	$(MAKE) hassfest-setup
 
 update:
@@ -84,8 +85,12 @@ all: ci coverage validate-local check-versions
 
 # ====== Lint & test ======
 lint:
+	@echo -n "Ruff check : "
 	@$(RUFF) check .
+	@echo -n "Ruff format: "
 	@$(RUFF) format --check .
+	@set -o pipefail; \
+		basedpyright --outputjson | python script/pretty_basedpyright.py
 
 fmt:
 	@$(RUFF) format .

README.md

@@ -10,6 +10,10 @@ Custom komponenta pro Home Assistant, založená na [async-bakalari-api3](https:
 
 ## 🚨 Breaking changes
 
+- Verze 1.3.0 zavádí pro každý předmět jednotlivý senzor (dynamické generování podle dat z Bakalářů).
+  - původní senzor `all_marks` již drží jen metadata pro Lovelace kartu
+  - obsah metadat a co lze z tohoto senzoru získat viz níže.
+
 Od verze 1.1.0 jsou již senzory migrovány pod `DeviceRegistry`
  - nově je každé dítě jako separátní `DeviceRegistry` (zařízení v HUBu) s jednotlivými senzory
  - `uid` senzoru se nezměnilo, ale změnil se název senzoru - nyní dědí jméno z `DeviceRegistry`
@@ -33,18 +37,50 @@ Od verze 1.1.0 jsou již senzory migrovány pod `DeviceRegistry`
 
 - Zprávy
   - tento senzor stahuje zprávy za poslední měsíc
+  - TODO: všechny zprávy za školní rok - problém je v limitu pro `recorder`\
+  v plánu je lokální cache, aby se "nezatěžoval" senzor
 
 - Rozvrh
   - tento senzor stahuje rozvrh na aktuální týden +- 7 dní
 
 - Známky
-  - ze školního serveru se již stahují všechny známky
-  - známky jsou agregované per-předmět
+  - každý předmět má nyní svůj vlastní senzro
+  - původní senzor `all_marks` udržuje pouze metadata pro Lovelace kartu
+  - ze školního serveru se již stahují všechny známky, zrušen limit 30 posledních
+  - známky jsou agregované per-předmět a per-child
   - zobrazení poslední přijaté známky nadále funguje bez rozdílu
   - přidána možnost `fire_event` pro vyvolání události při nové známce, bude sloužit k oznámení např. v mobilní aplikaci
   - přidána možnost Websocketu
   - další funkcionality v následujících verzích
 
+Příklad metadat v senzoru `Všechny známky`
+
+```yaml
+friendly_names:
+  - Český jazyk a literatura
+  - Matematika
+  ...
+mapping_names:
+  "2":
+    name: Český jazyk a literatura
+    abbr: ČJ
+  "10":
+    name: Matematika
+    abbr: M
+sensor_map:
+  "2": >-
+    sensor.bakalari_...._znamky_cj_jméno_dítěte
+  "10": >-
+    sensor.bakalari_...._znamky_m_jméno_dítěte
+summary:
+  wavg: "1.22"
+  avg: "1.16"
+  subjects: "8"
+  total_marks: "105"
+  total_point_marks: "0"
+  total_non_point_marks: "105"
+```
+
 ## Karty pro Lovelace jsou nyní instalovány přes HACS ve vlastím [repozitáři](https://github.com/schizza/bakalari-ha-frontend).
 
 - v HACS přidej repozitář `https://github.com/schizza/bakalari-ha-frontend`
@@ -60,8 +96,8 @@ Od verze 1.1.0 jsou již senzory migrovány pod `DeviceRegistry`
 
 ## Požadavky
 
-- Home Assistant `2025.9.1+`
-- PyPI: `async-bakalari-api==0.6.0`
+- Home Assistant `2025.9.4+`
+- PyPI: `async-bakalari-api==0.7.0`
 
 ## Licence
 

bump-bakalari.toml

@@ -1,5 +1,5 @@
 [tool.bumpversion]
-current_version = "0.6.0"
+current_version = "0.7.0"
 commit = false
 tag = false
 

bump-ha.toml

@@ -22,7 +22,7 @@ replace = 'pip install homeassistant=={new_version}'
 no-regex = true
 
 [[tool.bumpversion.files]]
-filename = "custom_components/bakalari/const.py"
-search = 'API_VERSION: Final = "{current_version}"'
-replace = 'API_VERSION: Final = "{new_version}"'
+filename = "README.md"
+search = '- Home Assistant `{current_version}+`'
+replace = '- Home Assistant `{new_version}+`'
 no-regex = true