Skip to content

v0.17.2 - Unified Pattern Option Across Example Scripts (2026-03-05)

What Changed?

This release introduces Options.pattern() to kazunoko.options and migrates all example scripts from hand-written typer.Option("--pattern", ...) definitions to the new shared method. All nine affected scripts now use a consistent --pattern option with a unified help text.

What's New

Unified --pattern Option Across Example Scripts

All example scripts now share the same --pattern option via kazunoko.options.Options.

Before (per-script manual definition):

pattern: str = typer.Option(
    "events*.jsonl",
    "--pattern",
    help="Glob pattern for JSONL files",
)

After (shared via Options):

pattern: str = Options.pattern("events*.jsonl")

Installation

Quick Start

# Get the release
git checkout v0.17.2

# Setup
uv sync

# Run CLI
uv run kazunoko --help

What's Different from the Last Version?

✅ Added

  • Options.pattern(default): new shared glob pattern option in kazunoko.options

🔧 Changed

  • check_coincidence.py: typer.Option("run*.parquet", "--pattern", ...) → Options.pattern("run*.parquet")
  • check_event_rate.py: typer.Option("*.parquet", "--pattern", ...) → Options.pattern("run*.parquet")
  • create_run_summary.py: typer.Option("events*.jsonl", "--pattern", ...) → Options.pattern("events*.jsonl")
  • from_jsonl_to_parquet.py: typer.Option("events*.jsonl", "--pattern", ...) → Options.pattern("events*.jsonl")
  • from_jsonl_to_root.py: typer.Option("events*.jsonl", "--pattern", ...) → Options.pattern("events*.jsonl")
  • from_parquet_to_root.py: typer.Option("run.parquet", "--pattern", ...) → Options.pattern("run*.parquet")
  • plot_thresholds.py: typer.Option("fitted_thresholds.json", "--pattern", "-p", ...) → Options.pattern("fitted_thresholds.json") (removes -p short flag)
  • fit_thresholds.py: typer.Option("events_*.jsonl", "--pattern", "-p", ...) → Options.pattern("events*.jsonl") (removes -p short flag)
  • monitor.py: typer.Option("events_*.jsonl", "--pattern", ...) → Options.pattern("events*.jsonl")

Is It Safe to Upgrade?

Backward Compatible: Yes, with one minor CLI change

  • --pattern behavior is unchanged in all scripts
  • plot_thresholds.py and fit_thresholds.py no longer accept -p as a short flag for --pattern

Tests Passed

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

Release Details

  • Date: 2026-03-05
  • Version: v0.17.2
  • Files Changed: 10
  • Commits: 4e43420, 7717af7, aaf743b, 13b54f3, 2fbb14c, 8a9aace, 415c47e, 6e2deb5, 05bcffb, 8d703a7, a5fd421

Next Steps

  • Add tests for kazunoko.workspace functions