Skip to content

v0.16.3 - Example Script CLI Consistency (2026-03-04)

What Changed?

This release improves CLI consistency across all example scripts. Help text, option defaults, and user-facing messages are now aligned. After measurement ends (or is interrupted), each acquisition script now prints next steps to stderr to guide users toward follow-up workflows.

What's New

Next Steps Message After Measurement

get_events.py, get_runs.py, and get_thresholds.py now print a next steps message to stderr when measurement completes or is interrupted with Ctrl+C.

Example output from get_runs.py:

Next steps:
  - Rename the output directory before next measurement
      e.g. mv 20260304/ 20260304_run1/
  - Create a run summary:
      uv run create_run_summary.py 20260304_run1/
  - Convert to Parquet for analysis:
      uv run from_jsonl_to_parquet.py 20260304_run1/

Installation

Quick Start

# Get the release
git checkout v0.16.3

# Setup
uv sync

# Run CLI
uv run kazunoko --help

What's Different from the Last Version?

✅ Added

  • get_events.py: next steps message printed after measurement ends or is interrupted
  • get_runs.py: next steps message printed after measurement ends or is interrupted
  • get_thresholds.py: next steps message printed after measurement ends or is interrupted
  • template_minimal.py: added --log-level option and setup_logger() call

🔧 Changed

  • fit_thresholds.py: removed --save flag; results are always saved to fitted_thresholds.json; added --overwrite to prevent accidental overwrites
  • create_run_summary.py: moved module docstring before PEP 723 # /// script block (consistent with all other scripts)

🐛 Fixed

  • options.py: corrected --poll-count help text from default: 50000 to default: 100
  • get_events.py, get_runs.py, get_thresholds.py: updated docstring to reflect correct --poll-count default of 100

Is It Safe to Upgrade?

Backward Compatible: Yes, with one exception

  • fit_thresholds.py: --save flag removed. Results are now always saved. Use --overwrite if fitted_thresholds.json already exists.
  • All other changes are display-only or additive

Tests Passed

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

Release Details

  • Date: 2026-03-04
  • Version: v0.16.3
  • Files Changed: 8
  • Commits: 91a5066, ed3abc6, 26dde0b, bc808fd, d8cd6db, 89d85b4, 8d2fb04

Next Steps

  • Add tests for kazunoko.workspace functions