onvif-python 0.0.8__tar.gz → 0.1.0__tar.gz

{onvif_python-0.0.8/onvif_python.egg-info → onvif_python-0.1.0}/PKG-INFO

@@ -1,14 +1,11 @@
 Metadata-Version: 2.4
 Name: onvif-python
-Version: 0.0.8
+Version: 0.1.0
 Summary: A comprehensive and developer-friendly Python library for working with ONVIF-compliant devices
 Author-email: Nirsimetri Technologies® <open@nirsimetri.com>
 Maintainer: Kaburagi
 License-Expression: MIT
-Project-URL: Homepage, https://github.com/nirsimetri/onvif-python
-Project-URL: Issues, https://github.com/nirsimetri/onvif-python/issues
 Project-URL: Documentation, https://deepwiki.com/nirsimetri/onvif-python
-Project-URL: Repository, https://github.com/nirsimetri/onvif-python.git
 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
@@ -43,9 +40,9 @@ Dynamic: license-file
 
 [![License](https://img.shields.io/badge/License-MIT-blue)](https://github.com/nirsimetri/onvif-python?tab=MIT-1-ov-file)
 [![DeepWiki](https://img.shields.io/badge/DeepWiki-AI%20Wiki-orange)](https://deepwiki.com/nirsimetri/onvif-python)
-[![Release](https://img.shields.io/badge/Release-v0.0.8-red?logo=archive)](https://github.com/nirsimetri/onvif-python/releases)
+[![Release](https://img.shields.io/badge/Release-v0.1.0-red?logo=archive)](https://github.com/nirsimetri/onvif-python/releases)
 <br>
-[![PyPI](https://img.shields.io/badge/PyPI-0.0.8-yellow?logo=archive)](https://pypi.org/project/onvif-python/)
+[![PyPI](https://img.shields.io/badge/PyPI-0.1.0-yellow?logo=archive)](https://pypi.org/project/onvif-python/)
 [![Downloads](https://img.shields.io/pypi/dm/onvif-python?label=PyPI%20Downloads)](https://clickpy.clickhouse.com/dashboard/onvif-python)
 
 **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.  
@@ -96,7 +93,14 @@ Create an instance of `ONVIFClient` by providing your device's IP address, port,
 ```python
 from onvif import ONVIFClient
 
+# Basic connection
 client = ONVIFClient("192.168.1.17", 8000, "admin", "admin123")
+
+# With custom WSDL directory (optional)
+client = ONVIFClient(
+    "192.168.1.17", 8000, "admin", "admin123",
+    wsdl_dir="/path/to/custom/wsdl"  # Use custom WSDL files in this path
+)
 ```
 
 **2. Create Service Instance**
@@ -189,8 +193,9 @@ The `ONVIFClient` class provides various configuration options to customize the
 
 | Parameter | Type | Required | Default | Description |
 |-----------|------|----------|---------|-------------|
-| `apply_patch` | `bool` | ❌ No | `True` | Enable zeep patching for better `xsd:any` field parsing and automatic flattening |
-| `capture_xml` | `bool` | ❌ No | `False` | Enable XML capture plugin for debugging SOAP requests/responses |
+| `apply_patch` | `bool` | ❌ No | `True` | Enable zeep patching for better `xsd:any` field parsing and automatic flattening, applied at (>= [`v0.0.4`](https://github.com/nirsimetri/onvif-python/releases/tag/v0.0.4)) |
+| `capture_xml` | `bool` | ❌ No | `False` | Enable XML capture plugin for debugging SOAP requests/responses, applied at (>= [`v0.0.6`](https://github.com/nirsimetri/onvif-python/releases/tag/v0.0.6)) |
+| `wsdl_dir`    | `str`  | ❌ No | `None` | Custom WSDL directory path for using external WSDL files instead of built-in ones (e.g., `/path/to/custom/wsdl`), applied at (>= [`v0.1.0`](https://github.com/nirsimetri/onvif-python/releases/tag/v0.1.0)) |
 
 </details>
 
@@ -320,6 +325,33 @@ if client.xml_plugin:
 > - `save_to_file(request_file, response_file)` - Save XML to files
 > - `clear_history()` - Clear captured history
 
+**Custom WSDL Directory:**
+```python
+from onvif import ONVIFClient
+
+# Use custom WSDL files instead of built-in ones
+client = ONVIFClient(
+    "192.168.1.17", 
+    80, 
+    "admin", 
+    "password",
+    wsdl_dir="/path/to/custom/wsdl"  # Custom WSDL directory
+)
+
+# All services will automatically use custom WSDL files
+device = client.devicemgmt()
+media = client.media()
+ptz = client.ptz()
+
+# The custom WSDL directory should have a flat structure:
+# /path/to/custom/wsdl/
+# ├── devicemgmt.wsdl
+# ├── media.wsdl
+# ├── ptz.wsdl
+# ├── imaging.wsdl
+# └── ... (other WSDL files)
+```
+
 </details>
 
 <details>
@@ -339,7 +371,8 @@ client = ONVIFClient(
     use_https=True,             # Secure communication
     verify_ssl=True,            # Verify certificates (default)
     apply_patch=True,           # Enhanced parsing (default)
-    capture_xml=False           # Disable debug mode (default)
+    capture_xml=False,          # Disable debug mode (default)
+    wsdl_dir=None               # Use built-in WSDL files (default)
 )
 ```
 </details>
@@ -349,12 +382,13 @@ client = ONVIFClient(
 - **Authentication:** This library uses **WS-UsernameToken with Digest** authentication by default, which is the standard for ONVIF devices.
 - **Patching:** The `apply_patch=True` (default) enables custom zeep patching that improves `xsd:any` field parsing. This is recommended for better compatibility with ONVIF responses.
 - **XML Capture:** Only use `capture_xml=True` during development/debugging as it increases memory usage and may expose sensitive data in logs.
+- **Custom WSDL:** Use `wsdl_dir` parameter to specify a custom directory containing WSDL files. The directory should have a flat structure with WSDL files directly in the root (e.g., `/path/to/custom/wsdl/devicemgmt.wsdl`, `/path/to/custom/wsdl/media.wsdl`, etc.).
 - **Cache Location:** Disk cache (when using `CacheMode.DB` or `CacheMode.ALL`) is stored in `~/.onvif-python/onvif_zeep_cache.sqlite`.
 
 ## Service Discovery: Understanding Device Capabilities
 
 > [!WARNING]
-> Before performing any operations on an ONVIF device, it is highly recommended to discover which services are available and supported by the device. This library automatically uses `GetServices` during initialization to discover service endpoints, but you can also query services manually for detailed information including capabilities.
+> Before performing any operations on an ONVIF device, it is highly recommended to discover which services are available and supported by the device. This library automatically performs comprehensive service discovery during initialization using a robust fallback mechanism.
 
 **Why discover device services?**
 
@@ -365,50 +399,84 @@ client = ONVIFClient(
 
 **How service discovery works in this library:**
 
-The `ONVIFClient` automatically calls `GetServices` during initialization to build a service map. This map is used internally to resolve service endpoints:
+The `ONVIFClient` uses a **3-tier discovery approach** to maximize device compatibility:
+
+1. **GetServices (Preferred)** - Tries `GetServices` first for detailed service information
+2. **GetCapabilities (Fallback)** - Falls back to `GetCapabilities` if `GetServices` is not supported
+3. **Default URLs (Final Fallback)** - Uses standard ONVIF URLs as last resort
 
 ```python
 from onvif import ONVIFClient
 
 client = ONVIFClient("192.168.1.17", 8000, "admin", "admin123")
 
-# Access the discovered services
-print(client.services)
-# Example output: [{'Namespace': 'http://www.onvif.org/ver10/device/wsdl', 'XAddr': '...', 'Version': {...}}, ...]
-
-# Check the service map (namespace -> XAddr mapping)
-print(client._service_map)
-# Example output: {'http://www.onvif.org/ver10/media/wsdl': 'http://192.168.1.17:8000/onvif/Media', ...}
+# Check what discovery method was used
+if client.services:
+    print("Service discovery: GetServices (preferred)")
+    print("Discovered services:", len(client.services))
+    print("Service map:", client._service_map)
+elif client.capabilities:
+    print("Service discovery: GetCapabilities (fallback)")
+    print("Available capabilities:", client.capabilities)
+else:
+    print("Service discovery: Using default URLs")
 ```
 
-**Get detailed service information with capabilities:**
+**Why this approach?**
 
-If you need detailed capability information for each service, call `GetServices` with `IncludeCapability=True`:
+- **GetServices** provides the most accurate and detailed service information, but it's **optional** in the ONVIF specification
+- **GetCapabilities** is **mandatory** for all ONVIF-compliant devices, ensuring broader compatibility
+- **Default URLs** guarantee basic connectivity even with non-compliant devices
+
+**Get detailed service information:**
+
+If you need comprehensive service details, you can manually call `GetServices` with capabilities:
 
 ```python
 device = client.devicemgmt()
-services = device.GetServices(IncludeCapability=True)
-
-for service in services:
-    print(f"Service: {service.Namespace}")
-    print(f"Endpoint: {service.XAddr}")
-    print(f"Version: {service.Version.Major}.{service.Version.Minor}")
-    if hasattr(service, 'Capabilities') and service.Capabilities:
-        print(f"Capabilities: {service.Capabilities}")
+
+try:
+    # Try to get detailed service information
+    services = device.GetServices(IncludeCapability=True)
+    for service in services:
+        print(f"Service: {service.Namespace}")
+        print(f"XAddr: {service.XAddr}")
+        if hasattr(service, 'Capabilities'):
+            print(f"Capabilities: {service.Capabilities}")
+except Exception:
+    # Fallback to GetCapabilities for legacy devices
+    capabilities = device.GetCapabilities()
+    print("Capabilities:", capabilities)
 ```
 
-**Alternative: Use GetCapabilities for legacy compatibility:**
+**Access capabilities information:**
 
-For backward compatibility or when you need a quick overview of major service categories, you can still use `GetCapabilities`:
+When using `GetCapabilities` fallback, you can access capability information:
 
 ```python
-capabilities = client.devicemgmt().GetCapabilities()
-print(capabilities)
-# Example output: {'Media': {'XAddr': '...', ...}, 'PTZ': {...}, 'Events': {...}, ...}
+device = client.devicemgmt()
+
+try:
+    # Get capabilities information from device
+    capabilities = device.GetCapabilities()
+    
+    # Main services (always available)
+    print("Media XAddr:", getattr(capabilities.Media, 'XAddr', 'Not available'))
+    print("PTZ XAddr:", getattr(capabilities.PTZ, 'XAddr', 'Not available'))
+    
+    # Extension services (device-dependent)
+    ext = getattr(capabilities, 'Extension', None)
+    if ext:
+        print("DeviceIO XAddr:", getattr(ext.DeviceIO, 'XAddr', 'Not available'))
+        print("Recording XAddr:", getattr(ext.Recording, 'XAddr', 'Not available'))
+        print("Search XAddr:", getattr(ext.Search, 'XAddr', 'Not available'))
+        print("Replay XAddr:", getattr(ext.Replay, 'XAddr', 'Not available'))
+except Exception as e:
+    print(f"Error getting capabilities: {e}")
 ```
 
 > [!TIP]
-> The library handles service discovery automatically, so you typically don't need to call `GetServices` manually unless you need detailed capability information or want to refresh the service list after device configuration changes.
+> The library handles service discovery automatically with intelligent fallback. You typically don't need to call discovery methods manually unless you need detailed capability information or want to refresh the service list after device configuration changes.
 
 ## Tested Devices
 
@@ -561,10 +629,10 @@ Some ONVIF services have multiple bindings in the same WSDL. These typically inc
 
 ## Future Improvements (Stay tuned and star ⭐ this repo)
 
-- [x] Add debugging mode with raw xml on SOAP requests and responses. ([c258162](https://github.com/nirsimetri/onvif-python/commit/c258162))
-- [ ] Add functionality for `ONVIFClient` to accept a custom `wsdl_path` service.
-- [ ] Add asynchronous (async/await) support for non-blocking ONVIF operations and concurrent device communication.
+- [x] ~~Add debugging mode with raw xml on SOAP requests and responses.~~ ([c258162](https://github.com/nirsimetri/onvif-python/commit/c258162))
+- [x] ~~Add functionality for `ONVIFClient` to accept a custom `wsdl_dir` service.~~ ([65f2570](https://github.com/nirsimetri/onvif-python/commit/65f257092e4c9daa23dd0d00825ed38a45d23b70))
 - [ ] Add `ONVIF CLI` program to interact directly with ONVIF devices via terminal.
+- [ ] Add asynchronous (async/await) support for non-blocking ONVIF operations and concurrent device communication.
 - [ ] Implement structured data models for ONVIF Schemas using [xsdata](https://github.com/tefra/xsdata).
 - [ ] Integrate [xmltodict](https://github.com/martinblech/xmltodict) for simplified XML parsing and conversion.
 - [ ] Enhance documentation with API references and diagrams (not from [AI Wiki](https://deepwiki.com/nirsimetri/onvif-python)).

{onvif_python-0.0.8 → onvif_python-0.1.0}/README.md

@@ -2,9 +2,9 @@
 
 [![License](https://img.shields.io/badge/License-MIT-blue)](https://github.com/nirsimetri/onvif-python?tab=MIT-1-ov-file)
 [![DeepWiki](https://img.shields.io/badge/DeepWiki-AI%20Wiki-orange)](https://deepwiki.com/nirsimetri/onvif-python)
-[![Release](https://img.shields.io/badge/Release-v0.0.8-red?logo=archive)](https://github.com/nirsimetri/onvif-python/releases)
+[![Release](https://img.shields.io/badge/Release-v0.1.0-red?logo=archive)](https://github.com/nirsimetri/onvif-python/releases)
 <br>
-[![PyPI](https://img.shields.io/badge/PyPI-0.0.8-yellow?logo=archive)](https://pypi.org/project/onvif-python/)
+[![PyPI](https://img.shields.io/badge/PyPI-0.1.0-yellow?logo=archive)](https://pypi.org/project/onvif-python/)
 [![Downloads](https://img.shields.io/pypi/dm/onvif-python?label=PyPI%20Downloads)](https://clickpy.clickhouse.com/dashboard/onvif-python)
 
 **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.  
@@ -55,7 +55,14 @@ Create an instance of `ONVIFClient` by providing your device's IP address, port,
 ```python
 from onvif import ONVIFClient
 
+# Basic connection
 client = ONVIFClient("192.168.1.17", 8000, "admin", "admin123")
+
+# With custom WSDL directory (optional)
+client = ONVIFClient(
+    "192.168.1.17", 8000, "admin", "admin123",
+    wsdl_dir="/path/to/custom/wsdl"  # Use custom WSDL files in this path
+)
 ```
 
 **2. Create Service Instance**
@@ -148,8 +155,9 @@ The `ONVIFClient` class provides various configuration options to customize the
 
 | Parameter | Type | Required | Default | Description |
 |-----------|------|----------|---------|-------------|
-| `apply_patch` | `bool` | ❌ No | `True` | Enable zeep patching for better `xsd:any` field parsing and automatic flattening |
-| `capture_xml` | `bool` | ❌ No | `False` | Enable XML capture plugin for debugging SOAP requests/responses |
+| `apply_patch` | `bool` | ❌ No | `True` | Enable zeep patching for better `xsd:any` field parsing and automatic flattening, applied at (>= [`v0.0.4`](https://github.com/nirsimetri/onvif-python/releases/tag/v0.0.4)) |
+| `capture_xml` | `bool` | ❌ No | `False` | Enable XML capture plugin for debugging SOAP requests/responses, applied at (>= [`v0.0.6`](https://github.com/nirsimetri/onvif-python/releases/tag/v0.0.6)) |
+| `wsdl_dir`    | `str`  | ❌ No | `None` | Custom WSDL directory path for using external WSDL files instead of built-in ones (e.g., `/path/to/custom/wsdl`), applied at (>= [`v0.1.0`](https://github.com/nirsimetri/onvif-python/releases/tag/v0.1.0)) |
 
 </details>
 
@@ -279,6 +287,33 @@ if client.xml_plugin:
 > - `save_to_file(request_file, response_file)` - Save XML to files
 > - `clear_history()` - Clear captured history
 
+**Custom WSDL Directory:**
+```python
+from onvif import ONVIFClient
+
+# Use custom WSDL files instead of built-in ones
+client = ONVIFClient(
+    "192.168.1.17", 
+    80, 
+    "admin", 
+    "password",
+    wsdl_dir="/path/to/custom/wsdl"  # Custom WSDL directory
+)
+
+# All services will automatically use custom WSDL files
+device = client.devicemgmt()
+media = client.media()
+ptz = client.ptz()
+
+# The custom WSDL directory should have a flat structure:
+# /path/to/custom/wsdl/
+# ├── devicemgmt.wsdl
+# ├── media.wsdl
+# ├── ptz.wsdl
+# ├── imaging.wsdl
+# └── ... (other WSDL files)
+```
+
 </details>
 
 <details>
@@ -298,7 +333,8 @@ client = ONVIFClient(
     use_https=True,             # Secure communication
     verify_ssl=True,            # Verify certificates (default)
     apply_patch=True,           # Enhanced parsing (default)
-    capture_xml=False           # Disable debug mode (default)
+    capture_xml=False,          # Disable debug mode (default)
+    wsdl_dir=None               # Use built-in WSDL files (default)
 )
 ```
 </details>
@@ -308,12 +344,13 @@ client = ONVIFClient(
 - **Authentication:** This library uses **WS-UsernameToken with Digest** authentication by default, which is the standard for ONVIF devices.
 - **Patching:** The `apply_patch=True` (default) enables custom zeep patching that improves `xsd:any` field parsing. This is recommended for better compatibility with ONVIF responses.
 - **XML Capture:** Only use `capture_xml=True` during development/debugging as it increases memory usage and may expose sensitive data in logs.
+- **Custom WSDL:** Use `wsdl_dir` parameter to specify a custom directory containing WSDL files. The directory should have a flat structure with WSDL files directly in the root (e.g., `/path/to/custom/wsdl/devicemgmt.wsdl`, `/path/to/custom/wsdl/media.wsdl`, etc.).
 - **Cache Location:** Disk cache (when using `CacheMode.DB` or `CacheMode.ALL`) is stored in `~/.onvif-python/onvif_zeep_cache.sqlite`.
 
 ## Service Discovery: Understanding Device Capabilities
 
 > [!WARNING]
-> Before performing any operations on an ONVIF device, it is highly recommended to discover which services are available and supported by the device. This library automatically uses `GetServices` during initialization to discover service endpoints, but you can also query services manually for detailed information including capabilities.
+> Before performing any operations on an ONVIF device, it is highly recommended to discover which services are available and supported by the device. This library automatically performs comprehensive service discovery during initialization using a robust fallback mechanism.
 
 **Why discover device services?**
 
@@ -324,50 +361,84 @@ client = ONVIFClient(
 
 **How service discovery works in this library:**
 
-The `ONVIFClient` automatically calls `GetServices` during initialization to build a service map. This map is used internally to resolve service endpoints:
+The `ONVIFClient` uses a **3-tier discovery approach** to maximize device compatibility:
+
+1. **GetServices (Preferred)** - Tries `GetServices` first for detailed service information
+2. **GetCapabilities (Fallback)** - Falls back to `GetCapabilities` if `GetServices` is not supported
+3. **Default URLs (Final Fallback)** - Uses standard ONVIF URLs as last resort
 
 ```python
 from onvif import ONVIFClient
 
 client = ONVIFClient("192.168.1.17", 8000, "admin", "admin123")
 
-# Access the discovered services
-print(client.services)
-# Example output: [{'Namespace': 'http://www.onvif.org/ver10/device/wsdl', 'XAddr': '...', 'Version': {...}}, ...]
-
-# Check the service map (namespace -> XAddr mapping)
-print(client._service_map)
-# Example output: {'http://www.onvif.org/ver10/media/wsdl': 'http://192.168.1.17:8000/onvif/Media', ...}
+# Check what discovery method was used
+if client.services:
+    print("Service discovery: GetServices (preferred)")
+    print("Discovered services:", len(client.services))
+    print("Service map:", client._service_map)
+elif client.capabilities:
+    print("Service discovery: GetCapabilities (fallback)")
+    print("Available capabilities:", client.capabilities)
+else:
+    print("Service discovery: Using default URLs")
 ```
 
-**Get detailed service information with capabilities:**
+**Why this approach?**
 
-If you need detailed capability information for each service, call `GetServices` with `IncludeCapability=True`:
+- **GetServices** provides the most accurate and detailed service information, but it's **optional** in the ONVIF specification
+- **GetCapabilities** is **mandatory** for all ONVIF-compliant devices, ensuring broader compatibility
+- **Default URLs** guarantee basic connectivity even with non-compliant devices
+
+**Get detailed service information:**
+
+If you need comprehensive service details, you can manually call `GetServices` with capabilities:
 
 ```python
 device = client.devicemgmt()
-services = device.GetServices(IncludeCapability=True)
-
-for service in services:
-    print(f"Service: {service.Namespace}")
-    print(f"Endpoint: {service.XAddr}")
-    print(f"Version: {service.Version.Major}.{service.Version.Minor}")
-    if hasattr(service, 'Capabilities') and service.Capabilities:
-        print(f"Capabilities: {service.Capabilities}")
+
+try:
+    # Try to get detailed service information
+    services = device.GetServices(IncludeCapability=True)
+    for service in services:
+        print(f"Service: {service.Namespace}")
+        print(f"XAddr: {service.XAddr}")
+        if hasattr(service, 'Capabilities'):
+            print(f"Capabilities: {service.Capabilities}")
+except Exception:
+    # Fallback to GetCapabilities for legacy devices
+    capabilities = device.GetCapabilities()
+    print("Capabilities:", capabilities)
 ```
 
-**Alternative: Use GetCapabilities for legacy compatibility:**
+**Access capabilities information:**
 
-For backward compatibility or when you need a quick overview of major service categories, you can still use `GetCapabilities`:
+When using `GetCapabilities` fallback, you can access capability information:
 
 ```python
-capabilities = client.devicemgmt().GetCapabilities()
-print(capabilities)
-# Example output: {'Media': {'XAddr': '...', ...}, 'PTZ': {...}, 'Events': {...}, ...}
+device = client.devicemgmt()
+
+try:
+    # Get capabilities information from device
+    capabilities = device.GetCapabilities()
+    
+    # Main services (always available)
+    print("Media XAddr:", getattr(capabilities.Media, 'XAddr', 'Not available'))
+    print("PTZ XAddr:", getattr(capabilities.PTZ, 'XAddr', 'Not available'))
+    
+    # Extension services (device-dependent)
+    ext = getattr(capabilities, 'Extension', None)
+    if ext:
+        print("DeviceIO XAddr:", getattr(ext.DeviceIO, 'XAddr', 'Not available'))
+        print("Recording XAddr:", getattr(ext.Recording, 'XAddr', 'Not available'))
+        print("Search XAddr:", getattr(ext.Search, 'XAddr', 'Not available'))
+        print("Replay XAddr:", getattr(ext.Replay, 'XAddr', 'Not available'))
+except Exception as e:
+    print(f"Error getting capabilities: {e}")
 ```
 
 > [!TIP]
-> The library handles service discovery automatically, so you typically don't need to call `GetServices` manually unless you need detailed capability information or want to refresh the service list after device configuration changes.
+> The library handles service discovery automatically with intelligent fallback. You typically don't need to call discovery methods manually unless you need detailed capability information or want to refresh the service list after device configuration changes.
 
 ## Tested Devices
 
@@ -520,10 +591,10 @@ Some ONVIF services have multiple bindings in the same WSDL. These typically inc
 
 ## Future Improvements (Stay tuned and star ⭐ this repo)
 
-- [x] Add debugging mode with raw xml on SOAP requests and responses. ([c258162](https://github.com/nirsimetri/onvif-python/commit/c258162))
-- [ ] Add functionality for `ONVIFClient` to accept a custom `wsdl_path` service.
-- [ ] Add asynchronous (async/await) support for non-blocking ONVIF operations and concurrent device communication.
+- [x] ~~Add debugging mode with raw xml on SOAP requests and responses.~~ ([c258162](https://github.com/nirsimetri/onvif-python/commit/c258162))
+- [x] ~~Add functionality for `ONVIFClient` to accept a custom `wsdl_dir` service.~~ ([65f2570](https://github.com/nirsimetri/onvif-python/commit/65f257092e4c9daa23dd0d00825ed38a45d23b70))
 - [ ] Add `ONVIF CLI` program to interact directly with ONVIF devices via terminal.
+- [ ] Add asynchronous (async/await) support for non-blocking ONVIF operations and concurrent device communication.
 - [ ] Implement structured data models for ONVIF Schemas using [xsdata](https://github.com/tefra/xsdata).
 - [ ] Integrate [xmltodict](https://github.com/martinblech/xmltodict) for simplified XML parsing and conversion.
 - [ ] Enhance documentation with API references and diagrams (not from [AI Wiki](https://deepwiki.com/nirsimetri/onvif-python)).