v0.20.9 - Dependency Groups Migration (2026-06-06)¶

What Changed?¶

This release migrates docs and dev dependencies from [project.optional-dependencies] to [dependency-groups] (PEP 735). This prevents development tools from being published to PyPI as user-installable extras. ReadTheDocs configuration is updated to use uv's native support for dependency groups.

What's New¶

Main Feature: Dependency Groups (PEP 735)¶

What it does: Development and documentation dependencies are now managed as [dependency-groups] instead of [project.optional-dependencies]. This is the correct way to declare dev-only dependencies that should not be exposed to end users via PyPI.

How to use it:

# Install all groups (dev + docs)
uv sync --all-groups

# Install docs group only
uv sync --group docs

# Install dev group only
uv sync --group dev

Installation¶

Quick Start¶

# Get the release
git checkout 0.20.9

# Setup
task env:setup

# Run CLI
uv run kazunoko --help

What's Different from the Last Version?¶

🔧 Changed¶

pyproject.toml: docs and dev moved from [project.optional-dependencies] to [dependency-groups]
Taskfile.yml: deps:setup and deps:update now use uv sync --all-groups instead of uv sync --all-extras
.readthedocs.yaml: switched from method: pip + extra_requirements to method: uv + groups: [docs]
mkdocs.yml: navigation reorganized into Users Guide, Developers Guide, Contributors Guide, and Maintainers Guide

Is It Safe to Upgrade?¶

Backward Compatible: Yes

No changes to the public API or CLI behavior
Users installing osechi-kazunoko from PyPI are unaffected
Developers must run uv sync --all-groups instead of uv sync --all-extras

Tests Passed¶

✅ Builds without errors
✅ uv sync --all-groups installs all dependencies correctly
✅ ReadTheDocs build uses uv sync --group docs

Release Details¶

Date: 2026-06-06
Version: v0.20.9
Files Changed: 5
Commits: 188b2ab, 109ae6a, bb34b36, 752dbc0, cca278c, 42f9881

Next Steps¶

Continue documentation improvements across the four guide sections