plotly-cloud 0.2.0__py3-none-any.whl → 0.3.0__py3-none-any.whl

plotly_cloud/__init__.py

@@ -1,3 +1,3 @@
 """Plotly Cloud Extension package."""
 
-__version__ = "0.2.0"
+__version__ = "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/_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/_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
@@ -135,9 +140,7 @@ async def create_deployment_zip(project_path: str, output_path: str) -> int:
             dirs[:] = [
                 d
                 for d in dirs
-                if not should_exclude_path(
-                    str(os.path.relpath(os.path.join(root, d), project_path)), exclude_patterns
-                )
+                if not should_exclude_path(str(os.path.relpath(os.path.join(root, d), project_path)), exclude_patterns)
             ]
 
             for file in files:
@@ -167,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",
@@ -249,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/_devtool_hooks.py

@@ -1,41 +1,16 @@
-import asyncio
-
 import dash
 import flask
-from packaging.version import parse as _parse_version
 
 from plotly_cloud._devtool_publish_rpc import PlotlyCloudPublishRPC
-
-dash_version = _parse_version(dash.__version__)
-
-
-def _run_sync(coro):
-    """Run an async coroutine synchronously, handling event loop correctly for Python 3.10+."""
-    try:
-        # Check if there's already a running loop
-        loop = asyncio.get_running_loop()
-    except RuntimeError:
-        # No running loop, try to get or create one
-        loop = asyncio.get_event_loop()
-        if loop is None or loop.is_closed():
-            loop = asyncio.new_event_loop()
-            asyncio.set_event_loop(loop)
-
-    return loop.run_until_complete(coro)
+from plotly_cloud._run_sync import run_sync
 
 
 def install_hook():
-    import nest_asyncio
-
-    # Make asyncio stuff runs smoothly.
-    # Prevent no loop and existing loop errors.
-    nest_asyncio.apply()
-
     rpc = PlotlyCloudPublishRPC()
 
     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"},
@@ -59,7 +34,7 @@ def install_hook():
     @dash.hooks.route("_plotly_cloud_publish", methods=["POST"])
     def plotly_cloud_publish_rpc():
         data = flask.request.get_json()
-        data = _run_sync(rpc.handle_operation(data))
+        data = run_sync(rpc.handle_operation(data))
         return flask.jsonify(data)
 
     @dash.hooks.setup()

plotly_cloud/_devtool_publish_rpc.py

@@ -4,6 +4,7 @@ import asyncio
 import importlib
 import os
 import tempfile
+import traceback
 from typing import Any
 
 import dash
@@ -167,6 +168,7 @@ class PlotlyCloudPublishRPC:
             method = getattr(self, operation_name)
             return await method(data)
         except Exception as e:
+            traceback.print_exc()
             return {"error": str(e)}
 
     async def initialize(self, data: Any) -> RPCResponse:
@@ -224,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/_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/_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/_run_sync.py

@@ -0,0 +1,34 @@
+# Background event loop for async operations
+import asyncio
+import threading
+
+_loop: asyncio.AbstractEventLoop = None  # type: ignore
+_loop_thread: threading.Thread = None  # type: ignore
+
+
+def _get_event_loop():
+    """Get or create a background event loop running in a separate thread."""
+    global _loop, _loop_thread
+
+    if _loop is None or _loop.is_closed():
+        _loop = asyncio.new_event_loop()
+
+        def run_loop():
+            asyncio.set_event_loop(_loop)
+            _loop.run_forever()
+
+        _loop_thread = threading.Thread(target=run_loop, daemon=True)
+        _loop_thread.start()
+
+    return _loop
+
+
+def run_sync(coro):
+    """Run an async coroutine synchronously using a background event loop.
+
+    This avoids issues with nested event loops and ensures proper task context
+    for Python 3.14+ where anyio requires asyncio.current_task() to return a valid task.
+    """
+    loop = _get_event_loop()
+    future = asyncio.run_coroutine_threadsafe(coro, loop)
+    return future.result()

plotly_cloud/cli.py

@@ -7,7 +7,6 @@ import textwrap
 from collections.abc import Sequence
 from typing import Union
 
-import nest_asyncio
 from rich.console import Console
 from rich.panel import Panel
 
@@ -111,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",
@@ -197,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",
@@ -216,8 +223,6 @@ def print_command_help(command_class: BaseCommand, group: str, command: str) ->
 
 def main() -> None:
     """Main CLI entry point."""
-    # Allow to run multiple calls to asyncio run.
-    nest_asyncio.apply()
 
     # Parse group and command
     group, command, args_index = parse_group_and_command()

{plotly_cloud-0.2.0.dist-info → plotly_cloud-0.3.0.dist-info}/METADATA

@@ -1,13 +1,12 @@
 Metadata-Version: 2.4
 Name: plotly-cloud
-Version: 0.2.0
+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
 Requires-Python: >=3.9
-Requires-Dist: dash>=2.0.0
+Requires-Dist: dash>=3.2.0
 Requires-Dist: httpx<1.0.0,>=0.24.0
-Requires-Dist: nest-asyncio>=1.6.0
 Requires-Dist: rich>=10.0.0
 Requires-Dist: tomli-w>=1.2.0
 Requires-Dist: tomli>=2.2.1

plotly_cloud-0.3.0.dist-info/RECORD

@@ -0,0 +1,22 @@
+plotly_cloud/__init__.py,sha256=-mqc6UM_gyoGqxNbCnS8Yy3Kc9hjnIij_Qn4KEiTz4k,61
+plotly_cloud/_api_types.py,sha256=CdP0w2YGjBUourO_vsoPcpHVXxemW6V3ezHewKXuIyc,1529
+plotly_cloud/_changes.py,sha256=oNGLYQfrJTFJgEsRneY2uNTPz4C6yRTWif31Wmodiy0,2040
+plotly_cloud/_cloud_env.py,sha256=FDjIBUsJssKMW14HOrITg-5tdgkCI1FnmEy8U6zulcQ,2953
+plotly_cloud/_commands.py,sha256=DB_c285mj--r2uuMKlfBBS_vM7f5gXF2nqH3jRXKGBc,39295
+plotly_cloud/_definitions.py,sha256=GKLat5c9fkM-qJQ6_jPu5zjC6g3fkDANpTVKzMO50z0,2456
+plotly_cloud/_deploy.py,sha256=h2SKGDkKfZBuSW0_bDMV_9Gc9Ixjf5ZQl40q1wfY8Xk,18549
+plotly_cloud/_devtool_hooks.py,sha256=QJZMwxLz7LZffnhylpvukcBQcwA9xQncwLIljRraCqc,1173
+plotly_cloud/_devtool_publish_rpc.py,sha256=BNUYsRbRIFQJzgYj8LBusjFK_wrD-vCY5C2imoTXHrk,11439
+plotly_cloud/_oauth.py,sha256=VzUMAahDjxdaTEJbUw_SQeG4AnuMA4NtHVGnjGQcsGw,12646
+plotly_cloud/_parser.py,sha256=kN06LfOxFm1itfQEC11b6X9HjZj18lBogPgnN4kcEtE,6041
+plotly_cloud/_run_sync.py,sha256=Km782HXOwp-o6murS_Ng_vC7wG_7AR9bwVVfF0aY4Zk,1012
+plotly_cloud/cli.py,sha256=SZzqT6QCBPZkuv92rEwbbaqEM-giWENSrpytmYIjfYY,10685
+plotly_cloud/cloud-env.toml,sha256=VhoG3DY6yBEwQG17_FqlJP8BxDqaffHbYlIFrxV6k9o,254
+plotly_cloud/cloud_devtools.css,sha256=3y2Q9NzM1arrkniLGZHfkiqtttuD5X7LkmCuxrkMRtI,3730
+plotly_cloud/cloud_devtools.js,sha256=rGhhRjM8BHWrrIspGlHgvjRz_OvfEQXueiwzrb_fVIQ,44265
+plotly_cloud/exceptions.py,sha256=QtNXLtryTbLqw3fUvho5GjsvR2W6BZ6rcMmvXJ0nVd0,4045
+plotly_cloud-0.3.0.dist-info/METADATA,sha256=yDGYPknff8AKoeDH3aV4cRX8Dcf63LHOSuyyfy5rIFo,8102
+plotly_cloud-0.3.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+plotly_cloud-0.3.0.dist-info/entry_points.txt,sha256=iZVffCSWjpG8Ht2HZAJDwZBmG-kVlIbH_V6SF8cwLNY,115
+plotly_cloud-0.3.0.dist-info/licenses/LICENSE,sha256=ElWBU-rl1xjn3Pvcguv5MNomrIMao1mPtuT_j8Q6WaI,1068
+plotly_cloud-0.3.0.dist-info/RECORD,,

{plotly_cloud-0.2.0.dist-info → plotly_cloud-0.3.0.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: hatchling 1.28.0
+Generator: hatchling 1.29.0
 Root-Is-Purelib: true
 Tag: py3-none-any

plotly_cloud-0.2.0.dist-info/RECORD

@@ -1,21 +0,0 @@
-plotly_cloud/__init__.py,sha256=oVX8cZCjc1qrroC9dAdwHPNfeQ2HKb4K4r9_zfs5dWE,61
-plotly_cloud/_api_types.py,sha256=CdP0w2YGjBUourO_vsoPcpHVXxemW6V3ezHewKXuIyc,1529
-plotly_cloud/_changes.py,sha256=YQJGChUzSGCgQOVnsA98vqWLARaY893UqVePYsCAhh8,2084
-plotly_cloud/_cloud_env.py,sha256=FDjIBUsJssKMW14HOrITg-5tdgkCI1FnmEy8U6zulcQ,2953
-plotly_cloud/_commands.py,sha256=8rPwUoGZ9BpwVNt2xT-NtQ7kEwZBO92sqQg_aB0Ii0Q,39206
-plotly_cloud/_definitions.py,sha256=GKLat5c9fkM-qJQ6_jPu5zjC6g3fkDANpTVKzMO50z0,2456
-plotly_cloud/_deploy.py,sha256=q76NaEI9iN137fhYzWsGuEk6VPjoGrZmsTnR-HQLqKU,17620
-plotly_cloud/_devtool_hooks.py,sha256=IPpX1tcMwHpLtBKhTkaXz48FvfFjv0-cgoZsZP2Aqcg,1913
-plotly_cloud/_devtool_publish_rpc.py,sha256=JY8FlP0yue6Yjsil6EDHpGSEdXfYnjEmLnK75CGKopM,11390
-plotly_cloud/_oauth.py,sha256=BwkeBOVHqoUfguiP4WBpT_xXB-oFJoFL-8VGqp6cuoQ,12403
-plotly_cloud/_parser.py,sha256=EoyehZZRy_A8PHO2yTMUkJcXTgztgh-7gAQF2uaP640,5795
-plotly_cloud/cli.py,sha256=keez1KpXxZEDLWYo58VnvzPBG6mctMf1aNqDWGqfvq4,10474
-plotly_cloud/cloud-env.toml,sha256=VhoG3DY6yBEwQG17_FqlJP8BxDqaffHbYlIFrxV6k9o,254
-plotly_cloud/cloud_devtools.css,sha256=3y2Q9NzM1arrkniLGZHfkiqtttuD5X7LkmCuxrkMRtI,3730
-plotly_cloud/cloud_devtools.js,sha256=rGhhRjM8BHWrrIspGlHgvjRz_OvfEQXueiwzrb_fVIQ,44265
-plotly_cloud/exceptions.py,sha256=QtNXLtryTbLqw3fUvho5GjsvR2W6BZ6rcMmvXJ0nVd0,4045
-plotly_cloud-0.2.0.dist-info/METADATA,sha256=zlHwCUtx33W4rORzOrr4b2diItblXVTZuXqoWvfjvyg,8137
-plotly_cloud-0.2.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-plotly_cloud-0.2.0.dist-info/entry_points.txt,sha256=iZVffCSWjpG8Ht2HZAJDwZBmG-kVlIbH_V6SF8cwLNY,115
-plotly_cloud-0.2.0.dist-info/licenses/LICENSE,sha256=ElWBU-rl1xjn3Pvcguv5MNomrIMao1mPtuT_j8Q6WaI,1068
-plotly_cloud-0.2.0.dist-info/RECORD,,