onvif-python 0.1.7__tar.gz → 0.1.8__tar.gz

{onvif_python-0.1.7/onvif_python.egg-info → onvif_python-0.1.8}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: onvif-python
-Version: 0.1.7
-Summary: A comprehensive and developer-friendly Python library for working with ONVIF-compliant devices
+Version: 0.1.8
+Summary: A modern Python library for ONVIF-compliant devices
 Author-email: Nirsimetri Technologies® <open@nirsimetri.com>
 Maintainer: Kaburagi
 License-Expression: MIT
@@ -11,8 +11,12 @@ Project-URL: Changelog, https://github.com/nirsimetri/onvif-python/releases
 Keywords: onvif,Camera,onvif-python,ip-camera,cctv,soap,surveillance,cctv cameras,soap-client,onvif-client,onvif-library,onvif-specifications
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Environment :: Console
-Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Operating System :: OS Independent
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: Information Technology
@@ -37,15 +41,23 @@ Requires-Dist: black; extra == "dev"
 Requires-Dist: flake8; extra == "dev"
 Dynamic: license-file
 
-# ONVIF Python
+<h1 align="center">ONVIF Python</h1>
 
-[![Codacy grade](https://img.shields.io/codacy/grade/bff08a94e4d447b690cea49c6594826d?label=Project%20Quality&logo=codacy)](https://app.codacy.com/gh/nirsimetri/onvif-python/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade)
+<div align="center">
+	
+[![Codacy grade](https://img.shields.io/codacy/grade/bff08a94e4d447b690cea49c6594826d?label=Code%20Quality&logo=codacy)](https://app.codacy.com/gh/nirsimetri/onvif-python/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade)
 [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/nirsimetri/onvif-python)
-[![PyPI](https://img.shields.io/badge/PyPI-0.1.7-orange?logo=archive)](https://pypi.org/project/onvif-python/)
+[![PyPI](https://img.shields.io/badge/PyPI-0.1.8-orange?logo=archive)](https://pypi.org/project/onvif-python/)
 [![Downloads](https://img.shields.io/pypi/dm/onvif-python?label=Downloads&color=red)](https://clickpy.clickhouse.com/dashboard/onvif-python)
 <br>
 [![Build](https://github.com/nirsimetri/onvif-python/actions/workflows/python-app.yml/badge.svg?branch=main)](https://github.com/nirsimetri/onvif-python/actions/workflows/python-app.yml)
 [![Upload Python Package](https://github.com/nirsimetri/onvif-python/actions/workflows/python-publish.yml/badge.svg)](https://github.com/nirsimetri/onvif-python/actions/workflows/python-publish.yml)
+</div>
+
+<h1 align="center">
+  <img src="https://raw.githubusercontent.com/nirsimetri/onvif-python/refs/heads/main/assets/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.  
 
@@ -187,7 +199,7 @@ Explore more advanced usage and service-specific operations in the [`examples/`]
 ## ONVIF CLI
 
 > [!NOTE]
-> The CLI is automatically installed when you install the `onvif-python` see [Installation](#installation). This feature has been available since `onvif-python` version [`0.1.1`](https://github.com/nirsimetri/onvif-python/releases/tag/v0.1.1).
+> The CLI is automatically installed when you install the `onvif-python` see [Installation](#installation). This feature has been available since `onvif-python` version [`>=0.1.1`](https://github.com/nirsimetri/onvif-python/releases/tag/v0.1.1).
 
 ![Windows](https://img.shields.io/badge/Windows-0078D6?style=plastic&logo=gitforwindows&logoColor=white)
 ![Linux](https://img.shields.io/badge/Linux-FCC624?style=plastic&logo=linux&logoColor=black)
@@ -242,7 +254,7 @@ usage: onvif [-h] [--host HOST] [--port PORT] [--username USERNAME] [--password
              [--health-check-interval HEALTH_CHECK_INTERVAL] [--version]
              [service] [method] [params ...]
 
-ONVIF Terminal Client — v0.1.7
+ONVIF Terminal Client — v0.1.8
 https://github.com/nirsimetri/onvif-python
 
 positional arguments:
@@ -306,7 +318,7 @@ Examples:
 <summary><b>2. Interactive Shell</b></summary> 
 
 ```bash
-ONVIF Interactive Shell — v0.1.7
+ONVIF Interactive Shell — v0.1.8
 https://github.com/nirsimetri/onvif-python
 
 Basic Commands:

{onvif_python-0.1.7 → onvif_python-0.1.8}/README.md

@@ -1,12 +1,20 @@
-# ONVIF Python
+<h1 align="center">ONVIF Python</h1>
 
-[![Codacy grade](https://img.shields.io/codacy/grade/bff08a94e4d447b690cea49c6594826d?label=Project%20Quality&logo=codacy)](https://app.codacy.com/gh/nirsimetri/onvif-python/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade)
+<div align="center">
+	
+[![Codacy grade](https://img.shields.io/codacy/grade/bff08a94e4d447b690cea49c6594826d?label=Code%20Quality&logo=codacy)](https://app.codacy.com/gh/nirsimetri/onvif-python/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade)
 [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/nirsimetri/onvif-python)
-[![PyPI](https://img.shields.io/badge/PyPI-0.1.7-orange?logo=archive)](https://pypi.org/project/onvif-python/)
+[![PyPI](https://img.shields.io/badge/PyPI-0.1.8-orange?logo=archive)](https://pypi.org/project/onvif-python/)
 [![Downloads](https://img.shields.io/pypi/dm/onvif-python?label=Downloads&color=red)](https://clickpy.clickhouse.com/dashboard/onvif-python)
 <br>
 [![Build](https://github.com/nirsimetri/onvif-python/actions/workflows/python-app.yml/badge.svg?branch=main)](https://github.com/nirsimetri/onvif-python/actions/workflows/python-app.yml)
 [![Upload Python Package](https://github.com/nirsimetri/onvif-python/actions/workflows/python-publish.yml/badge.svg)](https://github.com/nirsimetri/onvif-python/actions/workflows/python-publish.yml)
+</div>
+
+<h1 align="center">
+  <img src="https://raw.githubusercontent.com/nirsimetri/onvif-python/refs/heads/main/assets/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.  
 
@@ -148,7 +156,7 @@ Explore more advanced usage and service-specific operations in the [`examples/`]
 ## ONVIF CLI
 
 > [!NOTE]
-> The CLI is automatically installed when you install the `onvif-python` see [Installation](#installation). This feature has been available since `onvif-python` version [`0.1.1`](https://github.com/nirsimetri/onvif-python/releases/tag/v0.1.1).
+> The CLI is automatically installed when you install the `onvif-python` see [Installation](#installation). This feature has been available since `onvif-python` version [`>=0.1.1`](https://github.com/nirsimetri/onvif-python/releases/tag/v0.1.1).
 
 ![Windows](https://img.shields.io/badge/Windows-0078D6?style=plastic&logo=gitforwindows&logoColor=white)
 ![Linux](https://img.shields.io/badge/Linux-FCC624?style=plastic&logo=linux&logoColor=black)
@@ -203,7 +211,7 @@ usage: onvif [-h] [--host HOST] [--port PORT] [--username USERNAME] [--password
              [--health-check-interval HEALTH_CHECK_INTERVAL] [--version]
              [service] [method] [params ...]
 
-ONVIF Terminal Client — v0.1.7
+ONVIF Terminal Client — v0.1.8
 https://github.com/nirsimetri/onvif-python
 
 positional arguments:
@@ -267,7 +275,7 @@ Examples:
 <summary><b>2. Interactive Shell</b></summary> 
 
 ```bash
-ONVIF Interactive Shell — v0.1.7
+ONVIF Interactive Shell — v0.1.8
 https://github.com/nirsimetri/onvif-python
 
 Basic Commands:

{onvif_python-0.1.7 → onvif_python-0.1.8}/onvif/cli/interactive.py

@@ -191,7 +191,7 @@ class InteractiveShell(cmd.Cmd):
             "  / __ \\/ | / / |  / /  _/ ____/",
             " / / / /  |/ /| | / // // /_    ",
             "/ /_/ / /|  / | |/ // // __/    ",
-            "\\____/_/ |_/  |___/___/_/  v0.1.7",
+            "\\____/_/ |_/  |___/___/_/  v0.1.8",
             "                                ",
         ]
 
@@ -1385,7 +1385,7 @@ class InteractiveShell(cmd.Cmd):
             super().do_help(line)
         else:
             help_text = f"""
-{colorize('ONVIF Interactive Shell — v0.1.7', 'cyan')}\n{colorize('https://github.com/nirsimetri/onvif-python', 'white')}
+{colorize('ONVIF Interactive Shell — v0.1.8', 'cyan')}\n{colorize('https://github.com/nirsimetri/onvif-python', 'white')}
 
 {colorize('Basic Commands:', 'yellow')}
   capabilities, caps       - Show device capabilities

{onvif_python-0.1.7 → onvif_python-0.1.8}/onvif/cli/main.py

@@ -17,7 +17,7 @@ def create_parser():
     """Create argument parser for ONVIF CLI"""
     parser = argparse.ArgumentParser(
         prog="onvif",
-        description=f"{colorize('ONVIF Terminal Client', 'yellow')} — v0.1.7\nhttps://github.com/nirsimetri/onvif-python",
+        description=f"{colorize('ONVIF Terminal Client', 'yellow')} — v0.1.8\nhttps://github.com/nirsimetri/onvif-python",
         formatter_class=argparse.RawDescriptionHelpFormatter,
         epilog=f"""
 Examples:
@@ -149,7 +149,7 @@ def main():
 
     # Show ONVIF CLI version
     if args.version:
-        print(colorize("0.1.7", "yellow"))
+        print(colorize("0.1.8", "yellow"))
         sys.exit(0)
 
     # Validate arguments early (before discovery)

{onvif_python-0.1.7 → onvif_python-0.1.8}/onvif/cli/utils.py

@@ -317,7 +317,8 @@ def get_method_documentation(service_obj, method_name: str) -> Optional[Dict[str
             doc_text = colorize("No description available.", "reset")
 
         # 2. Get parameters from Python method signature using inspect
-        method = getattr(service_obj, method_name)
+        # Use object.__getattribute__ to bypass ONVIFService wrapper and get original method
+        method = object.__getattribute__(service_obj, method_name)
         sig = inspect.signature(method)
         for param in sig.parameters.values():
             if param.name != "self":
@@ -331,7 +332,8 @@ def get_method_documentation(service_obj, method_name: str) -> Optional[Dict[str
     except (etree.ParseError, FileNotFoundError, AttributeError, ValueError):
         # Fallback in case of any error, still try to get params
         try:
-            method = getattr(service_obj, method_name)
+            # Use object.__getattribute__ to bypass ONVIFService wrapper and get original method
+            method = object.__getattribute__(service_obj, method_name)
             sig = inspect.signature(method)
             for param in sig.parameters.values():
                 if param.name != "self":

{onvif_python-0.1.7 → onvif_python-0.1.8}/onvif/client.py

@@ -1,6 +1,7 @@
 # onvif/client.py
 
 from urllib.parse import urlparse, urlunparse
+from functools import wraps
 
 from .services import (
     Device,
@@ -41,10 +42,56 @@ from .services import (
     MediaSigning,
 )
 from .operator import CacheMode
-from .utils import ONVIFWSDL, ZeepPatcher, XMLCapturePlugin
+from .utils import ONVIFWSDL, ZeepPatcher, XMLCapturePlugin, ONVIFOperationException
+
+
+def service(func):
+    """Decorator to wrap service accessor methods with ONVIFOperationException handling.
+
+    This decorator catches any exception raised during service initialization and
+    wraps it in ONVIFOperationException for consistent error handling across all
+    ONVIF client service accessors.
+
+    Args:
+        func: Service accessor method to wrap
+
+    Returns:
+        Wrapped function that handles exceptions
+
+    Raises:
+        ONVIFOperationException: If service initialization fails
+    """
+
+    @wraps(func)
+    def wrapper(self, *args, **kwargs):
+        try:
+            return func(self, *args, **kwargs)
+        except ONVIFOperationException:
+            # Re-raise ONVIFOperationException as-is to avoid double-wrapping
+            raise
+        except Exception as e:
+            # Wrap any other exception in ONVIFOperationException
+            raise ONVIFOperationException(func.__name__, e)
+
+    return wrapper
 
 
 class ONVIFClient:
+    """ONVIF Client for communicating with ONVIF-compliant devices.
+
+    This is the main class for interacting with ONVIF devices. It provides access to
+    all ONVIF services including Device Management, Media, PTZ, Events, Analytics, and more.
+
+    The client automatically discovers available services on the device using GetServices
+    or GetCapabilities, and provides lazy initialization for service endpoints.
+
+    Attributes:
+        services: List of available services from GetServices response
+        capabilities: Device capabilities from GetCapabilities response (fallback)
+        xml_plugin: XML capture plugin for debugging (if capture_xml=True)
+        wsdl_dir: Custom WSDL directory path (if provided)
+    """
+
     def __init__(
         self,
         host: str,
@@ -90,7 +137,8 @@ class ONVIFClient:
         }
 
         # Device Management (Core) service is always available
-        self._devicemgmt = Device(**self.common_args)
+        self._devicemgmt = None
+        self._devicemgmt = self.devicemgmt()
 
         # Try to retrieve device services and create namespace -> XAddr mapping
         self.services = None
@@ -280,11 +328,15 @@ class ONVIFClient:
 
     # Core (Device Management)
 
+    @service
     def devicemgmt(self):
+        if self._devicemgmt is None:
+            self._devicemgmt = Device(**self.common_args)
         return self._devicemgmt
 
     # Core (Events)
 
+    @service
     def events(self):
         if self._events is None:
             self._events = Events(
@@ -292,18 +344,16 @@ class ONVIFClient:
             )
         return self._events
 
+    @service
     def pullpoint(self, SubscriptionRef):
         xaddr = None
-        try:
-            addr_obj = SubscriptionRef["SubscriptionReference"]["Address"]
-            if isinstance(addr_obj, dict) and "_value_1" in addr_obj:
-                xaddr = addr_obj["_value_1"]
-            elif hasattr(addr_obj, "_value_1"):
-                xaddr = addr_obj._value_1
+        addr_obj = SubscriptionRef["SubscriptionReference"]["Address"]
+        if isinstance(addr_obj, dict) and "_value_1" in addr_obj:
+            xaddr = addr_obj["_value_1"]
+        elif hasattr(addr_obj, "_value_1"):
+            xaddr = addr_obj._value_1
 
-            xaddr = self._rewrite_xaddr_if_needed(xaddr)
-        except Exception:
-            pass
+        xaddr = self._rewrite_xaddr_if_needed(xaddr)
 
         if not xaddr:
             raise RuntimeError(
@@ -315,6 +365,7 @@ class ONVIFClient:
 
         return self._pullpoints[xaddr]
 
+    @service
     def notification(self):
         if self._notification is None:
             self._notification = Notification(
@@ -322,18 +373,16 @@ class ONVIFClient:
             )
         return self._notification
 
+    @service
     def subscription(self, SubscriptionRef):
         xaddr = None
-        try:
-            addr_obj = SubscriptionRef["SubscriptionReference"]["Address"]
-            if isinstance(addr_obj, dict) and "_value_1" in addr_obj:
-                xaddr = addr_obj["_value_1"]
-            elif hasattr(addr_obj, "_value_1"):
-                xaddr = addr_obj._value_1
+        addr_obj = SubscriptionRef["SubscriptionReference"]["Address"]
+        if isinstance(addr_obj, dict) and "_value_1" in addr_obj:
+            xaddr = addr_obj["_value_1"]
+        elif hasattr(addr_obj, "_value_1"):
+            xaddr = addr_obj._value_1
 
-            xaddr = self._rewrite_xaddr_if_needed(xaddr)
-        except Exception:
-            pass
+        xaddr = self._rewrite_xaddr_if_needed(xaddr)
 
         if not xaddr:
             raise RuntimeError(
@@ -347,6 +396,7 @@ class ONVIFClient:
 
     # Imaging
 
+    @service
     def imaging(self):
         if self._imaging is None:
             self._imaging = Imaging(
@@ -356,6 +406,7 @@ class ONVIFClient:
 
     # Media
 
+    @service
     def media(self):
         if self._media is None:
             self._media = Media(
@@ -363,6 +414,7 @@ class ONVIFClient:
             )
         return self._media
 
+    @service
     def media2(self):
         if self._media2 is None:
             self._media2 = Media2(
@@ -372,6 +424,7 @@ class ONVIFClient:
 
     # PTZ
 
+    @service
     def ptz(self):
         if self._ptz is None:
             self._ptz = PTZ(xaddr=self._get_xaddr("ptz", "PTZ"), **self.common_args)
@@ -379,6 +432,7 @@ class ONVIFClient:
 
     # DeviceIO
 
+    @service
     def deviceio(self):
         if self._deviceio is None:
             self._deviceio = DeviceIO(
@@ -388,6 +442,7 @@ class ONVIFClient:
 
     # Display
 
+    @service
     def display(self):
         if self._display is None:
             self._display = Display(
@@ -397,6 +452,7 @@ class ONVIFClient:
 
     # Analytics
 
+    @service
     def analytics(self):
         if self._analytics is None:
             self._analytics = Analytics(
@@ -404,6 +460,7 @@ class ONVIFClient:
             )
         return self._analytics
 
+    @service
     def ruleengine(self):
         if self._ruleengine is None:
             self._ruleengine = RuleEngine(
@@ -411,6 +468,7 @@ class ONVIFClient:
             )
         return self._ruleengine
 
+    @service
     def analyticsdevice(self):
         if self._analyticsdevice is None:
             self._analyticsdevice = AnalyticsDevice(
@@ -421,6 +479,7 @@ class ONVIFClient:
 
     # PACS
 
+    @service
     def accesscontrol(self):
         if self._accesscontrol is None:
             self._accesscontrol = AccessControl(
@@ -429,6 +488,7 @@ class ONVIFClient:
             )
         return self._accesscontrol
 
+    @service
     def doorcontrol(self):
         if self._doorcontrol is None:
             self._doorcontrol = DoorControl(
@@ -438,6 +498,7 @@ class ONVIFClient:
 
     # AccessRules
 
+    @service
     def accessrules(self):
         if self._accessrules is None:
             self._accessrules = AccessRules(
@@ -447,6 +508,7 @@ class ONVIFClient:
 
     # ActionEngine
 
+    @service
     def actionengine(self):
         if self._actionengine is None:
             self._actionengine = ActionEngine(
@@ -457,6 +519,7 @@ class ONVIFClient:
 
     # AppManagement
 
+    @service
     def appmanagement(self):
         if self._appmanagement is None:
             self._appmanagement = AppManagement(
@@ -467,6 +530,7 @@ class ONVIFClient:
 
     # AuthenticationBehavior
 
+    @service
     def authenticationbehavior(self):
         if self._authenticationbehavior is None:
             self._authenticationbehavior = AuthenticationBehavior(
@@ -479,6 +543,7 @@ class ONVIFClient:
 
     # Credential
 
+    @service
     def credential(self):
         if self._credential is None:
             self._credential = Credential(
@@ -489,6 +554,7 @@ class ONVIFClient:
 
     # Recording
 
+    @service
     def recording(self):
         if self._recording is None:
             self._recording = Recording(
@@ -499,6 +565,7 @@ class ONVIFClient:
 
     # Replay
 
+    @service
     def replay(self):
         if self._replay is None:
             self._replay = Replay(
@@ -509,6 +576,7 @@ class ONVIFClient:
 
     # Provisioning
 
+    @service
     def provisioning(self):
         if self._provisioning is None:
             self._provisioning = Provisioning(
@@ -519,6 +587,7 @@ class ONVIFClient:
 
     # Receiver
 
+    @service
     def receiver(self):
         if self._receiver is None:
             self._receiver = Receiver(
@@ -529,6 +598,7 @@ class ONVIFClient:
 
     # Schedule
 
+    @service
     def schedule(self):
         if self._schedule is None:
             self._schedule = Schedule(
@@ -537,8 +607,9 @@ class ONVIFClient:
             )
         return self._schedule
 
-    # Search
+    # Search Recording
 
+    @service
     def search(self):
         if self._search is None:
             self._search = Search(
@@ -549,6 +620,7 @@ class ONVIFClient:
 
     # Thermal
 
+    @service
     def thermal(self):
         if self._thermal is None:
             self._thermal = Thermal(
@@ -559,6 +631,7 @@ class ONVIFClient:
 
     # Uplink
 
+    @service
     def uplink(self):
         if self._uplink is None:
             self._uplink = Uplink(
@@ -569,6 +642,7 @@ class ONVIFClient:
 
     # Security - AdvancedSecurity
 
+    @service
     def security(self):
         if self._security is None:
             self._security = AdvancedSecurity(
@@ -577,30 +651,35 @@ class ONVIFClient:
             )
         return self._security
 
+    @service
     def jwt(self, xaddr):
         if self._jwt is None:
             xaddr = self._rewrite_xaddr_if_needed(xaddr)
             self._jwt = JWT(xaddr=xaddr, **self.common_args)
         return self._jwt
 
+    @service
     def keystore(self, xaddr):
         if self._keystore is None:
             xaddr = self._rewrite_xaddr_if_needed(xaddr)
             self._keystore = Keystore(xaddr=xaddr, **self.common_args)
         return self._keystore
 
+    @service
     def tlsserver(self, xaddr):
         if self._tlsserver is None:
             xaddr = self._rewrite_xaddr_if_needed(xaddr)
             self._tlsserver = TLSServer(xaddr=xaddr, **self.common_args)
         return self._tlsserver
 
+    @service
     def dot1x(self, xaddr):
         if self._dot1x is None:
             xaddr = self._rewrite_xaddr_if_needed(xaddr)
             self._dot1x = Dot1X(xaddr=xaddr, **self.common_args)
         return self._dot1x
 
+    @service
     def authorizationserver(self, xaddr):
         if self._authorizationserver is None:
             xaddr = self._rewrite_xaddr_if_needed(xaddr)
@@ -609,6 +688,7 @@ class ONVIFClient:
             )
         return self._authorizationserver
 
+    @service
     def mediasigning(self, xaddr):
         if self._mediasigning is None:
             xaddr = self._rewrite_xaddr_if_needed(xaddr)

{onvif_python-0.1.7 → onvif_python-0.1.8}/onvif/operator.py

@@ -15,6 +15,18 @@ from .utils import ONVIFOperationException, ZeepPatcher
 
 
 class CacheMode(Enum):
+    """WSDL caching strategies for ONVIF client performance optimization.
+
+    Different caching modes provide trade-offs between performance, memory usage,
+    and disk storage. Choose based on your application's requirements.
+
+    Attributes:
+        ALL: Maximum performance with both memory and disk caching
+        DB: Disk-only caching for persistent storage
+        MEM: Memory-only caching for temporary sessions
+        NONE: No caching, always fetch fresh WSDLs
+    """
+
     ALL = "all"  # CachingClient + SqliteCache →
     # (+) Fast startup (WSDL/schema cached in memory + disk), great for multi-device and long-running apps
     # (-) More complex, extra overhead on both disk and memory
@@ -37,6 +49,27 @@ class CacheMode(Enum):
 
 
 class ONVIFOperator:
+    """Low-level ONVIF service operator using Zeep SOAP client.
+
+    This class handles the actual SOAP communication with ONVIF devices. It manages
+    WSDL loading, service binding, authentication, caching, and error handling.
+
+    ONVIFOperator is typically used internally by service classes (Device, Media, PTZ, etc.)
+    and is not meant to be instantiated directly by end users. Use ONVIFClient instead.
+
+    Attributes:
+        wsdl_path (str): Path to the WSDL file
+        host (str): Device hostname or IP address
+        port (int): Device port number
+        username (str): ONVIF username
+        password (str): ONVIF password
+        timeout (int): Request timeout in seconds
+        apply_patch (bool): Whether to apply xsd:any flattening patch
+        address (str): Service endpoint URL (XAddr)
+        client: Zeep SOAP client instance
+        service: Zeep service proxy for making SOAP calls
+    """
+
     def __init__(
         self,
         wsdl_path: str,
@@ -124,6 +157,23 @@ class ONVIFOperator:
         # logging.debug(f"ONVIFOperator initialized {binding} at {self.address}")
 
     def call(self, method: str, *args, **kwargs):
+        """Call an ONVIF service operation.
+
+        This method invokes a SOAP operation on the ONVIF device service and handles
+        errors gracefully. It automatically flattens xsd:any fields in the response
+        when apply_patch is enabled.
+
+        Args:
+            method: Name of the ONVIF operation to call (e.g., "GetDeviceInformation")
+            *args: Positional arguments to pass to the operation
+            **kwargs: Keyword arguments to pass to the operation
+
+        Returns:
+            The operation result, with xsd:any fields flattened if apply_patch=True
+
+        Raises:
+            ONVIFOperationException: If the operation fails (wraps original exception)
+        """
         try:
             func = getattr(self.service, method)
         except AttributeError as e:

{onvif_python-0.1.7 → onvif_python-0.1.8}/onvif/services/accesscontrol.py

@@ -1,10 +1,10 @@
 # onvif/services/accesscontrol.py
 
 from ..operator import ONVIFOperator
-from ..utils import ONVIFWSDL
+from ..utils import ONVIFWSDL, ONVIFService
 
 
-class AccessControl:
+class AccessControl(ONVIFService):
     def __init__(self, xaddr=None, **kwargs):
         # References:
         # - ONVIF Release 2.3 (May 2013) Release Notes

{onvif_python-0.1.7 → onvif_python-0.1.8}/onvif/services/accessrules.py

@@ -1,10 +1,10 @@
 # onvif/services/accessrules.py
 
 from ..operator import ONVIFOperator
-from ..utils import ONVIFWSDL
+from ..utils import ONVIFWSDL, ONVIFService
 
 
-class AccessRules:
+class AccessRules(ONVIFService):
     def __init__(self, xaddr=None, **kwargs):
         # References:
         # - ONVIF Release 2.6 (June 2015) Release Notes