marimo-pys 0.0.1__tar.gz

marimo_pys-0.0.1/PKG-INFO

@@ -0,0 +1,31 @@
+Metadata-Version: 2.4
+Name: marimo_pys
+Version: 0.0.1
+Summary: PyScript Execution Function in Marimo
+Author: Uniras
+Author-email: tkappeng@gmail.com
+License: MIT License
+Project-URL: Homepage, https://github.com/uniras/pysionui
+Project-URL: Repository, https://github.com/uniras/pysionui
+Keywords: PyScript,Marimo
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Utilities
+Description-Content-Type: text/markdown
+
+# marimo_pys
+
+## Description
+
+marimo_pys is PyScript execute function in marimo
+

marimo_pys-0.0.1/README.md

@@ -0,0 +1,6 @@
+# marimo_pys
+
+## Description
+
+marimo_pys is PyScript execute function in marimo
+

marimo_pys-0.0.1/marimo_pys/__init__.py

@@ -0,0 +1,158 @@
+import inspect
+import textwrap
+import html
+import json
+import base64
+import marimo as mo
+from typing import Callable, Optional, Union, Any
+
+
+def run_pyscript(
+    code: Union[Callable, str],
+    width: str = '100%',
+    height: str = '200px',
+    body_style: str = '',
+    iframe_style: str = '',
+    iframe_sandbox: str = 'allow-scripts',
+    config: Optional[dict[str, Any]] = None,
+    data: Optional[dict[str, Any]] = None,
+    add_script: Optional[list[str]] = None,
+    add_module: Optional[list[str]] = None,
+    add_css: Optional[list[str]] = None,
+    add_dangerous_html: str = '',
+    terminal: bool = False,
+    pys_version: str = '2026.7.3',
+    pys_type: str = 'mpy',
+) -> mo.Html:
+    """
+    Generates HTML to execute the specified Python function as a PyScript and returns it as an Marimo iframe.
+
+    Args:
+        code (Union[Callable, str]): The async function or raw source code to be executed.
+            A callable must be a coroutine function; it is awaited in the browser as
+            ``await code(js, data)``, where ``js`` is the PyScript ``js`` module and
+            ``data`` is the ``data`` argument decoded back into a plain Python object.
+            Only the function's own source is transferred: it runs in a fresh
+            interpreter with no access to the surrounding module's imports, globals or
+            closure variables, so every import must happen inside the function body.
+            Decorators are not supported.
+        width (str): Width of the iframe. Default is '100%'.
+        height (str): Height of the iframe. Default is '200px'.
+        body_style (str): Additional CSS styles for the body. Default is ''.
+        iframe_style (str): Additional CSS styles for the iframe. Default is ''.
+        iframe_sandbox (str): Sandbox attributes for the iframe. Default is 'allow-scripts'.
+        config (Optional[dict[str, Any]]): Configuration dictionary for PyScript. Default is None.
+        data (Optional[dict[str, Any]]): Data dictionary to be passed to the function. Default is None.
+        add_script (Optional[list[str]]): List of additional JavaScript files to include. Default is None.
+        add_module (Optional[list[str]]): List of additional JavaScript modules to include. Default is None.
+        add_css (Optional[list[str]]): List of additional CSS files to include. Default is None.
+        add_dangerous_html (str): Additional HTML content to include in the body. note: This can be dangerous if it includes untrusted content. Default is ''.
+        terminal (bool): Whether to enable terminal output in PyScript. Default is False.
+        pys_version (str): Version of PyScript to use. Default is '2026.7.3'.
+        pys_type (str): Type of PyScript to use. Default is 'mpy'.
+
+    Returns:
+        mo.Html: An HTML object containing the iframe with the PyScript execution.
+    """
+
+    # Set default values for optional parameters
+    config = config or {}
+    data = data or {}
+    add_script = add_script or []
+    add_module = add_module or []
+    add_css = add_css or []
+
+    # Validate the input function and extract its source code
+    if callable(code):
+        # Validate that the function has a valid name
+        func_name: Optional[str] = getattr(code, '__name__', None)
+        if not func_name or not func_name.isidentifier():
+            raise ValueError('Provided function must have a valid name.')
+
+        # Validate that the function is a coroutine function
+        if not inspect.iscoroutinefunction(code):
+          raise TypeError(
+              f"{func_name!r} must be an async function; "
+              f"declare it as 'async def {func_name}(js, data)'."
+          )
+
+        # Extract function source code as a string and normalize it by left-justifying it
+        clean_source = textwrap.dedent(inspect.getsource(code))
+
+        execute_script = f'{clean_source}\n\n# --- Auto-generated trigger ---\nimport js\nimport json\nawait {func_name}(js, json.loads(js.JSON.stringify(js.globalThis.pys_data)))'
+    elif isinstance(code, str):
+        # If func is a string, treat it as raw source code
+        execute_script = code
+    else:
+        raise TypeError('code must be either a callable or a string representing the source code.')
+
+    # Encode the script in base64 for embedding in the HTML
+    b64_script = base64.b64encode(execute_script.encode()).decode()
+
+    # Convert config dictionaries to JSON
+    if isinstance(config, dict):
+        config_json = html.escape(json.dumps(config, allow_nan=False, ensure_ascii=False, separators=(',', ':')))
+    else:
+        raise TypeError('data must be a dictionary.')
+
+    # Convert data dictionaries to JSON
+    if isinstance(data, dict):
+        data_json = json.dumps(data, allow_nan=False, ensure_ascii=False, separators=(',', ':')).replace('<', '\\u003c')
+    else:
+        raise TypeError('data must be a dictionary.')
+
+    # Include additional scripts, modules, and CSS
+    script_includes = '\n' + '\n'.join([f'<script type="text/javascript" src="{html.escape(script)}"></script>' for script in add_script]) if len(add_script) > 0 else ''
+    module_includes = '\n' + '\n'.join([f'<script type="module" src="{html.escape(module)}"></script>' for module in add_module]) if len(add_module) > 0 else ''
+    css_includes = '\n' + '\n'.join([f'<link rel="stylesheet" href="{html.escape(css)}" />' for css in add_css]) if len(add_css) > 0 else ''
+
+    # Add attribute if terminal output is enabled in PyScript
+    terminal_attr = ' terminal' if terminal else ''
+
+    # Checking the PyScript type
+    if pys_type not in ('py', 'mpy', 'py-game'):
+        raise ValueError("Invalid pys_type. Must be one of 'mpy', 'py', or 'py-game'.")
+
+    # Assemble the HTML template (CSS {} etc. are doubled for escaping in f-string)
+    html_template = f"""
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <script>
+    // Set the data JSON as a global variable
+    globalThis.pys_data = {data_json};
+
+    // polyscript's relative_url defaults its base to location.href:
+    //   P = (e, t = location.href) => new URL(e, t.replace(/^blob:/, "")).href
+    // Inside an <iframe srcdoc>, location.href is "about:srcdoc", so config
+    // resolution (a non-URL config falls back to "./config.txt") throws a
+    // TypeError, define() fails, and PyScript never boots.
+    // The replace() above already strips "blob:", but "about:" is not handled.
+    // Patching URL before core.js loads is the only hook available:
+    // <base href> has no effect (the base comes from location.href, not baseURI),
+    // On PyScript upgrades, drop this patch and re-test. Verified against 2026.7.3.
+    const NativeURL = window.URL;
+    class PatchedURL extends NativeURL {{
+      constructor(url, base) {{
+        const b = base == null ? '' : String(base);
+        if (b === '' || b.startsWith('about:')) {{
+          base = 'https://pyscript.net/releases/{pys_version}/';
+        }}
+        super(url, base);
+      }}
+    }}
+    window.URL = PatchedURL;
+  </script>
+  <link rel="stylesheet" href="https://pyscript.net/releases/{pys_version}/core.css" />{css_includes}{script_includes}
+  <script type="module" src="https://pyscript.net/releases/{pys_version}/core.js"></script>{module_includes}
+</head>
+<body style="margin: 0; {html.escape(body_style)}">
+  {add_dangerous_html}
+  <script type="{pys_type}" config="{config_json}" src="data:text/python;charset=utf-8;base64,{b64_script}"{terminal_attr}></script>
+</body>
+</html>
+    """
+
+    # Wrap in an iframe and return
+    return mo.Html(f'<iframe srcdoc="{html.escape(html_template)}" width="{html.escape(width)}" height="{html.escape(height)}" style="{html.escape(iframe_style)}" sandbox="{html.escape(iframe_sandbox)}"></iframe>')

marimo_pys-0.0.1/marimo_pys.egg-info/PKG-INFO

@@ -0,0 +1,31 @@
+Metadata-Version: 2.4
+Name: marimo_pys
+Version: 0.0.1
+Summary: PyScript Execution Function in Marimo
+Author: Uniras
+Author-email: tkappeng@gmail.com
+License: MIT License
+Project-URL: Homepage, https://github.com/uniras/pysionui
+Project-URL: Repository, https://github.com/uniras/pysionui
+Keywords: PyScript,Marimo
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Utilities
+Description-Content-Type: text/markdown
+
+# marimo_pys
+
+## Description
+
+marimo_pys is PyScript execute function in marimo
+

marimo_pys-0.0.1/marimo_pys.egg-info/SOURCES.txt

@@ -0,0 +1,7 @@
+README.md
+pyproject.toml
+marimo_pys/__init__.py
+marimo_pys.egg-info/PKG-INFO
+marimo_pys.egg-info/SOURCES.txt
+marimo_pys.egg-info/dependency_links.txt
+marimo_pys.egg-info/top_level.txt

marimo_pys-0.0.1/marimo_pys.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

marimo_pys-0.0.1/marimo_pys.egg-info/top_level.txt

@@ -0,0 +1 @@
+marimo_pys

marimo_pys-0.0.1/pyproject.toml

@@ -0,0 +1,34 @@
+[build-system]
+requires = ["setuptools >= 61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "marimo_pys"
+version = "0.0.1"
+description = "PyScript Execution Function in Marimo"
+readme = "README.md"
+authors = [
+  {name = "Uniras"},
+  {email = "tkappeng@gmail.com"}
+]
+license = {text = "MIT License"}
+keywords = ["PyScript", "Marimo"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Programming Language :: Python :: 3 :: Only",
+    "Topic :: Software Development :: Libraries",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Utilities",
+]
+
+[project.urls]
+Homepage = "https://github.com/uniras/pysionui"
+Repository = "https://github.com/uniras/pysionui"

marimo_pys-0.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+