icmd-python 1.5.7__py3-none-any.whl → 1.6.5__py3-none-any.whl

icmd/__init__.py

@@ -1,5 +1,17 @@
 """Python client app for ICMD® API."""
 
-from .core import ICMD
+from .core import (
+    ICMD,
+    ICMDAuthenticationError,
+    ICMDConnectionError,
+    ICMDRequestError,
+    ICMDValidationError,
+)
 
-__all__ = ["ICMD"]
+__all__ = [
+    "ICMD",
+    "ICMDAuthenticationError",
+    "ICMDConnectionError",
+    "ICMDRequestError",
+    "ICMDValidationError",
+]

icmd/core/__init__.py

@@ -1,12 +1,29 @@
 """Core ICMD client modules."""
 
-from .client import ICMD, ICMDAuthenticationError, ICMDConnectionError, ICMDValidationError
+from . import urls
+from .apps import Design, Fatigue, Resource, Workspace
+from .client import (
+    ICMD,
+    ICMDAuthenticationError,
+    ICMDConnectionError,
+    ICMDRequestError,
+    ICMDValidationError,
+)
 from .credentials import CredentialManager
+from .display import display_designs, display_jobs
 
 __all__ = [
     "ICMD",
     "CredentialManager",
+    "Design",
+    "Fatigue",
     "ICMDAuthenticationError",
     "ICMDConnectionError",
+    "ICMDRequestError",
     "ICMDValidationError",
+    "Resource",
+    "Workspace",
+    "display_designs",
+    "display_jobs",
+    "urls",
 ]

icmd/core/apps.py

@@ -0,0 +1,168 @@
+"""Composition-based resource access for ICMD API.
+
+Provides a clean nested-attribute API::
+
+    icmd = ICMD("icmd.questek.com")
+    icmd.design.job.list(page=1, page_size=10)
+    icmd.workspace.dataset.get("uuid-123")
+"""
+
+from __future__ import annotations
+
+from functools import partial
+from typing import TYPE_CHECKING, Any
+
+from . import urls
+
+if TYPE_CHECKING:
+    from collections.abc import Callable
+
+    from .client import ICMD
+
+
+class Resource:
+    """Generic API resource with list/get/add operations.
+
+    Parameters
+    ----------
+    client : ICMD
+        The ICMD client instance.
+    list_url : Callable[[], str]
+        Callable that returns the list endpoint.
+    item_url : Callable[[str], str] | None
+        Callable that accepts a UUID and returns the detail endpoint.
+        If None, 'get()' raises 'NotImplementedError'.
+    """
+
+    def __init__(
+        self,
+        client: ICMD,
+        list_url: Callable[[], str],
+        item_url: Callable[[str], str] | None = None,
+    ) -> None:
+        self._client = client
+        self._list_url = list_url
+        self._item_url = item_url
+
+    def list(self, **params: Any) -> dict | list[dict]:
+        """List resources, forwarding query parameters."""
+        return self._client._request_json("get", self._list_url(), params=params or None)
+
+    def get(self, uuid: str) -> dict | list[dict]:
+        """Get a single resource by UUID."""
+        if self._item_url is None:
+            raise NotImplementedError("This resource does not support get()")
+        return self._client._request_json("get", self._item_url(uuid))
+
+    def add(self, data: Any) -> dict | list[dict]:
+        """Create a new resource."""
+        return self._client._request_json("post", self._list_url(), json=data)
+
+
+class ReadOnlyResource:
+    """Resource that only supports get-by-UUID (e.g. results).
+
+    Parameters
+    ----------
+    client : ICMD
+        The ICMD client instance.
+    item_url : Callable[[str], str]
+        Callable that accepts a UUID and returns the detail endpoint.
+    """
+
+    def __init__(self, client: ICMD, item_url: Callable[[str], str]) -> None:
+        self._client = client
+        self._item_url = item_url
+
+    def get(self, uuid: str) -> dict | list[dict]:
+        """Get a single resource by UUID."""
+        return self._client._request_json("get", self._item_url(uuid))
+
+
+class DesignResource(Resource):
+    """Resource for toolkit designs — auto-attaches 'owner_group' on add().
+
+    Parameters
+    ----------
+    client : ICMD
+        The ICMD client instance.
+    list_url : Callable[[], str]
+        Callable that returns the list endpoint.
+    item_url : Callable[[str], str] | None
+        Callable that accepts a UUID and returns the detail endpoint.
+    """
+
+    def add(
+        self,
+        data: dict | None = None,
+        design_name: str | None = None,
+        share_with_group: bool = True,
+    ) -> dict | list[dict]:
+        """Create a new design, auto-attaching owner_group.
+
+        Parameters
+        ----------
+        data : dict | None
+            Payload for the design. If None, an empty dict is used.
+        design_name : str | None
+            Optional name for the design (sets 'name' key).
+        share_with_group : bool
+            Whether to share with the owner group (default True).
+        """
+        payload: dict[str, Any] = dict(data) if data else {}
+        payload["owner_group"] = self._client.owner_group
+        if design_name is not None:
+            payload["name"] = design_name
+        payload["share_with_group"] = share_with_group
+        return self._client._request_json("post", self._list_url(), json=payload)
+
+
+class _ToolkitApp:
+    """Private base for toolkit apps (Design, Fatigue).
+
+    Sets up 'job', 'design', 'model', and 'result' sub-resources
+    for the given toolkit name.
+    """
+
+    def __init__(self, client: ICMD, toolkit: str) -> None:
+        self.job = Resource(
+            client,
+            partial(urls.jobs, toolkit=toolkit),
+            partial(urls.job, toolkit=toolkit),
+        )
+        self.design = DesignResource(
+            client,
+            partial(urls.designs, toolkit=toolkit),
+            partial(urls.design, toolkit=toolkit),
+        )
+        self.model = Resource(
+            client,
+            partial(urls.models, toolkit=toolkit),
+            item_url=None,
+        )
+        self.result = ReadOnlyResource(
+            client,
+            partial(urls.results, toolkit=toolkit),
+        )
+
+
+class Design(_ToolkitApp):
+    """Design Alloy toolkit resources."""
+
+    def __init__(self, client: ICMD) -> None:
+        super().__init__(client, "design")
+
+
+class Fatigue(_ToolkitApp):
+    """Fatigue Simulation toolkit resources."""
+
+    def __init__(self, client: ICMD) -> None:
+        super().__init__(client, "fatigue")
+
+
+class Workspace:
+    """Workspace resources (datasets, ML models)."""
+
+    def __init__(self, client: ICMD) -> None:
+        self.dataset = Resource(client, urls.datasets, urls.dataset)
+        self.ml_model = Resource(client, urls.ml_models, urls.ml_model)

icmd/core/client.py

@@ -5,7 +5,8 @@ import webbrowser
 from datetime import UTC, datetime, timedelta
 from getpass import getpass
 from http import HTTPStatus
-from typing import TYPE_CHECKING, Any, ClassVar
+from typing import TYPE_CHECKING, Any, ClassVar, Literal
+from urllib.parse import quote
 
 if TYPE_CHECKING:
     from pathlib import Path
@@ -13,6 +14,8 @@ if TYPE_CHECKING:
 import requests
 from requests.adapters import HTTPAdapter
 
+from .apps import Design, Fatigue, Workspace
+from .constants import GROUPS
 from .credentials import CredentialManager
 from .slim_packages import ensure_slim_packages
 
@@ -29,6 +32,26 @@ class ICMDValidationError(Exception):
     """Raised when input validation fails."""
 
 
+class ICMDRequestError(Exception):
+    """Raised when an API request fails.
+
+    Attributes
+    ----------
+        status_code: HTTP status code from the failed request.
+        response_text: Raw response body text for debugging.
+    """
+
+    def __init__(
+        self,
+        message: str,
+        status_code: int | None = None,
+        response_text: str | None = None,
+    ):
+        self.status_code = status_code
+        self.response_text = response_text
+        super().__init__(message)
+
+
 class ICMD:
     """ICMD client - supports multiple domains per process."""
 
@@ -108,6 +131,11 @@ class ICMD:
         self._server_config_cache = None
 
         self._credentials = CredentialManager()
+        self._owner_group: int | None = None
+
+        self.design: Design = Design(self)
+        self.fatigue: Fatigue = Fatigue(self)
+        self.workspace: Workspace = Workspace(self)
 
         # Clear cached credentials if requested
         if clear_cache:
@@ -117,7 +145,9 @@ class ICMD:
         if developer_token:
             self._session.headers["Authorization"] = f"Bearer {developer_token}"
             self._developer_token = developer_token
-            # Skip all auth flows for developer tokens
+            # Don't fail ICMD initialization if slim package management fails
+            with contextlib.suppress(Exception):
+                ensure_slim_packages(self)
             return
 
         self._developer_token = None
@@ -613,11 +643,8 @@ class ICMD:
 
                 except KeyboardInterrupt:
                     # Default to first provider on Ctrl+C
-                    print(
-                        f"\nDefaulting to {
-                            saml_providers[0].get('name', saml_providers[0]['id'])
-                        }..."
-                    )
+                    provider_name = saml_providers[0].get("name", saml_providers[0]["id"])
+                    print(f"\nDefaulting to {provider_name}...")
                     return saml_providers[0]
 
         except EOFError:
@@ -631,8 +658,6 @@ class ICMD:
     def _saml_authentication(self) -> None:
         """Authenticate with Django SAML SSO."""
         try:
-            from urllib.parse import quote
-
             # Get SAML provider configuration
             provider = self._get_saml_provider()
 
@@ -783,6 +808,27 @@ class ICMD:
         """DELETE request."""
         return self.request("DELETE", endpoint, **kwargs)
 
+    def upload(self, endpoint: str, data: Any = None, **kwargs) -> requests.Response:
+        """Upload data to an endpoint.
+
+        Alias for post() - provides more intuitive naming for data submission.
+
+        Parameters
+        ----------
+        endpoint : str
+            API endpoint to upload to.
+        data : Any
+            Data to upload (will be JSON serialized).
+        **kwargs : Any
+            Additional arguments passed to the request method.
+
+        Returns
+        -------
+        requests.Response
+            Response from the API.
+        """
+        return self.post(endpoint, data, **kwargs)
+
     def logout(self, clear_saved_credentials: bool = False) -> None:
         """Logout and clear session.
 
@@ -811,3 +857,153 @@ class ICMD:
             self._credentials.clear_refresh_token(self.domain)
 
         print("Logged out successfully.")
+
+    # -------------------------------------------------------------------------
+    # High-level API helper methods
+    # -------------------------------------------------------------------------
+
+    @staticmethod
+    def _check_response(resp: requests.Response, operation: str | None = None) -> None:
+        """Determine if there was an error obtaining response and if so raise exception.
+
+        Parameters
+        ----------
+        resp : Response
+            The response object to check.
+        operation : str | None
+            Description of the operation being performed, for error context.
+        """
+        if not (HTTPStatus.OK <= resp.status_code < HTTPStatus.MULTIPLE_CHOICES):
+            if operation:
+                message = f"Failed to {operation}: status {resp.status_code}. Message: {resp.text}"
+            else:
+                message = f"Request failed with status: {resp.status_code}. Message: {resp.text}"
+            raise ICMDRequestError(
+                message,
+                status_code=resp.status_code,
+                response_text=resp.text,
+            )
+
+    def _request_json(
+        self,
+        method: Literal["get", "post", "put", "delete"],
+        endpoint: str,
+        operation: str | None = None,
+        **kwargs: Any,
+    ) -> dict | list[dict]:
+        """Make a request and return the JSON response.
+
+        Parameters
+        ----------
+        method : Literal["get", "post", "post", "delete"]
+            HTTP method ('get', 'post', 'put', 'delete').
+        endpoint : str
+            API endpoint.
+        operation : str | None
+            Description of the operation being performed, for error context.
+        **kwargs : Any
+            Additional arguments passed to the request method.
+
+        Returns
+        -------
+        dict | list[dict]
+            Parsed JSON response as a dict or list of dicts.
+
+        Raises
+        ------
+        ICMDRequestError
+            If the request fails.
+        """
+        resp = self.request(method.upper(), endpoint, **kwargs)
+        self._check_response(resp, operation)
+        return resp.json()
+
+    def _get_owner_group_id(self, group_name: str | None = None) -> int:
+        """Return the group ID of a specific user group.
+
+        Parameters
+        ----------
+        group_name : str | None
+            Name of the group for which to obtain the ID.
+            If not specified, retrieves the ID of the first group listed in the user account.
+
+        Returns
+        -------
+        int
+            The group ID.
+
+        Raises
+        ------
+        ICMDRequestError
+            If no groups are found for the user or group data is malformed.
+        ValueError
+            If group_name is specified but no group with that name exists.
+        """
+        groups = self._request_json("get", GROUPS, operation="fetch owner group")
+        if not isinstance(groups, list) or not groups:
+            raise ICMDRequestError("No groups found for user")
+        if not isinstance(groups[0], dict) or "id" not in groups[0]:
+            raise ICMDRequestError("Group data missing 'id' field")
+        if group_name is not None:
+            groups_with_group_name = [group for group in groups if group["name"] == group_name]
+            if len(groups_with_group_name) == 0:
+                raise ValueError(f"No group found with name '{group_name}'") from None
+            return groups_with_group_name[0]["id"]
+        return groups[0]["id"]
+
+    def set_owner_group(self, group_name: str | None = None) -> None:
+        """Set the owner group for subsequent API operations.
+
+        Parameters
+        ----------
+        group_name : str | None
+            Name of the owner group. If not specified, uses the first group
+            listed in the user account.
+
+        Raises
+        ------
+        ICMDRequestError
+            If no groups are found for the user or group data is malformed.
+        ValueError
+            If group_name is specified but no group with that name exists.
+        """
+        self._owner_group = self._get_owner_group_id(group_name)
+
+    def get_owner_group_names(self) -> list[str]:
+        """Get all available owner group names for the current user.
+
+        Returns
+        -------
+        list[str]
+            List of group names available to the user.
+
+        Raises
+        ------
+        ICMDRequestError
+            If no groups are found for the user or group data is malformed.
+        """
+        groups = self._request_json("get", GROUPS, operation="fetch owner groups")
+        if not isinstance(groups, list) or not groups:
+            raise ICMDRequestError("No groups found for user")
+        return [group["name"] for group in groups]
+
+    @property
+    def owner_group(self) -> int:
+        """Return the owner group ID of the current user.
+
+        The owner group is fetched lazily on first access and cached
+        for subsequent calls.
+
+        Returns
+        -------
+        int
+            The owner group ID.
+
+        Raises
+        ------
+        ICMDRequestError
+            If fetching the owner group fails.
+        """
+        if self._owner_group is None:
+            self._owner_group = self._get_owner_group_id()
+        return self._owner_group

icmd/core/constants.py

@@ -0,0 +1,12 @@
+"""API endpoint constants for ICMD client."""
+
+# API endpoint constants
+MACHINE_LEARNING_MODELS: str = "workspace/mlmodels"
+DATASETS: str = "workspace/dataset"
+DESIGN_TOOLKIT: str = "design_alloy"
+FATIGUE_TOOLKIT: str = "simulation_fatigue"
+GROUPS: str = "account/groups"
+QT_MODEL: str = "qt_model"
+JOB: str = "job"
+RESULTS: str = "results"
+DESIGN: str = "design"

icmd/core/display.py

@@ -0,0 +1,143 @@
+"""Display utilities for ICMD data.
+
+This module provides interactive display functions for designs and jobs.
+
+Example usage:
+    from icmd import ICMD
+    from icmd.core.display import display_designs, display_jobs
+
+    client = ICMD("icmd.questek.com")
+    display_designs(client, toolkit="design")
+    display_jobs(client, toolkit="fatigue")
+"""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Literal
+
+from . import urls
+from .pagination import handle_pagination_input, print_pagination_info, print_table
+
+if TYPE_CHECKING:
+    from .client import ICMD
+
+
+def display_designs(
+    client: ICMD,
+    toolkit: Literal["design", "fatigue"] = "design",
+    page_number: int = 1,
+    page_size: int = 10,
+    interactive: bool = True,
+) -> None:
+    """Display designs in a paginated table.
+
+    Parameters
+    ----------
+    client : ICMD
+        Authenticated ICMD client instance.
+    toolkit : Literal["design", "fatigue"]
+        Toolkit from which to display designs. Default is "design".
+    page_number : int
+        Starting page number. Default is 1.
+    page_size : int
+        Number of designs per page. Default is 10.
+    interactive : bool
+        If True, allows navigation between pages. Default is True.
+    """
+    current_page = page_number
+    total_items = client.get(urls.designs(toolkit)).json()["count"]
+    total_pages = (total_items + page_size - 1) // page_size
+    toolkit_name = urls._toolkit(toolkit).replace("_", " ").title()
+
+    while True:
+        response = client.get(
+            urls.designs(toolkit),
+            params={"page": int(current_page), "page_size": int(page_size)},
+        ).json()
+        designs = response["data"]
+
+        rows = [
+            [
+                d.get("uuid", "N/A"),
+                d.get("name", "Unnamed"),
+                d.get("last_updated", "N/A")[:19] if d.get("last_updated") else "N/A",
+                str(d.get("jobs_count", "N/A")),
+            ]
+            for d in designs
+        ]
+        print_table(
+            ["UUID", "Name", "Last Updated", "Number of Jobs"],
+            rows,
+            [36, 30, 20, 15],
+            toolkit_name,
+            "designs",
+        )
+        print_pagination_info(current_page, page_size, total_items)
+
+        if not interactive:
+            break
+
+        current_page = handle_pagination_input(current_page, total_pages)
+        if current_page is None:
+            break
+
+
+def display_jobs(
+    client: ICMD,
+    toolkit: Literal["design", "fatigue"] = "design",
+    page_number: int = 1,
+    page_size: int = 10,
+    interactive: bool = True,
+) -> None:
+    """Display jobs in a paginated table.
+
+    Parameters
+    ----------
+    client : ICMD
+        Authenticated ICMD client instance.
+    toolkit : Literal["design", "fatigue"]
+        Toolkit from which to display jobs. Default is "design".
+    page_number : int
+        Starting page number. Default is 1.
+    page_size : int
+        Number of jobs per page. Default is 10.
+    interactive : bool
+        If True, allows navigation between pages. Default is True.
+    """
+    current_page = page_number
+    total_items = client.get(urls.jobs(toolkit)).json()["count"]
+    total_pages = (total_items + page_size - 1) // page_size
+    toolkit_name = urls._toolkit(toolkit).replace("_", " ").title()
+
+    while True:
+        response = client.get(
+            urls.jobs(toolkit),
+            params={"page": int(current_page), "page_size": int(page_size)},
+        ).json()
+        jobs = response["data"]
+
+        rows = [
+            [
+                j.get("uuid", "N/A"),
+                j.get("design_name", j.get("design", {}).get("name", "N/A"))[:30],
+                j.get("job_status", "N/A"),
+                j.get("created_at", "N/A")[:19] if j.get("created_at") else "N/A",
+            ]
+            for j in jobs
+        ]
+
+        print_table(
+            ["UUID", "Design", "Status", "Created"],
+            rows,
+            [36, 30, 15, 20],
+            toolkit_name,
+            "jobs",
+        )
+        print_pagination_info(current_page, page_size, total_items)
+
+        if not interactive:
+            break
+
+        current_page = handle_pagination_input(current_page, total_pages)
+        if current_page is None:
+            break

icmd/core/pagination.py

@@ -0,0 +1,91 @@
+"""Pagination helpers for ICMD client."""
+
+
+def print_table(
+    headers: list[str],
+    rows: list[list[str]],
+    col_widths: list[int],
+    toolkit_name: str,
+    list_type: str,
+) -> None:
+    """Print a formatted table to the console.
+
+    Parameters
+    ----------
+    headers : list[str]
+        Column headers.
+    rows : list[list[str]]
+        Table rows.
+    col_widths : list[int]
+        Width for each column.
+    toolkit_name : str
+        Toolkit name (e.g., "Fatigue Simulation").
+    list_type : str
+        Type of items being listed (e.g., "jobs" or "designs"
+    """
+    border_length = 80
+    print(f"\n{'=' * border_length}")
+    print(f"{list_type.title()} - {toolkit_name.title()} Toolkit")
+    print("=" * border_length)
+    header_row = " | ".join(h.ljust(w) for h, w in zip(headers, col_widths, strict=False))
+    separator = "-+-".join("-" * w for w in col_widths)
+    print(header_row)
+    print(separator)
+
+    for row in rows:
+        print(" | ".join(str(cell).ljust(w)[:w] for cell, w in zip(row, col_widths, strict=False)))
+
+
+def print_pagination_info(page_number: int, page_size: int, total_items: int) -> None:
+    """Print pagination information.
+
+    Parameters
+    ----------
+    page_number : int
+        Current page number.
+    page_size : int
+        Number of items per page.
+    total_items : int
+        Total number of items.
+    """
+    total_pages = (total_items + page_size - 1) // page_size
+    start_item = (page_number - 1) * page_size + 1
+    end_item = min(page_number * page_size, total_items)
+
+    print(
+        f"\nPage {page_number} of {total_pages} | Items {start_item}-{end_item} of {total_items}"
+    )
+    print("Navigation: [n]ext, [p]revious, [g]o to page, [q]uit")
+
+
+def handle_pagination_input(current_page: int, total_pages: int) -> int | None:
+    """Handle pagination navigation input.
+
+    Returns
+    -------
+    int | None
+        The new page number, or None to exit.
+    """
+    try:
+        choice = input("\nEnter choice: ").strip().lower()
+    except (EOFError, KeyboardInterrupt):
+        print("\nExiting...")
+        return None
+
+    if choice == "q":
+        return None
+    if choice == "n" and current_page < total_pages:
+        return current_page + 1
+    if choice == "p" and current_page > 1:
+        return current_page - 1
+    if choice == "g":
+        try:
+            target = int(input("Go to page: ").strip())
+            if 1 <= target <= total_pages:
+                return target
+            print(f"Invalid page. Please enter 1-{total_pages}.")
+        except ValueError:
+            print("Invalid input. Please enter a number.")
+    elif choice in ("n", "p"):
+        print("Already at the first/last page.")
+    return current_page

icmd/core/slim_packages.py

@@ -321,7 +321,7 @@ def _format_version_info(version_data: dict | None) -> str:
         return "unknown"
 
     parts = []
-    for repo in ["qt-models", "qt-calphad", "qt-base", "qt-optimizer"]:
+    for repo in ["qt-models", "qt-calphad", "qt-base", "qt-optimizer", "qt-designer"]:
         if repo in version_data and version_data[repo] != "unknown":
             version = version_data[repo]
             parts.append(f"{repo}@{version}")
@@ -354,7 +354,11 @@ def ensure_slim_packages(icmd_client: "ICMD") -> None:
         # Get remote version and download URL from backend (single API call)
         remote_version, download_url = get_slim_packages_info(icmd_client)
         if remote_version is None:
-            # Specific error already printed by get_slim_packages_info()
+            # Backend unavailable - print warning and try cached version
+            print(
+                "⚠ Warning: Could not check slim packages version from backend. "
+                "Using cached version if available."
+            )
             # Try to inject cached version for this server
             server_dir = QTPY_SLIM_BASE / get_server_slug(icmd_client.domain)
             if server_dir.exists():

icmd/core/urls.py

@@ -0,0 +1,111 @@
+"""URL builders for ICMD API endpoints.
+
+This module provides helper functions to construct API endpoint URLs,
+so users don't need to know the string patterns.
+
+Example usage:
+    from icmd import ICMD
+    from icmd.core import urls
+
+    client = ICMD("icmd.questek.com")
+    dataset = client.get(urls.dataset("uuid-123")).json()
+    client.upload(urls.datasets(), data=payload)
+"""
+
+from .constants import (
+    DATASETS,
+    DESIGN,
+    DESIGN_TOOLKIT,
+    FATIGUE_TOOLKIT,
+    GROUPS,
+    JOB,
+    MACHINE_LEARNING_MODELS,
+    QT_MODEL,
+    RESULTS,
+)
+
+
+def _toolkit(toolkit: str = "design") -> str:
+    """Return toolkit endpoint.
+
+    Parameters
+    ----------
+    toolkit : str
+        Either "design" for Design Alloy or "fatigue" for Fatigue Simulation.
+
+    Returns
+    -------
+    str
+        The API endpoint string for the toolkit.
+
+    Raises
+    ------
+    ValueError
+        If toolkit is not "design" or "fatigue".
+    """
+    if toolkit == "design":
+        return DESIGN_TOOLKIT
+    if toolkit == "fatigue":
+        return FATIGUE_TOOLKIT
+    raise ValueError(f"Unknown toolkit: {toolkit}. Must be 'design' or 'fatigue'.")
+
+
+# Dataset URLs
+def datasets() -> str:
+    """Return the datasets endpoint."""
+    return DATASETS
+
+
+def dataset(uuid: str) -> str:
+    """Return the endpoint for a specific dataset."""
+    return f"{DATASETS}/{uuid}"
+
+
+# Design URLs
+def designs(toolkit: str = "design") -> str:
+    """Return the designs endpoint for a toolkit."""
+    return f"{_toolkit(toolkit)}/{DESIGN}"
+
+
+def design(uuid: str, toolkit: str = "design") -> str:
+    """Return the endpoint for a specific design."""
+    return f"{_toolkit(toolkit)}/{DESIGN}/{uuid}"
+
+
+# Job URLs
+def jobs(toolkit: str = "design") -> str:
+    """Return the jobs endpoint for a toolkit."""
+    return f"{_toolkit(toolkit)}/{JOB}"
+
+
+def job(uuid: str, toolkit: str = "design") -> str:
+    """Return the endpoint for a specific job."""
+    return f"{_toolkit(toolkit)}/{JOB}/{uuid}"
+
+
+# Results URLs
+def results(uuid: str, toolkit: str = "design") -> str:
+    """Return the endpoint for specific results."""
+    return f"{_toolkit(toolkit)}/{RESULTS}/{uuid}"
+
+
+# Model URLs
+def models(toolkit: str = "design") -> str:
+    """Return the models endpoint for a toolkit."""
+    return f"{_toolkit(toolkit)}/{QT_MODEL}"
+
+
+def ml_models() -> str:
+    """Return the ML models endpoint."""
+    return MACHINE_LEARNING_MODELS
+
+
+def ml_model(uuid: str) -> str:
+    """Return the endpoint for a specific ML model."""
+    return f"{MACHINE_LEARNING_MODELS}/{uuid}"
+
+
+# Groups
+def groups() -> str:
+    """Return the groups endpoint."""
+    return GROUPS

icmd/version.py

@@ -1 +1 @@
-__version__ = "1.5.7"
+__version__ = "1.6.5"

{icmd_python-1.5.7.dist-info → icmd_python-1.6.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: icmd-python
-Version: 1.5.7
+Version: 1.6.5
 Summary: Python client app for ICMD®
 Author: QuesTek Innovations LLC
 Requires-Python: >=3.12
@@ -13,10 +13,9 @@ Requires-Dist: requests
 Requires-Dist: scipy
 Requires-Dist: xarray
 Provides-Extra: dev
-Requires-Dist: myst-nb; extra == "dev"
+Requires-Dist: pyright; extra == "dev"
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: pytest-xdist; extra == "dev"
 Requires-Dist: ruff; extra == "dev"
-Requires-Dist: sphinx; extra == "dev"
-Requires-Dist: sphinx-rtd-theme; extra == "dev"
 Requires-Dist: pre-commit; extra == "dev"
+Requires-Dist: plotly; extra == "dev"

icmd_python-1.6.5.dist-info/RECORD

@@ -0,0 +1,15 @@
+icmd/__init__.py,sha256=qRlXs1lxfZ7zwpE8OhUYFUatAt6kztvCHK8Mc8qhQIk,310
+icmd/version.py,sha256=LEtHSENWZLwKaCJasxjOIQSt5Y_OahmKZYacXCmyQtI,22
+icmd/core/__init__.py,sha256=p92vCWcT0SMFNZRrIBz57NreZyNEKTJRS-tE3QbbBvI,614
+icmd/core/apps.py,sha256=iWbK63Nv6MlyYOxIcu_HvenGI6nokzoUTCxU6xouxJk,5086
+icmd/core/client.py,sha256=Ag7Se48Z6r28hcFmhA0DtQbesn0_uWcRiZtfoAzGxxo,38460
+icmd/core/constants.py,sha256=DG8u7PKLiihCQOR_uftMmgZh5CLh3PRqVl2KF4atdoY,364
+icmd/core/credentials.py,sha256=PwLstCLl11KlusLVE7oBkU1rEgvb9u0HpWUhfapfBQY,6690
+icmd/core/display.py,sha256=F89Ihcr4mtEZJkV3_J7LkOPbF-vsTQIvJZ1vSuZOTtY,4265
+icmd/core/pagination.py,sha256=Xv9vTY02FFIGBvndQsXoz1ruhlu148vtCWWFbL_5fwI,2735
+icmd/core/slim_packages.py,sha256=MO4cMF5yGrYTfqUQnNWt16ajxneY-pzDJTejTNwC0JE,16081
+icmd/core/urls.py,sha256=-K7rsGKLOqpcVKJhQnZJJArJWEd7y_uw-vwaJyryVXc,2631
+icmd_python-1.6.5.dist-info/METADATA,sha256=GswTuSpG6uFnhvx1V6RBSlfI2pYsSshisCOiwf5QlnY,591
+icmd_python-1.6.5.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+icmd_python-1.6.5.dist-info/top_level.txt,sha256=olzM6Z_QEwg7RrFVOnkgO0I2Ps2m7vhSqYQZYeiawcw,5
+icmd_python-1.6.5.dist-info/RECORD,,

{icmd_python-1.5.7.dist-info → icmd_python-1.6.5.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.9.0)
+Generator: setuptools (82.0.1)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

icmd_python-1.5.7.dist-info/RECORD

@@ -1,10 +0,0 @@
-icmd/__init__.py,sha256=Y3zT6WXeWkIuMsLjwXs1lTjiGSj-dzLvetVSmRu_u2w,84
-icmd/version.py,sha256=oF7Y8496FUgsdoGzNFWSpl1UtgtgO43P0Tct09Fxbx0,22
-icmd/core/__init__.py,sha256=4-zYFBsm52YklOAfbd0EF6wqAQS2bCIDeRAQFJRX9Lw,305
-icmd/core/client.py,sha256=_5cQsWCraJsZoQH6-iTdnS6LwbA2cPvPb4FTQg4Sx0o,31766
-icmd/core/credentials.py,sha256=PwLstCLl11KlusLVE7oBkU1rEgvb9u0HpWUhfapfBQY,6690
-icmd/core/slim_packages.py,sha256=EdZTv8kMuqHKuHeNCbzdREkgvJZr_JnWcR1ytfbCYXU,15896
-icmd_python-1.5.7.dist-info/METADATA,sha256=jj6l1A_bJXTuz09PjZ73hjG95zoEd0HnmC1gFJE1h2Q,639
-icmd_python-1.5.7.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-icmd_python-1.5.7.dist-info/top_level.txt,sha256=olzM6Z_QEwg7RrFVOnkgO0I2Ps2m7vhSqYQZYeiawcw,5
-icmd_python-1.5.7.dist-info/RECORD,,