Release 0.4.3

.gitattributes

@@ -1,2 +1,4 @@
-onvif/wsdl/** linguist-generated=true
-onvif/** linguist-generated=true
+onvif/wsdl/** linguist-generated
+onvif/db/** linguist-generated
+assets/** linguist-generated
+docs/** linguist-documentation

.github/workflows/cli-cross-platform.yml

@@ -0,0 +1,50 @@
+name: CLI Cross-Platform
+
+on:
+  push:
+    branches: [ "main" ]
+    paths:
+      - "onvif/**"
+      - "pyproject.toml"
+  pull_request:
+    branches: [ "main", "dev" ]
+    paths:
+      - "onvif/**"
+      - "pyproject.toml"
+
+env:
+  MIN_PYTHON_VERSION: "3.10"
+
+jobs:
+  cli-test:
+
+    runs-on: ${{ matrix.os }}
+
+    strategy:
+      matrix:
+        os:
+          - ubuntu-latest
+          - windows-latest
+          - macos-latest
+          - ubuntu-24.04-arm
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1  # v7.0.1
+
+      - name: Set up Python ${{ env.MIN_PYTHON_VERSION }} (${{ matrix.os }})
+        uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97  # v7.0.0
+        with:
+          python-version: ${{ env.MIN_PYTHON_VERSION }}
+
+      - name: Install package (${{ matrix.os }})
+        run: |
+          python -m pip install --upgrade pip
+          pip install .
+
+      - name: Test CLI Help (${{ matrix.os }})
+        run: onvif --help
+
+      - name: Test CLI Discovery (${{ matrix.os }})
+        run: |
+          python -c "import subprocess, sys; result = subprocess.run(['onvif', '--discover', '--interactive']); sys.exit(0 if result.returncode == 1 else result.returncode)"

.github/workflows/coverage-reporter.yml

@@ -2,11 +2,9 @@ name: Codacy Coverage Reporter
 
 on:
   push:
+    # Codacy always requests the latest coverage report 
+    # from the most recent commit, even if it is out of context.
     branches: [ "main", "dev" ]
-    paths:
-      - "onvif/**"
-      - "tests/**"
-      - "examples/**"
 
 permissions:
   contents: read
@@ -15,12 +13,10 @@ env:
   MIN_PYTHON_VERSION: "3.10"  # Use the minimum supported Python version for coverage generation
 
 jobs:
-  codacy-coverage-reporter:
+  reporter:
 
     runs-on: ubuntu-latest
 
-    name: codacy-coverage-reporter
-
     steps:
       - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1  # v7.0.1
 

.github/workflows/documentation-preview.yml

@@ -0,0 +1,56 @@
+name: Documentation Preview
+
+on:
+  pull_request:
+    types:
+      - opened
+      - synchronize
+      - reopened
+      - closed
+    paths:
+      - "docs/**"
+      - "onvif/**"
+      - "mkdocs.yml"
+      - "pyproject.toml"
+
+permissions:
+  contents: write
+  pull-requests: write
+
+concurrency:
+  group: preview-${{ github.event.pull_request.number }}
+  cancel-in-progress: true
+
+jobs:
+  preview:
+
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1  # v7.0.1
+
+      - name: Set up Python
+        if: github.event.action != 'closed'
+        uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97  # v7.0.0
+        with:
+          python-version: "3.12"
+
+      - name: Install documentation dependencies
+        if: github.event.action != 'closed'
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[docs]"
+
+      - name: Build documentation
+        if: github.event.action != 'closed'
+        run: |
+          mkdocs build --strict
+
+      - name: Deploy PR preview
+        uses: rossjrw/pr-preview-action@ffa7509e91a3ec8dfc2e5536c4d5c1acdf7a6de9  # v1.8.1
+        with:
+          source-dir: site/
+          preview-branch: gh-pages
+          umbrella-dir: pr-preview
+          wait-for-pages-deployment: true

.github/workflows/documentation.yml

@@ -0,0 +1,37 @@
+name: Documentation
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - "docs/**"
+      - "onvif/**"
+      - "mkdocs.yml"
+      - "pyproject.toml"
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  deploy:
+
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1  # v7.0.1
+
+      - name: Set up Python
+        uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97  # v7.0.0
+        with:
+          python-version: "3.12"
+
+      - name: Install documentation dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install ".[docs]"
+
+      - name: Deploy documentation
+        run: mkdocs gh-deploy --force

.github/workflows/python-app.yml

@@ -1,19 +1,26 @@
 name: Python Application
 
 on:
+  push:
+    branches: [ "main" ]
+    paths:
+      - "onvif/**"
+      - "tests/**"
+      - "examples/**"  # to enforce lint and format standard
+      - "pyproject.toml"
   pull_request:
     branches: [ "main", "dev" ]
     paths:
       - "onvif/**"
       - "tests/**"
-      - "examples/**"
+      - "examples/**"  # to enforce lint and format standard
+      - "pyproject.toml"
 
 permissions:
   contents: read
 
 env:
-  COVERAGE_FAIL_UNDER: 49  # Will be raised gradually (in percentage)
-  MIN_PYTHON_VERSION: "3.10"  # Use the minimum supported Python version for coverage generation
+  COVERAGE_FAIL_UNDER: 85  # Will be raised gradually (in percentage)
 
 jobs:
   build:
@@ -46,16 +53,14 @@ jobs:
     - name: Check imports order with isort
       run: isort --check-only .
 
+    - name: Check spelling with codespell
+      run: codespell .
+
     - name: Lint with pylint
       run: pylint .
 
     - name: Type check with mypy
       run: mypy .
 
     - name: Test and coverage check with pytest
-      run: |
-        if [ "${{ matrix.python-version }}" = "${{ env.MIN_PYTHON_VERSION }}" ]; then
-          pytest --cov=onvif --cov-fail-under=${{ env.COVERAGE_FAIL_UNDER }} --cov-report=term-missing
-        else
-          pytest .
-        fi
+      run: pytest --cov=onvif --cov-fail-under=${{ env.COVERAGE_FAIL_UNDER }} --cov-report=term-missing

.github/workflows/python-publish.yml

@@ -12,9 +12,9 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1  # v7.0.1
       - name: Set up Python 3.x
-        uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97
+        uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97  # v7.0.0
         with:
           python-version: "3.x"
 
@@ -25,7 +25,7 @@ jobs:
           python -m build
 
       - name: Upload distributions
-        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a  # v7.0.1
         with:
           name: release-dists
           path: dist/
@@ -46,12 +46,12 @@ jobs:
 
     steps:
       - name: Retrieve release distributions
-        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c
+        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c  # v8.0.1
         with:
           name: release-dists
           path: dist/
 
       - name: Publish release distributions to PyPI
-        uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33
+        uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33  # v1.14.2
         with:
           packages-dir: dist/

.gitignore

@@ -23,6 +23,7 @@ site/
 .coverage
 coverage.xml
 codacy-coverage.sh
+result.json
 
 # Python cache
 __pycache__/

LICENSE.md → LICENSE

@@ -1,4 +1,4 @@
-The MIT License (MIT)
+MIT License
 
 Copyright (c) 2025-2026 Nirsimetri Technologies®
 

NOTICE

@@ -0,0 +1,11 @@
+This project is an independent open-source implementation of the ONVIF (https://www.onvif.org) specifications. It is not affiliated with, endorsed by, or sponsored by ONVIF or its member companies.
+
+- The name “ONVIF” and the ONVIF logo are registered trademarks of the ONVIF organization.  
+- Any references to ONVIF within this project are made strictly for the purpose of describing interoperability with ONVIF-compliant devices and services.  
+- Use of the ONVIF trademark in this repository is solely nominative and does not imply any partnership, certification, or official status.
+- This project includes WSDL/XSD/HTML files from the official ONVIF specifications.
+- These files are © ONVIF and are redistributed here for interoperability purposes.
+- The WSDL files in the https://github.com/nirsimetri/onvif-python/tree/main/onvif/wsdl folder are distributed under the ONVIF Contributor License Agreement and Apache License 2.0. See https://github.com/nirsimetri/onvif-python/tree/main/onvif/wsdl/LICENSE for details.
+- All rights to the ONVIF specifications are reserved by ONVIF.
+
+If you require certified ONVIF-compliant devices or clients, please refer to the official https://www.onvif.org/conformant-products. For authoritative reference and the latest official ONVIF specifications, please consult the https://www.onvif.org/profiles/specifications/specification-history.

README.md

@@ -1,20 +1,15 @@
-<h1 align="center">ONVIF Python</h1>
+# ONVIF Python
 
-<div align="center">
-<a href="https://app.codacy.com/gh/nirsimetri/onvif-python/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade"><img src="https://img.shields.io/codacy/grade/bff08a94e4d447b690cea49c6594826d?style=plastic&logo=codacy&label=Code%20Quality"/></a>
-<a href="https://pypi.org/project/onvif-python/"><img alt="PyPI Version" src="https://img.shields.io/badge/Version-0.4.2-orange?logo=python&logoColor=white&color=yellow&style=plastic"></a>
-<a href="https://pepy.tech/projects/onvif-python"><img alt="Pepy Total Downloads" src="https://img.shields.io/pepy/dt/onvif-python?logo=pypi&logoColor=white&label=Downloads&color=red&style=plastic"></a>
+[![Python Version](https://img.shields.io/pypi/pyversions/onvif-python?logo=python&logoColor=white&color=blue&style=plastic&label=Python)](https://pypi.org/project/onvif-python)
+[![PyPI Version](https://img.shields.io/pypi/v/onvif-python?logo=pypi&logoColor=white&color=blue&style=plastic&label=PyPI)](https://pypi.org/project/onvif-python/)
+[![Quality](https://img.shields.io/codacy/grade/bff08a94e4d447b690cea49c6594826d?style=plastic&logo=codacy&label=Quality)](https://app.codacy.com/gh/nirsimetri/onvif-python/dashboard)
+[![Coverage](https://img.shields.io/codacy/coverage/bff08a94e4d447b690cea49c6594826d?style=plastic&logo=codacy&label=Coverage)](https://app.codacy.com/gh/nirsimetri/onvif-python/coverage)
+[![Downloads](https://img.shields.io/pepy/dt/onvif-python?label=Downloads&color=red&style=plastic)](https://pepy.tech/projects/onvif-python)
 <br>
-<a href="https://github.com/nirsimetri/onvif-python/actions/workflows/python-app.yml"><img alt="Build" src="https://github.com/nirsimetri/onvif-python/actions/workflows/python-app.yml/badge.svg?branch=main"></a>
-<a href="https://github.com/nirsimetri/onvif-python/actions/workflows/python-publish.yml"><img alt="Upload Python Package" src="https://github.com/nirsimetri/onvif-python/actions/workflows/python-publish.yml/badge.svg"></a>
-</div>
+[![Build](https://img.shields.io/github/actions/workflow/status/nirsimetri/onvif-python/python-app.yml?logo=github&style=plastic&label=Build)](https://github.com/nirsimetri/onvif-python/actions/workflows/python-app.yml)
+[![Upload Python](https://img.shields.io/github/actions/workflow/status/nirsimetri/onvif-python/python-publish.yml?logo=github&style=plastic&label=Upload%20Package)](https://github.com/nirsimetri/onvif-python/actions/workflows/python-publish.yml)
+[![CLI Cross-Platform](https://img.shields.io/github/actions/workflow/status/nirsimetri/onvif-python/cli-cross-platform.yml?logo=github&style=plastic&label=CLI%20Cross-Platform)](https://github.com/nirsimetri/onvif-python/actions/workflows/cli-cross-platform.yml)
 
-<h1 align="center">
-  <img src="https://raw.githubusercontent.com/nirsimetri/onvif-python/refs/heads/main/assets/images/carbon_onvif.png" alt="onvif" width="700px">
-  <br>
-</h1>
-
-**This project provides a comprehensive and developer-friendly Python library for working with ONVIF-compliant devices.** It is designed to be reliable, easy to integrate, and flexible enough to support a wide range of ONVIF profiles and services.  
 
 **[ONVIF](https://www.onvif.org) (Open Network Video Interface Forum)** is a global standard for the interface of IP-based physical security products, including network cameras, video recorders, and related systems.  
 
@@ -59,4 +54,4 @@ For complete guide, including usage examples and API references, please visit th
 
 ## License
 
-This project is licensed under the MIT License. See [LICENSE](./LICENSE.md) for details.
+This project is licensed under the MIT License. See [LICENSE](./LICENSE) for details.

docs/core/onvif_cli.md

@@ -55,7 +55,7 @@ This library includes a powerful command-line interface (CLI) for interacting wi
                 [--health-check-interval HEALTH_CHECK_INTERVAL] [--output OUTPUT] [--version]
                 [service] [method] [params ...]
 
-    ONVIF Terminal Client — v0.4.2
+    ONVIF Terminal Client — v0.4.3
     https://github.com/nirsimetri/onvif-python
 
     positional arguments:
@@ -137,7 +137,7 @@ This library includes a powerful command-line interface (CLI) for interacting wi
 ??? abstract "Interactive Shell"
 
     ```shell
-    ONVIF Interactive Shell — v0.4.2
+    ONVIF Interactive Shell — v0.4.3
     https://github.com/nirsimetri/onvif-python
 
     Basic Commands:
@@ -304,10 +304,13 @@ onvif media GetProfiles -d -u admin -p password
 1. **Automatic Network Scanning**: Sends a WS-Discovery Probe message to the multicast address `239.255.255.250:3702`
 2. **Device Detection**: Listens for ProbeMatch responses from ONVIF devices (default timeout: 4 seconds)
 3. **Interactive Selection**: Displays a numbered list of discovered devices with their details:
-   - Device UUID (Endpoint Reference)
-   - XAddrs (ONVIF service URLs)
-   - Device Types (e.g., NetworkVideoTransmitter)
-   - Scopes (name, location, hardware, profile information)
+    - Device UUID (Endpoint Reference)
+    - Hostname (hostname of the device)
+    - XAddrs (ONVIF service URLs)
+    - Date & Time (in UTC and/or Local)
+    - Device Types (e.g., NetworkVideoTransmitter)
+    - Services (available services on device)
+    - Scopes (name, location, hardware, profile information)
 4. **Connection**: Once you select a device, the CLI automatically connects using the discovered host and port
 
 #### Example Discovery Output