figpack 0.2.2__py3-none-any.whl → 0.2.3__py3-none-any.whl

figpack/__init__.py

@@ -2,4 +2,4 @@
 figpack - A Python package for creating shareable, interactive visualizations in the browser
 """
 
-__version__ = "0.2.2"
+__version__ = "0.2.3"

figpack/core/_show_view.py

@@ -38,6 +38,19 @@ def _is_in_notebook() -> bool:
         return False
 
 
+def _is_in_colab():
+    try:
+        import google.colab  # type: ignore
+
+        return True
+    except ImportError:
+        return False
+
+
+def _is_in_jupyterhub():
+    return "JUPYTERHUB_USER" in os.environ
+
+
 def _display_inline_iframe(url: str, height: int) -> None:
     """
     Display an iframe inline in a Jupyter notebook.
@@ -75,6 +88,7 @@ def _show_view(
     port: Union[int, None] = None,
     allow_origin: Union[str, None] = None,
     upload: bool = False,
+    ephemeral: bool = False,
     title: Union[str, None] = None,
     description: Union[str, None] = None,
     inline: Union[bool, None] = None,
@@ -91,16 +105,17 @@ def _show_view(
         with tempfile.TemporaryDirectory(prefix="figpack_upload_") as tmpdir:
             prepare_figure_bundle(view, tmpdir, title=title, description=description)
 
-            # Check for required environment variable
+            # Check for API key - required for regular uploads, optional for ephemeral
             api_key = os.environ.get("FIGPACK_API_KEY")
-            if not api_key:
+            if not ephemeral and not api_key:
                 raise EnvironmentError(
                     "FIGPACK_API_KEY environment variable must be set to upload views."
                 )
 
             # Upload the bundle
-            print("Starting upload...")
-            figure_url = _upload_bundle(tmpdir, api_key, title=title)
+            figure_url = _upload_bundle(
+                tmpdir, api_key, title=title, ephemeral=ephemeral
+            )
 
             if use_inline:
                 # For uploaded figures, display the remote URL inline and continue

figpack/core/_upload_bundle.py

@@ -133,33 +133,45 @@ def _create_or_get_figure(
     total_files: int = None,
     total_size: int = None,
     title: str = None,
+    ephemeral: bool = False,
 ) -> dict:
     """
     Create a new figure or get existing figure information
 
     Args:
         figure_hash: The hash of the figure
-        api_key: The API key for authentication
+        api_key: The API key for authentication (required for non-ephemeral)
         total_files: Optional total number of files
         total_size: Optional total size of files
         title: Optional title for the figure
+        ephemeral: Whether to create an ephemeral figure
 
     Returns:
         dict: Figure information from the API
     """
+    # Validate API key requirement
+    if not ephemeral and api_key is None:
+        raise ValueError("API key is required for non-ephemeral figures")
+
     payload = {
         "figureHash": figure_hash,
-        "apiKey": api_key,
         "figpackVersion": __version__,
     }
 
+    # API key is optional for ephemeral figures
+    if api_key is not None:
+        payload["apiKey"] = api_key
+
     if total_files is not None:
         payload["totalFiles"] = total_files
     if total_size is not None:
         payload["totalSize"] = total_size
     if title is not None:
         payload["title"] = title
+    if ephemeral:
+        payload["ephemeral"] = True
 
+    # Use the same endpoint for both regular and ephemeral figures
     response = requests.post(f"{FIGPACK_API_BASE_URL}/api/figures/create", json=payload)
 
     if not response.ok:
@@ -212,16 +224,16 @@ def _finalize_figure(figure_url: str, api_key: str) -> dict:
     return response_data
 
 
-def _upload_bundle(tmpdir: str, api_key: str, title: str = None) -> str:
+def _upload_bundle(
+    tmpdir: str, api_key: str, title: str = None, ephemeral: bool = False
+) -> str:
     """
     Upload the prepared bundle to the cloud using the new database-driven approach
     """
     tmpdir_path = pathlib.Path(tmpdir)
 
     # Compute deterministic figure ID based on file contents
-    print("Computing deterministic figure ID...")
     figure_hash = _compute_deterministic_figure_hash(tmpdir_path)
-    print(f"Figure hash: {figure_hash}")
 
     # Collect all files to upload
     all_files = []
@@ -239,17 +251,15 @@ def _upload_bundle(tmpdir: str, api_key: str, title: str = None) -> str:
 
     # Find available figure ID and create/get figure in database with metadata
     result = _create_or_get_figure(
-        figure_hash, api_key, total_files, total_size, title=title
+        figure_hash, api_key, total_files, total_size, title=title, ephemeral=ephemeral
     )
     figure_info = result.get("figure", {})
     figure_url = figure_info.get("figureUrl")
 
     if figure_info["status"] == "completed":
-        print(f"Figure already exists at: {figure_url}")
+        print(f"Figure already exists. No upload needed.")
         return figure_url
 
-    print(f"Using figure URL: {figure_url}")
-
     files_to_upload = all_files
     total_files_to_upload = len(files_to_upload)
 

figpack/core/figpack_view.py

@@ -18,7 +18,8 @@ class FigpackView:
         port: Union[int, None] = None,
         open_in_browser: bool = False,
         allow_origin: Union[str, None] = None,
-        upload: bool = False,
+        upload: Union[bool, None] = None,
+        ephemeral: Union[bool, None] = None,
         _dev: bool = False,
         title: Union[str, None] = None,
         description: Union[str, None] = None,
@@ -33,13 +34,37 @@ class FigpackView:
             open_in_browser: Whether to open in browser automatically
             allow_origin: CORS allow origin header
             upload: Whether to upload the figure
+            ephemeral: Whether to upload as ephemeral figure (None=auto-detect, True=force ephemeral, False=force regular)
             _dev: Development mode flag
             title: Title for the browser tab and figure
             description: Description text (markdown supported) for the figure
             inline: Whether to display inline in notebook (None=auto-detect, True=force inline, False=force browser)
             inline_height: Height in pixels for inline iframe display (default: 600)
         """
-        from ._show_view import _show_view
+        from ._show_view import (
+            _show_view,
+            _is_in_notebook,
+            _is_in_colab,
+            _is_in_jupyterhub,
+        )
+
+        if ephemeral is None and upload is None:
+            # If we haven't specified both, then let's check if we're in a notebook in a non-local environment
+            if _is_in_notebook():
+                if _is_in_colab():
+                    # if we are in a notebook and in colab, we should show as uploaded ephemeral
+                    print("Detected Google Colab notebook environment.")
+                    upload = True
+                    ephemeral = True
+                if _is_in_jupyterhub():
+                    # if we are in a notebook and in jupyterhub, we should show as uploaded ephemeral
+                    print("Detected JupyterHub notebook environment.")
+                    upload = True
+                    ephemeral = True
+
+        # Validate ephemeral parameter
+        if ephemeral and not upload:
+            raise ValueError("ephemeral=True requires upload=True to be set")
 
         if _dev:
             if port is None:
@@ -61,6 +86,7 @@ class FigpackView:
             open_in_browser=open_in_browser,
             allow_origin=allow_origin,
             upload=upload,
+            ephemeral=ephemeral,
             title=title,
             description=description,
             inline=inline,

{figpack-0.2.2.dist-info → figpack-0.2.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: figpack
-Version: 0.2.2
+Version: 0.2.3
 Summary: A Python package for creating shareable, interactive visualizations in the browser
 Author-email: Jeremy Magland <jmagland@flatironinstitute.org>
 License: Apache-2.0

{figpack-0.2.2.dist-info → figpack-0.2.3.dist-info}/RECORD

@@ -1,12 +1,12 @@
-figpack/__init__.py,sha256=BlI-Bj-E91wj4Sbs7MKpLjKuVrld9nLGeiNTSjNHoGw,124
+figpack/__init__.py,sha256=qKVa2XgXzmxB506Y98CMOKvDXy8y-xdiDmkDLGJ3YE8,124
 figpack/cli.py,sha256=DYV-DxzWnQTMNywW-ZzhlTEFOEIt11rAKdobdBmRQFk,12051
 figpack/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 figpack/core/_bundle_utils.py,sha256=73E6FinAvrt1QATGncIqyg6JLeiWVmlGF8NOcFyeYSs,1913
 figpack/core/_server_manager.py,sha256=8uxJftMgJ7EcVXtLo_VQuaiCZIyqgE89yDfCXKEgyeQ,10922
-figpack/core/_show_view.py,sha256=muuz0jMptAz7Z63kHlQzaBstKDwYWx4aM912xUD7Vrs,4892
-figpack/core/_upload_bundle.py,sha256=5nVNfHJewhu0oPPrBDkf9pzYj4T7ZyQFyZBgpK2v4qQ,12960
+figpack/core/_show_view.py,sha256=WeHbQ1qdq5Lr54XTuNqmCIrwR4jbPWu8dT7Sm_UNcsk,5194
+figpack/core/_upload_bundle.py,sha256=8D3M778E7nvkl9xnyrFOBlFhOOhywdiwLzOSPCMm4KE,13351
 figpack/core/config.py,sha256=6EU9CMvzGk9308Xlx8iJ2cIHJV6pqhXyiZGkK2snA4g,108
-figpack/core/figpack_view.py,sha256=85wb_oom0MSOk7eV8Xm96lOKYo0ggYyQJ_NC4F79qn8,2474
+figpack/core/figpack_view.py,sha256=q-Xxk9X4dnLy_kGX0POC7FLB6qwmBfqrWD6uelPJZVE,3708
 figpack/figpack-gui-dist/index.html,sha256=HU8Dv1EzISPzQjibGxDA6tAz7VpzjL6o-HXOPKv4s4E,486
 figpack/figpack-gui-dist/assets/index-Cmae55E4.css,sha256=Yg0apcYehJwQvSQIUH13S7tsfqWQDevpJsAho0dDf0g,5499
 figpack/figpack-gui-dist/assets/index-DUR9Dmwh.js,sha256=iHbhpBXkfKoDzn-ZDxh2_uktWyzSTwes9gzgdBEM7PU,1590964
@@ -39,9 +39,9 @@ figpack/views/TabLayout.py,sha256=5g3nmL95PfqgI0naqZXHMwLVo2ebDlGX01Hy9044bUw,18
 figpack/views/TabLayoutItem.py,sha256=xmHA0JsW_6naJze4_mQuP_Fy0Nm17p2N7w_AsmVRp8k,880
 figpack/views/TimeseriesGraph.py,sha256=OAaCjO8fo86u_gO_frNfRGxng3tczxGDGKcJEvZo3rE,7469
 figpack/views/__init__.py,sha256=8y4KdRtrdDF0-xtQQkj4k_d8Ajk44Q7myztl3StdZcU,407
-figpack-0.2.2.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-figpack-0.2.2.dist-info/METADATA,sha256=vbtrTDAXwFUDxLwYY_7DsjhXY6gHjMvl3r_5UH8Ectk,5886
-figpack-0.2.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-figpack-0.2.2.dist-info/entry_points.txt,sha256=l6d3siH2LxXa8qJGbjAqpIZtI5AkMSyDeoRDCzdrUto,45
-figpack-0.2.2.dist-info/top_level.txt,sha256=lMKGaC5xWmAYBx9Ac1iMokm42KFnJFjmkP2ldyvOo-c,8
-figpack-0.2.2.dist-info/RECORD,,
+figpack-0.2.3.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+figpack-0.2.3.dist-info/METADATA,sha256=m_CybGYmcQYpRliR1ZkHMP7sM7qbSTR89sVKBzZvTOI,5886
+figpack-0.2.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+figpack-0.2.3.dist-info/entry_points.txt,sha256=l6d3siH2LxXa8qJGbjAqpIZtI5AkMSyDeoRDCzdrUto,45
+figpack-0.2.3.dist-info/top_level.txt,sha256=lMKGaC5xWmAYBx9Ac1iMokm42KFnJFjmkP2ldyvOo-c,8
+figpack-0.2.3.dist-info/RECORD,,