onvif-python 0.0.4__py3-none-any.whl → 0.0.6__py3-none-any.whl

onvif/__init__.py

@@ -12,6 +12,6 @@ __all__ = [
     "ONVIFWSDL",
     "ONVIFOperationException",
     "apply_patch",
-    "remove_patch", 
+    "remove_patch",
     "is_patched",
-]
+]

onvif/client.py

@@ -41,7 +41,12 @@ from .services import (
     MediaSigning,
 )
 from .operator import CacheMode
-from .utils.zeep import apply_patch as _apply_zeep_patch, remove_patch as _remove_zeep_patch
+from .utils.zeep import (
+    apply_patch as _apply_zeep_patch,
+    remove_patch as _remove_zeep_patch,
+)
+from .utils.wsdl import ONVIFWSDL
+from .utils.xml_capture import XMLCapturePlugin
 
 
 class ONVIFClient:
@@ -56,15 +61,22 @@ class ONVIFClient:
         use_https=False,
         verify_ssl=True,
         apply_patch=True,
+        capture_xml=False,
     ):
         self.apply_patch = apply_patch
-        
+
         # Apply or remove zeep patch based on user preference
         if apply_patch:
             _apply_zeep_patch()
         else:
             _remove_zeep_patch()
-        
+
+        # Initialize XML capture plugin if requested
+        self.xml_plugin = None
+        if capture_xml:
+            self.xml_plugin = XMLCapturePlugin()
+
+        # Pass to ONVIFOperator
         self.common_args = {
             "host": host,
             "port": port,
@@ -74,14 +86,22 @@ class ONVIFClient:
             "cache": cache,
             "use_https": use_https,
             "verify_ssl": verify_ssl,
-            "apply_flatten": apply_patch,  # Pass to ONVIFOperator
+            "apply_flatten": apply_patch,
+            "plugins": [self.xml_plugin] if self.xml_plugin else None,
         }
 
         # Device Management (Core) service is always available
         self._devicemgmt = Device(**self.common_args)
 
-        # Retrieve device capabilities once and reuse
-        self.capabilities = self._devicemgmt.GetCapabilities(Category="All")
+        # Retrieve device services once and create namespace -> XAddr mapping
+        self.services = self._devicemgmt.GetServices(IncludeCapability=False)
+        self._service_map = {}
+        for service in self.services:
+            namespace = getattr(service, "Namespace", None)
+            xaddr = getattr(service, "XAddr", None)
+
+            if namespace and xaddr:
+                self._service_map[namespace] = xaddr
 
         # Lazy init for other services
 
@@ -141,45 +161,48 @@ class ONVIFClient:
         self._authorizationserver = None
         self._mediasigning = None
 
-
     def _get_xaddr(self, service_name: str, service_path: str):
         """
-        Resolve XAddr from GetCapabilities. Fallback to default if not present.
-        Now supports nested Extension with _value_1 dict (after normalized parsing).
+        Resolve XAddr from GetServices based on namespace mapping.
+        Falls back to default URL if service not found.
         """
-        svc = getattr(self.capabilities, service_name, None)
-
-        # Step 1: check direct attribute (e.g. capabilities.Media)
-        if svc and hasattr(svc, "XAddr"):
-            xaddr = svc.XAddr
-        else:
-            # Step 2: try legacy Extension.service_name
-            ext = getattr(self.capabilities, "Extension", None)
-            if ext and hasattr(ext, service_name):
-                svc = getattr(ext, service_name, None)
-                xaddr = getattr(svc, "XAddr", None) if svc else None
-            else:
-                # Step 3: try new-style _value_1 dict inside Extension
-                ext_dict = getattr(ext, "_value_1", {})
-                xaddr = ext_dict.get(service_name, {}).get("XAddr") if isinstance(ext_dict, dict) else None
-
-        if xaddr:
-            parsed = urlparse(xaddr)
-            # Host/port from device
-            device_host = parsed.hostname
-            device_port = parsed.port
-            # Host/port from connection
-            connect_host = self.common_args["host"]
-            connect_port = self.common_args["port"]
-            # if host/port differ, rewrite XAddr to use connection values
-            if (device_host != connect_host) or (device_port != connect_port):
-                protocol = "https" if self.common_args["use_https"] else "http"
-                new_netloc = f"{connect_host}:{connect_port}"
-                rewritten = urlunparse((protocol, new_netloc, parsed.path, "", "", ""))
-                return rewritten
-            return xaddr
-
-        # Fallback default
+        # Get the namespace for this service from WSDL_MAP
+        try:
+            # Try to get the service definition from WSDL_MAP
+            # Most services use ver10, some use ver20
+            wsdl_def = None
+
+            # Try ver10 first, then ver20
+            if service_name in ONVIFWSDL.WSDL_MAP:
+                if "ver10" in ONVIFWSDL.WSDL_MAP[service_name]:
+                    wsdl_def = ONVIFWSDL.WSDL_MAP[service_name]["ver10"]
+                elif "ver20" in ONVIFWSDL.WSDL_MAP[service_name]:
+                    wsdl_def = ONVIFWSDL.WSDL_MAP[service_name]["ver20"]
+
+            if wsdl_def:
+                namespace = wsdl_def["namespace"]
+                xaddr = self._service_map.get(namespace)
+
+                if xaddr:
+                    # Rewrite host/port if needed
+                    parsed = urlparse(xaddr)
+                    device_host = parsed.hostname
+                    device_port = parsed.port
+                    connect_host = self.common_args["host"]
+                    connect_port = self.common_args["port"]
+
+                    if (device_host != connect_host) or (device_port != connect_port):
+                        protocol = "https" if self.common_args["use_https"] else "http"
+                        new_netloc = f"{connect_host}:{connect_port}"
+                        rewritten = urlunparse(
+                            (protocol, new_netloc, parsed.path, "", "", "")
+                        )
+                        return rewritten
+                    return xaddr
+        except Exception:
+            pass
+
+        # Fallback to default URL
         protocol = "https" if self.common_args["use_https"] else "http"
         return f"{protocol}://{self.common_args['host']}:{self.common_args['port']}/onvif/{service_path}"
 
@@ -193,7 +216,7 @@ class ONVIFClient:
     def events(self):
         if self._events is None:
             self._events = Events(
-                xaddr=self._get_xaddr("Events", "Events"), **self.common_args
+                xaddr=self._get_xaddr("events", "Events"), **self.common_args
             )
         return self._events
 
@@ -220,7 +243,7 @@ class ONVIFClient:
     def notification(self):
         if self._notification is None:
             self._notification = Notification(
-                xaddr=self._get_xaddr("Events", "Events"), **self.common_args
+                xaddr=self._get_xaddr("notification", "Events"), **self.common_args
             )
         return self._notification
 
@@ -249,7 +272,7 @@ class ONVIFClient:
     def imaging(self):
         if self._imaging is None:
             self._imaging = Imaging(
-                xaddr=self._get_xaddr("Imaging", "Imaging"), **self.common_args
+                xaddr=self._get_xaddr("imaging", "Imaging"), **self.common_args
             )
         return self._imaging
 
@@ -258,14 +281,14 @@ class ONVIFClient:
     def media(self):
         if self._media is None:
             self._media = Media(
-                xaddr=self._get_xaddr("Media", "Media"), **self.common_args
+                xaddr=self._get_xaddr("media", "Media"), **self.common_args
             )
         return self._media
 
     def media2(self):
         if self._media2 is None:
             self._media2 = Media2(
-                xaddr=self._get_xaddr("Media2", "Media2"), **self.common_args
+                xaddr=self._get_xaddr("media2", "Media2"), **self.common_args
             )
         return self._media2
 
@@ -273,7 +296,7 @@ class ONVIFClient:
 
     def ptz(self):
         if self._ptz is None:
-            self._ptz = PTZ(xaddr=self._get_xaddr("PTZ", "PTZ"), **self.common_args)
+            self._ptz = PTZ(xaddr=self._get_xaddr("ptz", "PTZ"), **self.common_args)
         return self._ptz
 
     # DeviceIO
@@ -281,7 +304,7 @@ class ONVIFClient:
     def deviceio(self):
         if self._deviceio is None:
             self._deviceio = DeviceIO(
-                xaddr=self._get_xaddr("DeviceIO", "DeviceIO"), **self.common_args
+                xaddr=self._get_xaddr("deviceio", "DeviceIO"), **self.common_args
             )
         return self._deviceio
 
@@ -290,7 +313,7 @@ class ONVIFClient:
     def display(self):
         if self._display is None:
             self._display = Display(
-                xaddr=self._get_xaddr("Display", "Display"), **self.common_args
+                xaddr=self._get_xaddr("display", "Display"), **self.common_args
             )
         return self._display
 
@@ -299,21 +322,21 @@ class ONVIFClient:
     def analytics(self):
         if self._analytics is None:
             self._analytics = Analytics(
-                xaddr=self._get_xaddr("Analytics", "Analytics"), **self.common_args
+                xaddr=self._get_xaddr("analytics", "Analytics"), **self.common_args
             )
         return self._analytics
 
     def ruleengine(self):
         if self._ruleengine is None:
             self._ruleengine = RuleEngine(
-                xaddr=self._get_xaddr("Analytics", "Analytics"), **self.common_args
+                xaddr=self._get_xaddr("ruleengine", "Analytics"), **self.common_args
             )
         return self._ruleengine
 
     def analyticsdevice(self):
         if self._analyticsdevice is None:
             self._analyticsdevice = AnalyticsDevice(
-                xaddr=self._get_xaddr("AnalyticsDevice", "AnalyticsDevice"),
+                xaddr=self._get_xaddr("analyticsdevice", "AnalyticsDevice"),
                 **self.common_args,
             )
         return self._analyticsdevice
@@ -323,7 +346,7 @@ class ONVIFClient:
     def accesscontrol(self):
         if self._accesscontrol is None:
             self._accesscontrol = AccessControl(
-                xaddr=self._get_xaddr("AccessControl", "AccessControl"),
+                xaddr=self._get_xaddr("accesscontrol", "AccessControl"),
                 **self.common_args,
             )
         return self._accesscontrol
@@ -331,7 +354,7 @@ class ONVIFClient:
     def doorcontrol(self):
         if self._doorcontrol is None:
             self._doorcontrol = DoorControl(
-                xaddr=self._get_xaddr("DoorControl", "DoorControl"), **self.common_args
+                xaddr=self._get_xaddr("doorcontrol", "DoorControl"), **self.common_args
             )
         return self._doorcontrol
 
@@ -340,7 +363,7 @@ class ONVIFClient:
     def accessrules(self):
         if self._accessrules is None:
             self._accessrules = AccessRules(
-                xaddr=self._get_xaddr("AccessRules", "AccessRules"), **self.common_args
+                xaddr=self._get_xaddr("accessrules", "AccessRules"), **self.common_args
             )
         return self._accessrules
 
@@ -349,7 +372,7 @@ class ONVIFClient:
     def actionengine(self):
         if self._actionengine is None:
             self._actionengine = ActionEngine(
-                xaddr=self._get_xaddr("ActionEngine", "ActionEngine"),
+                xaddr=self._get_xaddr("actionengine", "ActionEngine"),
                 **self.common_args,
             )
         return self._actionengine
@@ -359,7 +382,7 @@ class ONVIFClient:
     def appmanagement(self):
         if self._appmanagement is None:
             self._appmanagement = AppManagement(
-                xaddr=self._get_xaddr("AppManagement", "AppManagement"),
+                xaddr=self._get_xaddr("appmgmt", "AppManagement"),
                 **self.common_args,
             )
         return self._appmanagement
@@ -370,7 +393,7 @@ class ONVIFClient:
         if self._authenticationbehavior is None:
             self._authenticationbehavior = AuthenticationBehavior(
                 xaddr=self._get_xaddr(
-                    "AuthenticationBehavior", "AuthenticationBehavior"
+                    "authenticationbehavior", "AuthenticationBehavior"
                 ),
                 **self.common_args,
             )
@@ -381,7 +404,7 @@ class ONVIFClient:
     def credential(self):
         if self._credential is None:
             self._credential = Credential(
-                xaddr=self._get_xaddr("Credential", "Credential"),
+                xaddr=self._get_xaddr("credential", "Credential"),
                 **self.common_args,
             )
         return self._credential
@@ -391,7 +414,7 @@ class ONVIFClient:
     def recording(self):
         if self._recording is None:
             self._recording = Recording(
-                xaddr=self._get_xaddr("Recording", "Recording"),
+                xaddr=self._get_xaddr("recording", "Recording"),
                 **self.common_args,
             )
         return self._recording
@@ -401,7 +424,7 @@ class ONVIFClient:
     def replay(self):
         if self._replay is None:
             self._replay = Replay(
-                xaddr=self._get_xaddr("Replay", "Replay"),
+                xaddr=self._get_xaddr("replay", "Replay"),
                 **self.common_args,
             )
         return self._replay
@@ -411,7 +434,7 @@ class ONVIFClient:
     def provisioning(self):
         if self._provisioning is None:
             self._provisioning = Provisioning(
-                xaddr=self._get_xaddr("Provisioning", "Provisioning"),
+                xaddr=self._get_xaddr("provisioning", "Provisioning"),
                 **self.common_args,
             )
         return self._provisioning
@@ -421,7 +444,7 @@ class ONVIFClient:
     def receiver(self):
         if self._receiver is None:
             self._receiver = Receiver(
-                xaddr=self._get_xaddr("Receiver", "Receiver"),
+                xaddr=self._get_xaddr("receiver", "Receiver"),
                 **self.common_args,
             )
         return self._receiver
@@ -431,7 +454,7 @@ class ONVIFClient:
     def schedule(self):
         if self._schedule is None:
             self._schedule = Schedule(
-                xaddr=self._get_xaddr("Schedule", "Schedule"),
+                xaddr=self._get_xaddr("schedule", "Schedule"),
                 **self.common_args,
             )
         return self._schedule
@@ -441,7 +464,7 @@ class ONVIFClient:
     def search(self):
         if self._search is None:
             self._search = Search(
-                xaddr=self._get_xaddr("Search", "Search"),
+                xaddr=self._get_xaddr("search", "SearchRecording"),
                 **self.common_args,
             )
         return self._search
@@ -451,7 +474,7 @@ class ONVIFClient:
     def thermal(self):
         if self._thermal is None:
             self._thermal = Thermal(
-                xaddr=self._get_xaddr("Thermal", "Thermal"),
+                xaddr=self._get_xaddr("thermal", "Thermal"),
                 **self.common_args,
             )
         return self._thermal
@@ -461,7 +484,7 @@ class ONVIFClient:
     def uplink(self):
         if self._uplink is None:
             self._uplink = Uplink(
-                xaddr=self._get_xaddr("Uplink", "Uplink"),
+                xaddr=self._get_xaddr("uplink", "Uplink"),
                 **self.common_args,
             )
         return self._uplink
@@ -471,7 +494,7 @@ class ONVIFClient:
     def security(self):
         if self._security is None:
             self._security = AdvancedSecurity(
-                xaddr=self._get_xaddr("Security", "Security"),
+                xaddr=self._get_xaddr("advancedsecurity", "Security"),
                 **self.common_args,
             )
         return self._security

onvif/operator.py

@@ -53,6 +53,7 @@ class ONVIFOperator:
         use_https: bool = False,
         verify_ssl: bool = True,
         apply_flatten: bool = True,
+        plugins: list = None,
     ):
         self.wsdl_path = wsdl_path
         self.host = host
@@ -109,6 +110,7 @@ class ONVIFOperator:
             transport=transport,
             settings=settings,
             wsse=wsse,
+            plugins=plugins,
         )
 
         if not binding:
@@ -125,7 +127,7 @@ class ONVIFOperator:
 
         try:
             result = func(*args, **kwargs)
-            # Post-process to flatten xsd:any fields if enabled
+            # Post-process to flatten xsd:any fields if enabled (> v0.0.4 patch)
             if self.apply_flatten:
                 return flatten_xsd_any_fields(result)
             return result

onvif/services/accesscontrol.py

@@ -6,6 +6,11 @@ from ..utils import ONVIFWSDL
 
 class AccessControl:
     def __init__(self, xaddr=None, **kwargs):
+        # References:
+        # - ONVIF Release 2.3 (May 2013) Release Notes
+        # - PACSBinding (ver10/pacs/accesscontrol.wsdl)
+        # - Operations: https://developer.onvif.org/pub/specs/branches/development/wsdl/ver10/pacs/accesscontrol.wsdl
+
         definition = ONVIFWSDL.get_definition("accesscontrol")
         self.operator = ONVIFOperator(
             definition["path"],

onvif/services/accessrules.py

@@ -6,6 +6,11 @@ from ..utils import ONVIFWSDL
 
 class AccessRules:
     def __init__(self, xaddr=None, **kwargs):
+        # References:
+        # - ONVIF Release 2.6 (June 2015) Release Notes
+        # - AccessRulesBinding (ver10/accessrules/wsdl/accessrules.wsdl)
+        # - Operations: https://developer.onvif.org/pub/specs/branches/development/wsdl/ver10/accessrules/wsdl/accessrules.wsdl
+
         definition = ONVIFWSDL.get_definition("accessrules")
         self.operator = ONVIFOperator(
             definition["path"],

onvif/services/actionengine.py

@@ -6,6 +6,11 @@ from ..utils import ONVIFWSDL
 
 class ActionEngine:
     def __init__(self, xaddr=None, **kwargs):
+        # References:
+        # - ONVIF Release 2.2 (September 2012) Release Notes
+        # - ActionEngineBinding (ver10/actionengine.wsdl)
+        # - Operations: https://developer.onvif.org/pub/specs/branches/development/wsdl/ver10/actionengine.wsdl
+
         definition = ONVIFWSDL.get_definition("actionengine")
         self.operator = ONVIFOperator(
             definition["path"],

onvif/services/analytics/analytics.py

@@ -6,6 +6,11 @@ from ...utils import ONVIFWSDL
 
 class Analytics:
     def __init__(self, xaddr=None, **kwargs):
+        # References:
+        # - ONVIF Release 2.41 (December 2013) Release Notes
+        # - AnalyticsEngineBinding (ver20/analytics/wsdl/analytics.wsdl)
+        # - Operations: https://developer.onvif.org/pub/specs/branches/development/wsdl/ver20/analytics/wsdl/analytics.wsdl
+
         definition = ONVIFWSDL.get_definition("analytics", "ver20")
         self.operator = ONVIFOperator(
             definition["path"],

onvif/services/analytics/ruleengine.py

@@ -6,6 +6,11 @@ from ...utils import ONVIFWSDL
 
 class RuleEngine:
     def __init__(self, xaddr=None, **kwargs):
+        # References:
+        # - ONVIF Release 2.41 (December 2013) Release Notes
+        # - RuleEngineBinding (ver20/analytics/wsdl/analytics.wsdl)
+        # - Operations: https://developer.onvif.org/pub/specs/branches/development/wsdl/ver20/analytics/wsdl/analytics.wsdl
+
         definition = ONVIFWSDL.get_definition("ruleengine", "ver20")
         self.operator = ONVIFOperator(
             definition["path"],

onvif/services/analyticsdevice.py

@@ -15,11 +15,12 @@ class AnalyticsDevice:
         # (pre-2019) that may still expose an AnalyticsDevice XAddr.
         #
         # In modern ONVIF-compliant devices, you should prefer using the Analytics
-        # service (`onvif/services/analytics.py`). If the device does not advertise
-        # an AnalyticsDevice capability in GetCapabilities → Extension, then calling
-        # this class will result in SOAP faults.
+        # service (`onvif/services/analytics/analytics.py`). If the device does not list
+        # AnalyticsDevice in `GetServices` response, then this service is not available
+        # on the device and calling this class will result in SOAP faults.
         #
         # References:
+        # - Introduce in ONVIF Release 2.1 (June 2011) Split from Core 2.0
         # - ONVIF Release 18.12 (December 2018) Release Notes
         # - AnalyticsDeviceBinding (ver10/analyticsdevice.wsdl)
         # - Successor: Analytics Service (ver20/analytics/wsdl/analytics.wsdl)

onvif/services/appmgmt.py

@@ -6,6 +6,11 @@ from ..utils import ONVIFWSDL
 
 class AppManagement:
     def __init__(self, xaddr=None, **kwargs):
+        # References:
+        # - ONVIF Release 19.12 (December 2019) Release Notes
+        # - AppManagementBinding (ver10/appmgmt/wsdl/appmgmt.wsdl)
+        # - Operations: https://developer.onvif.org/pub/specs/branches/development/wsdl/ver10/appmgmt/wsdl/appmgmt.wsdl
+
         definition = ONVIFWSDL.get_definition("appmgmt")
         self.operator = ONVIFOperator(
             definition["path"],

onvif/services/authenticationbehavior.py

@@ -6,6 +6,11 @@ from ..utils import ONVIFWSDL
 
 class AuthenticationBehavior:
     def __init__(self, xaddr=None, **kwargs):
+        # References:
+        # - ONVIF Release 18.06 (June 2018) Release Notes
+        # - AuthenticationBehaviorBinding (ver10/authenticationbehavior/wsdl/authenticationbehavior.wsdl)
+        # - Operations: https://developer.onvif.org/pub/specs/branches/development/wsdl/ver10/authenticationbehavior/wsdl/authenticationbehavior.wsdl
+
         definition = ONVIFWSDL.get_definition("authenticationbehavior")
         self.operator = ONVIFOperator(
             definition["path"],

onvif/services/credential.py

@@ -6,6 +6,11 @@ from ..utils import ONVIFWSDL
 
 class Credential:
     def __init__(self, xaddr=None, **kwargs):
+        # References:
+        # - ONVIF Release 2.6 (June 2015) Release Notes
+        # - CredentialBinding (ver10/credential/wsdl/credential.wsdl)
+        # - Operations: https://developer.onvif.org/pub/specs/branches/development/wsdl/ver10/credential/wsdl/credential.wsdl
+
         definition = ONVIFWSDL.get_definition("credential")
         self.operator = ONVIFOperator(
             definition["path"],

onvif/services/deviceio.py

@@ -6,6 +6,11 @@ from ..utils import ONVIFWSDL
 
 class DeviceIO:
     def __init__(self, xaddr=None, **kwargs):
+        # References:
+        # - ONVIF Release 2.1 (June 2011) Split from Core 2.0
+        # - DeviceIOBinding (ver10/deviceio.wsdl)
+        # - Operations: https://developer.onvif.org/pub/specs/branches/development/wsdl/ver10/deviceio.wsdl
+
         definition = ONVIFWSDL.get_definition("deviceio")
         self.operator = ONVIFOperator(
             definition["path"],

onvif/services/devicemgmt.py

@@ -6,6 +6,11 @@ from ..utils import ONVIFWSDL
 
 class Device:
     def __init__(self, xaddr=None, **kwargs):
+        # References:
+        # - ONVIF Core
+        # - DeviceBinding (ver10/device/wsdl/devicemgmt.wsdl)
+        # - Operations: https://developer.onvif.org/pub/specs/branches/development/wsdl/ver10/device/wsdl/devicemgmt.wsdl
+
         definition = ONVIFWSDL.get_definition("devicemgmt")
         self.operator = ONVIFOperator(
             definition["path"],
@@ -25,7 +30,7 @@ class Device:
         return self.operator.call("GetDeviceInformation")
 
     def SetSystemDateAndTime(
-        self, DateTimeType, DaylightSavings=True, TimeZone=None, UTCDateTime=None
+        self, DateTimeType, DaylightSavings, TimeZone=None, UTCDateTime=None
     ):
         return self.operator.call(
             "SetSystemDateAndTime",

onvif/services/display.py

@@ -6,6 +6,11 @@ from ..utils import ONVIFWSDL
 
 class Display:
     def __init__(self, xaddr=None, **kwargs):
+        # References:
+        # - ONVIF Release 2.1 (June 2011) Split from Core 2.0
+        # - DisplayBinding (ver10/display.wsdl)
+        # - Operations: https://developer.onvif.org/pub/specs/branches/development/wsdl/ver10/display.wsdl
+
         definition = ONVIFWSDL.get_definition("display")
         self.operator = ONVIFOperator(
             definition["path"],

onvif/services/doorcontrol.py

@@ -6,6 +6,11 @@ from ..utils import ONVIFWSDL
 
 class DoorControl:
     def __init__(self, xaddr=None, **kwargs):
+        # References:
+        # - ONVIF Release 2.3 (May 2013) Release Notes
+        # - DoorControlBinding (ver10/pacs/doorcontrol.wsdl)
+        # - Operations: https://developer.onvif.org/pub/specs/branches/development/wsdl/ver10/pacs/doorcontrol.wsdl
+
         definition = ONVIFWSDL.get_definition("doorcontrol")
         self.operator = ONVIFOperator(
             definition["path"],

onvif/services/events/events.py

@@ -6,6 +6,11 @@ from ...utils import ONVIFWSDL
 
 class Events:
     def __init__(self, xaddr=None, **kwargs):
+        # References:
+        # - ONVIF Core
+        # - EventBinding (ver10/events/wsdl/event-vs.wsdl)
+        # - Operations: https://developer.onvif.org/pub/specs/branches/development/wsdl/ver10/events/wsdl/event.wsdl
+
         definition = ONVIFWSDL.get_definition("events")
         self.operator = ONVIFOperator(
             definition["path"],

onvif/services/events/notification.py

@@ -6,6 +6,10 @@ from ...utils import ONVIFWSDL
 
 class Notification:
     def __init__(self, xaddr=None, **kwargs):
+        # References:
+        # - NotificationProducerBinding (ver10/events/wsdl/event-vs.wsdl)
+        # - Operations: https://developer.onvif.org/pub/specs/branches/development/wsdl/ver10/events/wsdl/event.wsdl
+
         definition = ONVIFWSDL.get_definition("notification")
         self.operator = ONVIFOperator(
             definition["path"],

onvif/services/events/pullpoint.py

@@ -6,6 +6,10 @@ from ...utils import ONVIFWSDL
 
 class PullPoint:
     def __init__(self, xaddr=None, **kwargs):
+        # References:
+        # - PullPointSubscriptionBinding (ver10/events/wsdl/event-vs.wsdl)
+        # - Operations: https://developer.onvif.org/pub/specs/branches/development/wsdl/ver10/events/wsdl/event.wsdl
+
         definition = ONVIFWSDL.get_definition("pullpoint")
         self.operator = ONVIFOperator(
             definition["path"],

onvif/services/events/subscription.py

@@ -6,6 +6,10 @@ from ...utils import ONVIFWSDL
 
 class Subscription:
     def __init__(self, xaddr=None, **kwargs):
+        # References:
+        # - SubscriptionManagerBinding (ver10/events/wsdl/event-vs.wsdl)
+        # - Operations: https://developer.onvif.org/pub/specs/branches/development/wsdl/ver10/events/wsdl/event.wsdl
+
         definition = ONVIFWSDL.get_definition("subscription")
         self.operator = ONVIFOperator(
             definition["path"],