feat: add a new field "execute_readme_py" to afterpython.toml to pass in "--execute" option when running "marimo export html-wasm"

Author: softwareentrepreneer

afterpython/README_sample.py

@@ -1,14 +1,25 @@
+# ruff: noqa
+
+# /// script
+# requires-python = ">=3.13"
+# dependencies = [
+#     "marimo>=0.23.8",
+#     "pfeed==0.0.8",
+# ]
+# ///
+
 import marimo
 
-__generated_with = "0.23.4"
+__generated_with = "0.23.8"
 app = marimo.App()
 
 
-@app.cell(hide_code=True)
+@app.cell
 def _():
     import marimo as mo
+    import pfeed as pe
 
-    return (mo,)
+    return mo, pe
 
 
 @app.cell(hide_code=True)
@@ -25,5 +36,73 @@ def _():
     return
 
 
+@app.cell
+async def _():
+    import sys
+
+    if sys.platform == "emscripten":
+        import micropip
+
+        await micropip.install(["polars", "pyarrow", "pyodide-http"])
+
+        # avoid creating a thread in tqdm
+        import tqdm
+
+        tqdm.tqdm.monitor_interval = 0
+
+        import pyodide_http
+
+        pyodide_http.patch_all()
+
+        # CORS proxy shim — public.bybit.com sends no CORS headers,
+        # so route every httpx.get through a proxy that does.
+        import httpx
+
+        _orig_get = httpx.get
+        PROXY = "https://pfeed-cors.lucky-water-569b.workers.dev/?url="
+
+        def _proxied_get(url, *args, **kwargs):
+            return _orig_get(PROXY + url, *args, **kwargs)
+
+        httpx.get = _proxied_get
+    return
+
+
+@app.cell(hide_code=True)
+def _(mo):
+    mo.callout(
+        mo.md(
+            "**Demo mode.** This is `pfeed` running in WASM — core features "
+            "are not fully supported. "
+            "For full functionality, install locally:\n\n"
+            "```\npip install pfeed[core]\n```\n"
+            "Click **▶ Run all** (top right) to start. First run takes ~15s while Pyodide and dependencies load."
+        ),
+        kind="info",
+    )
+    return
+
+
+@app.cell
+def _(pe):
+    bybit = pe.Bybit()
+    feed = bybit.market_feed
+    result = feed.download(
+        product="BTC_USDT_PERP",
+        resolution="1minute",
+        start_date="2026-01-01",
+        end_date="2026-01-01",
+        storage_config=None,
+    )
+    df = result.data.collect()
+    df
+    return
+
+
+@app.cell
+def _():
+    return
+
+
 if __name__ == "__main__":
     app.run()

afterpython/_website/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@afterpython/project-website-template",
-	"version": "0.3.8",
+	"version": "0.3.9",
 	"license": "Apache-2.0",
 	"type": "module",
 	"packageManager": "pnpm@11.1.1",

afterpython/_website/src/routes/+page.svelte

@@ -9,47 +9,6 @@
 
 	const { data }: PageProps = $props();
 
-	let readmeIframeEl = $state<HTMLIFrameElement | null>(null);
-	let readmeIframeHeight = $state(800);
-
-	function handleReadmeIframeLoad() {
-		const doc = readmeIframeEl?.contentDocument;
-		if (!doc) return;
-
-		// Marimo's wasm app shell sets html/body to 100vh with internal scrolling,
-		// which prevents the iframe from sizing to real content. Override so the
-		// document flows naturally and scrollHeight reflects actual content height.
-		const style = doc.createElement('style');
-		style.textContent = `
-			html, body {
-				height: auto !important;
-				min-height: 0 !important;
-				max-height: none !important;
-				overflow: visible !important;
-			}
-			#App, #root, marimo-mount, [class*="marimo"] {
-				height: auto !important;
-				min-height: 0 !important;
-				max-height: none !important;
-				overflow: visible !important;
-			}
-		`;
-		(doc.head ?? doc.documentElement).appendChild(style);
-
-		const update = () => {
-			const h = Math.max(
-				doc.documentElement?.scrollHeight ?? 0,
-				doc.body?.scrollHeight ?? 0
-			);
-			if (h > 0) readmeIframeHeight = h;
-		};
-
-		update();
-		const ro = new ResizeObserver(update);
-		if (doc.documentElement) ro.observe(doc.documentElement);
-		if (doc.body) ro.observe(doc.body);
-	}
-
 	// Extract repository URL safely
 	const repositoryUrl = $derived(
 		data.project_url?.find((url: string) => url.startsWith('repository,'))?.split(', ')[1]
@@ -142,13 +101,10 @@
 
 		{#if data.readme_py}
 			<iframe
-				bind:this={readmeIframeEl}
 				src={resolve('/readme_py/readme_py.html')}
 				title="README"
 				loading="lazy"
-				onload={handleReadmeIframeLoad}
-				class="w-full max-w-4xl rounded-2xl border border-bg300 bg-bg100 text-left shadow-lg"
-				style="height: {readmeIframeHeight}px;"
+				class="h-[96vh] w-full max-w-4xl rounded-2xl border mb-28 border-bg300 bg-bg100 text-left shadow-lg"
 			></iframe>
 		{:else if data.description}
 			<div

afterpython/afterpython.toml

@@ -11,6 +11,7 @@ logo_dark = "logo.svg"
 thumbnail = "thumbnail.png"  # thumbnail for the website, also used as default thumbnail for all content types, e.g. blog posts, tutorials, examples, and guides
 announcement = ""
 readme_py = "wasm"  # marimo html export format: "wasm" or "static"
+execute_readme_py = false  # execute README.py cells at build time and embed outputs as a preview (wasm mode only)
 api_reference = false  # set to true to enable the pdoc-generated API reference
 
 # [website.blog]

afterpython/doc/project_website.md

@@ -158,11 +158,14 @@ Choose the export mode in `afterpython.toml`:
 ```toml
 [website]
 readme_py = "wasm"  # or "static"
+execute_readme_py = false  # execute cells at build time and embed outputs as a preview (wasm mode only)
 ```
 
 - **`wasm`** (default) — interactive. Cells run in the browser via Pyodide. Great for live demos of your package, but adds a ~10MB+ Pyodide download on first visit. Won't work for packages with C extensions that aren't ported to Pyodide.
 - **`static`** — pre-rendered HTML, no runtime. Lighter, but cells can't execute. AfterPython adds an "Open in molab" badge so users can still run the notebook on a real Python server hosted by marimo.
 
+Set `execute_readme_py = true` to execute the notebook before exporting and embed the cell outputs as a preview — visitors see results immediately instead of a blank notebook while Pyodide boots. Marimo runs the execution in an isolated environment pinned to WASM-compatible packages when possible. Only honored in `wasm` mode.
+
 `README.md` is still required (PyPI uses it for the long description) and is shown if `README.py` is absent or isn't a marimo notebook.
 
 ### FAQs