v0.1.1 — 2025-10-17

Overview

Welcome to v0.1.1! This release marks a significant milestone with the introduction of the ONVIF Command-Line Interface (CLI), a powerful tool for interacting with ONVIF devices directly from your terminal. This feature was the primary focus of this cycle, evolving from its initial concept to a robust, cross-platform utility.

This version includes a feature-rich interactive shell, direct command execution, and numerous bug fixes to improve stability and user experience.

Changelog Summary

PyPI

https://pypi.org/project/onvif-python/0.1.1 (18592240303)

New Features

• Implementation of ONVIF CLI (645be01) (912fd5a) (1f754aa) (d172066) (038bf0b)
  • Introduced a comprehensive CLI program accessible via onvif or python -m onvif.cli.
  • Supports both an interactive shell (-i) and direct command execution.
  • The desc <method> command in the interactive shell displays detailed documentation and parameter information for any service method, parsed directly from WSDL files.
  • The interactive shell now includes a background TCP health check that automatically exits the session if the connection to the device is lost, similar to an SSH session.
  • The CLI will securely prompt for a password if it is not provided as an argument, using getpass.
  • Users can control the WSDL caching behavior (all, db, mem, none) directly from the command line.

Refactor

• Add type hints to ONVIFClient constructor parameters for improved clarity (017d5cb)
• Improve detail extraction in ONVIFOperationException for better error reporting (cd8d088)

Documentation & Test

• Add comprehensive tests for project components and error handling (3bf1ebf)
• Add comprehensive ONVIF CLI section (9fdffb7)
  • Added a new, detailed section to README.md and README_ID.md explaining the features and usage of the new ONVIF CLI.

---

Full Changelog: v0.1.0...v0.1.1