Skip to content

v0.4.9 - Run Summary Script Enhancements (2025-12-24)

What Changed?

This release adds progress bars to the create_run_summary.py example script for visual feedback during event file loading. The script now displays a progress bar as it processes multiple event data files and generates the run summary TOML. All improvements maintain backward compatibility with existing run summary generation workflows.

What's New

Main Feature: Progress Bars for Event File Loading

What it does: The create_run_summary.py example script now includes visual progress bars during the event file loading phase. Users receive real-time feedback on file processing progress as the script iterates through and loads event data files.

How to use it: Simply run the create_run_summary.py script as before - progress bars are automatic and transparent:

# Progress bar shown during file loading
uv run create_run_summary.py ./20251221_run126

# With verbose output
uv run create_run_summary.py ./20251221_run126 --verbose

Installation

Quick Start

# Get the release
git checkout v0.4.9

# Setup
task env:setup

# Run CLI
uv run kazunoko --help

What's Different from the Last Version?

✅ Added

  • Progress bars for event file loading with visual feedback
  • Rich console output with colored status messages
  • Global console instances (stdout/stderr) for consistent formatting
  • rich dependency to PEP 723 script dependencies

🔧 Changed

  • Replaced manual file iteration with Progress context manager for visual feedback
  • load_events() function wrapped with Progress bar for file loading operations
  • Progress bar displays on stderr during file processing
  • Error handling preserves progress updates even when individual files fail

🐛 Fixed

  • None (enhancement release)

Is It Safe to Upgrade?

Backward Compatible: Yes

  • All existing functionality preserved
  • TOML generation algorithm unchanged
  • Run summary output format and content unaffected
  • Progress bars only enhance visibility without disrupting operations
  • Command-line interface remains the same

Tests Passed

  • ✅ Builds without errors
  • ✅ Progress bars display correctly during file loading
  • ✅ Event file loading logic unchanged and verified
  • ✅ Console output formatting consistent with project standards
  • ✅ Pre-commit hooks passed (commitizen check)

Release Details

  • Date: 2025-12-24
  • Version: v0.4.9
  • Files Changed: 2 (examples/create_run_summary.py, version files)
  • Commits:
  • c010d4f - feat: add progress bar to create_run_summary.py file loading
  • cf7a524 - bump: version 0.4.8 → 0.4.9

Next Steps

  • Consider adding elapsed time and ETA to progress bars for large file sets
  • Evaluate consistency of progress bars across all example scripts
  • Gather user feedback on visual output and progress bar styling