Skip to content

v0.17.1 - Options and Logging Consistency (2026-03-05)

What Changed?

This release unifies CLI option definitions and logging setup across all example scripts. All scripts now use Options.verbose(), Options.log_level(), and setup_logger() from the kazunoko library, replacing hand-written typer.Option definitions.

What's New

Unified CLI Options Across Example Scripts

All example scripts now share the same --verbose/--quiet/-v/-q toggle and --log-level option via kazunoko.options.Options.

Before (per-script manual definition):

verbose: bool = typer.Option(False, "--verbose", help="Show detailed progress")

After (shared via Options):

verbose: bool = Options.verbose()       # --verbose/--quiet, -v/-q
log_level: LogLevel = Options.log_level()  # --log-level

And at the start of main():

setup_logger(log_level=log_level)

Installation

Quick Start

# Get the release
git checkout v0.17.1

# Setup
uv sync

# Run CLI
uv run kazunoko --help

What's Different from the Last Version?

🔧 Changed

  • check_coincidence.py: --verbose/-v → Options.verbose() (adds --quiet/-q); add Options.log_level() and setup_logger(); PEP 723 dependency updated to osechi-kazunoko (removes typer, rich)
  • check_event_rate.py: same as above; also fixed incorrect setup_logger(log_level, verbose) call → setup_logger(log_level=log_level)
  • create_run_summary.py: add Options.log_level() and setup_logger()
  • plot_thresholds.py: add Options.log_level() and setup_logger()
  • from_jsonl_to_parquet.py: --verbose → Options.verbose(); add Options.log_level() and setup_logger(); PEP 723 dependency updated to osechi-kazunoko
  • from_jsonl_to_root.py: same as from_jsonl_to_parquet.py
  • from_parquet_to_root.py: same as from_jsonl_to_parquet.py

🐛 Fixed

  • check_event_rate.py, check_coincidence.py: setup_logger() was incorrectly called with two positional arguments; corrected to setup_logger(log_level=log_level)

Is It Safe to Upgrade?

Backward Compatible: Yes, with one minor CLI change

  • --verbose now also accepts --quiet / -q to suppress output in scripts that previously only had --verbose
  • All other behavior is unchanged

Tests Passed

  • ✅ Builds without errors
  • ✅ uvx ruff check src/ passes with no issues

Release Details

  • Date: 2026-03-05
  • Version: v0.17.1
  • Files Changed: 7
  • Commits: 22b7a09, e82b459, 33447b4, 4417d84, 9f39d2f, 7911ead, 710d8fa, 02b561b

Next Steps

  • Add Options.pattern() to kazunoko.options for shared glob pattern option
  • Add tests for kazunoko.workspace functions