Skip to content

v0.20.3 - Fix threading imports in monitor example scripts (2026-06-04)

What Changed?

This release fixes two threading import issues in the monitor example scripts. monitor_events.py was missing the threading import after it was accidentally removed in a previous refactor, causing a NameError at runtime. monitor_thresholds.py had an unused threading import that was removed for clarity.


What's New

Fix: Restore missing threading import in monitor_events.py

What it does: Restores import threading that was accidentally deleted in commit 48760a9 when stdin mode was removed. DirectoryMonitor still uses threading.Lock() to guard _file_positions against concurrent access from the watchdog thread.

How to use it: No changes needed — monitor_events.py will run without NameError again.


Fix: Remove unused threading import from monitor_thresholds.py

What it does: Removes import threading from monitor_thresholds.py where it was never used. ThresholdFileMonitor watches a single file accessed only from the watchdog Observer thread, so no locking is required.


Installation

Quick Start

# Get the release
git checkout v0.20.3

# Setup
uv sync

# Run CLI
uv run kazunoko --help

What's Different from the Last Version?

🐛 Fixed

  • examples/monitor_events.py: restored import threading removed accidentally in 48760a9 — fixes NameError: name 'threading' is not defined
  • examples/monitor_thresholds.py: removed unused import threading — no functional impact

Is It Safe to Upgrade?

Backward Compatible: Yes

  • No API or behavior changes.
  • monitor_events.py is restored to working state.
  • monitor_thresholds.py behavior is unchanged.

Tests Passed

  • ✅ Builds without errors
  • monitor_events.py starts without NameError
  • monitor_thresholds.py runs without warnings

Release Details

  • Date: 2026-06-04
  • Version: v0.20.3
  • Files Changed: 2
  • Commits: 1e7eb4a, 49bc0dc

Next Steps

Continue stabilizing example scripts for reliable operation.