plotly-cloud 0.1.0__py3-none-any.whl

plotly_cloud/__init__.py

@@ -0,0 +1,3 @@
+"""Plotly Cloud CLI package."""
+
+__version__ = "0.1.0"

plotly_cloud/_api_types.py

@@ -0,0 +1,37 @@
+"""API type definitions for Plotly Cloud."""
+
+from typing import Any, Dict, List
+
+from typing_extensions import NotRequired, TypedDict
+
+
+class AppRequest(TypedDict):
+    pythonVersion: NotRequired[str]
+    entrypointModule: NotRequired[str]
+    name: NotRequired[str]
+    appUrl: NotRequired[str]
+    description: NotRequired[str]
+    isViewPrivate: NotRequired[str]
+    invitations: NotRequired[List[str]]
+    environmentVariables: NotRequired[List[Dict[str, Any]]]
+
+EnvironmentVariables = Dict[str, Any]
+
+class ErrorResponse(TypedDict):
+    error: NotRequired[str]
+    error_description: NotRequired[str]
+
+class App(TypedDict):
+    id: NotRequired[str]
+    author_id: NotRequired[str]
+    name: NotRequired[str]
+    description: NotRequired[str]
+    app_url: NotRequired[str]
+    is_view_private: NotRequired[bool]
+    created_with_desktop: NotRequired[bool]
+    desktop_app_version: NotRequired[str]
+    environment_variables: NotRequired[EnvironmentVariables]
+    invitations: NotRequired[List[str]]
+    status: NotRequired[str]
+    created_at: NotRequired[str]
+    last_published: NotRequired[str]

plotly_cloud/_changes.py

@@ -0,0 +1,77 @@
+import asyncio
+import hashlib
+import os
+import sys
+from concurrent.futures import ThreadPoolExecutor
+
+_builtins_modules = list(sys.builtin_module_names) + ["frozen", "builtin"]
+
+
+if hasattr(sys, "stdlib_module_names"):
+    _builtins_modules += list(sys.stdlib_module_names)  # type: ignore
+
+
+def collect_module_files(*extras):
+    collected = []
+    for mod in sys.modules.values():
+        parent = getattr(mod.__spec__, "parent", "")
+        if (
+            hasattr(mod, "__file__")
+            and mod.__file__ is not None
+            and mod.__file__.endswith(".py")
+            and parent not in _builtins_modules
+            and mod.__name__ not in _builtins_modules
+        ):
+            collected.append(mod.__file__)
+    return collected + list(extras)
+
+
+def hash_file_content(filename):
+    with open(filename, encoding="utf-8") as f:
+        content = f.read()
+        return hashlib.sha256(content.encode("utf-8"), usedforsecurity=False).hexdigest(), filename
+
+
+def stat_file_time(filename):
+    return os.stat(filename).st_mtime, filename
+
+
+async def until_change(collector, *extras, initial_hashes=None):
+    # We hash ten files at a time.
+    pool = ThreadPoolExecutor(max_workers=10)
+    loop = asyncio.get_event_loop()
+
+    changed = False
+    hashed_files = {}
+
+    async def collect():
+        collected = []
+        files = collector(*extras)
+        for f in files:
+            collected.append(loop.run_in_executor(pool, stat_file_time, f))
+
+        content = await asyncio.gather(*collected)
+        result = {}
+
+        for hashed, filename in content:
+            result[filename] = hashed
+
+        return result
+
+    if initial_hashes is None or not hashed_files:
+        hashed_files = await collect()
+
+    while not changed:
+        collected = await collect()
+
+        if len(collected) != len(hashed_files):
+            return
+
+        for co_key, co_value in collected.items():
+            if co_key not in hashed_files:
+                return
+
+            if co_value != hashed_files[co_key]:
+                return
+
+        await asyncio.sleep(1.0)

plotly_cloud/_cloud_env.py

@@ -0,0 +1,93 @@
+"""Cloud environment configuration management for Plotly Cloud CLI."""
+
+import os
+from pathlib import Path
+
+import tomli
+from rich.console import Console
+
+from .exceptions import CloudConfigError, EnvironmentError
+
+console = Console()
+
+
+class CloudConfig:
+    """Manages cloud configuration for Plotly Cloud CLI."""
+
+    def __init__(self):
+        self._config_cache = None
+
+    @property
+    def config_path(self) -> Path:
+        """Path to the cloud-env.toml configuration file."""
+        return Path(__file__).parent / "cloud-env.toml"
+
+    @property
+    def config(self) -> dict:
+        """Load and cache cloud configuration."""
+        if self._config_cache is None:
+            if not self.config_path.exists():
+                raise CloudConfigError(
+                    f"Cloud configuration not found at {self.config_path}",
+                    "Configuration file is missing from the package.",
+                )
+
+            try:
+                with open(self.config_path, "rb") as f:
+                    self._config_cache = tomli.load(f)
+            except Exception as e:
+                raise CloudConfigError("Failed to load cloud configuration", str(e)) from e
+
+        return self._config_cache
+
+    def get_oauth_client_id(self) -> str:
+        """Get OAuth client ID from configuration."""
+        # Check environment variable first (overrides config file)
+        client_id = os.getenv("PLOTLY_OAUTH_CLIENT_ID", "")
+        if client_id:
+            return client_id
+
+        try:
+            client_id = self.config.get("oauth_client_id", "")
+            if client_id:
+                return client_id
+        except CloudConfigError:
+            pass
+
+        raise EnvironmentError("OAuth client ID not configured. Set 'oauth_client_id' in cloud-env.toml.")
+
+    def get_api_base_url(self) -> str:
+        """Get API base URL from configuration."""
+        # Check environment variable first (overrides config file)
+        api_url = os.getenv("PLOTLY_API_BASE_URL", "")
+        if api_url:
+            return api_url
+
+        try:
+            api_url = self.config.get("api_base_url", "")
+            if api_url:
+                return api_url
+        except CloudConfigError:
+            pass
+
+        raise EnvironmentError("API base URL not configured. Set 'api_base_url' in cloud-env.toml.")
+
+    def validate(self) -> bool:
+        """Validate cloud configuration setup."""
+        try:
+            client_id = self.get_oauth_client_id()
+            api_url = self.get_api_base_url()
+
+            if not all([client_id, api_url]):
+                console.print("✗ Incomplete cloud configuration")
+                return False
+
+            console.print("✓ Cloud configuration is valid")
+            return True
+        except (CloudConfigError, EnvironmentError) as e:
+            console.print(f"✗ Configuration error: {e}")
+            return False
+
+
+# Global instance
+cloud_config = CloudConfig()