Finish package: fix packaging, modernize, add public API, CI and docs

.github/workflows/ci.yml

@@ -0,0 +1,42 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+  workflow_dispatch:
+
+jobs:
+  test:
+    name: Test (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+
+      - name: Lint (ruff)
+        run: ruff check .
+
+      - name: Format check (black)
+        run: black --check .
+
+      - name: Type check (mypy)
+        run: mypy rohlik_api
+
+      - name: Test (pytest)
+        run: pytest --cov=rohlik_api --cov-report=term-missing

PUBLISHING.md

@@ -110,15 +110,15 @@ Configure Trusted Publishing on PyPI:
 
 When releasing a new version:
 
-1. Update version in `pyproject.toml`
-2. Update version in `rohlik_api/__init__.py`
-3. Update CHANGELOG in README.md
-4. Create a git tag:
+1. Bump `__version__` in `rohlik_api/__init__.py` (this is the single source of
+   truth — `pyproject.toml` reads it dynamically).
+2. Create a git tag:
    ```bash
    git tag v0.1.1
    git push origin v0.1.1
    ```
-5. Build and publish the new version
+3. Build and publish the new version (or let the GitHub Actions release workflow
+   do it).
 
 ## Verification