Skip to content

v0.1.42 - Enhanced Measurement Metadata Collection (2025-12-14)

What Changed?

This release enhances the measure command to collect and include comprehensive metadata about the measurement session. The update captures MAC address and version information (both kurikintons firmware and kazunoko library versions) in the measurement metadata for better traceability and reproducibility. All changes maintain full backward compatibility with existing measurement workflows.

What's New

Enhanced Metadata Collection in Measure Command

What it does: The measure command now automatically collects and includes device metadata in the measurement output. This includes the device's MAC address and firmware version, along with the kazunoko library version used for the measurement.

How to use it: Simply use the measure command as before—metadata is automatically collected and included in the output:

uv run kazunoko measure --device /dev/ttyUSB0

Metadata included: - mac_address: Device MAC address (for device identification) - kurikintons: Firmware version (detector firmware) - kazunoko: Library version (this software version)

These fields are automatically added to the measurement metadata and help track which device and software versions were used for each measurement.

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

  • MAC address collection in measure command metadata
  • Kurikintons firmware version tracking in measurement output
  • Kazunoko library version tracking in measurement output

🔧 Changed

  • Moved __version__ import to top of cli.py for cleaner code organization
  • Enhanced measurement metadata to include device and software version information

Is It Safe to Upgrade?

Backward Compatible: Yes

  • No breaking changes to CLI or API
  • Existing measurement workflows continue to work as before
  • Additional metadata fields are purely additive to the measurement output

Tests Passed

  • ✅ Builds without errors
  • ✅ [Specific test 1]
  • ✅ [Specific test 2]

Release Details

  • Date: 2025-12-14
  • Version: v0.1.42
  • Files Changed: 1
  • Commits: feb00b5

Next Steps

Future releases will continue to enhance measurement traceability and may include: - Automatic measurement file naming with version information - Measurement validation against specific firmware versions - Extended metadata collection for environmental conditions