refactor: rename utils to device_utils and adopt camelCase public API

  refactor: rename utils to device_utils and adopt camelCase public API

  Reorganize device utility modules from `mistapi.utils` to
  `mistapi.device_utils` with a clean separation between internal
  implementations (`__tools/`) and public-facing device modules
  (ap, ex, srx, ssr). Public function names now use camelCase
  (e.g. retrieveArpTable, monitorTraffic) for consistency with the
  auto-generated REST API.

  Also adds comprehensive unit tests for api_request, api_response,
  api_session, models, pagination, logger, init, and websocket_client.

Author: tmunzer-AIDE

README.md

@@ -12,18 +12,24 @@
 
 # isort: skip_file
 from mistapi.__api_session import APISession as APISession
-from mistapi import api as api
-from mistapi import cli as cli
-from mistapi import websockets as websockets
-from mistapi import utils as utils
 from mistapi.__pagination import get_all as get_all
 from mistapi.__pagination import get_next as get_next
 from mistapi.__version import __author__ as __author__
 from mistapi.__version import __version__ as __version__
 
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from mistapi import api as api
+    from mistapi import cli as cli
+    from mistapi import device_utils as device_utils
+    from mistapi import websockets as websockets
+
 _LAZY_SUBPACKAGES = {
     "api": "mistapi.api",
     "cli": "mistapi.cli",
+    "websockets": "mistapi.websockets",
+    "device_utils": "mistapi.device_utils",
 }
 
 

src/mistapi/__init__.py

@@ -2380,7 +2380,7 @@ def getSiteDeviceZtpPassword(
 
 
 def testSiteSsrDnsResolution(
-    mist_session: _APISession, site_id: str, device_id: str
+    mist_session: _APISession, site_id: str, device_id: str, body: dict | list
 ) -> _APIResponse:
     """
     API doc: https://www.juniper.net/documentation/us/en/software/mist/api/http/api/utilities/wan/test-site-ssr-dns-resolution
@@ -2402,7 +2402,7 @@ def testSiteSsrDnsResolution(
     """
 
     uri = f"/api/v1/sites/{site_id}/devices/{device_id}/resolve_dns"
-    resp = mist_session.mist_post(uri=uri)
+    resp = mist_session.mist_post(uri=uri, body=body)
     return resp
 
 

src/mistapi/api/v1/sites/devices.py

@@ -21,9 +21,9 @@
     from mistapi.utils import ap, ex, srx, ssr
 
     # Use device-specific utilities
-    await ap.ping(session, site_id, device_id, host)
-    await ex.cable_test(session, site_id, device_id, port_id)
-    await ssr.show_service_path(session, site_id, device_id)
+    ap.ping(session, site_id, device_id, host)
+    ex.cableTest(session, site_id, device_id, port_id)
+    ssr.showServicePath(session, site_id, device_id)
 
 Supported Devices:
 - ap:  Mist Access Points
@@ -44,26 +44,11 @@
 # Device-specific modules (recommended)
 # Function-based modules (legacy, still supported)
 # Internal modules
-from mistapi.utils import (
-    __ws_wrapper,
+from mistapi.device_utils import (
     ap,
-    arp,
-    bgp,
-    bpdu,
-    dhcp,
-    dns,
-    dot1x,
     ex,
-    mac,
-    ospf,
-    policy,
-    port,
-    routes,
-    service_path,
-    sessions,
     srx,
     ssr,
-    tools,
 )
 
 __all__ = [
@@ -72,21 +57,4 @@
     "ex",
     "srx",
     "ssr",
-    # Function-based modules (legacy)
-    "arp",
-    "bgp",
-    "bpdu",
-    "dhcp",
-    "dns",
-    "dot1x",
-    "mac",
-    "ospf",
-    "policy",
-    "port",
-    "routes",
-    "service_path",
-    "sessions",
-    "tools",
-    # Internal
-    "__ws_wrapper",
 ]

src/mistapi/utils/__init__.py src/mistapi/device_utils/__init__.pysrc/mistapi/utils/__init__.py renamed to src/mistapi/device_utils/__init__.py

@@ -0,0 +1,42 @@
+"""
+--------------------------------------------------------------------------------
+------------------------- Mist API Python CLI Session --------------------------
+
+    Written by: Thomas Munzer (tmunzer@juniper.net)
+    Github    : https://github.com/tmunzer/mistapi_python
+
+    This package is licensed under the MIT License.
+
+--------------------------------------------------------------------------------
+
+Mist API Utilities
+==================
+
+This package provides utility functions for interacting with Mist devices.
+
+Device-Specific Modules (Recommended)
+--------------------------------------
+Import device-specific modules for a clean, organized API:
+
+    from mistapi.utils import ap, ex, srx, ssr
+
+    # Use device-specific utilities
+    ap.ping(session, site_id, device_id, host)
+    ex.cable_test(session, site_id, device_id, port_id)
+    ssr.show_service_path(session, site_id, device_id)
+
+Supported Devices:
+- ap:  Mist Access Points
+- ex:  Juniper EX Switches
+- srx: Juniper SRX Firewalls
+- ssr: Juniper Session Smart Routers
+
+Function-Based Modules (Legacy)
+---------------------------------
+Original organization by function type (still available):
+
+    from mistapi.utils import arp, bgp, dhcp, mac, port, routes, tools
+
+Available modules: arp, bgp, bpdu, dhcp, dns, dot1x, mac, policy, port, routes,
+                   service_path, tools
+"""