marimo-dev 0.2.8__tar.gz → 0.3.0__tar.gz

{marimo_dev-0.2.8 → marimo_dev-0.3.0}/PKG-INFO

@@ -1,10 +1,11 @@
 Metadata-Version: 2.3
 Name: marimo-dev
-Version: 0.2.8
+Version: 0.3.0
 Summary: Build and publish python packages from marimo notebooks
 Author: Deufel
 Author-email: Deufel <MDeufel13@gmail.com>
 License: MIT
+Requires-Dist: anthropic>=0.84.0
 Requires-Dist: fastcore>=1.10.0
 Requires-Dist: ipython>=9.8.0
 Requires-Dist: marimo>=0.19.7
@@ -13,14 +14,18 @@ Requires-Dist: pydantic-ai-slim>=1.50.0
 Requires-Dist: pytest>=9.0.2
 Requires-Dist: python-fasthtml>=0.12.37
 Requires-Dist: youtube-transcript-api>=1.2.3
-Requires-Python: >=3.12
-Project-URL: Repository, https://github.com/deufel/m-dev
+Requires-Python: >=3.13
 Project-URL: PyPI, https://pypi.org/project/marimo-dev/
+Project-URL: Repository, https://github.com/deufel/m-dev
 Description-Content-Type: text/markdown
 
 # marimo-dev
 
-Build Python packages from Marimo notebooks.
+> [!WARNING]
+> This project is under active development and is not an official marimo tool - Mar 2026
+
+
+Build Python packages (and applications[in progress]) from Marimo notebooks.
 
 ## Why this exists
 

{marimo_dev-0.2.8 → marimo_dev-0.3.0}/README.md

@@ -1,6 +1,10 @@
 # marimo-dev
 
-Build Python packages from Marimo notebooks.
+> [!WARNING]
+> This project is under active development and is not an official marimo tool - Mar 2026
+
+
+Build Python packages (and applications[in progress]) from Marimo notebooks.
 
 ## Why this exists
 

{marimo_dev-0.2.8 → marimo_dev-0.3.0}/pyproject.toml

@@ -4,11 +4,12 @@ build-backend = "uv_build"
 
 [project]
 name = "marimo-dev"
-version = "0.2.8"
+version = "0.3.0"
 description = "Build and publish python packages from marimo notebooks"
 readme = "README.md"
-requires-python = ">=3.12"
+requires-python = ">=3.13"
 dependencies = [
+    "anthropic>=0.84.0",
     "fastcore>=1.10.0",
     "ipython>=9.8.0",
     "marimo>=0.19.7",
@@ -51,9 +52,6 @@ PyPI = "https://pypi.org/project/marimo-dev/"
   skip_prefixes = ["XX_", "test_"]
 
 # Remove this when ready to upload this is a saftey net for not accidentally uploading
-classifiers = ["Private :: Do Not Upload"]
+# classifiers = ["Private :: Do Not Upload"]
 
-# Development packages
-[dependency-groups]
-dev = ["anthropic>=0.72.0", "marimo[mcp]>=0.18.4" , "pytest>=8.4.2"]
 

{marimo_dev-0.2.8 → marimo_dev-0.3.0}/src/marimo_dev/__init__.py

@@ -1,12 +1,12 @@
 """Build and publish python packages from marimo notebooks"""
-__version__ = '0.2.8'
+__version__ = '0.3.0'
 __author__ = 'Deufel'
 from .core import Config, read_config, Kind, Param, Node
 from .read import inline_doc, parse_params, parse_hash_pipe, parse_class_params, parse_class_methods, parse_ret, src_with_decs, is_export, parse_import, parse_const, parse_export, parse_node, parse_file, read_meta, nb_name, scan
 from .pkg import clean, write, write_mod, rewrite_imports, write_init
-from .docs import cls_sig, fn_sig, sig, write_llms, exp_type, render_param, nb_path, render_node, render_module_page, build_docs, export_wasm, write_nojekyll, html_preview, render_index_page, Icon
-from .build import build, tidy, nuke, get_pypi_name, extract_import_names, pep723_header, bundle
-from .publish import publish
+from .docs import nb_path, render_node, render_module_page, build_docs, export_wasm, write_nojekyll, html_preview, render_index_page, Icon, write_highlighter
+from .build import build, tidy, nuke, get_pypi_name, extract_import_names, pep723_header, write_llms, bundle, bundle_notebook
+from .publish import check_credentials, check_pypi_auth, publish
 from .cli import main
 __all__ = [
     "Config",
@@ -17,12 +17,12 @@ __all__ = [
     "build",
     "build_docs",
     "bundle",
+    "bundle_notebook",
+    "check_credentials",
+    "check_pypi_auth",
     "clean",
-    "cls_sig",
-    "exp_type",
     "export_wasm",
     "extract_import_names",
-    "fn_sig",
     "get_pypi_name",
     "html_preview",
     "inline_doc",
@@ -48,13 +48,12 @@ __all__ = [
     "render_index_page",
     "render_module_page",
     "render_node",
-    "render_param",
     "rewrite_imports",
     "scan",
-    "sig",
     "src_with_decs",
     "tidy",
     "write",
+    "write_highlighter",
     "write_init",
     "write_llms",
     "write_mod",

marimo_dev-0.3.0/src/marimo_dev/build.py

@@ -0,0 +1,226 @@
+from .core import Kind, Param, Node, Config, read_config
+from .read import scan, read_meta
+from .pkg import write_mod, write_init, clean
+from pathlib import Path
+import ast, shutil, re, sys
+
+IMPORT_TO_PYPI = {'bs4': 'beautifulsoup4', 'PIL': 'pillow', 'cv2': 'opencv-python', 'sklearn': 'scikit-learn', 'yaml': 'pyyaml'}
+
+def build(
+    root='.',  # root directory containing pyproject.toml
+)->str:        # path to built package
+    "Build a Python package from notebooks."
+    cfg = read_config(root)
+    meta, mods = scan(root)
+    mod_names = [name for name, _ in mods]
+    pkg = Path(root) / cfg.out / meta['name'].replace('-', '_')
+    if pkg.exists(): shutil.rmtree(pkg)
+    pkg.mkdir(parents=True, exist_ok=True)
+    for name, nodes in mods:
+        stripped = re.sub(r'^[a-z]_', '', name)
+        if stripped != 'index' and any(n.kind == Kind.EXP for n in nodes): write_mod(pkg/f'{stripped}.py', nodes, mod_names)
+    write_init(pkg/'__init__.py', meta, mods)
+    all_exp = [n for _, nodes in mods for n in nodes if n.kind == Kind.EXP]
+    if all_exp: write_llms()
+    return str(pkg)
+
+def tidy():
+    "Remove cache and temporary files (__pycache__, __marimo__, .pytest_cache, etc)."
+    import shutil
+    for p in Path('.').rglob('__pycache__'): shutil.rmtree(p, ignore_errors=True)
+    for p in Path('.').rglob('__marimo__'): shutil.rmtree(p, ignore_errors=True)
+    for p in Path('.').rglob('.pytest_cache'): shutil.rmtree(p, ignore_errors=True)
+    for p in Path('.').rglob('*.pyc'): p.unlink(missing_ok=True)
+    print("Cleaned cache files")
+
+def nuke():
+    "Remove all build artifacts (dist, docs, src) and cache files."
+    import shutil
+    tidy()
+    for d in ['dist', 'docs', 'src', 'temp']: shutil.rmtree(d, ignore_errors=True)
+    print("Nuked build artifacts")
+
+def get_pypi_name(import_name):
+    "Map import name to PyPI package name."
+    root = import_name.split('.')[0]
+    return IMPORT_TO_PYPI.get(root, root)
+
+def extract_import_names(nodes):
+    "Extract top-level module names from import nodes."
+    names = set()
+    for n in nodes:
+        if n.kind != Kind.IMP: continue
+        tree = ast.parse(n.src)
+        for stmt in ast.walk(tree):
+            if isinstance(stmt, ast.Import):
+                for alias in stmt.names:
+                    names.add(alias.name.split('.')[0])
+            elif isinstance(stmt, ast.ImportFrom) and stmt.module:
+                names.add(stmt.module.split('.')[0])
+    return names
+
+def pep723_header(deps):
+    "Generate PEP 723 inline script metadata."
+    deps_str = ', '.join(f'"{d}"' for d in sorted(deps))
+    return f'# /// script\n# dependencies = [{deps_str}]\n# ///\n'
+
+def write_llms(root='.'):
+    "Generate llms.txt and llms-full.txt from parsed notebooks."
+    cfg = read_config(root)
+    meta, mods = scan(root)
+    name = meta['name']
+    desc = meta.get('description', '')
+    docs_dir = Path(root) / cfg.docs
+    docs_dir.mkdir(parents=True, exist_ok=True)
+
+    # llms-full.txt — complete cleaned source
+    full_parts = [f"# {name}\n\n> {desc}\n"]
+    for mod_name, nodes in mods:
+        exports = [n for n in nodes if n.kind == Kind.EXP]
+        if not exports: continue
+        stripped = re.sub(r'^[a-z]_', '', mod_name)
+        full_parts.append(f"## {stripped}\n")
+        for n in exports:
+            full_parts.append(clean(n.src))
+    Path(docs_dir / 'llms-full.txt').write_text('\n\n'.join(full_parts) + '\n')
+
+    # llms.txt — summary with links
+    base_url = meta.get('url', '')
+    lines = [f"# {name}\n", f"> {desc}\n"]
+    for mod_name, nodes in mods:
+        exports = [n for n in nodes if n.kind == Kind.EXP]
+        if not exports: continue
+        stripped = re.sub(r'^[a-z]_', '', mod_name)
+        names = ', '.join(n.name for n in exports)
+        lines.append(f"- [{stripped}]({base_url}/{stripped}): {names}")
+    lines.append(f"\n- [llms-full.txt]({base_url}/llms-full.txt): Complete source code")
+    Path(docs_dir / 'llms.txt').write_text('\n'.join(lines) + '\n')
+
+    return f"Wrote {docs_dir}/llms.txt and llms-full.txt"
+
+def bundle(root='.', name=None):
+    "Bundle all notebooks into a single Python file with PEP 723 dependencies."
+    cfg = read_config(root)
+    meta, mods = scan(root)
+
+    # Get notebook filenames to filter out local imports
+    nbs_dir = Path(root) / cfg.nbs
+    nb_names = {f.stem for f in nbs_dir.glob('*.py')}
+
+    # Collect all nodes
+    all_nodes = [n for _, nodes in mods for n in nodes]
+
+    # Extract dependencies
+    import_names = extract_import_names(all_nodes)
+    mod_names = [m for m, _ in mods]
+
+    # Filter out local modules, notebook names, and stdlib
+    external = {get_pypi_name(n) for n in import_names 
+                if n not in mod_names 
+                and n not in nb_names 
+                and n not in sys.stdlib_module_names}
+
+    # Build output
+    header = pep723_header(external)
+
+    # Filter out local imports, dedupe externals
+    seen = set()
+    filtered_imports = []
+    for n in all_nodes:
+        if n.kind != Kind.IMP: continue
+        # Skip if it's a local notebook import
+        if any(nb in n.src for nb in nb_names): continue
+        if n.src not in seen:
+            seen.add(n.src)
+            filtered_imports.append(n.src)
+
+    imports = '\n'.join(filtered_imports)
+
+    consts = '\n'.join(n.src for n in all_nodes if n.kind == Kind.CONST)
+    setup = '\n'.join(n.src for n in all_nodes if n.kind == Kind.SETUP)
+    exports = '\n\n'.join(clean(n.src) for n in all_nodes if n.kind == Kind.EXP)
+
+    content = '\n\n'.join(p for p in [header, imports, consts, setup, exports] if p.strip())
+
+    # Determine output path
+    if name:
+        out_path = Path(root) / name
+    else:
+        out_path = Path(root) / cfg.out / meta['name'].replace('-', '_') / '__init__.py'
+
+    out_path.parent.mkdir(parents=True, exist_ok=True)
+    out_path.write_text(content)
+    return f"Bundled to {out_path}"
+
+def bundle_notebook(root='.', name=None, include_cells=False):
+    "Bundle all notebooks into a single marimo notebook file."
+    cfg = read_config(root)
+    nbs_dir = Path(root) / cfg.nbs
+
+    # Get ordered notebook files (skip XX_ and test_)
+    files = sorted(f for f in nbs_dir.glob('*.py')
+                   if not any(f.name.startswith(p) for p in cfg.skip_prefixes))
+    nb_stems = {f.stem for f in files}
+
+    # Decorators to keep
+    keep = {'app.function', 'app.class_definition'}
+    if include_cells: keep.add('app.cell')
+
+    setup_lines = []
+    cells = []
+
+    for f in files:
+        txt = f.read_text()
+        tree = ast.parse(txt)
+        lines = txt.splitlines()
+
+        for node in tree.body:
+            # Collect setup block contents
+            if isinstance(node, ast.With):
+                for s in node.body:
+                    line = ast.get_source_segment(txt, s)
+                    if not line: continue
+                    # Skip cross-notebook imports
+                    if any(nb in line for nb in nb_stems): continue
+                    if line.strip() not in setup_lines: setup_lines.append(line.strip())
+
+            # Collect decorated cells
+            elif isinstance(node, (ast.FunctionDef, ast.AsyncFunctionDef, ast.ClassDef)):
+                src = ast.get_source_segment(txt, node)
+                if not src: continue
+                # Check decorators
+                dec_names = []
+                for d in getattr(node, 'decorator_list', []):
+                    if isinstance(d, ast.Attribute): dec_names.append(f"{ast.unparse(d)}")
+                    elif isinstance(d, ast.Name): dec_names.append(d.id)
+                if any(d in keep for d in dec_names):
+                    # Reconstruct with decorators
+                    dec_lines = [lines[d.lineno - 1] for d in node.decorator_list]
+                    block = '\n'.join(dec_lines) + '\n' + src
+                    cells.append(block)
+
+    # Check for name collisions
+    seen = {}
+    for f in files:
+        txt = f.read_text()
+        tree = ast.parse(txt)
+        for node in tree.body:
+            if not isinstance(node, (ast.FunctionDef, ast.AsyncFunctionDef, ast.ClassDef)): continue
+            if node.name.startswith('_'): continue
+            if node.name in seen:
+                raise ValueError(f"Name collision: '{node.name}' defined in both {seen[node.name]} and {f.name}")
+            seen[node.name] = f.name
+
+    # Build output
+    meta = read_meta(root)
+    header = f'import marimo\n\n__generated_with = "0.20.4"\napp = marimo.App(width="full")\n'
+    setup = 'with app.setup:\n' + '\n'.join(f'    {l}' for l in setup_lines)
+    body = '\n\n\n'.join(cells)
+    footer = 'if __name__ == "__main__":\n    app.run()'
+
+    content = '\n\n'.join([header, setup, body, footer]) + '\n'
+
+    out_path = Path(root) / (name or f"{meta['name'].replace('-', '_')}_bundled.py")
+    out_path.parent.mkdir(parents=True, exist_ok=True)
+    out_path.write_text(content)
+    return f"Bundled notebook to {out_path}"

{marimo_dev-0.2.8 → marimo_dev-0.3.0}/src/marimo_dev/core.py

@@ -21,8 +21,9 @@ def read_config(root='.'):
 
 class Kind(Enum):
     "Types of nodes in parsed code"
-    IMP='import'    # Import statement
-    CONST='const'   # Constant definition
+    IMP='import'
+    CONST='const'
+    SETUP='setup'
     EXP='export'
 
 @dataclass

marimo_dev-0.3.0/src/marimo_dev/docs.py

@@ -0,0 +1,310 @@
+from .core import Kind, Param, Node, Config, read_config
+from .read import scan, nb_name, read_meta
+from .pkg import clean
+from .build import bundle_notebook
+from pathlib import Path
+import ast, re, os
+import marimo as mo
+from functools import partial
+from fastcore.xml import Span, Code, Li, Article, Div, Ul, P, FT, to_xml, Pre, Link, A, Iframe, Button, H1, H2, H3, Nav, Aside, Header, Input, NotStr, Strong, Main
+from fasthtml.components import ft, Html, Head, Script, Body, show, Style, Title
+
+icons = {'home': '<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-house-icon lucide-house"><path d="M15 21v-8a1 1 0 0 0-1-1h-4a1 1 0 0 0-1 1v8"/><path d="M3 10a2 2 0 0 1 .709-1.528l7-6a2 2 0 0 1 2.582 0l7 6A2 2 0 0 1 21 10v9a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2z"/></svg>', 'pypi': '<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-blocks-icon lucide-blocks"><path d="M10 22V7a1 1 0 0 0-1-1H4a2 2 0 0 0-2 2v12a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2v-5a1 1 0 0 0-1-1H2"/><rect x="14" y="2" width="8" height="8" rx="1"/></svg>', 'menu': '<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-menu-icon lucide-menu"><path d="M4 5h16"/><path d="M4 12h16"/><path d="M4 19h16"/></svg>', 'x': '<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-x-icon lucide-x"><path d="M18 6 6 18"/><path d="m6 6 12 12"/></svg>', 'github': '<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-github-icon lucide-github"><path d="M15 22v-4a4.8 4.8 0 0 0-1-3.5c3 0 6-2 6-5.5.08-1.25-.27-2.48-1-3.5.28-1.15.28-2.35 0-3.5 0 0-1 0-3 1.5-2.64-.5-5.36-.5-8 0C6 2 5 2 5 2c-.3 1.15-.3 2.35 0 3.5A5.403 5.403 0 0 0 4 9c0 3.5 3 5.5 6 5.5-.39.49-.68 1.05-.85 1.65-.17.6-.22 1.23-.15 1.85v4"/><path d="M9 18c-4.51 2-5-2-7-2"/></svg>', 'code': '<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-code-icon lucide-code"><path d="m16 18 6-6-6-6"/><path d="m8 6-6 6 6 6"/></svg>', 'info': '<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-info-icon lucide-info"><circle cx="12" cy="12" r="10"/><path d="M12 16v-4"/><path d="M12 8h.01"/></svg>', 'calendar': '<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-calendar1-icon lucide-calendar-1"><path d="M11 14h1v4"/><path d="M16 2v4"/><path d="M3 10h18"/><path d="M8 2v4"/><rect x="3" y="4" width="18" height="18" rx="2"/></svg>', 'circle-x': '<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-circle-x-icon lucide-circle-x"><circle cx="12" cy="12" r="10"/><path d="m15 9-6 6"/><path d="m9 9 6 6"/></svg>', 'external-link': '<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-external-link-icon lucide-external-link"><path d="M15 3h6v6"/><path d="M10 14 21 3"/><path d="M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6"/></svg>'}
+COLORS = {'keyword': '#c792ea', 'string': '#c3e88d', 'builtin': '#82aaff', 'decorator': '#f78c6c', 'comment': '#546e7a', 'number': '#f78c6c', 'punctuation': '#89ddff', 'defname': '#82aaff', 'classname': '#ffcb6b', 'operator': '#89ddff', 'call': '#82aaff', 'fstring': '#c3e88d', 'type': '#ffcb6b'}
+
+def nb_path(
+    mod_name, 
+    root='.'
+):
+    '''[TODO] '''
+    cfg = read_config(root)
+    for f in (Path(root) / cfg.nbs).glob('*.py'):
+        if nb_name(f, root) == mod_name: return f.relative_to(root)
+    return None
+
+def render_node(n, repo_url=None, root='.'):
+    '''Builds a `node` for docs'''
+    t = 'class' if 'class ' in n.src else 'async' if n.src.lstrip().startswith('async ') else 'func'
+    signature = clean(n.src)
+    node_id = f"code-{n.module}-{n.name}"
+    nb = nb_path(n.module, root)
+    tag_colors = {'func': '#10b981', 'async': '#f59e0b', 'class': '#8b5cf6'}
+
+    code_lines = [Span(line, cls="code-line") for line in signature.split('\n')]
+
+    def ghbtn(icon, label, url):
+        if not url: return None
+        return A(Button(Icon(icon, size=16), label, cls="gh-btn"), href=url, target="_blank", cls="gh-link")
+
+    tag = Span(t, cls="tag", style=f"background:{tag_colors.get(t, '#666')};")
+    mod_name = Span(Span(f"{n.module}.", cls="mod"), Span(n.name, cls="name"), cls="full-name") if n.module else Span(n.name, cls="full-name name")
+
+    copy_btn = Button("📋", cls="copy-btn", onclick=f"navigator.clipboard.writeText(document.getElementById('{node_id}').textContent).then(() => this.textContent = '✓').then(() => setTimeout(() => this.textContent = '📋', 1500))")
+    source_btn = ghbtn('github', 'Source', f"{repo_url}/blob/master/{nb}#L{n.lineno}" if repo_url and nb and n.lineno else None)
+    edit_btn = ghbtn('code', 'Edit', f"{repo_url}/edit/master/{nb}" if repo_url and nb else None)
+    blame_btn = ghbtn('info', 'Blame', f"{repo_url}/blame/master/{nb}#L{n.lineno}" if repo_url and nb and n.lineno else None)
+    history_btn = ghbtn('calendar', 'History', f"{repo_url}/commits/master/{nb}" if repo_url and nb else None)
+    issue_btn = ghbtn('circle-x', 'Issue', f"{repo_url}/issues/new?title=Issue%20with%20{n.name}&body={repo_url}/blob/master/{nb}%23L{n.lineno}" if repo_url and nb and n.lineno else None)
+
+    return Article(
+        Style("""
+            me { margin-bottom: 0.75rem; border-radius: 8px; overflow: hidden; background: #1e1e1e; max-width: 100%; }
+            me .header { display: flex; justify-content: space-between; align-items: center; padding: 0.75rem 1rem; }
+            me .header-left { display: flex; align-items: center; }
+            me .header-right { display: flex; align-items: center; gap: 0.5rem; }
+            me .tag { padding: 0.25rem 0.6rem; border-radius: 4px; font-size: 0.75rem; font-weight: 600; color: white; }
+            me .full-name { font-weight: 500; font-size: 1rem; margin-left: 0.75rem; }
+            me .mod { color: #666; }
+            me .name { color: #e5e5e5; }
+            me .doc { margin: 0; padding: 0 1rem 0.5rem 1rem; color: #888; font-size: 0.85rem; }
+            me .gh-btn { display: flex; align-items: center; gap: 0.25rem; background: #333; border: 1px solid #444; color: #ccc; padding: 0.25rem 0.5rem; border-radius: 4px; cursor: pointer; font-size: 0.75rem; }
+            me .gh-link { text-decoration: none; }
+            me .copy-btn { background: transparent; border: none; cursor: pointer; font-size: 0.9rem; padding: 0.25rem; }
+            me pre { background: #1a1a1a; border-top: 1px solid #2a2a2a; margin: 0; padding: 0.5rem 0; }
+            me code { counter-reset: line; font-size: 0.8rem; line-height: 1.6; color: #ccc; }
+            me .code-line { display: block; padding-left: 3.5em; white-space: pre-wrap; word-break: break-all; position: relative; }
+            me .code-line::before { content: counter(line); counter-increment: line; position: absolute; left: 0; width: 2.5em; text-align: right; color: #555; user-select: none; }
+        """),
+        Div(Div(tag, mod_name, cls="header-left"),
+            Div(copy_btn, source_btn, edit_btn, blame_btn, history_btn, issue_btn, cls="header-right"),
+            cls="header"),
+        P(n.doc, cls="doc") if n.doc else None,
+        Pre(Code(*code_lines, cls="language-python", id=node_id)))
+
+def render_module_page(mod_name, mod_nodes, all_mod_names, meta, root='.'):
+    '''Builds a Module Page'''
+    repo_url = meta.get('urls', {}).get('Repository')
+    exp_nodes = [n for n in mod_nodes if n.kind == Kind.EXP]
+
+    head_elements = [
+        Script(type="module", src="https://cdn.jsdelivr.net/gh/starfederation/datastar@1.0.0-RC.8/bundles/datastar.js"),
+        Script(src="https://cdn.jsdelivr.net/gh/gnat/css-scope-inline@main/script.js"),
+        Script(src="js/highlight.js", type="module"),
+        Style("body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; margin: 0; } code { font-family: 'SF Mono', Consolas, monospace; }"),
+        Title(f"{mod_name} - {meta['name']}")]
+
+    nav_links = [Li(A("← Index", href="index.html", cls="back-link"))] + [
+        Li(A(m, href=f"{m}.html", cls=f"nav-link {'active' if m == mod_name else ''}")) for m in all_mod_names]
+
+    nav = Nav(
+        Style("""
+            me { padding: 1rem; background: #1a1a1a; min-width: 180px; }
+            me h3 { margin: 0 0 1rem 0; color: #fff; }
+            me ul { list-style: none; padding: 0; margin: 0; }
+            me .back-link { color: #888; text-decoration: none; font-size: 0.85rem; }
+            me .back-link:hover { color: #fff; }
+            me .nav-link { color: #aaa; text-decoration: none; }
+            me .nav-link:hover { color: #fff; }
+            me .nav-link.active { color: #fff; }
+            me input { width: 100%; padding: 0.5rem; border: 1px solid #333; border-radius: 4px; background: #252525; color: #fff; margin-bottom: 1rem; box-sizing: border-box; }
+        """),
+        H3(meta['name']),
+        Input(type="text", placeholder="Search...", **{"data-bind": "search"}),
+        Ul(*nav_links))
+
+    header = Header(
+        Style("""
+            me { padding: 1rem; background: #1e1e1e; border-bottom: 1px solid #333; }
+            me .header-row { display: flex; align-items: center; justify-content: space-between; }
+            me h1 { margin: 0; font-size: 1.5rem; color: #fff; }
+            me .wasm-btn { display: flex; align-items: center; gap: 0.25rem; background: #333; border: 1px solid #444; color: #ccc; padding: 0.5rem 0.75rem; border-radius: 4px; cursor: pointer; font-size: 0.85rem; }
+            me .wasm-link { text-decoration: none; }
+        """),
+        Div(H1(mod_name),
+            A(Button(Icon('external-link', size=16), "Run in Browser", cls="wasm-btn"),
+              href=f"wasm/{mod_name}/index.html", target="_blank", cls="wasm-link"),
+            cls="header-row"))
+
+    content = Div(
+        Style("""
+            me { padding: 1rem; background: #121212; overflow-y: auto; flex: 1; }
+        """),
+        *[render_node(n, repo_url, root) for n in exp_nodes])
+
+    body = Body(nav,
+        Div(header, content, style="flex: 1; display: flex; flex-direction: column;"),
+        style="display: flex; height: 100vh; margin: 0; background: #121212;",
+        **{"data-signals": "{search: ''}"})
+
+    return Html(Head(*head_elements), body)
+
+def build_docs(
+    root='.'    # the project root (this should never really change)
+):
+    '''Builds the static documentation website'''
+    cfg = read_config(root)
+    meta = read_meta(root)
+    _, mods = scan(root)
+    mod_names = [name for name, _ in mods]
+    docs_path = Path(root) / cfg.docs
+    docs_path.mkdir(exist_ok=True)
+    (docs_path / "index.html").write_text(to_xml(render_index_page(meta, mods)))
+    for mod_name, mod_nodes in mods:
+        (docs_path / f"{mod_name}.html").write_text(to_xml(render_module_page(mod_name, mod_nodes, mod_names, meta, root)))
+    export_wasm(root)
+    return f"Generated index + {len(mods)} module pages in {docs_path}"
+
+def export_wasm(
+    root='.'  # Project Root
+):
+    """Uses the bundeled notebook to make a WASM marimo notebook"""
+    cfg = read_config(root)
+    wasm_dir = Path(root) / cfg.docs / 'wasm'
+    wasm_dir.mkdir(parents=True, exist_ok=True)
+    bundled = Path(root) / cfg.nbs / '_bundled.py'
+    bundle_notebook(root, name=str(bundled))
+    os.system(f"marimo export html-wasm {bundled} -o {wasm_dir} --mode edit")
+    bundled.unlink()
+
+def write_nojekyll(root='.'):
+    cfg = read_config(root)
+    Path(root, cfg.docs, '.nojekyll').touch()
+
+def html_preview(width='100%', height='300px'):
+    "Display FT components in an IFrame"
+    def _preview(*components): show(Iframe(srcdoc=to_xml(components[0] if len(components) == 1 else Div(*components)), width=width, height=height))
+    return _preview
+
+def render_index_page(meta, mods, repo_url=None):
+    mod_names = [name for name, _ in mods]
+    head_elements = [
+        Script(type="module", src="https://cdn.jsdelivr.net/gh/starfederation/datastar@1.0.0-RC.7/bundles/datastar.js"),
+        Script(src="https://cdn.jsdelivr.net/gh/gnat/css-scope-inline@main/script.js"),
+        Script(src="js/highlight.js", type="module"),
+        Style("body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; margin: 0; } code { font-family: 'SF Mono', Consolas, monospace; }"),
+        Title(meta['name'])]
+
+    nav_links = [Li(A(m, href=f"{m}.html", cls="nav-link")) for m in mod_names]
+
+    nav = Nav(
+        Style("""
+            me { padding: 1rem; background: #1a1a1a; min-width: 180px; }
+            me h3 { margin: 0 0 1rem 0; color: #fff; }
+            me ul { list-style: none; padding: 0; margin: 0; }
+            me .nav-link { color: #aaa; text-decoration: none; }
+            me .nav-link:hover { color: #fff; }
+        """),
+        H3(meta['name']),
+        Ul(*nav_links))
+
+    module_cards = [A(
+        Div(H3(name, cls="card-title"),
+            P(f"{len([n for n in nodes if n.kind == Kind.EXP])} exports", cls="card-count"),
+            cls="card"),
+        href=f"{name}.html", cls="card-link")
+        for name, nodes in mods]
+
+    content = Div(
+        Style("""
+            me { padding: 2rem; flex: 1; }
+            me h1 { margin: 0 0 0.5rem 0; color: #fff; }
+            me .desc { color: #888; margin: 0 0 2rem 0; }
+            me .version { color: #666; margin: 0 0 2rem 0; font-size: 0.9rem; }
+            me h2 { color: #fff; margin: 0 0 1rem 0; font-size: 1.2rem; }
+            me .grid { display: grid; grid-template-columns: repeat(auto-fill, minmax(200px, 1fr)); gap: 1rem; }
+            me .card-link { text-decoration: none; }
+            me .card { padding: 1rem; background: #1e1e1e; border-radius: 8px; }
+            me .card:hover { background: #252525; }
+            me .card-title { margin: 0 0 0.5rem 0; color: #fff; }
+            me .card-count { margin: 0; color: #888; }
+        """),
+        H1(meta['name']),
+        P(meta['desc'], cls="desc"),
+        P(f"Version {meta['version']}", cls="version"),
+        H2("Modules"),
+        Div(*module_cards, cls="grid"))
+
+    body = Body(nav, content, style="display: flex; min-height: 100vh; margin: 0; background: #121212;")
+    return Html(Head(*head_elements), body)
+
+def Icon(name: str,            # name of the icon MUST be in icon_dict
+         size=24,              # value to be passed to height and width of the icon
+         stroke=1.5,           # stroke width 
+         cls=None,             # css class
+         icon_dict:dict=icons, # Dict of icons {"name":"<svg...>"}
+         **kwargs              # passed to through to FT 
+        ) -> 'Any':            # Follow recomendation from fastHTML docs
+    '''
+    Creates a custom html compliant <icon-{name}>... 
+    Intended to be used with a Global Dict of icons {"home": "<svg...", "info": "<svg..."} 
+    Icon('home') -> <icon-home> ....  </icon-home>
+    '''
+    if name not in icon_dict: raise ValueError(f"Icon '{name}' not found")
+
+    # count=1 Replace only the first occurrence of width & height 99% of time this is what you want
+    svg_string = icon_dict[name]
+    svg_string = re.sub(r'width="\d+"', f'width="{size}"', svg_string, count=1)
+    svg_string = re.sub(r'height="\d+"', f'height="{size}"', svg_string, count=1)
+    svg_string = re.sub(r'stroke-width="\d+"', f'stroke-width="{stroke}"', svg_string)
+
+    return ft(f'icon-{name}', NotStr(svg_string), cls=cls, **kwargs)
+
+def write_highlighter(root='.'):
+    "Write Python syntax highlighter JS to docs folder."
+    cfg = read_config(root)
+    js_dir = Path(root) / cfg.docs / 'js'
+    js_dir.mkdir(parents=True, exist_ok=True)
+
+    tokens = [
+        ('py-decorator',   r'@[\w.]+'),
+        ('py-defname',     r'(?<=def )\w+'),
+        ('py-classname',   r'(?<=class )\w+'),
+        ('py-keyword',     r'\b(?:def|class|return|if|elif|else|for|while|import|from|as|with|try|except|finally|raise|yield|async|await|pass|break|continue|in|is|not|and|or|lambda|None|True|False|self)\b'),
+        ('py-builtin',     r'\b(?:print|len|range|list|dict|set|tuple|int|str|float|bool|isinstance|hasattr|getattr|setattr|enumerate|zip|map|filter|any|all|sorted|reversed|super|type|open|next)\b'),
+        ('py-call',        r'\b\w+(?=\()'),
+        ('py-number',      r'\b\d[\d_]*(?:\.\d[\d_]*)?(?:e[+-]?\d+)?\b'),
+        ('py-operator',    r'->|==|!=|<=|>=|\*\*|\/\/|[+\-*/%=<>&|^~]'),
+        ('py-punctuation', r'[{}\(\)\[\]:,;]'),
+        ('py-fstring',     r"f(?='|\")"),
+        ('py-type',        r'(?<=: )\w+'),
+        ('py-string',      r'"""[\s\S]*?"""|\'\'\'[\s\S]*?\'\'\'|"[^"\n]*"|\'[^\'\n]*\''),
+        ('py-comment',     r'#.*'),
+    ]
+
+
+    token_js = ',\n  '.join(f"['{name}', /{pattern}/g]" for name, pattern in tokens)
+    color_css = '\n'.join(f'::highlight({name}) {{ color: {COLORS[name.replace("py-", "")]}; }}' for name, _ in tokens)
+
+    js = f"""const PY_TOKENS = [
+  {token_js}
+];
+
+function highlightAll(root = document) {{
+  if (!CSS?.highlights) return;
+  for (const [name] of PY_TOKENS) CSS.highlights.delete(name);
+  root.querySelectorAll('pre code').forEach(code => {{
+    const textNodes = [];
+    code.querySelectorAll('.code-line').forEach(line => {{
+        if (line.firstChild?.nodeType === Node.TEXT_NODE) textNodes.push(line.firstChild);
+    }});
+    if (!textNodes.length) return;
+
+    for (const [name, pattern] of PY_TOKENS) {{
+      const highlight = CSS.highlights.get(name) ?? new Highlight();
+      for (const node of textNodes) {{
+        const src = node.textContent;
+        const re = new RegExp(pattern.source, pattern.flags);
+        for (const match of src.matchAll(re)) {{
+          const range = new Range();
+          range.setStart(node, match.index);
+          range.setEnd(node, match.index + match[0].length);
+          highlight.add(range);
+        }}
+      }}
+      if (highlight.size > 0) CSS.highlights.set(name, highlight);
+    }}
+  }});
+}}
+
+// Inject highlight styles
+const style = document.createElement('style');
+style.textContent = `{color_css}`;
+document.head.appendChild(style);
+
+if (document.readyState === 'loading') document.addEventListener('DOMContentLoaded', () => highlightAll());
+else highlightAll();
+"""
+
+
+    (js_dir / 'highlight.js').write_text(js)
+    return f"Wrote {js_dir}/highlight.js"

{marimo_dev-0.2.8 → marimo_dev-0.3.0}/src/marimo_dev/pkg.py

@@ -23,7 +23,7 @@ def write_mod(
     "Write module file with imports, constants, and exports."
     g = {k: [n for n in nodes if n.kind == k] for k in Kind}
     imports = '\n'.join(rewrite_imports(n.src, mod_names) for n in g[Kind.IMP])
-    parts = [imports, '\n'.join(n.src for n in g[Kind.CONST]), '\n\n'.join(clean(n.src) for n in g[Kind.EXP])]
+    parts = [imports, '\n'.join(n.src for n in g[Kind.CONST]), '\n'.join(n.src for n in g[Kind.SETUP]), '\n\n'.join(clean(n.src) for n in g[Kind.EXP])]
     write(path, *parts)
 
 def rewrite_imports(

marimo_dev-0.3.0/src/marimo_dev/publish.py

@@ -0,0 +1,93 @@
+import subprocess, configparser, shutil
+from pathlib import Path
+from .build import build
+
+CREDENTIALS = {'testpypi': {'file': '~/.pypirc', 'section': 'testpypi', 'key_field': 'password', 'prefix': 'pypi-', 'url': 'https://test.pypi.org/manage/account/'}, 'pypi': {'file': '~/.pypirc', 'section': 'pypi', 'key_field': 'password', 'prefix': 'pypi-', 'url': 'https://pypi.org/manage/account/'}, 'github': {'cmd': 'gh auth status', 'url': 'https://github.com/settings/tokens'}}
+
+def check_credentials(platform='testpypi'):
+    "Check if credentials exist for a platform and return status info."
+    cred = CREDENTIALS.get(platform)
+    if not cred: return {'found': False, 'msg': f"Unknown platform: {platform}"}
+
+    url = cred['url']
+
+    # Command-based check (e.g. GitHub)
+    if 'cmd' in cred:
+        try:
+            r = subprocess.run(cred['cmd'].split(), capture_output=True, text=True)
+            if r.returncode == 0:
+                return {'found': True, 'platform': platform, 'msg': r.stdout.strip(), 'source': cred['cmd']}
+            return {'found': False, 'msg': f"Not authenticated. Set up at {url}"}
+        except FileNotFoundError:
+            return {'found': False, 'msg': f"CLI not installed. Get it at {url}"}
+
+    # File-based check (e.g. PyPI)
+    path = Path(cred['file']).expanduser()
+    if not path.exists():
+        return {'found': False, 'msg': f"No {cred['file']} found. Create a token at {url}"}
+
+    config = configparser.ConfigParser()
+    config.read(path)
+    section = cred['section']
+
+    if section not in config:
+        return {'found': False, 'msg': f"No [{section}] section in {cred['file']}. Create a token at {url}"}
+
+    password = config[section].get(cred['key_field'], '')
+    if not password:
+        return {'found': False, 'msg': f"No {cred['key_field']} in [{section}]. Create a token at {url}"}
+
+    prefix = cred.get('prefix', '')
+    preview = password[:len(prefix)+4] + '...' if password.startswith(prefix) else '****'
+    return {'found': True, 'platform': platform, 'username': config[section].get('username', ''), 'preview': preview, 'source': str(path)}
+
+def check_pypi_auth(test=True):
+    "Check if PyPI credentials exist and return status info."
+    pypirc = Path.home() / '.pypirc'
+    section = 'testpypi' if test else 'pypi'
+    target = 'Test PyPI' if test else 'PyPI'
+    url = 'https://test.pypi.org/manage/account/' if test else 'https://pypi.org/manage/account/'
+
+    if not pypirc.exists():
+        return {'found': False, 'msg': f"No ~/.pypirc found. Create a token at {url}"}
+
+    config = configparser.ConfigParser()
+    config.read(pypirc)
+
+    if section not in config:
+        return {'found': False, 'msg': f"No [{section}] section in ~/.pypirc. Create a token at {url}"}
+
+    password = config[section].get('password', '')
+    if not password:
+        return {'found': False, 'msg': f"No password in [{section}]. Create a token at {url}"}
+
+    preview = password[:9] + '...' if password.startswith('pypi-') else '****'
+    return {'found': True, 'section': section, 'username': config[section].get('username', ''), 'preview': preview, 'source': str(pypirc)}
+
+def publish(
+    test:bool=True, # Use Test PyPI if True, real PyPI if False
+):
+    "Build and publish package to PyPI. Looks for ~/.pypirc for credentials, otherwise prompts."
+
+    print("Rebuilding package from notebooks...")
+    build()
+
+    shutil.rmtree('dist', ignore_errors=True)
+    print("Building distribution...")
+    subprocess.run(['uv', 'build'], check=True)
+
+    pypirc, cmd = Path.home() / '.pypirc', ['uv', 'publish']
+    section = 'testpypi' if test else 'pypi'
+
+    if test: cmd.extend(['--publish-url', 'https://test.pypi.org/legacy/'])
+    else: cmd.extend(['--publish-url', 'https://upload.pypi.org/legacy/'])
+
+    if pypirc.exists():
+        config = configparser.ConfigParser()
+        config.read(pypirc)
+        if section in config:
+            username, password = config[section].get('username', '__token__'), config[section].get('password', '')
+            cmd.extend(['--username', username, '--password', password])
+
+    print(f"Publishing to {'Test ' if test else ''}PyPI...")
+    subprocess.run(cmd, check=True)

{marimo_dev-0.2.8 → marimo_dev-0.3.0}/src/marimo_dev/read.py

@@ -123,8 +123,11 @@ def parse_node(
     if isinstance(n, ast.With):
         for s in n.body:
             if (node := parse_import(s, ls)): yield node
-            if (node := parse_const(s, ls)): yield node
-                
+            elif (node := parse_const(s, ls)): yield node
+            else: yield Node(Kind.SETUP, 
+                             getattr(s, 'name', '_setup'), 
+                             ast.get_source_segment(src, s) or ast.unparse(s)
+                            )
     # Handle export-named cells (e.g. def export(): or def export_main():)
     if isinstance(n, ast.FunctionDef) and n.name.startswith('export'):
         # Check it's decorated with @app.cell, not @app.function

marimo_dev-0.2.8/src/marimo_dev/build.py

@@ -1,119 +0,0 @@
-from .core import Kind, Param, Node, Config, read_config
-from .read import scan, read_meta
-from .pkg import write_mod, write_init, clean
-from .docs import write_llms
-from pathlib import Path
-import ast, shutil, re, sys
-
-IMPORT_TO_PYPI = {'bs4': 'beautifulsoup4', 'PIL': 'pillow', 'cv2': 'opencv-python', 'sklearn': 'scikit-learn', 'yaml': 'pyyaml'}
-
-def build(
-    root='.',  # root directory containing pyproject.toml
-)->str:        # path to built package
-    "Build a Python package from notebooks."
-    cfg = read_config(root)
-    meta, mods = scan(root)
-    mod_names = [name for name, _ in mods]
-    pkg = Path(root) / cfg.out / meta['name'].replace('-', '_')
-    if pkg.exists(): shutil.rmtree(pkg)
-    pkg.mkdir(parents=True, exist_ok=True)
-    for name, nodes in mods:
-        stripped = re.sub(r'^[a-z]_', '', name)
-        if stripped != 'index' and any(n.kind == Kind.EXP for n in nodes): write_mod(pkg/f'{stripped}.py', nodes, mod_names)
-    write_init(pkg/'__init__.py', meta, mods)
-    all_exp = [n for _, nodes in mods for n in nodes if n.kind == Kind.EXP]
-    if all_exp: write_llms(meta, all_exp)
-    return str(pkg)
-
-def tidy():
-    "Remove cache and temporary files (__pycache__, __marimo__, .pytest_cache, etc)."
-    import shutil
-    for p in Path('.').rglob('__pycache__'): shutil.rmtree(p, ignore_errors=True)
-    for p in Path('.').rglob('__marimo__'): shutil.rmtree(p, ignore_errors=True)
-    for p in Path('.').rglob('.pytest_cache'): shutil.rmtree(p, ignore_errors=True)
-    for p in Path('.').rglob('*.pyc'): p.unlink(missing_ok=True)
-    print("Cleaned cache files")
-
-def nuke():
-    "Remove all build artifacts (dist, docs, src) and cache files."
-    import shutil
-    tidy()
-    for d in ['dist', 'docs', 'src', 'temp']: shutil.rmtree(d, ignore_errors=True)
-    print("Nuked build artifacts")
-
-def get_pypi_name(import_name):
-    "Map import name to PyPI package name."
-    root = import_name.split('.')[0]
-    return IMPORT_TO_PYPI.get(root, root)
-
-def extract_import_names(nodes):
-    "Extract top-level module names from import nodes."
-    names = set()
-    for n in nodes:
-        if n.kind != Kind.IMP: continue
-        tree = ast.parse(n.src)
-        for stmt in ast.walk(tree):
-            if isinstance(stmt, ast.Import):
-                for alias in stmt.names:
-                    names.add(alias.name.split('.')[0])
-            elif isinstance(stmt, ast.ImportFrom) and stmt.module:
-                names.add(stmt.module.split('.')[0])
-    return names
-
-def pep723_header(deps):
-    "Generate PEP 723 inline script metadata."
-    deps_str = ', '.join(f'"{d}"' for d in sorted(deps))
-    return f'# /// script\n# dependencies = [{deps_str}]\n# ///\n'
-
-def bundle(root='.', name=None):
-    "Bundle all notebooks into a single Python file with PEP 723 dependencies."
-    cfg = read_config(root)
-    meta, mods = scan(root)
-    
-    # Get notebook filenames to filter out local imports
-    nbs_dir = Path(root) / cfg.nbs
-    nb_names = {f.stem for f in nbs_dir.glob('*.py')}
-    
-    # Collect all nodes
-    all_nodes = [n for _, nodes in mods for n in nodes]
-    
-    # Extract dependencies
-    import_names = extract_import_names(all_nodes)
-    mod_names = [m for m, _ in mods]
-    
-    # Filter out local modules, notebook names, and stdlib
-    external = {get_pypi_name(n) for n in import_names 
-                if n not in mod_names 
-                and n not in nb_names 
-                and n not in sys.stdlib_module_names}
-    
-    # Build output
-    header = pep723_header(external)
-
-    # Filter out local imports, dedupe externals
-    seen = set()
-    filtered_imports = []
-    for n in all_nodes:
-        if n.kind != Kind.IMP: continue
-        # Skip if it's a local notebook import
-        if any(nb in n.src for nb in nb_names): continue
-        if n.src not in seen:
-            seen.add(n.src)
-            filtered_imports.append(n.src)
-    
-    imports = '\n'.join(filtered_imports)
-    
-    consts = '\n'.join(n.src for n in all_nodes if n.kind == Kind.CONST)
-    exports = '\n\n'.join(clean(n.src) for n in all_nodes if n.kind == Kind.EXP)
-    
-    content = '\n\n'.join(p for p in [header, imports, consts, exports] if p.strip())
-    
-    # Determine output path
-    if name:
-        out_path = Path(root) / name
-    else:
-        out_path = Path(root) / cfg.out / meta['name'].replace('-', '_') / '__init__.py'
-    
-    out_path.parent.mkdir(parents=True, exist_ok=True)
-    out_path.write_text(content)
-    return f"Bundled to {out_path}"

marimo_dev-0.2.8/src/marimo_dev/docs.py

@@ -1,236 +0,0 @@
-from .core import Kind, Param, Node, Config, read_config
-from .read import scan, nb_name, read_meta
-from pathlib import Path
-import ast, re, os
-import marimo as mo
-from functools import partial
-from fastcore.xml import Span, Code, Li, Article, Div, Ul, P, FT, to_xml, Pre, Link, A, Iframe, Button, H1, H2, H3, Nav, Aside, Header, Input, NotStr, Strong, Main
-from fasthtml.components import ft, Html, Head, Script, Body, show, Style, Title
-
-icons = {'home': '<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-house-icon lucide-house"><path d="M15 21v-8a1 1 0 0 0-1-1h-4a1 1 0 0 0-1 1v8"/><path d="M3 10a2 2 0 0 1 .709-1.528l7-6a2 2 0 0 1 2.582 0l7 6A2 2 0 0 1 21 10v9a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2z"/></svg>', 'pypi': '<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-blocks-icon lucide-blocks"><path d="M10 22V7a1 1 0 0 0-1-1H4a2 2 0 0 0-2 2v12a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2v-5a1 1 0 0 0-1-1H2"/><rect x="14" y="2" width="8" height="8" rx="1"/></svg>', 'menu': '<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-menu-icon lucide-menu"><path d="M4 5h16"/><path d="M4 12h16"/><path d="M4 19h16"/></svg>', 'x': '<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-x-icon lucide-x"><path d="M18 6 6 18"/><path d="m6 6 12 12"/></svg>', 'github': '<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-github-icon lucide-github"><path d="M15 22v-4a4.8 4.8 0 0 0-1-3.5c3 0 6-2 6-5.5.08-1.25-.27-2.48-1-3.5.28-1.15.28-2.35 0-3.5 0 0-1 0-3 1.5-2.64-.5-5.36-.5-8 0C6 2 5 2 5 2c-.3 1.15-.3 2.35 0 3.5A5.403 5.403 0 0 0 4 9c0 3.5 3 5.5 6 5.5-.39.49-.68 1.05-.85 1.65-.17.6-.22 1.23-.15 1.85v4"/><path d="M9 18c-4.51 2-5-2-7-2"/></svg>', 'code': '<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-code-icon lucide-code"><path d="m16 18 6-6-6-6"/><path d="m8 6-6 6 6 6"/></svg>', 'info': '<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-info-icon lucide-info"><circle cx="12" cy="12" r="10"/><path d="M12 16v-4"/><path d="M12 8h.01"/></svg>', 'calendar': '<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-calendar1-icon lucide-calendar-1"><path d="M11 14h1v4"/><path d="M16 2v4"/><path d="M3 10h18"/><path d="M8 2v4"/><rect x="3" y="4" width="18" height="18" rx="2"/></svg>', 'circle-x': '<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-circle-x-icon lucide-circle-x"><circle cx="12" cy="12" r="10"/><path d="m15 9-6 6"/><path d="m9 9 6 6"/></svg>', 'external-link': '<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-external-link-icon lucide-external-link"><path d="M15 3h6v6"/><path d="M10 14 21 3"/><path d="M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6"/></svg>'}
-
-def cls_sig(
-    n:Node,           # the node to generate signature for
-    dataclass=False,  # whether to include @dataclass decorator
-)->str:               # formatted class signature
-    "Generate a class signature string."
-    header = f"@dataclass\nclass {n.name}:" if dataclass else f"class {n.name}:"
-    lines = [header]
-    if n.doc: lines.append(f'    """{n.doc}"""')
-    for p in n.params:
-        attr = f"    {p.name}{f': {p.anno}' if p.anno else ''}{f' = {p.default}' if p.default else ''}"
-        if p.doc: attr += f"  # {p.doc}"
-        lines.append(attr)
-    for m in n.methods:
-        ps = ', '.join(f"{p.name}{f': {p.anno}' if p.anno else ''}{f'={p.default}' if p.default else ''}" for p in m['params'])
-        ret = f" -> {m['ret'][0]}" if m['ret'] else ""
-        lines.append(f"    def {m['name']}({ps}){ret}:")
-        if m['doc']: lines.append(f'        """{m["doc"]}"""')
-    return '\n'.join(lines)
-
-def fn_sig(
-    n: Node,        # the node to generate signature for
-    is_async=False  # async ?
-)->str:             # formatted signature string
-    "Generate a function signature string with inline parameter documentation."
-    prefix = 'async def' if is_async else 'def'
-    ret = f" -> {n.ret[0]}" if n.ret else ""
-    if not n.params:
-        sig = f"{prefix} {n.name}(){ret}:"
-        return f'{sig}\n    """{n.doc}"""' if n.doc else sig
-    params = [f"    {p.name}{f': {p.anno}' if p.anno else ''}{f'={p.default}' if p.default else ''},{f'  # {p.doc}' if p.doc else ''}" for p in n.params]
-    params[-1] = params[-1].replace(',', '')
-    lines = [f"{prefix} {n.name}("] + params + [f"){ret}:"]
-    if n.doc: lines.append(f'    """{n.doc}"""')
-    return '\n'.join(lines)
-
-def sig(
-    n:Node, # the node to generate signature for
-)->str:     # formatted signature string
-    "Generate a signature string for a class or function node."
-    t = exp_type(n)
-    if t == 'class': return cls_sig(n, dataclass=n.src.lstrip().startswith('@dataclass'))
-    return fn_sig(n, is_async=t == 'async')
-
-def write_llms(
-    meta: dict,    # project metadata from pyproject.toml
-    nodes: list,   # list of Node objects to document
-    root: str='.'  # root directory containing pyproject.toml
-):
-    "Write API signatures to llms.txt file for LLM consumption."
-    cfg = read_config(root)
-    sigs = '\n\n'.join(sig(n) for n in nodes if not n.name.startswith('__') and 'nodoc' not in n.hash_pipes)
-    content = f"# {meta['name']}\n\n> {meta['desc']}\n\nVersion: {meta['version']}\n\n## API\n\n```python\n{sigs}\n```"
-    Path(cfg.docs).mkdir(exist_ok=True)
-    (Path(cfg.docs)/'llms.txt').write_text(content)
-
-def exp_type(n):
-    if n.methods or 'class ' in n.src: return 'class'
-    if n.src.lstrip().startswith('async def'): return 'async'
-    return 'func'
-
-def render_param(p):
-    parts = [Code(p.name)]
-    if p.anno: parts.append(Span(f": {p.anno}", style="color: #666;"))
-    if p.default: parts.append(Span(f" = {p.default}", style="color: #888;"))
-    if p.doc: parts.append(Span(f" — {p.doc}", style="color: #555; font-style: italic;"))
-    return Li(*parts)
-
-def nb_path(
-    mod_name, 
-    root='.'
-):
-    '''[TODO] '''
-    cfg = read_config(root)
-    for f in (Path(root) / cfg.nbs).glob('*.py'):
-        if nb_name(f, root) == mod_name: return f.relative_to(root)
-    return None
-
-def render_node(
-    n, 
-    repo_url=None, 
-    root='.'
-):
-    '''Builds a `node` for docs'''
-    t = exp_type(n)
-    signature = sig(n)
-    lines = signature.split('\n')
-    line_nums = '\n'.join(str(i+1) for i in range(len(lines)))
-    node_id = f"code-{n.module}-{n.name}"
-    tag_colors = {'func': '#10b981', 'async': '#f59e0b', 'class': '#8b5cf6'}
-    tag = Span(t, style=f"padding: 0.25rem 0.6rem; border-radius: 4px; font-size: 0.75rem; font-weight: 600; background: {tag_colors.get(t, '#666')}; color: white;")
-    full_name = Span(Span(f"{n.module}.", style="color: #666;"), Span(n.name, style="color: #e5e5e5;"), style="font-weight: 500; font-size: 1rem; margin-left: 0.75rem;") if n.module else Span(n.name, style="font-weight: 500; font-size: 1rem; color: #e5e5e5; margin-left: 0.75rem;")
-    nb = nb_path(n.module, root)
-    btn_style = "display: flex; align-items: center; gap: 0.25rem; background: #333; border: 1px solid #444; color: #ccc; padding: 0.25rem 0.5rem; border-radius: 4px; cursor: pointer; font-size: 0.75rem;"
-    link_style = "text-decoration: none;"
-    copy_btn = Button("📋", onclick=f"navigator.clipboard.writeText(document.getElementById('{node_id}').textContent).then(() => this.textContent = '✓').then(() => setTimeout(() => this.textContent = '📋', 1500))", style="background: transparent; border: none; cursor: pointer; font-size: 0.9rem; padding: 0.25rem;")
-    source_btn = A(Button(Icon('github', size=16), "Source", style=btn_style), href=f"{repo_url}/blob/master/{nb}#L{n.lineno}", target="_blank", style=link_style) if repo_url and nb and n.lineno else None
-    edit_btn = A(Button(Icon('code', size=16), "Edit", style=btn_style), href=f"{repo_url}/edit/master/{nb}", target="_blank", style=link_style) if repo_url and nb else None
-    blame_btn = A(Button(Icon('info', size=16), "Blame", style=btn_style), href=f"{repo_url}/blame/master/{nb}#L{n.lineno}", target="_blank", style=link_style) if repo_url and nb and n.lineno else None
-    history_btn = A(Button(Icon('calendar', size=16), "History", style=btn_style), href=f"{repo_url}/commits/master/{nb}", target="_blank", style=link_style) if repo_url and nb else None
-    issue_btn = A(Button(Icon('circle-x', size=16), "Issue", style=btn_style), href=f"{repo_url}/issues/new?title=Issue%20with%20{n.name}&body={repo_url}/blob/master/{nb}%23L{n.lineno}", target="_blank", style=link_style) if repo_url and nb else None
-
-    header = Div(
-        Div(tag, full_name, style="display: flex; align-items: center;"),
-        Div(copy_btn, source_btn, edit_btn, blame_btn, history_btn, issue_btn, style="display: flex; align-items: center; gap: 0.5rem;"),
-        style="display: flex; justify-content: space-between; align-items: center; padding: 0.75rem 1rem;")
-    doc_line = P(n.doc, style="margin: 0; padding: 0 1rem 0.5rem 1rem; color: #888; font-size: 0.85rem;") if n.doc else None
-    code_block = Div(
-        Pre(Code(line_nums), style="margin: 0; padding: 0; color: #555; text-align: right; user-select: none; font-size: 0.8rem; line-height: 1.6;"),
-        Pre(Code(signature, cls="language-python", id=node_id), style="margin: 0; padding: 0; flex: 1; overflow-x: auto; font-size: 0.8rem; line-height: 1.6;"),
-        style="display: flex; background: #1a1a1a; border-top: 1px solid #2a2a2a;")
-    return Article(header, doc_line, code_block, style="margin-bottom: 0.75rem; border-radius: 8px; overflow: hidden; background: #1e1e1e;")
-
-def render_module_page(
-    mod_name, 
-    mod_nodes, 
-    all_mod_names, 
-    meta, 
-    root='.'):
-    '''Builds a Module Page'''
-    repo_url = meta.get('urls', {}).get('Repository')
-    exp_nodes = [n for n in mod_nodes if n.kind == Kind.EXP]
-    content = Div(*[render_node(n, repo_url, root) for n in exp_nodes], style="padding: 1rem; background: #121212; overflow-y: auto;")
-    head_elements = [
-        Script(type="module", src="https://cdn.jsdelivr.net/gh/starfederation/datastar@1.0.0-RC.7/bundles/datastar.js"),
-        Link(rel="stylesheet", href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.9.0/styles/vs2015.min.css"),
-        Script(src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.9.0/highlight.min.js"),
-        Script("hljs.highlightAll();"),
-        Style("body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; margin: 0; } code { font-family: 'SF Mono', Consolas, monospace; }"),
-        Title(f"{mod_name} - {meta['name']}")]
-    search_input = Input(type="text", placeholder="Search...", style="width: 100%; padding: 0.5rem; border: 1px solid #333; border-radius: 4px; background: #252525; color: #fff; margin-bottom: 1rem;", **{"data-bind": "search"})
-    nav_links = [Li(A("← Index", href="index.html", style="color: #888; text-decoration: none; font-size: 0.85rem;"))] + [Li(A(m, href=f"{m}.html", style=f"color: {'#fff' if m == mod_name else '#aaa'}; text-decoration: none;")) for m in all_mod_names]
-    nav = Nav(
-        H3(meta['name'], style="margin: 0 0 1rem 0; color: #fff;"),
-        search_input,
-        Ul(*nav_links, style="list-style: none; padding: 0; margin: 0;"),
-        style="padding: 1rem; background: #1a1a1a; min-width: 180px;")
-    btn_style = "display: flex; align-items: center; gap: 0.25rem; background: #333; border: 1px solid #444; color: #ccc; padding: 0.5rem 0.75rem; border-radius: 4px; cursor: pointer; font-size: 0.85rem;"
-    wasm_btn = A(Button(Icon('external-link', size=16), "Run in Browser", style=btn_style), href=f"wasm/{mod_name}/index.html", target="_blank", style="text-decoration: none;")
-    header = Header(
-        Div(H1(mod_name, style="margin: 0; font-size: 1.5rem; color: #fff;"), wasm_btn, style="display: flex; align-items: center; justify-content: space-between;"),
-        style="padding: 1rem; background: #1e1e1e; border-bottom: 1px solid #333;")
-    body = Body(nav, Div(header, content, style="flex: 1; display: flex; flex-direction: column;"), style="display: flex; height: 100vh; margin: 0; background: #121212;", **{"data-signals": "{search: ''}"})
-    return Html(Head(*head_elements), body)
-
-def build_docs(
-    root='.'    # the project root (this should never really change)
-):
-    '''Builds the static documentation website'''
-    cfg = read_config(root)
-    meta = read_meta(root)
-    _, mods = scan(root)
-    mod_names = [name for name, _ in mods]
-    docs_path = Path(root) / cfg.docs
-    docs_path.mkdir(exist_ok=True)
-    (docs_path / "index.html").write_text(to_xml(render_index_page(meta, mods)))
-    for mod_name, mod_nodes in mods:
-        (docs_path / f"{mod_name}.html").write_text(to_xml(render_module_page(mod_name, mod_nodes, mod_names, meta, root)))
-    export_wasm(root)
-    return f"Generated index + {len(mods)} module pages in {docs_path}"
-
-def export_wasm(root='.'):
-    cfg = read_config(root)
-    nbs_dir = Path(root) / cfg.nbs
-    wasm_dir = Path(root) / cfg.docs / 'wasm'
-    wasm_dir.mkdir(parents=True, exist_ok=True)
-    for f in nbs_dir.glob('*.py'):
-        name = nb_name(f, root)
-        if name: os.system(f"marimo export html-wasm {f} -o {wasm_dir}/{name} --mode edit")
-
-def write_nojekyll(root='.'):
-    cfg = read_config(root)
-    Path(root, cfg.docs, '.nojekyll').touch()
-
-def html_preview(width='100%', height='300px'):
-    "Display FT components in an IFrame"
-    def _preview(*components): show(Iframe(srcdoc=to_xml(components[0] if len(components) == 1 else Div(*components)), width=width, height=height))
-    return _preview
-
-def render_index_page(meta, mods, repo_url=None):
-    mod_names = [name for name, _ in mods]
-    head_elements = [
-        Script(type="module", src="https://cdn.jsdelivr.net/gh/starfederation/datastar@1.0.0-RC.7/bundles/datastar.js"),
-        Link(rel="stylesheet", href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.9.0/styles/vs2015.min.css"),
-        Script(src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.9.0/highlight.min.js"),
-        Script("hljs.highlightAll();"),
-        Style("body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; margin: 0; } code { font-family: 'SF Mono', Consolas, monospace; }"),
-        Title(meta['name'])]
-    nav_links = [Li(A(m, href=f"{m}.html", style="color: #aaa; text-decoration: none;")) for m in mod_names]
-    nav = Nav(
-        H3(meta['name'], style="margin: 0 0 1rem 0; color: #fff;"),
-        Ul(*nav_links, style="list-style: none; padding: 0; margin: 0;"),
-        style="padding: 1rem; background: #1a1a1a; min-width: 180px;")
-    module_cards = [A(Div(H3(name, style="margin: 0 0 0.5rem 0; color: #fff;"), P(f"{len([n for n in nodes if n.kind == Kind.EXP])} exports", style="margin: 0; color: #888;"), 
-        style="padding: 1rem; background: #1e1e1e; border-radius: 8px;"), href=f"{name}.html", style="text-decoration: none;") for name, nodes in mods]
-    content = Div(
-        H1(meta['name'], style="margin: 0 0 0.5rem 0; color: #fff;"),
-        P(meta['desc'], style="color: #888; margin: 0 0 2rem 0;"),
-        P(f"Version {meta['version']}", style="color: #666; margin: 0 0 2rem 0; font-size: 0.9rem;"),
-        H2("Modules", style="color: #fff; margin: 0 0 1rem 0; font-size: 1.2rem;"),
-        Div(*module_cards, style="display: grid; grid-template-columns: repeat(auto-fill, minmax(200px, 1fr)); gap: 1rem;"),
-        style="padding: 2rem; flex: 1;")
-    body = Body(nav, content, style="display: flex; min-height: 100vh; margin: 0; background: #121212;")
-    return Html(Head(*head_elements), body)
-
-def Icon(name: str,            # name of the icon MUST be in icon_dict
-         size=24,              # value to be passed to height and width of the icon
-         stroke=1.5,           # stroke width 
-         cls=None,             # css class
-         icon_dict:dict=icons, # Dict of icons {"name":"<svg...>"}
-         **kwargs              # passed to through to FT 
-        ) -> 'Any':            # Follow recomendation from fastHTML docs
-    '''
-    Creates a custom html compliant <icon-{name}>... 
-    Intended to be used with a Global Dict of icons {"home": "<svg...", "info": "<svg..."} 
-    Icon('home') -> <icon-home> ....  </icon-home>
-    '''
-    if name not in icon_dict: raise ValueError(f"Icon '{name}' not found")
-
-    # count=1 Replace only the first occurrence of width & height 99% of time this is what you want
-    svg_string = icon_dict[name]
-    svg_string = re.sub(r'width="\d+"', f'width="{size}"', svg_string, count=1)
-    svg_string = re.sub(r'height="\d+"', f'height="{size}"', svg_string, count=1)
-    svg_string = re.sub(r'stroke-width="\d+"', f'stroke-width="{stroke}"', svg_string)
-
-    return ft(f'icon-{name}', NotStr(svg_string), cls=cls, **kwargs)

marimo_dev-0.2.8/src/marimo_dev/publish.py

@@ -1,31 +0,0 @@
-import subprocess, configparser, shutil
-from pathlib import Path
-from .build import build
-
-def publish(
-    test:bool=True, # Use Test PyPI if True, real PyPI if False
-):
-    "Build and publish package to PyPI. Looks for ~/.pypirc for credentials, otherwise prompts."
-
-    print("Rebuilding package from notebooks...")
-    build()
-
-    shutil.rmtree('dist', ignore_errors=True)
-    print("Building distribution...")
-    subprocess.run(['uv', 'build'], check=True)
-
-    pypirc, cmd = Path.home() / '.pypirc', ['uv', 'publish']
-    section = 'testpypi' if test else 'pypi'
-
-    if test: cmd.extend(['--publish-url', 'https://test.pypi.org/legacy/'])
-    else: cmd.extend(['--publish-url', 'https://upload.pypi.org/legacy/'])
-
-    if pypirc.exists():
-        config = configparser.ConfigParser()
-        config.read(pypirc)
-        if section in config:
-            username, password = config[section].get('username', '__token__'), config[section].get('password', '')
-            cmd.extend(['--username', username, '--password', password])
-
-    print(f"Publishing to {'Test ' if test else ''}PyPI...")
-    subprocess.run(cmd, check=True)