onvif-python 0.4.2__tar.gz → 0.4.3__tar.gz

onvif_python-0.4.2/LICENSE.md → onvif_python-0.4.3/LICENSE

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

onvif_python-0.4.3/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.

{onvif_python-0.4.2/onvif_python.egg-info → onvif_python-0.4.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: onvif-python
-Version: 0.4.2
+Version: 0.4.3
 Summary: A modern Python library for ONVIF-compliant devices
 Author-email: Nirsimetri Technologies® <open@nirsimetri.com>
 Maintainer: Kaburagi
@@ -12,15 +12,17 @@ Project-URL: Issues, https://github.com/nirsimetri/onvif-python/issues
 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: Intended Audience :: Developers
+Classifier: Intended Audience :: Information Technology
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3 :: Only
 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
-Classifier: Intended Audience :: Science/Research
 Classifier: Topic :: Software Development :: Libraries
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: Security
@@ -30,44 +32,42 @@ Classifier: Topic :: Communications
 Classifier: Topic :: Text Processing :: Markup :: XML
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
-License-File: LICENSE.md
-Requires-Dist: zeep>=4.3.0
-Requires-Dist: requests>=2.32.0
-Requires-Dist: pyreadline3>=3.5.4; sys_platform == "win32"
+License-File: LICENSE
+License-File: NOTICE
+Requires-Dist: zeep<4.4.0,>=4.3.0
+Requires-Dist: requests<3.0.0,>=2.32.0
+Requires-Dist: pyreadline3<4.0.0,>=3.5.4; sys_platform == "win32"
 Provides-Extra: dev
-Requires-Dist: pytest>=7.0; extra == "dev"
-Requires-Dist: pytest-cov; extra == "dev"
-Requires-Dist: black; extra == "dev"
-Requires-Dist: mypy; extra == "dev"
-Requires-Dist: isort; extra == "dev"
-Requires-Dist: pylint; extra == "dev"
-Requires-Dist: docformatter; extra == "dev"
+Requires-Dist: pytest<10.0,>=8.0; extra == "dev"
+Requires-Dist: pytest-cov<7.0,>=6.0; extra == "dev"
+Requires-Dist: black<27.0,>=26.0; extra == "dev"
+Requires-Dist: mypy<2.0,>=1.0; extra == "dev"
+Requires-Dist: isort<7.0,>=6.0; extra == "dev"
+Requires-Dist: pylint<4.3.0,>=4.1.2; extra == "dev"
+Requires-Dist: pylint-pytest<2.0,>=1.1; extra == "dev"
+Requires-Dist: docformatter<2.0,>=1.0; extra == "dev"
+Requires-Dist: codespell<3.0,>=2.0; extra == "dev"
 Requires-Dist: lxml-stubs; extra == "dev"
 Requires-Dist: types-setuptools; extra == "dev"
 Requires-Dist: types-requests; extra == "dev"
 Provides-Extra: docs
-Requires-Dist: mkdocs-material; extra == "docs"
-Requires-Dist: mkdocstrings[python]; extra == "docs"
-Requires-Dist: mkdocs-git-authors-plugin; extra == "docs"
+Requires-Dist: mkdocs-material<10.0.0,>=9.7.7; extra == "docs"
+Requires-Dist: mkdocstrings[python]<3.0.0,>=1.0.0; extra == "docs"
+Requires-Dist: mkdocs-git-authors-plugin<1.0.0,>=0.10.0; extra == "docs"
 Dynamic: license-file
 
-<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>
-
-<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>
+[![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)
 
-**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.  
 
@@ -112,4 +112,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.

{onvif_python-0.4.2 → onvif_python-0.4.3}/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.

onvif_python-0.4.3/onvif/cli/__init__.py

@@ -0,0 +1 @@
+"""ONVIF CLI."""

onvif_python-0.4.3/onvif/cli/interactive/__init__.py

@@ -0,0 +1,5 @@
+"""ONVIF Interactive Shell."""
+
+from onvif.cli.interactive.shell import InteractiveShell
+
+__all__ = ["InteractiveShell"]

onvif_python-0.4.3/onvif/cli/interactive/context.py

@@ -0,0 +1,55 @@
+"""ONVIF Interactive Shell context."""
+
+from dataclasses import dataclass, field
+from datetime import datetime
+from typing import Any
+
+from onvif.client import ONVIFClient
+
+
+@dataclass
+class ShellContext:  # pylint: disable=too-many-instance-attributes
+    """Store shared state for the interactive shell."""
+
+    UNSET = object()
+
+    client: ONVIFClient
+    args: object
+
+    current_service: object | None = None
+    current_service_name: str | None = None
+    stored_data: dict[str, Any] = field(
+        default_factory=dict
+    )  # For storing command results
+    stored_metadata: dict[str, dict[str, Any]] = field(
+        default_factory=dict
+    )  # For storing metadata about stored data (service, method
+
+    last_result: Any = field(default=UNSET, repr=False)
+    last_method: str | None = None
+    last_service_name: str | None = None
+    last_operation_timestamp: datetime | None = None
+
+    base_commands: list[str] = field(
+        default_factory=lambda: [
+            "capabilities",
+            "caps",
+            "services",
+            "help",
+            "exit",
+            "store",
+            "rm",
+            "show",
+            "cls",
+            "clear",
+            "info",
+            "debug",
+            "ls",
+            "cd",
+            "shortcuts",
+            "desc",
+            "type",
+        ]
+    )
+
+    device_info_text: str | None = None

onvif_python-0.4.3/onvif/cli/interactive/information.py

@@ -0,0 +1,175 @@
+"""Information commands implementation."""
+
+import cmd
+from typing import Callable
+
+from requests.exceptions import RequestException
+from zeep.exceptions import TransportError
+
+from onvif.cli.helpers.messages import INTERACTIVE_HELP, INTERACTIVE_SHORTCUTS
+from onvif.cli.utils import (
+    colorize,
+    format_capabilities_as_services,
+    format_services_list,
+)
+from onvif.utils.exceptions import ONVIFOperationException
+
+from .context import ShellContext
+
+
+class InformationCommands:
+    """Provide information commands."""
+
+    context: ShellContext
+    _handle_connection_error: Callable[..., None]
+
+    def do_help(self, arg):
+        """Show help information."""
+        if arg:
+            cmd.Cmd.do_help(self, arg)
+        else:
+            print(INTERACTIVE_HELP)
+
+    def do_shortcuts(self, _line):
+        """Show available shortcuts."""
+        print(INTERACTIVE_SHORTCUTS)
+
+    def do_info(self, _line):
+        """Show connection and device information."""
+        # Build connection and CLI options info
+        options_info = []
+
+        # Connection options
+        if hasattr(self.context.args, "https") and self.context.args.https:
+            options_info.append(f"  Use HTTPS     : {colorize('True', 'green')}")
+
+        if (
+            hasattr(self.context.args, "no_verify_ssl")
+            and self.context.args.no_verify_ssl
+        ):
+            options_info.append(f"  Verify SSL    : {colorize('False', 'red')}")
+
+        if (
+            hasattr(self.context.args, "timeout") and self.context.args.timeout != 10
+        ):  # 10 is default
+            options_info.append(
+                f"  Timeout       : {colorize(f'{self.context.args.timeout}s', 'yellow')}"
+            )
+
+        # CLI options
+        if hasattr(self.context.args, "debug") and self.context.args.debug:
+            options_info.append(f"  Debug Mode    : {colorize('True', 'green')}")
+
+        if hasattr(self.context.args, "no_patch") and self.context.args.no_patch:
+            options_info.append(f"  ZeepPatcher   : {colorize('Disabled', 'red')}")
+
+        if hasattr(self.context.args, "wsdl") and self.context.args.wsdl:
+            options_info.append(
+                f"  Custom WSDL   : {colorize(self.context.args.wsdl, 'yellow')}"
+            )
+
+        if (
+            hasattr(self.context.args, "health_check_interval")
+            and self.context.args.health_check_interval != 10
+        ):  # 10 is default
+            options_info.append(
+                f"  Health Check  : every {colorize(f'{self.context.args.health_check_interval}s', 'yellow')}"
+            )
+
+        # Format options info
+        options_display = ""
+        if options_info:
+            options_display = "\n" + "\n".join(options_info)
+
+        # Display connection and device information using stored data
+        print(
+            f"\n{colorize('[ONVIF Terminal Client]', 'yellow')}"
+            f"\n  Connected to  : "
+            f"{colorize(f'{self.context.args.host}:{self.context.args.port}', 'yellow')}"
+            f"\n  Auth Method   : "
+            f"{colorize('HTTP Digest' if self.context.args.digest else 'WS-UsernameToken', 'yellow')}"
+            f"{options_display}{self.context.device_info_text}"
+        )
+        print()  # Extra newline for spacing
+
+    def do_capabilities(self, _line):
+        """Show device capabilities in service format."""
+        try:
+            if (
+                hasattr(self.context.client, "capabilities")
+                and self.context.client.capabilities
+            ):
+                result = self.context.client.capabilities
+            else:
+                result = self.context.client.devicemgmt().GetCapabilities(
+                    Category="All"
+                )
+
+            self.context.stored_data["capabilities"] = result
+            self.context.stored_metadata["capabilities"] = {
+                "service": "devicemgmt",
+                "method": "GetCapabilities",
+            }
+
+            # Use special formatting for capabilities
+            output = format_capabilities_as_services(result)
+            print(output)
+        except ONVIFOperationException as e:
+            if isinstance(e.original_exception, (RequestException, TransportError)):
+                self._handle_connection_error()
+            else:
+                print(f"{colorize('Error:', 'red')} {e}")
+
+    def do_caps(self, line):
+        """Show device capabilities (alias for 'capabilities')"""
+        return self.do_capabilities(line)
+
+    def do_services(self, _line):
+        """Show available ONVIF services in service format."""
+        try:
+            if (
+                hasattr(self.context.client, "services")
+                and self.context.client.services
+            ):
+                result = self.context.client.services
+            else:
+                result = self.context.client.devicemgmt().GetServices(
+                    IncludeCapability=False
+                )
+
+            self.context.stored_data["services"] = result
+            self.context.stored_metadata["services"] = {
+                "service": "devicemgmt",
+                "method": "GetServices",
+            }
+
+            # Use special formatting for services
+            output = format_services_list(result)
+            print(output)
+        except ONVIFOperationException as e:
+            if isinstance(e.original_exception, (RequestException, TransportError)):
+                self._handle_connection_error()
+            else:
+                print(f"{colorize('Error:', 'red')} {e}")
+
+    def do_debug(self, _line):
+        """Show debug information."""
+        if self.context.client.xml_plugin:
+            if self.context.last_method and self.context.last_operation_timestamp:
+                print(f"{colorize('Last Operation:', 'cyan')}")
+                print(
+                    f"  operation: {self.context.last_service_name}.{self.context.last_method}()"
+                )
+                print(
+                    f"  timestamp: {self.context.last_operation_timestamp.strftime('%Y-%m-%d %H:%M:%S')}\n"
+                )
+
+            print(f"{colorize('Last SOAP Request:', 'cyan')}")
+            print(self.context.client.xml_plugin.last_sent_xml or "None")
+            print(f"\n{colorize('Last SOAP Response:', 'cyan')}")
+            print(self.context.client.xml_plugin.last_received_xml or "None")
+        else:
+            print(f"{colorize('Debug mode not enabled', 'yellow')}")
+            print(
+                f"Start CLI with {colorize('--debug', 'white')} flag to enable XML capture"
+            )

onvif_python-0.4.3/onvif/cli/interactive/navigation.py

@@ -0,0 +1,185 @@
+"""Navigation commands implementation."""
+
+import traceback
+from typing import Callable
+
+from onvif.cli.utils import (
+    colorize,
+    get_device_available_services,
+    get_service_methods,
+    get_service_required_args,
+    parse_json_params,
+)
+
+from .context import ShellContext
+
+
+class NavigationCommands:
+    """Provide navigation commands."""
+
+    context: ShellContext
+    _display_grid: Callable[..., None]
+    update_prompt: Callable[[], None]
+
+    def do_ls(self, _line):
+        """List available commands/services like TAB completion."""
+        if self.context.current_service:
+            # In service mode - show available methods
+            methods = get_service_methods(self.context.current_service)
+            # Add helper commands in service mode
+            methods.extend([colorize("type", "yellow"), colorize("desc", "yellow")])
+            if methods:
+                # Use the same display format as TAB completion
+                self._display_grid(methods)
+            else:
+                print("No methods available")
+        else:
+            # In root mode - show device-specific services and commands
+            services = get_device_available_services(self.context.client)
+            commands = self.context.base_commands
+            all_items = services + commands
+
+            if all_items:
+                # Use the same display format as TAB completion
+                self._display_grid(all_items)
+            else:
+                print("No commands available")
+
+    def do_cd(self, line):
+        """Change to service directory (alias for entering service)"""
+        if not line:
+            print("Usage: cd <service_name>")
+            available_services = get_device_available_services(self.context.client)
+            colored_services = [colorize(svc, "cyan") for svc in available_services]
+            print(f"Available services: {', '.join(colored_services)}")
+            return None
+        return self.do_enter_service(line)
+
+    def complete_cd(self, text, _line, _begidx, _endidx):
+        """Autocomplete service names for cd command."""
+        services = get_device_available_services(self.context.client)
+        return [s for s in services if s.lower().startswith(text.lower())]
+
+    def do_up(self, _line):
+        """Exit current service mode (go up one level)"""
+        if self.context.current_service:
+            print(
+                f"{colorize('Exited service:', 'yellow')} "
+                f"{colorize(f'{self.context.current_service_name}', 'cyan')}"
+            )
+            self.context.current_service = None
+            self.context.current_service_name = None
+            self.update_prompt()
+        else:
+            print("Not in service mode")
+
+    # pylint: disable=too-many-locals,too-many-branches,too-many-statements
+    def do_enter_service(self, line):
+        """Enter service mode with optional arguments for services that require them."""
+        # Parse service name and arguments
+        parts = line.split(None, 1)
+        service_name = parts[0] if parts else ""
+        args_str = parts[1] if len(parts) > 1 else ""
+
+        available_services = get_device_available_services(self.context.client)
+        if service_name not in available_services:
+            print(f"{colorize('Error:', 'red')} Unknown service '{service_name}'")
+            colored_services = [colorize(svc, "cyan") for svc in available_services]
+            print(f"Available services: {', '.join(colored_services)}")
+            return
+
+        try:
+            # Check if this service requires arguments
+            required_args = get_service_required_args(service_name)
+
+            if required_args:
+                # Service requires arguments
+                if not args_str:
+                    # No arguments provided, show help
+                    print(
+                        f"{colorize('Error:', 'red')} Service '{service_name}' requires arguments"
+                    )
+                    print(
+                        f"{colorize('Usage:', 'yellow')} {service_name} "
+                        f"{' '.join([f'{arg}=<value>' for arg in required_args])}"
+                    )
+                    print(
+                        f"{colorize('Example:', 'yellow')} "
+                        f"{service_name} {required_args[0]}=$subscription"
+                    )
+                    return
+
+                # Parse arguments
+                try:
+                    parsed_args = parse_json_params(args_str)
+                except (OSError, AttributeError, ValueError, TypeError) as e:
+                    print(f"{colorize('Error parsing arguments:', 'red')} {e}")
+                    return
+
+                # Check if all required arguments are provided
+                missing_args = [arg for arg in required_args if arg not in parsed_args]
+                if missing_args:
+                    print(
+                        f"{colorize('Error:', 'red')} "
+                        f"Missing required arguments: {', '.join(missing_args)}"
+                    )
+                    print(
+                        f"{colorize('Usage:', 'yellow')} {service_name} "
+                        f"{' '.join([f'{arg}=<value>' for arg in required_args])}"
+                    )
+                    return
+
+                # Resolve stored references in arguments
+                for arg_name in required_args:
+                    arg_value = parsed_args[arg_name]
+                    if isinstance(arg_value, str) and arg_value.startswith("$"):
+                        # Resolve stored reference
+                        reference = arg_value[1:]  # Remove $ prefix
+                        resolved_value = self._resolve_stored_reference(reference)
+                        if resolved_value is None:
+                            print(
+                                f"{colorize('Error:', 'red')} "
+                                f"Could not resolve reference '{arg_value}'"
+                            )
+                            return
+                        parsed_args[arg_name] = resolved_value
+
+                # Call service method with arguments
+                service_method = getattr(self.context.client, service_name)
+                service = service_method(**parsed_args)
+            else:
+                # Service doesn't require arguments
+                service = getattr(self.context.client, service_name)()
+
+            self.context.current_service = service
+            self.context.current_service_name = service_name
+            self.update_prompt()
+
+            print(
+                f"{colorize('Entered service:', 'yellow')} {colorize(service_name, 'cyan')}"
+            )
+
+            # Show available methods
+            methods = get_service_methods(service)
+            methods_preview = ", ".join(methods[:10])
+            if len(methods) > 10:
+                print(
+                    f"{colorize('Available methods:', 'yellow')} {methods_preview} ... "
+                    f"and {colorize(f'{len(methods) - 10} more.', 'yellow')}"
+                )
+                print(
+                    f"Type {colorize('ls', 'cyan')}/press "
+                    f"<{colorize('TAB', 'yellow')}> to see all."
+                )
+            else:
+                print(f"{colorize('Available methods:', 'yellow')} {methods_preview}")
+            print(f"Type {colorize('up', 'cyan')} to exit service mode.")
+
+        except (OSError, RuntimeError, ValueError, AttributeError) as e:
+            print(f"{colorize('Error entering service:', 'red')} {e}")
+            if self.context.args.debug:
+                traceback.print_exc()
+
+    def do_exit_service(self, line):
+        """Exit current service mode (alias for 'up')"""
+        return self.do_up(line)