v0.20.7 - Bug fixes and UX improvements for ROOT conversion scripts (2026-06-05)¶

What Changed?¶

This release fixes several bugs in the ROOT and Parquet conversion example scripts and improves the user experience with next-step suggestions after conversion. typer.Exit was being incorrectly caught by except Exception, causing spurious "Unexpected error:" messages. Input file lookup in from_parquet_to_root.py was also broken due to missing glob expansion.

What's New¶

Next-step suggestions after conversion¶

What it does: After a successful conversion, each script now prints a suggested next command to stderr.

How to use it:

# After from_jsonl_to_parquet.py completes:
# → Next step: uv run from_parquet_to_root.py 20251221_run126/

# After from_jsonl_to_root.py or from_parquet_to_root.py completes:
# → Next step: rootbrowse /path/to/run.root

Installation¶

Quick Start¶

# Get the release
git checkout v0.20.7

# Setup
task env:setup

# Run CLI
uv run kazunoko --help

What's Different from the Last Version?¶

🐛 Fixed¶

from_jsonl_to_parquet.py: typer.Exit no longer caught by except Exception; full output path replaced with filename only in "Output file exists" error message
from_jsonl_to_root.py: typer.Exit no longer caught by except Exception
from_parquet_to_root.py: typer.Exit no longer caught by except Exception; default --pattern changed from "run*.parquet" to "run.parquet"; input file lookup now uses glob() so wildcard patterns work correctly
from_jsonl_to_parquet.py: suggests from_parquet_to_root.py as next step after Parquet conversion
from_jsonl_to_root.py, from_parquet_to_root.py: suggests rootbrowse command after ROOT file creation

Is It Safe to Upgrade?¶

Backward Compatible: Yes

No API changes. Error messages are more accurate; behavior is unchanged for successful runs.

Tests Passed¶

✅ Builds without errors
✅ commitizen pre-commit hook passed

Release Details¶

Date: 2026-06-05
Version: v0.20.7
Files Changed: 3
Commits: 7fb6ef5, 6d9e1dc, f03bed0, 9374d39

Next Steps¶

No planned changes at this time.