solara 1.30.1__py2.py3-none-any.whl → 1.31.0__py2.py3-none-any.whl

solara/website/pages/documentation/components/output/sql_code.py

@@ -1,84 +0,0 @@
-"""
-# SqlCode
-"""
-import os
-import sqlite3
-import threading
-from typing import Optional, cast
-
-import pandas as pd
-
-try:
-    import vaex.datasets
-except ImportError:
-    vaex = None
-
-import solara
-from solara.alias import rv
-from solara.website.utils import apidoc
-
-if vaex is not None:
-    df_iris = vaex.datasets.iris().to_pandas_df()
-    df_titanic = vaex.datasets.titanic().to_pandas_df()
-
-    def create_db():
-        conn = sqlite3.connect(filename)
-        df_iris.to_sql("iris", conn, if_exists="replace", index=False)
-        df_titanic.to_sql("titanic", conn, if_exists="replace", index=False)
-        conn.close()
-
-    filename = "solara-sql.db"
-    if not os.path.exists(filename):
-        create_db()
-
-    conn = sqlite3.connect(filename)
-    conn.row_factory = sqlite3.Row
-    table_names = [k[0] for k in conn.execute("SELECT name FROM sqlite_master WHERE type='table' ORDER BY name").fetchall()]
-    table_hints = {table_name: conn.execute(f"SELECT * from {table_name} LIMIT 1").fetchone().keys() for table_name in table_names}
-
-
-@solara.component
-def Page():
-    if vaex is None:
-        return solara.Error("Vaex is not installed, run pip install vaex-core vaex-hdf5")
-    query, set_query = solara.use_state("SELECT * from titanic")
-    query_executed, set_query_executed = solara.use_state(cast(Optional[str], None))
-
-    def run_query(cancel: threading.Event) -> pd.DataFrame:
-        if not query_executed:
-            return
-        conn = sqlite3.connect(filename)
-        cursor = conn.cursor()
-        cursor.execute(query_executed)
-
-        df = pd.DataFrame(cursor.fetchall(), columns=[k[0] for k in cursor.description])
-        return df
-
-    result: solara.Result[pd.DataFrame] = solara.use_thread(run_query, dependencies=[query_executed])
-    with solara.VBox() as main:
-        solara.SqlCode(query=query, tables=table_hints, on_query=set_query)
-        enable_execute = (query != query_executed) or result.error is not None
-
-        def execute():
-            set_query_executed(query)
-            if query == query_executed and result.error:
-                result.retry()  # type: ignore
-
-        solara.Button("Execute", on_click=execute, disabled=not enable_execute)
-        if result.error:
-            solara.Error(f"Ooops {result.error}")
-        elif not query:
-            solara.Info("No query")
-
-        elif result.value is not None:
-            solara.Markdown(f"Result for query: `{query_executed}`")
-            df = result.value
-            solara.DataFrame(df)
-        elif query_executed is not None:
-            with solara.Div():
-                solara.Text("Loading data...")
-                rv.ProgressCircular(indeterminate=True, class_="solara-progress")
-    return main
-
-
-__doc__ += apidoc(solara.SqlCode.f)  # type: ignore

solara/website/pages/documentation/components/output/tooltip.py

@@ -1,12 +0,0 @@
-"""# Tooltip
-
-"""
-import solara
-from solara.website.components import NoPage
-from solara.website.utils import apidoc
-
-Page = NoPage
-title = "Tooltip"
-
-
-__doc__ += apidoc(solara.Tooltip.f)  # type: ignore

solara/website/pages/documentation/components/page/__init__.py

@@ -1,9 +0,0 @@
-import solara
-from solara.website.components import NoPage, SubCategoryLayout
-
-Page = NoPage
-
-
-@solara.component
-def Layout(children=[]):
-    SubCategoryLayout(children=children)

solara/website/pages/documentation/components/page/head.py

@@ -1,19 +0,0 @@
-"""# Head
-"""
-
-import solara
-from solara.website.utils import apidoc
-
-
-@solara.component
-def Page():
-    with solara.VBox() as main:
-        solara.Info("A Head component does not render somesome visual on the page, but it is used to avoid duplicate tags, such as titles.")
-        with solara.Head():
-            # title should always occur inside a Head component
-            solara.Title("Custom title")
-
-    return main
-
-
-__doc__ += apidoc(solara.Head.f)  # type: ignore

solara/website/pages/documentation/components/page/title.py

@@ -1,28 +0,0 @@
-"""# Title
-"""
-
-from typing import Optional, cast
-
-import solara
-from solara.website.utils import apidoc
-
-
-@solara.component
-def Page():
-    title, set_title = solara.use_state(cast(Optional[str], "Custom title!"))
-    with solara.VBox() as main:
-        solara.ToggleButtonsSingle(value=title, values=[None, "Custom title!", "Different custom title"], on_value=set_title)
-
-        if title is not None:
-            # if the title is not set in a child component, the parent's title will be used
-            with solara.Head():
-                # title should always occur inside a Head component
-                solara.Title(title)
-            solara.Info(f"Your browser tab title should say {title}", classes=["mt-4"])
-        else:
-            solara.Warning("If no title is set, the parent title is used.", classes=["mt-4"])
-
-    return main
-
-
-__doc__ += apidoc(solara.Title.f)  # type: ignore

solara/website/pages/documentation/components/status/__init__.py

@@ -1,9 +0,0 @@
-import solara
-from solara.website.components import NoPage, SubCategoryLayout
-
-Page = NoPage
-
-
-@solara.component
-def Layout(children=[]):
-    SubCategoryLayout(children=children)

solara/website/pages/documentation/components/status/error.py

@@ -1,40 +0,0 @@
-"""# Error
-
-Solara has 4 types of alerts:
-
- * [Success](/documentation/components/status/success)
- * [Info](/documentation/components/status/info)
- * [Warning](/documentation/components/status/warning)
- * Error (this page)
-
-
-
-"""
-
-import solara
-from solara.website.utils import apidoc
-
-
-@solara.component
-def Page():
-    icon, set_icon = solara.use_state(True)
-    dense, set_dense = solara.use_state(False)
-    outlined, set_outlined = solara.use_state(True)
-    text, set_text = solara.use_state(True)
-    with solara.VBox() as main:
-        with solara.GridFixed(4):
-            solara.Checkbox(label="Use icon", value=icon, on_value=set_icon)
-            solara.Checkbox(label="Show dense", value=dense, on_value=set_dense)
-            solara.Checkbox(label="Show as text", value=text, on_value=set_text)
-            solara.Checkbox(label="Show outlined", value=outlined, on_value=set_outlined)
-        solara.Error(
-            f"This is solara.Error(label='...', text={text}, dense={dense}, outlined={outlined}, icon={icon})",
-            text=text,
-            dense=dense,
-            outlined=outlined,
-            icon=icon,
-        )
-    return main
-
-
-__doc__ += apidoc(solara.Error.f)  # type: ignore

solara/website/pages/documentation/components/status/info.py

@@ -1,40 +0,0 @@
-"""# Info
-
-Solara has 4 types of alerts:
-
- * [Success](/documentation/components/status/success)
- * Info (this page)
- * [Warning](/documentation/components/status/warning)
- * [Error](/documentation/components/status/error)
-
-
-
-"""
-
-import solara
-from solara.website.utils import apidoc
-
-
-@solara.component
-def Page():
-    icon, set_icon = solara.use_state(True)
-    dense, set_dense = solara.use_state(False)
-    outlined, set_outlined = solara.use_state(True)
-    text, set_text = solara.use_state(True)
-    with solara.VBox() as main:
-        with solara.GridFixed(4):
-            solara.Checkbox(label="Use icon", value=icon, on_value=set_icon)
-            solara.Checkbox(label="Show dense", value=dense, on_value=set_dense)
-            solara.Checkbox(label="Show as text", value=text, on_value=set_text)
-            solara.Checkbox(label="Show outlined", value=outlined, on_value=set_outlined)
-        solara.Info(
-            f"This is solara.Info(label='...', text={text}, dense={dense}, outlined={outlined}, icon={icon})",
-            text=text,
-            dense=dense,
-            outlined=outlined,
-            icon=icon,
-        )
-    return main
-
-
-__doc__ += apidoc(solara.Info.f)  # type: ignore

solara/website/pages/documentation/components/status/progress.py

@@ -1,10 +0,0 @@
-"""# ProgressLinear
-"""
-import solara
-from solara.website.components import NoPage
-from solara.website.utils import apidoc
-
-Page = NoPage
-
-
-__doc__ += apidoc(solara.ProgressLinear.f)  # type: ignore

solara/website/pages/documentation/components/status/spinner.py

@@ -1,10 +0,0 @@
-"""
-# SpinnerSolara
-"""
-import solara
-from solara.website.components import NoPage
-from solara.website.utils import apidoc
-
-Page = NoPage
-
-__doc__ += apidoc(solara.SpinnerSolara.f)  # type: ignore

solara/website/pages/documentation/components/status/success.py

@@ -1,40 +0,0 @@
-"""# Success
-
-Solara has 4 types of alerts:
-
- * Success (this page)
- * [Info](/documentation/components/status/info)
- * [Warning](/documentation/components/status/warning)
- * [Error](/documentation/components/status/error)
-
-
-
-"""
-
-import solara
-from solara.website.utils import apidoc
-
-
-@solara.component
-def Page():
-    icon, set_icon = solara.use_state(True)
-    dense, set_dense = solara.use_state(False)
-    outlined, set_outlined = solara.use_state(True)
-    text, set_text = solara.use_state(True)
-    with solara.VBox() as main:
-        with solara.GridFixed(4):
-            solara.Checkbox(label="Use icon", value=icon, on_value=set_icon)
-            solara.Checkbox(label="Show dense", value=dense, on_value=set_dense)
-            solara.Checkbox(label="Show as text", value=text, on_value=set_text)
-            solara.Checkbox(label="Show outlined", value=outlined, on_value=set_outlined)
-        solara.Success(
-            f"This is solara.Success(label='...', text={text}, dense={dense}, outlined={outlined}, icon={icon})",
-            text=text,
-            dense=dense,
-            outlined=outlined,
-            icon=icon,
-        )
-    return main
-
-
-__doc__ += apidoc(solara.Success.f)  # type: ignore

solara/website/pages/documentation/components/status/warning.py

@@ -1,47 +0,0 @@
-"""# Warning
-
-Solara has 4 types of alerts:
-
- * [Success](/documentation/components/status/success)
- * [Info](/documentation/components/status/info)
- * Warning (this page)
- * [Error](/documentation/components/status/error)
-
-
-
-"""
-
-import solara
-from solara.website.utils import apidoc
-
-
-@solara.component
-def Page():
-    icon, set_icon = solara.use_state(True)
-    dense, set_dense = solara.use_state(False)
-    outlined, set_outlined = solara.use_state(True)
-    text, set_text = solara.use_state(True)
-    with solara.VBox() as main:
-        with solara.GridFixed(4):
-            solara.Checkbox(label="Use icon", value=icon, on_value=set_icon)
-            solara.Checkbox(label="Show dense", value=dense, on_value=set_dense)
-            solara.Checkbox(label="Show as text", value=text, on_value=set_text)
-            solara.Checkbox(label="Show outlined", value=outlined, on_value=set_outlined)
-        solara.Warning(
-            f"This is solara.Warning(label='...', text={text}, dense={dense}, outlined={outlined}, icon={icon})",
-            text=text,
-            dense=dense,
-            outlined=outlined,
-            icon=icon,
-        )
-        solara.Warning(
-            f"This is solara.Warning(label='...', text={text}, dense={dense}, outlined={outlined}, icon={icon})",
-            text=text,
-            dense=dense,
-            outlined=outlined,
-            icon=icon,
-        )
-    return main
-
-
-__doc__ += apidoc(solara.Warning.f)  # type: ignore

solara/website/pages/documentation/components/viz/__init__.py

@@ -1,9 +0,0 @@
-import solara
-from solara.website.components import NoPage, SubCategoryLayout
-
-Page = NoPage
-
-
-@solara.component
-def Layout(children=[]):
-    SubCategoryLayout(children=children)

solara/website/pages/documentation/components/viz/altair.py

@@ -1,44 +0,0 @@
-"""# FigureAltair
-
-"""
-
-import altair as alt
-import pandas as pd
-
-import solara
-from solara.website.utils import apidoc
-
-title = "FigureAltair"
-
-df = pd.DataFrame({"a": ["A", "B", "C", "D", "E", "F", "G", "H", "I"], "b": [28, 55, 43, 91, 81, 53, 19, 87, 52]})
-
-
-@solara.component
-def Page():
-    click_data, set_click_data = solara.use_state(None)
-    hover_data, set_hover_data = solara.use_state(None)
-
-    chart = alt.Chart(df).mark_bar().encode(x="a", y="b")
-
-    with solara.Div() as main:
-        solara.AltairChart(chart, on_click=set_click_data, on_hover=set_hover_data)
-
-        solara.Markdown(
-            f"""
-Click data:
-
-```
-{click_data}
-```
-
-Hover data:
-```
-{hover_data}
-```
-            """
-        )
-
-    return main
-
-
-__doc__ += apidoc(solara.FigureAltair.f)  # type: ignore

solara/website/pages/documentation/components/viz/echarts.py

@@ -1,78 +0,0 @@
-"""# Echarts
-
-"""
-
-
-import solara
-from solara.website.utils import apidoc
-
-options = {
-    "bars": {
-        "title": {"text": "ECharts Getting Started Example"},
-        "tooltip": {},
-        "legend": {"data": ["sales"]},
-        "xAxis": {"type": "category"},
-        "yAxis": {},
-        "emphasis": {"itemStyle": {"shadowBlur": 10, "shadowOffsetX": 0, "shadowColor": "rgba(0, 0, 0, 0.5)"}},
-        "series": [
-            {
-                "name": "sales",
-                "type": "bar",
-                "data": [
-                    {"name": "Shirts", "value": 5},
-                    {"name": "Cardigans", "value": 20},
-                    {"name": "Chiffons", "value": 36},
-                    {"name": "Pants", "value": 10},
-                    {"name": "Heels", "value": 10},
-                    {"name": "Socks", "value": 20},
-                ],
-                "universalTransition": True,
-            }
-        ],
-    },
-    "pie": {
-        "title": {"text": "ECharts Getting Started Example"},
-        "tooltip": {},
-        "legend": {"data": ["sales"]},
-        "series": [
-            {
-                "name": "sales",
-                "type": "pie",
-                "radius": [0, "50%"],
-                "data": [
-                    {"name": "Shirts", "value": 5},
-                    {"name": "Cardigans", "value": 20},
-                    {"name": "Chiffons", "value": 36},
-                    {"name": "Pants", "value": 10},
-                    {"name": "Heels", "value": 10},
-                    {"name": "Socks", "value": 20},
-                ],
-                "universalTransition": True,
-            }
-        ],
-    },
-}
-
-
-@solara.component
-def Page():
-    option, set_option = solara.use_state("bars")
-    click_data, set_click_data = solara.use_state(None)
-    mouseover_data, set_mouseover_data = solara.use_state(None)
-    mouseout_data, set_mouseout_data = solara.use_state(None)
-
-    with solara.VBox() as main:
-        with solara.Card("Echarts"):
-            with solara.ToggleButtonsSingle("bars", on_value=set_option):
-                solara.Button("bars")
-                solara.Button("pie")
-            solara.FigureEcharts(option=options[option], on_click=set_click_data, on_mouseover=set_mouseover_data, on_mouseout=set_mouseout_data)
-        with solara.Card("Event data"):
-            solara.Markdown(f"**Click data**: {click_data}")
-            solara.Markdown(f"**Mouseover data**: {mouseover_data}")
-            solara.Markdown(f"**Mouseout data**: {mouseout_data}")
-
-    return main
-
-
-__doc__ += apidoc(solara.FigureEcharts.f)  # type: ignore

solara/website/pages/documentation/components/viz/matplotlib.py

@@ -1,32 +0,0 @@
-"""# Matplotlib
-
-"""
-
-import numpy as np
-from matplotlib.figure import Figure
-
-import solara
-from solara.website.utils import apidoc
-
-x = np.linspace(0, 2, 100)
-
-
-@solara.component
-def Page():
-    freq, set_freq = solara.use_state(2.0)
-    phase, set_phase = solara.use_state(0.1)
-    y = np.sin(x * freq + phase)
-
-    fig = Figure()
-    ax = fig.subplots()
-    ax.plot(x, y)
-    ax.set_ylim(-1.2, 1.2)
-
-    with solara.VBox() as main:
-        solara.FloatSlider("Frequency", value=freq, on_value=set_freq, min=0, max=10)
-        solara.FloatSlider("Phase", value=phase, on_value=set_phase, min=0, max=np.pi, step=0.1)
-        solara.FigureMatplotlib(fig, dependencies=[freq, phase])
-    return main
-
-
-__doc__ += apidoc(solara.FigureMatplotlib.f)  # type: ignore

solara/website/pages/documentation/components/viz/plotly.py

@@ -1,63 +0,0 @@
-"""Renders a plotly figure object and support for events.
-
-You can use a regular plotly figure, for instance using plotly.express.
-
-Supported events are include in the example below.
-
-For performance, a dependency list can be provided. Any change to the dependency list will cause the Figure data to be updated.
-This can be significantly faster than comparing he figure data directly.
-
-"""
-
-import plotly.express as px
-
-import solara
-
-df = px.data.iris()
-
-
-@solara.component
-def Page():
-    with solara.VBox() as main:
-        selection_data, set_selection_data = solara.use_state(None)
-        click_data, set_click_data = solara.use_state(None)
-        hover_data, set_hover_data = solara.use_state(None)
-        unhover_data, set_unhover_data = solara.use_state(None)
-        deselect_data, set_deselect_data = solara.use_state(None)
-        fig = px.scatter(df, x="sepal_width", y="sepal_length", color="species")
-        solara.FigurePlotly(
-            fig, on_selection=set_selection_data, on_click=set_click_data, on_hover=set_hover_data, on_unhover=set_unhover_data, on_deselect=set_deselect_data
-        )
-
-        solara.Markdown(
-            f"""
-# Events data
-## selection
-```
-{selection_data}
-```
-
-## click
-```
-{click_data}
-```
-
-## hover
-```
-{hover_data}
-```
-
-## unhover
-```
-{unhover_data}
-```
-
-## deselect
-```
-{deselect_data}
-```
-
-
-"""
-        )
-    return main

solara/website/pages/documentation/components/viz/plotly_express.py

@@ -1,41 +0,0 @@
-"""
-
-Wraps plotly express function and adds cross filtering support.
-
-Instead of `plotly.express' you can use `solara.express` instead.
-
-```python
-# import plotly.express as px
-import solara.express as px
-
-df = px.data.iris()
-px.histogram(df, "species")
-px.scatter(df, x="sepal_width", y="sepal_length", color="species")
-```
-
-
-Click the lasso icon in the top scatter plot to select points, which should then be filtered out in the other
-plots.
-
-
-"""
-
-import plotly.express as px
-
-import solara
-import solara.express as spx
-
-df = px.data.iris()
-
-
-@solara.component
-def Page():
-    solara.provide_cross_filter()
-    fig = px.histogram(df, "species")
-    fig.update_layout(dragmode="select", selectdirection="h")
-
-    with solara.VBox() as main:
-        spx.scatter(df, x="sepal_width", y="sepal_length", color="species")
-        spx.scatter_3d(df, x="sepal_width", y="sepal_length", z="petal_width")
-        spx.CrossFilteredFigurePlotly(fig)
-    return main

solara/website/pages/documentation/examples/__init__.py

@@ -1,52 +0,0 @@
-import solara
-from solara.website.components import Gallery
-
-title = "Examples"
-
-
-@solara.component
-def Page(route_external=None):
-    Gallery(route_external)
-
-
-@solara.component
-def Layout(children):
-    # TODO: this is using a private API, what is the best way to do this?
-    # we want to 'eat' the whole route for the current level, and the level below
-    # for example the utilities directory. But if an example does routing, we don't want
-    # to take on that route.
-    router = solara.use_router()
-    route_current = router.path_routes[-1]
-    # route_current, all_routes = solara.use_route()
-
-    if route_current is None:
-        return solara.Error("Page not found")
-    module = route_current.module
-    assert module is not None
-    github_url = solara.util.github_url(module.__file__)
-
-    with solara.HBox(grow=False) as main:
-        if route_current.path == "fullscreen":
-            with solara.Padding(4, children=children):
-                pass
-        else:
-            with solara.VBox(grow=True, align_items="baseline"):
-                doc = module.__doc__
-                if doc:
-                    with solara.VBox(grow=True):
-                        solara.Markdown(doc)
-                with solara.HBox():
-                    if route_current.path != "/":
-                        solara.Button("View source code on GitHub", icon_name="mdi-github-circle", href=github_url, class_="ma-2", target="_blank", text=True)
-                        # code = inspect.getsource(module)
-
-                        # code_quoted = urllib.parse.quote_plus(code)
-                        # url = f"https://test.solara.dev/try?code={code_quoted}"
-                        # solara.Button("Run on solara.dev", icon_name="mdi-pencil", href=url, class_="ma-2", target="_blank")
-                # with solara.HBox():
-                if not hasattr(module, "Page"):
-                    solara.Error(f"No Page component found in {module}")
-                else:
-                    with solara.Padding(4, children=children):
-                        pass
-    return main