Release v1.8.0#

Overview#

v1.8.0 is a minor release marking the transition of the default CLI entry point from v0 to v1, establishing v1 as the primary implementation while maintaining backward compatibility.

Release Timeline: v1.7.2 (2025-12-17) → v1.8.0 (2025-12-29)


📊 Release Statistics#

Metric

Value

Total Commits

2

Code Changes

~5 lines modified

Features

1 major change

Files Modified

1 file

Breaking Changes

None - full backward compatibility


✨ Primary Change: Default CLI Migration to v1#

Overview#

The default haniwers command now uses the v1 CLI implementation. This marks the official transition from v0 (legacy) to v1 (next-generation) architecture, while maintaining full backward compatibility for existing users.

Implementation Details#

Commit: 611b5f0

Code Changes:

  • pyproject.toml - Updated CLI entry point (1 line)

    • haniwers = "haniwers.v1.cli:app" (changed from v0)

CLI Entry Points#

After v1.8.0:

Command

Implementation

Use Case

haniwers

v1 (default)

Recommended for all new work

haniwers-v1

v1 (explicit)

Production-grade next-generation CLI

haniwers-ng

v1 (alias)

Next-generation shorthand

haniwers-v0

v0 (legacy)

Backward compatibility & maintenance

Compatibility#

  • Backward Compatible: v0 CLI remains available via haniwers-v0 command

  • No Breaking Changes: All v1.7.2 functionality preserved

  • Drop-in Replacement: haniwers command usage unchanged

Benefits#

  • ✅ Unified default CLI across all installations

  • ✅ Users get v1’s modern architecture by default

  • ✅ Legacy v0 available for production systems needing stability

  • ✅ Clear migration path for existing deployments


🔄 Migration Guide (v1.7.2 → v1.8.0)#

Breaking Changes#

None - Full backward compatibility maintained

For Existing Users#

No action required - The haniwers command will automatically use v1 CLI.

If you prefer to explicitly use v0 for any reason:

# Continue using v0 (legacy)
haniwers-v0 --version
# Output: haniwers 1.8.0 (v0 implementation)

For New Installations#

The haniwers command now provides the modern v1 experience:

# Use modern v1 CLI (default)
haniwers --version
# Output: haniwers 1.8.0

haniwers daq --help
haniwers-v1 config init

Verification Steps#

# Verify default CLI points to v1
haniwers --version

# Test v1 CLI functionality
haniwers config show

# Verify v0 still available (if needed)
haniwers-v0 --version

📦 Installation#

PyPI#

pip install haniwers==1.8.0

From Source#

git fetch origin
git checkout v1.8.0
poetry install

🙏 Contributors & Reviewers#

This release represents the completion of the v1 migration effort, enabling:

  • Modern CLI architecture as the default

  • Improved user experience with v1 features

  • Stable legacy v0 available for maintenance


📌 Known Issues & Limitations#

None for this release - v1.8.0 is a smooth transition release.



🚀 Next Steps#

Planned for v1.9.0+#

  • Enhanced error handling refinements

  • Additional CLI command optimizations

  • Documentation updates based on user feedback

Community Feedback#

Please report issues at: qumasan/haniwers/issues


Release Date: December 29, 2025 Status: ✅ Ready for Production Quality Gates: All pre-commit checks passing, full backward compatibility verified