Skip to content

v0.18.1 - Timezone-Aware Timestamps in create_run_summary.py (2026-03-05)

What Changed?

This release updates create_run_summary.py to use get_timezone() instead of the hardcoded "Asia/Tokyo" string for timestamp conversion. The timezone is now resolved from the KAZUNOKO_TZ environment variable, falling back to the system timezone. This makes the script portable for users in different timezones.

What's New

Main Feature: Dynamic timezone in create_run_summary.py

What it does: Timestamps in the generated run_summary.toml are now converted to the local timezone resolved by get_timezone() rather than always using "Asia/Tokyo".

How to use it:

# Uses system timezone (default)
uv run create_run_summary.py ./20251221_run126

# Override timezone via environment variable
KAZUNOKO_TZ=Europe/Paris uv run create_run_summary.py ./20251221_run126

Installation

Quick Start

# Get the release
git checkout 0.18.1

# Setup
uv sync

# Run CLI
uv run kazunoko --help

What's Different from the Last Version?

🔧 Changed

  • create_run_summary.py: replaced hardcoded "Asia/Tokyo" with get_timezone() for timezone-aware timestamp conversion in both build_toml() and verbose logging

✅ Added

  • create_run_summary.py: documented KAZUNOKO_TZ environment variable in module docstring with usage example

Is It Safe to Upgrade?

Backward Compatible: Yes

  • Default behavior is unchanged for users whose system timezone is Asia/Tokyo
  • Users in other timezones now get correct local timestamps automatically
  • Set KAZUNOKO_TZ=Asia/Tokyo to preserve the previous behavior explicitly

Tests Passed

  • ✅ Builds without errors
  • ✅ uvx ruff check src/ passes
  • ✅ Pre-commit hooks pass

Release Details

  • Date: 2026-03-05
  • Version: v0.18.1
  • Files Changed: 1
  • Commits: 72a6a69, 22b6fa6

Next Steps

  • Consider exposing KAZUNOKO_TZ in the CLI as a global option