axiom-coding-agent-setup 1.0.10 → 1.0.11

package/.agents/skills/developing-with-streamlit/templates/themes/github/streamlit_app.py

@@ -0,0 +1,337 @@
+"""
+Streamlit Element Explorer - Theme Demo
+
+A comprehensive single-page app showcasing all major Streamlit components
+with custom theming. Use this to preview how your theme looks across
+different element types.
+"""
+# DO NOT EDIT — managed by manage.py, edit _shared/streamlit_app.py instead
+
+import numpy as np
+import pandas as pd
+import streamlit as st
+
+st.set_page_config(page_title="Element Explorer", page_icon="🎨", layout="wide")
+
+# Initialize sample data in session state
+if "chart_data" not in st.session_state:
+    np.random.seed(42)
+    st.session_state.chart_data = pd.DataFrame(
+        np.random.randn(20, 3), columns=["a", "b", "c"]
+    )
+
+chart_data = st.session_state.chart_data
+
+st.title("Streamlit Element Explorer")
+st.markdown(
+    "Explore how Streamlit's built-in elements look with this theme. "
+    "Select a category below to preview different components."
+)
+
+# Navigation using segmented_control for better performance
+section = st.segmented_control(
+    "Section",
+    ["Widgets", "Data", "Charts", "Text", "Layouts", "Chat", "Status"],
+    default="Widgets",
+    label_visibility="collapsed",
+)
+
+st.divider()
+
+# -----------------------------------------------------------------------------
+# WIDGETS SECTION
+# -----------------------------------------------------------------------------
+if section == "Widgets":
+    st.header("Widgets")
+
+    # Buttons
+    st.subheader("Buttons")
+    cols = st.columns(4)
+    cols[0].button("Primary", type="primary")
+    cols[1].button("Secondary", type="secondary")
+    cols[2].button("Tertiary", type="tertiary")
+    cols[3].link_button("Link", url="https://streamlit.io", icon=":material/open_in_new:")
+
+    # Form
+    with st.form(key="demo_form"):
+        st.subheader("Form")
+        form_cols = st.columns(2)
+        form_cols[0].text_input("Name", placeholder="Enter your name")
+        form_cols[1].text_input("Email", placeholder="you@example.com")
+        st.form_submit_button("Submit", type="primary")
+
+    # Selection widgets
+    st.subheader("Selection Widgets")
+    sel_cols = st.columns(2)
+
+    with sel_cols[0]:
+        st.checkbox("Checkbox option")
+        st.toggle("Toggle switch")
+        st.selectbox("Selectbox", options=["Option A", "Option B", "Option C"])
+        st.multiselect("Multiselect", options=["Tag 1", "Tag 2", "Tag 3"], default=["Tag 1"])
+
+    with sel_cols[1]:
+        st.radio("Radio buttons", options=["Choice 1", "Choice 2", "Choice 3"], horizontal=True)
+        st.pills("Pills", options=["Small", "Medium", "Large"], default="Medium")
+        st.segmented_control("Segmented", options=["Day", "Week", "Month"], default="Week")
+        st.caption("Feedback widget")
+        st.feedback("stars")
+
+    # Numeric & Sliders
+    st.subheader("Numeric Inputs")
+    num_cols = st.columns(3)
+    num_cols[0].number_input("Number input", value=42)
+    num_cols[1].slider("Slider", 0, 100, 50)
+    num_cols[2].select_slider("Select slider", options=["XS", "S", "M", "L", "XL"], value="M")
+
+    # Date/Time
+    st.subheader("Date & Time")
+    dt_cols = st.columns(2)
+    dt_cols[0].date_input("Date input")
+    dt_cols[1].time_input("Time input")
+
+    # Text inputs
+    st.subheader("Text Inputs")
+    txt_cols = st.columns(2)
+    txt_cols[0].text_input("Text input", placeholder="Type something...")
+    txt_cols[1].text_area("Text area", placeholder="Longer text goes here...", height=100)
+
+    # File upload
+    st.subheader("File Upload")
+    st.file_uploader("Upload a file", type=["csv", "txt", "pdf"])
+
+# -----------------------------------------------------------------------------
+# DATA SECTION
+# -----------------------------------------------------------------------------
+elif section == "Data":
+    st.header("Data Display")
+
+    # Metrics
+    st.subheader("Metrics")
+    m_cols = st.columns(4)
+    m_cols[0].metric("Revenue", "$45,231", "+12.5%")
+    m_cols[1].metric("Users", "2,847", "+8.2%")
+    m_cols[2].metric("Conversion", "3.24%", "-0.4%", delta_color="inverse")
+    m_cols[3].metric("Avg. Session", "4m 32s", "+1.2%")
+
+    st.divider()
+
+    # Dataframe
+    st.subheader("Dataframe")
+    df = pd.DataFrame({
+        "Name": ["Alice", "Bob", "Charlie", "Diana", "Eve"],
+        "Department": ["Engineering", "Sales", "Marketing", "Engineering", "Sales"],
+        "Salary": [95000, 78000, 82000, 105000, 71000],
+        "Start Date": pd.date_range("2022-01-15", periods=5, freq="3M"),
+        "Active": [True, True, False, True, True],
+    })
+    st.dataframe(
+        df,
+        hide_index=True,
+        column_config={
+            "Salary": st.column_config.NumberColumn(format="$%d"),
+            "Start Date": st.column_config.DateColumn(format="MMM DD, YYYY"),
+            "Active": st.column_config.CheckboxColumn("Active?"),
+        },
+    )
+
+    # Table
+    st.subheader("Static Table")
+    st.table(chart_data.head(5))
+
+    # JSON
+    st.subheader("JSON Display")
+    st.json({"name": "Streamlit", "version": "1.41.0", "features": ["themes", "widgets", "charts"]})
+
+# -----------------------------------------------------------------------------
+# CHARTS SECTION
+# -----------------------------------------------------------------------------
+elif section == "Charts":
+    st.header("Charts")
+
+    chart_cols = st.columns(2)
+
+    with chart_cols[0]:
+        st.subheader("Line Chart")
+        st.line_chart(chart_data, height=250)
+
+        st.subheader("Bar Chart")
+        st.bar_chart(chart_data, height=250)
+
+    with chart_cols[1]:
+        st.subheader("Area Chart")
+        st.area_chart(chart_data, height=250)
+
+        st.subheader("Scatter Chart")
+        st.scatter_chart(chart_data, height=250)
+
+# -----------------------------------------------------------------------------
+# TEXT SECTION
+# -----------------------------------------------------------------------------
+elif section == "Text":
+    st.header("Text Elements")
+
+    # Headers
+    st.subheader("Headers")
+    st.title("Title Element")
+    st.header("Header Element")
+    st.subheader("Subheader Element")
+    st.caption("Caption text - smaller, muted")
+
+    st.divider()
+
+    # Markdown
+    st.subheader("Markdown Formatting")
+    st.markdown(
+        "**Bold text**, *italic text*, ~~strikethrough~~, "
+        "`inline code`, [link](https://streamlit.io)"
+    )
+    st.markdown("Math: $E = mc^2$ and $\\int_0^\\infty e^{-x^2} dx = \\frac{\\sqrt{\\pi}}{2}$")
+    st.markdown("Emojis: 🚀 🎨 📊 ✨ and icons: :material/home: :material/settings:")
+
+    # Colored text
+    st.subheader("Colored Text")
+    color_cols = st.columns(3)
+    color_cols[0].markdown(":red[Red text] and :orange[Orange text]")
+    color_cols[1].markdown(":green[Green text] and :blue[Blue text]")
+    color_cols[2].markdown(":violet[Violet text] and :rainbow[Rainbow text]")
+
+    # Code blocks
+    st.subheader("Code Block")
+    st.code(
+        '''import streamlit as st
+
+# Create a themed dashboard
+st.set_page_config(page_title="My App", layout="wide")
+st.title("Hello, Streamlit!")
+
+# Display metrics
+col1, col2 = st.columns(2)
+col1.metric("Users", "1,234", "+5%")
+col2.metric("Revenue", "$56K", "+12%")''',
+        language="python",
+    )
+
+# -----------------------------------------------------------------------------
+# LAYOUTS SECTION
+# -----------------------------------------------------------------------------
+elif section == "Layouts":
+    st.header("Layout Elements")
+
+    # Columns
+    st.subheader("Columns with Borders")
+    layout_cols = st.columns(3, border=True)
+    layout_cols[0].write("**Column 1**\n\nFirst column content")
+    layout_cols[1].write("**Column 2**\n\nSecond column content")
+    layout_cols[2].write("**Column 3**\n\nThird column content")
+
+    # Tabs
+    st.subheader("Tabs")
+    tab1, tab2, tab3 = st.tabs(["📈 Chart", "📋 Data", "⚙️ Settings"])
+    with tab1:
+        st.write("Chart tab content")
+        st.line_chart(chart_data["a"], height=150)
+    with tab2:
+        st.write("Data tab content")
+        st.dataframe(chart_data.head(3))
+    with tab3:
+        st.write("Settings tab content")
+        st.checkbox("Enable feature X")
+        st.checkbox("Enable feature Y", value=True)
+
+    # Expander
+    st.subheader("Expander")
+    with st.expander("Click to expand"):
+        st.write("This content is hidden by default.")
+        st.image("https://placehold.co/400x200/29B5E8/white?text=Expanded+Content")
+
+    # Popover
+    st.subheader("Popover")
+    pop_cols = st.columns(3)
+    with pop_cols[0].popover("Open popover", icon=":material/info:"):
+        st.write("Popover content here!")
+        st.slider("Popover slider", 0, 100, 50)
+
+    # Container
+    st.subheader("Container with Border")
+    with st.container(border=True):
+        st.write("**Bordered Container**")
+        st.write("Content inside a container with a visible border.")
+        st.button("Button inside container")
+
+# -----------------------------------------------------------------------------
+# CHAT SECTION
+# -----------------------------------------------------------------------------
+elif section == "Chat":
+    st.header("Chat Elements")
+
+    # Chat messages
+    st.subheader("Chat Messages")
+    with st.chat_message("user"):
+        st.write("Hello! How can I analyze my sales data?")
+
+    with st.chat_message("assistant"):
+        st.write("I can help you with that! Here are a few options:")
+        st.markdown("""
+        1. **Revenue trends** - View monthly/quarterly patterns
+        2. **Top products** - Identify best sellers
+        3. **Customer segments** - Analyze by region or category
+        """)
+
+    with st.chat_message("user"):
+        st.write("Show me the revenue trends please.")
+
+    with st.chat_message("assistant"):
+        st.write("Here's your revenue trend for the past 20 periods:")
+        st.line_chart(chart_data["a"], height=200)
+
+    # Chat input
+    st.chat_input("Type a message...")
+
+# -----------------------------------------------------------------------------
+# STATUS SECTION
+# -----------------------------------------------------------------------------
+elif section == "Status":
+    st.header("Status Elements")
+
+    # Alert messages
+    st.subheader("Alert Messages")
+    st.error("Error: Something went wrong with the data pipeline.")
+    st.warning("Warning: API rate limit approaching (80% used).")
+    st.info("Info: New features available in the latest release.")
+    st.success("Success: Data exported successfully to warehouse.")
+
+    # Exception
+    st.subheader("Exception Display")
+    try:
+        raise ValueError("This is an example exception for demonstration")
+    except ValueError as e:
+        st.exception(e)
+
+    # Interactive status
+    st.subheader("Interactive Status")
+    status_cols = st.columns(3)
+    if status_cols[0].button("Show Toast", icon=":material/notifications:"):
+        st.toast("This is a toast notification!", icon="🔔")
+    if status_cols[1].button("Balloons", icon=":material/celebration:"):
+        st.balloons()
+    if status_cols[2].button("Snow", icon=":material/ac_unit:"):
+        st.snow()
+
+    # Progress
+    st.subheader("Progress Indicators")
+    st.progress(0.7, text="70% complete")
+    with st.spinner("Loading..."):
+        st.write("Spinner is active (non-blocking in this demo)")
+
+# -----------------------------------------------------------------------------
+# SIDEBAR
+# -----------------------------------------------------------------------------
+with st.sidebar:
+    st.header("Settings")
+    st.selectbox("Time Period", ["Last 7 days", "Last 30 days", "Last 90 days", "All time"])
+    st.multiselect("Metrics", ["Revenue", "Users", "Sessions"], default=["Revenue", "Users"])
+    st.slider("Confidence threshold", 0.0, 1.0, 0.8)
+    st.divider()
+    st.caption("Element Explorer v1.0")
+    st.caption("Theme: **GitHub**")

package/.agents/skills/developing-with-streamlit/templates/themes/manage.py

@@ -0,0 +1,332 @@
+#!/usr/bin/env python3
+"""Manage theme template directories (fully generated from _configs/).
+
+Usage:
+    python manage.py sync   # Regenerate all theme directories
+    python manage.py check  # Verify generated files haven't drifted
+    python manage.py new NAME       # Scaffold a new theme config
+"""
+
+import ast
+import re
+import shutil
+import sys
+from pathlib import Path
+
+ROOT = Path(__file__).parent
+SHARED = ROOT / "_shared"
+TEMPLATES = ROOT / "_templates"
+CONFIGS = ROOT / "_configs"
+FONTS = SHARED / "fonts"
+
+MANAGED_HEADER_PY = (
+    "# DO NOT EDIT — managed by manage.py, edit _shared/streamlit_app.py instead\n"
+)
+MANAGED_HEADER_TOML = (
+    "# DO NOT EDIT — managed by manage.py, edit _configs/{slug}.toml instead\n"
+)
+
+GITATTR_START = "# BEGIN managed by manage.py"
+GITATTR_END = "# END managed by manage.py"
+
+
+# ---------------------------------------------------------------------------
+# Theme discovery
+# ---------------------------------------------------------------------------
+
+TITLE_OVERRIDES = {"github": "GitHub"}
+
+
+def slug_to_title(slug):
+    """Derive a display title from a directory slug: 'solarized-light' -> 'Solarized Light'."""
+    if slug in TITLE_OVERRIDES:
+        return TITLE_OVERRIDES[slug]
+    return " ".join(w.capitalize() for w in slug.split("-"))
+
+
+def discover_themes():
+    """Find themes by scanning _configs/*.toml."""
+    return [
+        {"slug": c.stem, "title": slug_to_title(c.stem)}
+        for c in sorted(CONFIGS.glob("*.toml"))
+    ]
+
+
+# ---------------------------------------------------------------------------
+# Font discovery from config content
+# ---------------------------------------------------------------------------
+
+def discover_fonts(config_text):
+    """Extract font filenames referenced in config.toml content."""
+    return re.findall(r'url\s*=\s*["\']app/static/([^"\']+\.(?:ttf|otf|woff2?))["\']', config_text)
+
+
+# ---------------------------------------------------------------------------
+# Content builders
+# ---------------------------------------------------------------------------
+
+def expected_app(title):
+    """Build expected streamlit_app.py content for a theme."""
+    source = (SHARED / "streamlit_app.py").read_text()
+    body = source.replace("{{title}}", title)
+    # Insert managed header after the module docstring
+    tree = ast.parse(body)
+    if ast.get_docstring(tree) is not None:
+        # The docstring is the first statement; find end of its line
+        docstring_node = tree.body[0]
+        end_line = docstring_node.end_lineno  # 1-indexed
+        lines = body.split("\n")
+        insert_pos = end_line
+        return "\n".join(lines[:insert_pos]) + "\n" + MANAGED_HEADER_PY + "\n".join(lines[insert_pos:])
+    return MANAGED_HEADER_PY + body
+
+
+def expected_config(slug):
+    """Build expected .streamlit/config.toml content for a theme."""
+    source = (CONFIGS / f"{slug}.toml").read_text()
+    header = MANAGED_HEADER_TOML.replace("{slug}", slug)
+    return header + source
+
+
+def expected_from_template(tmpl_path, replacements):
+    """Build expected file content from a .tmpl template."""
+    text = tmpl_path.read_text()
+    for key, value in replacements.items():
+        text = text.replace("{{" + key + "}}", value)
+    return text
+
+
+# ---------------------------------------------------------------------------
+# Sync
+# ---------------------------------------------------------------------------
+
+def sync_theme(theme):
+    """Regenerate all files for a single theme directory."""
+    slug = theme["slug"]
+    title = theme["title"]
+    identifier = slug.replace("-", "_")
+    theme_dir = ROOT / slug
+
+    # Create directories
+    theme_dir.mkdir(exist_ok=True)
+    (theme_dir / ".streamlit").mkdir(exist_ok=True)
+    (theme_dir / "static").mkdir(exist_ok=True)
+
+    # .streamlit/config.toml — from _configs/
+    (theme_dir / ".streamlit" / "config.toml").write_text(expected_config(slug))
+
+    # streamlit_app.py
+    (theme_dir / "streamlit_app.py").write_text(expected_app(title))
+
+    # pyproject.toml
+    (theme_dir / "pyproject.toml").write_text(
+        expected_from_template(
+            TEMPLATES / "pyproject.toml.tmpl",
+            {"slug": slug, "title": title},
+        )
+    )
+
+    # snowflake.yml
+    (theme_dir / "snowflake.yml").write_text(
+        expected_from_template(
+            TEMPLATES / "snowflake.yml.tmpl",
+            {"slug": slug, "title": title, "identifier": identifier},
+        )
+    )
+
+    # Fonts — copy from _shared/fonts/ based on config references
+    config_text = (CONFIGS / f"{slug}.toml").read_text()
+    font_names = discover_fonts(config_text)
+    static_dir = theme_dir / "static"
+    for fname in font_names:
+        src = FONTS / fname
+        if not src.exists():
+            print(f"  Warning: font {fname} referenced in _configs/{slug}.toml not found in _shared/fonts/", file=sys.stderr)
+            continue
+        shutil.copy2(src, static_dir / fname)
+
+
+def update_gitattributes():
+    """Update .gitattributes with entries for generated theme files."""
+    gitattr_path = ROOT / ".gitattributes"
+
+    new_section = "\n".join([
+        GITATTR_START,
+        "*/.streamlit/config.toml linguist-generated",
+        "*/streamlit_app.py linguist-generated",
+        "*/pyproject.toml linguist-generated",
+        "*/snowflake.yml linguist-generated",
+        "*/static/*.ttf linguist-generated",
+        GITATTR_END,
+    ])
+
+    if gitattr_path.exists():
+        content = gitattr_path.read_text()
+        if GITATTR_START in content:
+            start = content.index(GITATTR_START)
+            end = content.index(GITATTR_END) + len(GITATTR_END)
+            content = content[:start] + new_section + content[end:]
+        else:
+            content = content.rstrip() + "\n\n" + new_section + "\n"
+    else:
+        content = new_section + "\n"
+
+    gitattr_path.write_text(content)
+
+
+def cmd_sync():
+    themes = discover_themes()
+    for t in themes:
+        sync_theme(t)
+        print(f"  Synced {t['slug']}/")
+
+    # Remove orphaned theme directories (directories not matching any config)
+    config_slugs = {t["slug"] for t in themes}
+    orphans = [
+        d for d in sorted(ROOT.iterdir())
+        if d.is_dir() and not d.name.startswith("_") and d.name not in config_slugs
+    ]
+    if orphans:
+        print("\nOrphaned directories (no matching config):")
+        for d in orphans:
+            print(f"  {d.name}/")
+        answer = input("Remove these directories? [y/N] ").strip().lower()
+        if answer == "y":
+            for d in orphans:
+                shutil.rmtree(d)
+                print(f"  Removed {d.name}/")
+        else:
+            print("  Skipped orphan removal.")
+
+    update_gitattributes()
+    print(f"\nSynced {len(themes)} theme directories.")
+
+
+# ---------------------------------------------------------------------------
+# Check
+# ---------------------------------------------------------------------------
+
+def cmd_check():
+    themes = discover_themes()
+    drifted = []
+    missing = []
+
+    for theme in themes:
+        slug = theme["slug"]
+        title = theme["title"]
+        identifier = slug.replace("-", "_")
+        theme_dir = ROOT / slug
+
+        # .streamlit/config.toml
+        target = theme_dir / ".streamlit" / "config.toml"
+        expected = expected_config(slug)
+        if not target.exists():
+            missing.append(f"{slug}/.streamlit/config.toml")
+        elif target.read_text() != expected:
+            drifted.append(f"{slug}/.streamlit/config.toml")
+
+        # streamlit_app.py
+        target = theme_dir / "streamlit_app.py"
+        if not target.exists():
+            missing.append(f"{slug}/streamlit_app.py")
+        elif target.read_text() != expected_app(title):
+            drifted.append(f"{slug}/streamlit_app.py")
+
+        # pyproject.toml
+        target = theme_dir / "pyproject.toml"
+        expected = expected_from_template(
+            TEMPLATES / "pyproject.toml.tmpl",
+            {"slug": slug, "title": title},
+        )
+        if not target.exists():
+            missing.append(f"{slug}/pyproject.toml")
+        elif target.read_text() != expected:
+            drifted.append(f"{slug}/pyproject.toml")
+
+        # snowflake.yml
+        target = theme_dir / "snowflake.yml"
+        expected = expected_from_template(
+            TEMPLATES / "snowflake.yml.tmpl",
+            {"slug": slug, "title": title, "identifier": identifier},
+        )
+        if not target.exists():
+            missing.append(f"{slug}/snowflake.yml")
+        elif target.read_text() != expected:
+            drifted.append(f"{slug}/snowflake.yml")
+
+        # Fonts
+        config_text = (CONFIGS / f"{slug}.toml").read_text()
+        font_names = discover_fonts(config_text)
+        for fname in font_names:
+            src = FONTS / fname
+            dest = theme_dir / "static" / fname
+            if not dest.exists():
+                missing.append(f"{slug}/static/{fname}")
+            elif src.exists() and src.read_bytes() != dest.read_bytes():
+                drifted.append(f"{slug}/static/{fname}")
+
+    ok = True
+    if missing:
+        print("Missing files (run 'python manage.py sync' to fix):")
+        for f in missing:
+            print(f"  {f}")
+        ok = False
+    if drifted:
+        print("Drifted files (run 'python manage.py sync' to fix):")
+        for f in drifted:
+            print(f"  {f}")
+        ok = False
+    if ok:
+        print(f"All generated files in sync across {len(themes)} theme directories.")
+    else:
+        sys.exit(1)
+
+
+# ---------------------------------------------------------------------------
+# New
+# ---------------------------------------------------------------------------
+
+def cmd_new(name):
+    config_path = CONFIGS / f"{name}.toml"
+    if config_path.exists():
+        print(f"Error: _configs/{name}.toml already exists", file=sys.stderr)
+        sys.exit(1)
+
+    config_path.write_text(
+        f"[server]\nenableStaticServing = true\n\n"
+        f"# {name} theme\n[theme]\nbase = \"dark\"\n"
+    )
+
+    print(f"Created _configs/{name}.toml — edit it, then run 'python manage.py sync'")
+
+
+# ---------------------------------------------------------------------------
+# CLI
+# ---------------------------------------------------------------------------
+
+if __name__ == "__main__":
+    if len(sys.argv) < 2 or sys.argv[1] in ("-h", "--help"):
+        print(__doc__.strip())
+        sys.exit(0 if len(sys.argv) > 1 else 1)
+
+    if not SHARED.is_dir():
+        print(f"Error: {SHARED} not found", file=sys.stderr)
+        sys.exit(1)
+
+    if not CONFIGS.is_dir():
+        print(f"Error: {CONFIGS} not found", file=sys.stderr)
+        sys.exit(1)
+
+    cmd = sys.argv[1]
+    if cmd == "sync":
+        cmd_sync()
+    elif cmd == "new":
+        if len(sys.argv) < 3:
+            print("Usage: python manage.py new NAME", file=sys.stderr)
+            sys.exit(1)
+        cmd_new(sys.argv[2])
+    elif cmd == "check":
+        cmd_check()
+    else:
+        print(f"Unknown command: {cmd}", file=sys.stderr)
+        sys.exit(1)