Skip to content

v0.13.0 - Add Logging Dependencies (2025-12-29)

What Changed?

This release adds missing core dependencies (loguru and platformdirs) that are required for the logging functionality introduced in v0.12.0. These dependencies were already imported in the code but were not declared in pyproject.toml, causing installation issues for end users. All functionality remains backward compatible.

What's New

Dependencies Added

What they do: - loguru>=0.7.0: Provides structured JSON logging with file rotation and console formatting - platformdirs>=4.0.0: Enables XDG-compliant log directory detection across Windows, macOS, and Linux

How to use it: These dependencies are automatically installed when you install kazunoko. The logging functionality works transparently in all CLI commands and library functions via setup_logger().

Code example:

from kazunoko.log import setup_logger

# Setup logging with info level
log_dir = setup_logger(log_level="info")
# Logs are now saved to platform-specific directory:
# - macOS: ~/Library/Logs/kazunoko/kazunoko.json
# - Linux: ~/.cache/kazunoko/kazunoko.json
# - Windows: %APPDATA%\osechi\kazunoko\Logs\kazunoko.json

Installation

Quick Start

# Get the release
git checkout v0.13.0

# Setup
uv sync

# Run CLI
uv run kazunoko --help

What's Different from the Last Version?

✅ Added

  • loguru>=0.7.0 as core dependency for structured JSON logging
  • platformdirs>=4.0.0 as core dependency for XDG-compliant log directory detection

🔧 Changed

  • No behavior changes; dependencies were already in use but not declared

🐛 Fixed

  • Fixed installation issues where logging functionality failed due to missing dependencies

Is It Safe to Upgrade?

Backward Compatible: Yes

  • No breaking changes; all existing code continues to work
  • New dependencies are required but provide no functional changes to existing behavior
  • Existing users should upgrade to resolve missing dependency issues

Tests Passed

  • ✅ Builds without errors
  • ✅ Pre-commit hooks passed
  • ✅ Package installs with new dependencies

Release Details

  • Date: 2025-12-29
  • Version: v0.13.0
  • Files Changed: 2
  • Commits:
  • 9c588e5 - feat(deps): add loguru and platformdirs to core dependencies
  • c395cc8 - bump: version 0.12.1 → 0.13.0

Next Steps

Continue maintaining logging infrastructure and address any user-reported issues with the new dependency setup.