Skip to content

v0.4.2 - Progress Bars for Event Collection (2025-12-24)

What Changed?

This release adds visual progress bars to event collection operations. The read and measure commands now display real-time progress when collecting events in count-based mode, improving user feedback and transparency during data acquisition. All progress information is displayed on stderr to keep stdout clean for data output redirection.

What's New

Main Feature: Progress Bars for Event Collection

What it does: Displays a visual progress bar during count-based event collection, showing how many events have been collected and the remaining count. This provides real-time feedback to users and helps estimate completion time.

How to use it: Simply run the read or measure command with a specific event count (default mode):

# Read 100 events with progress bar
kazunoko read 100

# Measure 500 events at threshold 300 with progress bar
kazunoko measure "1:300;2:300;3:300" 500

The progress bar appears on stderr and automatically updates as events arrive. Stdout remains clean for data output redirection:

# Progress on terminal, data saved to file
kazunoko read 100 > events.jsonl

# Both progress and data output separately
kazunoko read 100 2> progress.log 1> events.jsonl

Installation

Quick Start

# Get the release
git checkout vX.Y.Z

# Setup
task env:setup

# Run CLI
uv run kazunoko --help

What's Different from the Last Version?

✅ Added

  • Progress bars for read command (count-based event collection)
  • Progress bars for measure command (count-based event collection)
  • rich.Progress import for visual feedback

🔧 Changed

  • Event streaming output now includes progress bar on stderr
  • Progress information displays in cyan color following project color scheme

🐛 Fixed

  • None (feature release)

Is It Safe to Upgrade?

Backward Compatible: Yes

  • All existing functionality preserved
  • Progress bars only appear in interactive terminal mode (count-based collection)
  • When stdout is redirected, Rich automatically disables progress (no interference with data output)
  • Time-based collection (--use-sec) unaffected

Tests Passed

  • ✅ Builds without errors
  • ✅ Progress bars display correctly in terminal
  • ✅ Data redirection (stdout > file) works properly
  • ✅ Pre-commit hooks passed (commitizen check)

Release Details

  • Date: 2025-12-24
  • Version: v0.4.2
  • Files Changed: 1 (src/kazunoko/cli.py)
  • Commits:
  • 8c55f1d - feat: add progress bars to read and measure commands
  • c92dd84 - bump: version 0.4.1 → 0.4.2

Next Steps

  • Consider adding progress bars to time-based streaming with elapsed time display
  • Explore additional progress bar customization (e.g., speed indicators, ETA)
  • User feedback on progress bar behavior and styling