plotly-cloud 0.2.1__tar.gz → 0.3.0__tar.gz

{plotly_cloud-0.2.1 → plotly_cloud-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plotly-cloud
-Version: 0.2.1
+Version: 0.3.0
 Summary: Python extension for Plotly Cloud with CLI and Dash dev tools integration
 Project-URL: Repository, https://github.com/plotly/plotly-cloud-extension
 License-File: LICENSE

{plotly_cloud-0.2.1 → plotly_cloud-0.3.0}/plotly_cloud/__init__.py

@@ -1,3 +1,3 @@
 """Plotly Cloud Extension package."""
 
-__version__ = "0.2.1"
+__version__ = "0.3.0"

{plotly_cloud-0.2.1 → plotly_cloud-0.3.0}/plotly_cloud/_changes.py

@@ -7,8 +7,7 @@ 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
+_builtins_modules += list(getattr(sys, "stdlib_module_names", []))
 
 
 def collect_module_files(*extras):

{plotly_cloud-0.2.1 → plotly_cloud-0.3.0}/plotly_cloud/_commands.py

@@ -461,7 +461,7 @@ class PublishCommand(BaseCommand):
         },
         {
             "name": "--poll-status",
-            "type": lambda x: x.lower() in ("true", "1", "yes", "on"),  # type: ignore
+            "type": lambda x: x.lower() in ("true", "1", "yes", "on"),
             "default": True,
             "help": "Poll publishing status until completion (default: True)",
         },
@@ -477,6 +477,11 @@ class PublishCommand(BaseCommand):
             "default": 180,
             "help": "Polling timeout in seconds",
         },
+        {
+            "name": "--skip-size-check",
+            "action": "store_true",
+            "help": "Skip the standard 200MB project size validation (note: a hard 700MB maximum still applies)",
+        },
     ]
 
     @classmethod
@@ -584,7 +589,7 @@ class PublishCommand(BaseCommand):
             auth_task = progress.add_task("🔐 Checking authentication...", total=None)
 
             client_id = cloud_config.get_oauth_client_id()
-            oauth_client = OAuthClient(client_id)
+            oauth_client = OAuthClient(client_id, token=getattr(args, "api_key", None))
 
             # Check if authenticated, if not, perform login
             if not await oauth_client.is_authenticated():
@@ -666,7 +671,8 @@ class PublishCommand(BaseCommand):
                 try:
                     # Create deployment zip
                     package_task = progress.add_task("Creating deployment package...", total=None)
-                    zip_size = await create_deployment_zip(project_path, zip_path)
+                    skip_size_check = getattr(args, "skip_size_check", False)
+                    zip_size = await create_deployment_zip(project_path, zip_path, skip_size_check)
                     progress.update(
                         package_task, description=f"✓ Created deployment package: {zip_size / (1024 * 1024):.1f}MB"
                     )
@@ -816,15 +822,12 @@ class StatusCommand(BaseCommand):
         if not app_id:
             raise ApplicationError("No app_id found in configuration. Publish your app first using 'plotly publish'.")
 
-        # Get OAuth client for authentication
         client_id = cloud_config.get_oauth_client_id()
-        oauth_client = OAuthClient(client_id)
+        oauth_client = OAuthClient(client_id, token=getattr(args, "api_key", None))
 
-        # Check if authenticated
         if not await oauth_client.is_authenticated():
             raise ApplicationError("Not authenticated. Please run 'plotly login' first.")
 
-        # Get access token
         auth_token = await oauth_client.get_access_token()
         if not auth_token:
             raise ApplicationError("Unable to retrieve access token. Please try logging in again.")
@@ -885,15 +888,12 @@ class TeamsCommand(BaseCommand):
     @classmethod
     async def execute(cls, args: ParsedArguments) -> None:
         """Execute teams command."""
-        # Get OAuth client for authentication
         client_id = cloud_config.get_oauth_client_id()
-        oauth_client = OAuthClient(client_id)
+        oauth_client = OAuthClient(client_id, token=getattr(args, "api_key", None))
 
-        # Check if authenticated
         if not await oauth_client.is_authenticated():
             raise ApplicationError("Not authenticated. Please run 'plotly login' first.")
 
-        # Get access token
         auth_token = await oauth_client.get_access_token()
         if not auth_token:
             raise ApplicationError("Unable to retrieve access token. Please try logging in again.")
@@ -944,25 +944,26 @@ class WhoamiCommand(BaseCommand):
     @classmethod
     async def execute(cls, args: ParsedArguments) -> None:
         """Execute the whoami command."""
+        token = getattr(args, "api_key", None)
+        if token:
+            console.print("✓ Authenticated via bearer token")
+            return
+
         client_id = cloud_config.get_oauth_client_id()
         oauth_client = OAuthClient(client_id)
 
-        # Check if authenticated
         if not await oauth_client.is_authenticated():
             console.print("✗ Not logged in")
             return
 
-        # Load credentials to get user info
         credentials = await oauth_client.load_credentials()
         if not credentials:
             console.print("✗ No credentials found")
             return
 
-        # Try to refresh token to validate it
         try:
             await oauth_client.refresh_access_token()
 
-            # Extract user information from credentials
             user_info = credentials.get("user", {})
             email = user_info.get("email") or credentials.get("email")
 
@@ -972,6 +973,5 @@ class WhoamiCommand(BaseCommand):
                 console.print("✓ Logged in (no email information available)")
 
         except (TokenError, CredentialError):
-            # Token is invalid and cannot be refreshed, clear credentials
             await oauth_client.logout()
             console.print("✗ Invalid token - credentials cleared")

{plotly_cloud-0.2.1 → plotly_cloud-0.3.0}/plotly_cloud/_deploy.py

@@ -30,8 +30,9 @@ from .exceptions import (
     PlotlyCloudError,
 )
 
-# Maximum allowed zip file size (200MB)
+# Maximum allowed zip file size (200MB default, 700MB absolute max)
 MAX_ZIP_SIZE = 200 * 1024 * 1024
+ABSOLUTE_MAX_ZIP_SIZE = 700 * 1024 * 1024
 
 
 def parse_gitignore(project_path: str) -> set[str]:
@@ -111,19 +112,23 @@ def should_exclude_path(path: str, exclude_patterns: set[str]) -> bool:
     return False
 
 
-async def create_deployment_zip(project_path: str, output_path: str) -> int:
+async def create_deployment_zip(
+    project_path: str, output_path: str, skip_size_check: bool = False
+) -> int:
     """
     Create a zip file for deployment, excluding files based on .gitignore.
 
     Args:
         project_path: Path to the project directory
         output_path: Path where the zip file should be created
+        skip_size_check: If True, skip the maximum size validation
 
     Returns:
         Size of the created zip file in bytes
 
     Raises:
-        ValueError: If zip file exceeds size limit
+        FileSizeError: If zip file exceeds size limit and skip_size_check is False
+        FileSystemError: If the .gitignore file cannot be read
     """
     exclude_patterns = parse_gitignore(project_path)
     total_uncompressed_size = 0
@@ -165,7 +170,18 @@ async def create_deployment_zip(project_path: str, output_path: str) -> int:
     # Check uncompressed size only
     zip_size = os.path.getsize(output_path)
 
-    if total_uncompressed_size > MAX_ZIP_SIZE:
+    # Always enforce absolute maximum (700MB)
+    if total_uncompressed_size > ABSOLUTE_MAX_ZIP_SIZE:
+        os.remove(output_path)  # Clean up the oversized zip
+        raise FileSizeError(
+            f"This directory exceeds {ABSOLUTE_MAX_ZIP_SIZE / (1024 * 1024):.0f}MB and couldn't be published",
+            f"Total size: {total_uncompressed_size / (1024 * 1024):.1f}MB. "
+            f"Maximum allowed: {ABSOLUTE_MAX_ZIP_SIZE / (1024 * 1024):.0f}MB. "
+            "Consider excluding large files in your .gitignore.",
+        )
+
+    # Check default limit (200MB) unless skipped
+    if not skip_size_check and total_uncompressed_size > MAX_ZIP_SIZE:
         os.remove(output_path)  # Clean up the oversized zip
         raise FileSizeError(
             f"This directory exceeds {MAX_ZIP_SIZE / (1024 * 1024):.0f}MB and couldn't be published",
@@ -247,7 +263,8 @@ def _handle_error_response(response: Optional[httpx.Response], operation: str) -
 
     # Handle 403 Forbidden specifically
     if response.status_code == 403:
-        return ForbiddenError(f"Failed to {operation}: Access forbidden")
+        details = response.text.strip()[:200] if response.text else ""
+        return ForbiddenError(f"Failed to {operation}: Access forbidden", details=details)
 
     # Parse error based on content type
     content_type = response.headers.get("content-type", "").lower()

{plotly_cloud-0.2.1 → plotly_cloud-0.3.0}/plotly_cloud/_devtool_hooks.py

@@ -10,7 +10,7 @@ def install_hook():
 
     try:
         # The style only works with the position left defined.
-        dash.hooks.devtool(  # type: ignore
+        dash.hooks.devtool(
             "plotly_cloud_publish_component",
             "PlotlyCloudPublishComponent",
             {"id": "_plotly-cloud-publish"},

{plotly_cloud-0.2.1 → plotly_cloud-0.3.0}/plotly_cloud/_devtool_publish_rpc.py

@@ -226,7 +226,7 @@ class PlotlyCloudPublishRPC:
         device_code = data.get("device_code")
         status_code, response = await self.oauth_client.check_authentication_status(device_code)
         if status_code == 200:
-            await self.oauth_client._save_credentials(dict(response))
+            await self.oauth_client._save_credentials({**response})
             return {"result": {"success": True}}
         else:
             error = response.get("error", "unknown_error")

{plotly_cloud-0.2.1 → plotly_cloud-0.3.0}/plotly_cloud/_oauth.py

@@ -59,8 +59,9 @@ AuthResponse = Union[AuthTokenResponse, AuthErrorResponse]
 class OAuthClient:
     """OAuth client for WorkOS CLI Auth using device authorization flow."""
 
-    def __init__(self, client_id: str):
+    def __init__(self, client_id: str, token: Optional[str] = None):
         self.client_id = client_id
+        self.token = token
         self.credentials_path = self._get_credentials_path()
 
     def _get_credentials_path(self) -> Path:
@@ -278,11 +279,15 @@ class OAuthClient:
 
     async def is_authenticated(self) -> bool:
         """Check if user is authenticated."""
+        if self.token:
+            return True
         credentials = await self.load_credentials()
         return credentials is not None and "access_token" in credentials
 
     async def get_access_token(self) -> Optional[str]:
         """Get current access token."""
+        if self.token:
+            return self.token
         credentials = await self.load_credentials()
         if credentials:
             return credentials.get("access_token")
@@ -294,6 +299,8 @@ class OAuthClient:
         Raises:
             TokenError: If no refresh token available or refresh fails
         """
+        if self.token:
+            raise TokenError("Cannot refresh a static API key")
         credentials = await self.load_credentials()
         if not credentials or "refresh_token" not in credentials:
             raise TokenError("No refresh token available")

{plotly_cloud-0.2.1 → plotly_cloud-0.3.0}/plotly_cloud/_parser.py

@@ -1,5 +1,6 @@
 """Simple argument parser to replace argparse."""
 
+import os
 import sys
 from typing import Any, List
 
@@ -78,9 +79,10 @@ def parse_args(command_arguments: List[CommandArgument], args_index=3) -> Parsed
 
         result[key] = arg_spec.get("default")
 
-    # Add global verbose flag and help flag
+    # Add global flags
     result["verbose"] = False
     result["help"] = False
+    result["api_key"] = os.getenv("PLOTLY_API_KEY", None)
 
     # Check if the first argument is "help" and handle it specially
     if len(args) > 0 and args[0] == "help":
@@ -103,6 +105,14 @@ def parse_args(command_arguments: List[CommandArgument], args_index=3) -> Parsed
             i += 1
             continue
 
+        if arg == "--api-key":
+            if i + 1 < len(args):
+                result["api_key"] = args[i + 1]
+                i += 2
+            else:
+                i += 1
+            continue
+
         # Check if this is an optional argument
         if arg.startswith("-"):
             # Find matching optional argument specification

{plotly_cloud-0.2.1 → plotly_cloud-0.3.0}/plotly_cloud/cli.py

@@ -110,6 +110,10 @@ def print_main_help(show_banner=True) -> None:
 
     # Show global options
     global_options = [
+        {
+            "name": "--api-key",
+            "help": "API key for authentication (overrides OAuth, or set PLOTLY_API_KEY env var)",
+        },
         {
             "name": "--verbose, -v",
             "help": "Enable verbose output with detailed error information",
@@ -196,6 +200,10 @@ def print_command_help(command_class: BaseCommand, group: str, command: str) ->
 
     # Show global options
     global_options = [
+        {
+            "name": "--api-key",
+            "help": "API key for authentication (overrides OAuth, or set PLOTLY_API_KEY env var)",
+        },
         {
             "name": "--verbose, -v",
             "help": "Enable verbose output with detailed error information",

{plotly_cloud-0.2.1 → plotly_cloud-0.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "plotly-cloud"
-version = "0.2.1"
+version = "0.3.0"
 description = "Python extension for Plotly Cloud with CLI and Dash dev tools integration"
 readme = "README.md"
 requires-python = ">=3.9"