build: zabalení hry do instalovatelného Python balíčku #26

2026-06-27T19:18:42+02:00

david-spacil commented

2026-06-27 19:18:42 +02:00

Souhrn

Převádí projekt z volného skriptu na standardní instalovatelný Python balíček řízený pyproject.toml. Po instalaci jde hra spustit příkazem kostky (nebo python -m kostky). Kód se stěhuje do balíčku kostky/, hodnoty.csv se načítá bezpečně přes importlib.resources a přibývá konfigurace nástrojů (mypy, ruff) na jednom místě.

Změny

Struktura balíčku – kód přesunut do kostky/: main.py → kostky/kostky.py, hodnoty.csv → kostky/hodnoty.csv, přidány __init__.py a __main__.py (umožní python -m kostky).
pyproject.toml – backend hatchling; metadata, závislost tabulate, dev extra (mypy, ruff, types-tabulate); entry point kostky (kostky.kostky:main); konfigurace [tool.mypy] (strict) a [tool.ruff].
Verze z gitového tagu – dynamic = ["version"] + hatch-vcs ([tool.hatch.version] source = "vcs"), verze se tak bere z tagu, ne ručně.
Bezpečné načítání hodnoty.csv – open("hodnoty.csv") (závislé na aktuálním adresáři) nahrazeno importlib.resources.files(__package__), takže hra funguje bez ohledu na to, odkud se spustí.
.gitignore – přidány build artefakty (dist/, build/, *.egg-info/).
Úklid dle ruff – seřazené importy, nepoužité smyčkové proměnné (_dice, _i), ternární clear(), zalomené dlouhé řádky; opravená anotace to_sorted_tuple (L: list[tuple[int, str, int]]).

### Souhrn Převádí projekt z volného skriptu na standardní instalovatelný Python balíček řízený `pyproject.toml`. Po instalaci jde hra spustit příkazem `kostky` (nebo `python -m kostky`). Kód se stěhuje do balíčku `kostky/`, `hodnoty.csv` se načítá bezpečně přes `importlib.resources` a přibývá konfigurace nástrojů (mypy, ruff) na jednom místě. ### Změny - **Struktura balíčku** – kód přesunut do `kostky/`: `main.py` → `kostky/kostky.py`, `hodnoty.csv` → `kostky/hodnoty.csv`, přidány `__init__.py` a `__main__.py` (umožní `python -m kostky`). - **`pyproject.toml`** – backend hatchling; metadata, závislost `tabulate`, dev extra (`mypy`, `ruff`, `types-tabulate`); entry point `kostky` (`kostky.kostky:main`); konfigurace `[tool.mypy]` (strict) a `[tool.ruff]`. - **Verze z gitového tagu** – `dynamic = ["version"]` + hatch-vcs (`[tool.hatch.version] source = "vcs"`), verze se tak bere z tagu, ne ručně. - **Bezpečné načítání `hodnoty.csv`** – `open("hodnoty.csv")` (závislé na aktuálním adresáři) nahrazeno `importlib.resources.files(__package__)`, takže hra funguje bez ohledu na to, odkud se spustí. - **`.gitignore`** – přidány build artefakty (`dist/`, `build/`, `*.egg-info/`). - **Úklid dle ruff** – seřazené importy, nepoužité smyčkové proměnné (`_dice`, `_i`), ternární `clear()`, zalomené dlouhé řádky; opravená anotace `to_sorted_tuple` (`L: list[tuple[int, str, int]]`).

david-spacil added this to the v0.2.0 milestone 2026-06-27 19:18:42 +02:00

david-spacil self-assigned this 2026-06-27 19:18:42 +02:00

david-spacil added 9 commits 2026-06-27 19:18:43 +02:00

package: update .gitignore 754119980f

package: přesuny souborů 388c92f817

package: bezpečné otevírání csv 9d5c51a17a

package: povinná struktura 3808081482

package: přejmenovat main.py na kostky.py 9346735af6

package: přidat pyproject.toml a31eff26fd

package: změna názvu importu v __main__.py a9ef19ee52

fix: opravy (načítání csv + ruff) 69b30552cb

fix: oprava anotace to_sorted_tuple() db3f71592c