Skip to content

v0.14.0 - Package Rename and Build System Modernization (2025-12-30)

What Changed?

This release renames the PyPI package to osechi-kazunoko to reflect its role as part of the OSECHI cosmic ray detector suite. The module name remains kazunoko for clean imports. The build system has been upgraded to hatchling for a more modern, lightweight packaging experience while maintaining full compatibility with commitizen for version management.

What's New

Package Name Change

What it does: The PyPI package is now named osechi-kazunoko to clearly indicate it's part of the OSECHI cosmic ray detector ecosystem.

How to use it:

# Installation (new package name)
pip install osechi-kazunoko

# Import (module name unchanged)
import kazunoko
from kazunoko import Command, connect

# CLI (unchanged)
kazunoko --help

Build System Upgrade

The build backend has been switched from uv_build to hatchling for lighter, more modern Python packaging while maintaining full integration with commitizen version management.

Installation

Quick Start

# Install from PyPI (new package name)
pip install osechi-kazunoko

# Or with uv
uv pip install osechi-kazunoko

# Run CLI
kazunoko --help

From Source

# Get the release
git checkout v0.14.0

# Setup
uv sync

# Run CLI
uv run kazunoko --help

What's Different from the Last Version?

✅ Added

  • Package branding: New PyPI name osechi-kazunoko reflects OSECHI ecosystem integration

🔧 Changed

  • Build system: Upgraded from uv_build to hatchling for modern, lightweight packaging
  • Build configuration: Enhanced pyproject.toml with explicit hatch settings

🐛 Fixed

  • Build configuration compatibility with modern Python packaging standards

Is It Safe to Upgrade?

Backward Compatible: Mostly yes (see note below)

  • Module API: Unchanged. All imports work as before (import kazunoko)
  • CLI: Unchanged. Command line interface is identical
  • Package Installation: Users must update pip command: pip install osechi-kazunoko instead of pip install kazunoko

Note: If you have kazunoko installed via pip, uninstall it first before installing osechi-kazunoko:

pip uninstall kazunoko
pip install osechi-kazunoko

Tests Passed

  • ✅ Builds without errors (hatchling backend)
  • ✅ Package detection and module resolution
  • ✅ Version consistency checks (commitizen)

Release Details

  • Date: 2025-12-30
  • Version: v0.14.0
  • Files Changed: 4 (pyproject.toml, __init__.py, CHANGELOG.md)
  • Commits: 61f70c8, c80e64b, ece213c

Next Steps

Future releases will focus on expanding the OSECHI detector capabilities and improving documentation. The package naming convention now enables easier discovery as part of the broader OSECHI ecosystem.