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

solara/website/pages/documentation/components/lab/theming.py

@@ -1,72 +0,0 @@
-"""
-# Themes in Solara
-
-Theming is provided to Solara through the [`ipyvuetify`](https://solara.dev/docs/understanding/ipyvuetify) package.
-Two themes are provided by default: light and dark.
-Control over the theme variant (light, dark, or auto) can be provided to the user through the `ThemeToggle` component. Developers can
-control theming through the `solara.lab.theme` object.
-
-## Themes
-
-The default themes can be customized through altering `solara.lab.theme`. The
-[theme options of vuetify](https://v2.vuetifyjs.com/en/features/theme/#customizing)
-are available as `solara.lab.theme.themes.light` and `solara.lab.theme.themes.dark`. The different properties of the theme can be set through, for example
-
-```python
-solara.lab.theme.themes.light.primary = "#3f51b5"
-```
-
-Dark theme can be enabled/disabled through `solara.lab.theme.dark = True` / `False` / `None`. When set to `None`, the theme is set to auto,
-which will follow the system theme if the user's browser supports detecting it.
-
-When using solara server, the default theme variant can be set in the server settings through the command line interface. See
-[here](https://solara.dev/docs/understanding/solara-server) for more information.
-
-The active theme can be detected through `solara.lab.theme.dark_effective`, which is set to `True` or `False` depending on
-whether dark theme is enabled or not.
-
-## Example
-
-```solara
-import solara
-import solara.lab
-from solara.lab import theme as theme
-
-
-def change_color(colors):
-    if "purple" in colors:
-        theme.themes.light.info = "#8617c2"
-    else:
-        theme.themes.light.info = "#2196f3"
-
-    if "green" in colors:
-        theme.themes.light.error = "#33bd65"
-    else:
-        theme.themes.light.error = "#ff5252"
-
-
-@solara.component
-def Page():
-    solara.Info("Info message")
-    solara.Error("Error message")
-
-    with solara.ToggleButtonsMultiple(on_value=change_color):
-        solara.Button("Change Info", value="purple")
-        solara.Button("Change Error", value="green")
-```
-
-A more advanced example can be found at [the scatter app demo](https://solara.dev/apps/scatter) where
-we set a plotly theme based on dark/light theme, and also set the app bar color to its default so it
-responds to the theme variant change.
-
-## ThemeToggle
-
-"""
-
-import solara
-from solara.website.components import NoPage
-from solara.website.utils import apidoc
-
-title = "Themes"
-Page = NoPage
-__doc__ += apidoc(solara.lab.ThemeToggle)  # type: ignore

solara/website/pages/documentation/components/lab/use_task.py

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

solara/website/pages/documentation/components/layout/__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/layout/app_bar.py

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

solara/website/pages/documentation/components/layout/app_bar_title.py

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

solara/website/pages/documentation/components/layout/app_layout.py

@@ -1,23 +0,0 @@
-"""
-# AppLayout
-
-"""
-import solara
-import solara.lab
-from solara.website.utils import apidoc
-
-title = "AppLayout"
-
-
-@solara.component
-def Page():
-    return solara.Markdown(
-        """
-    An example cannot be shown embedded in this page, Visit the [AppLayout page](/apps/scatter) to see an example.
-
-    [![AppLayout screenshot](https://dxhl76zpt6fap.cloudfront.net/public/docs/app-layout.webp)](/apps/scatter)
-    """
-    )
-
-
-__doc__ += apidoc(solara.AppLayout.f)  # type: ignore

solara/website/pages/documentation/components/layout/card.py

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

solara/website/pages/documentation/components/layout/card_actions.py

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

solara/website/pages/documentation/components/layout/column.py

@@ -1,29 +0,0 @@
-"""
-# Column
-"""
-import solara
-import solara.lab
-from solara.website.utils import apidoc
-
-gap_size = solara.reactive("12px")
-align = solara.reactive("stretch")
-
-
-@solara.component
-def Page():
-    with solara.Card("Column demo") as main:
-        with solara.Column():
-            solara.Text("Align:")
-            solara.ToggleButtonsSingle(align, values=["start", "center", "end", "stretch"])
-            solara.Select(
-                label="Gap size",
-                values=["0px", "4px", "8px", "12px", "16px", "20px", "24px"],
-            ).connect(gap_size)
-        with solara.Column(gap=gap_size.value, align=align.value):
-            colors = "green red orange brown yellow pink".split()
-            for color in colors:
-                solara.Button("Solara", color=color)
-    return main
-
-
-__doc__ += apidoc(solara.Column.f)  # type: ignore

solara/website/pages/documentation/components/layout/columns.py

@@ -1,26 +0,0 @@
-"""
-# Columns
-
-"""
-import solara
-import solara.lab
-from solara.website.utils import apidoc
-
-gutters = solara.reactive(True)
-gutters_dense = solara.reactive(True)
-
-
-@solara.component
-def Page():
-    with solara.Columns([1, 2, 1], gutters=gutters.value, gutters_dense=gutters_dense.value) as main:
-        with solara.Card("Left", margin=0):
-            solara.Checkbox(label="Gutters").connect(gutters)
-            solara.Checkbox(label="Dense gutters").connect(gutters_dense)
-        with solara.Card("Middle", margin=0):
-            solara.Markdown("This column has a relative width of 2, the columns to the left and right have a relative width of 1.")
-        with solara.Card("Right", margin=0):
-            solara.Markdown("This column has a relative width of 1, the columns to the left has a relative width of 2.")
-    return main
-
-
-__doc__ += apidoc(solara.Columns.f)  # type: ignore

solara/website/pages/documentation/components/layout/columns_responsive.py

@@ -1,67 +0,0 @@
-"""
-# ColumnsResponsive
-
-"""
-import solara
-import solara.lab
-from solara.website.utils import apidoc
-
-title = "ColumnsResponsive"
-
-gutters = solara.reactive(True)
-gutters_dense = solara.reactive(True)
-wrap = solara.reactive(True)
-
-children_count = solara.reactive(12)
-columns_default = solara.reactive(6)
-columns_small = solara.reactive(4)
-columns_medium = solara.reactive(3)
-columns_large = solara.reactive(2)
-columns_xlarge = solara.reactive(1)
-
-
-@solara.component
-def Page():
-    with solara.VBox() as main:
-        with solara.Card("Controls"):
-            solara.Checkbox(label="Wrap").connect(wrap)
-            solara.Checkbox(label="Gutters").connect(gutters)
-            solara.Checkbox(label="Dense gutters").connect(gutters_dense)
-            solara.IntSlider("Children", max=20).connect(children_count)
-
-            solara.Select("columns default", values=[1, 2, 3, 4, 6, 12]).connect(columns_default)  # type: ignore
-            solara.Select("columns small", values=[1, 2, 3, 4, 6, 12]).connect(columns_small)  # type: ignore
-            solara.Select("columns medium", values=[1, 2, 3, 4, 6, 12]).connect(columns_medium)  # type: ignore
-            solara.Select("columns large", values=[1, 2, 3, 4, 6, 12]).connect(columns_large)  # type: ignore
-            solara.Select("columns xlarge", values=[1, 2, 3, 4, 6, 12]).connect(columns_xlarge)  # type: ignore
-        # taken from https://v2.vuetifyjs.com/en/styles/display/#display
-        solara.HTML(
-            "h2", unsafe_innerHTML=f"Current screensize is xsmall/default, each child is {columns_default.value} points wide", class_="ma-2 d-flex d-sm-none ma"
-        )
-        solara.HTML(
-            "h2", unsafe_innerHTML=f"Current screensize is small, each child is {columns_small.value} points wide", class_="ma-2 d-none d-sm-flex d-md-none"
-        )
-        solara.HTML(
-            "h2", unsafe_innerHTML=f"Current screensize is medium, each child is {columns_medium.value} points wide", class_="ma-2 d-none d-md-flex d-lg-none"
-        )
-        solara.HTML(
-            "h2", unsafe_innerHTML=f"Current screensize is large, each child is {columns_large.value} points wide", class_="ma-2 d-none d-lg-flex d-xl-none"
-        )
-        solara.HTML("h2", unsafe_innerHTML=f"Current screensize is xlarge, each child is {columns_xlarge.value} points wide", class_="ma-2 d-none d-xl-flex")
-        solara.Markdown("Change the screen size to see the effect of the different columns sizes.")
-        with solara.ColumnsResponsive(
-            default=columns_default.value,
-            small=columns_small.value,
-            medium=columns_medium.value,
-            large=columns_large.value,
-            xlarge=columns_xlarge.value,
-            wrap=wrap.value,
-            gutters=gutters.value,
-            gutters_dense=gutters_dense.value,
-        ):
-            for i in range(children_count.value):
-                solara.Text(f"{i}")
-    return main
-
-
-__doc__ += apidoc(solara.ColumnsResponsive.f)  # type: ignore

solara/website/pages/documentation/components/layout/griddraggable.py

@@ -1,61 +0,0 @@
-"""
-# GridDraggable
-
-Child components are laid out on a grid, which can be dragged and resized.
-"""
-import pprint
-import textwrap
-
-import solara
-
-from ..common import ColorCard
-
-title = "GridDraggable"
-
-
-@solara.component
-def Page():
-    grid_layout_initial = [
-        {"h": 5, "i": "0", "moved": False, "w": 3, "x": 0, "y": 0},
-        {"h": 5, "i": "1", "moved": False, "w": 5, "x": 3, "y": 0},
-        {"h": 11, "i": "2", "moved": False, "w": 4, "x": 8, "y": 0},
-        {"h": 12, "i": "3", "moved": False, "w": 5, "x": 0, "y": 5},
-        {"h": 6, "i": "4", "moved": False, "w": 3, "x": 5, "y": 5},
-        {"h": 6, "i": "5", "moved": False, "w": 7, "x": 5, "y": 11},
-    ]
-
-    colors = "green red orange brown yellow pink".split()
-
-    # we need to store the state of the grid_layout ourselves, otherwise it will 'reset'
-    # each time we change resizable or draggable
-    grid_layout, set_grid_layout = solara.use_state(grid_layout_initial)
-
-    # some placeholders
-    items = [ColorCard(title=f"Child {i}", color=colors[i]) for i in range(len(grid_layout))]
-    with solara.VBox() as main:
-        resizable = solara.ui_checkbox("Allow resizing", value=True)
-        draggable = solara.ui_checkbox("Allow dragging", value=True)
-
-        def reset_layout():
-            set_grid_layout(grid_layout_initial)
-
-        solara.Button("Reset to initial layout", on_click=reset_layout)
-
-        solara.GridDraggable(items=items, grid_layout=grid_layout, resizable=resizable, draggable=draggable, on_grid_layout=set_grid_layout)
-
-        # some string kung fu to make this print nicely
-        grid_layout_formatted = pprint.pformat(grid_layout, indent=4)
-        grid_layout_formatted = textwrap.indent(grid_layout_formatted, " " * len("grid_layout = "))
-        grid_layout_formatted = grid_layout_formatted[len("grid_layout = ") :]
-        solara.Markdown(
-            f"""
-            # Resulting layout
-
-            This layout can be copy pasted to put in your code as an initial layout:
-
-            ```python
-            grid_layout = {grid_layout_formatted}
-            ```
-            """
-        )
-    return main

solara/website/pages/documentation/components/layout/gridfixed.py

@@ -1,21 +0,0 @@
-"""
-# GridFixed
-
-Lays out children in a grid with a fixed number of columns.
-"""
-
-import solara
-
-from ..common import ColorCard
-
-title = "GridFixed"
-
-
-@solara.component
-def Page():
-    with solara.VBox() as main:
-        colors = "green red orange brown yellow pink".split()
-        with solara.GridFixed(columns=3):
-            for color in colors:
-                ColorCard(color, color)
-    return main

solara/website/pages/documentation/components/layout/hbox.py

@@ -1,17 +0,0 @@
-"""
-# HBox
-Lays out children in horizontal direction.
-"""
-import solara
-
-from ..common import ColorCard
-
-
-@solara.component
-def Page():
-    with solara.VBox() as main:
-        colors = "green red orange brown yellow pink".split()
-        with solara.HBox():
-            for color in colors:
-                ColorCard(color, color)
-    return main

solara/website/pages/documentation/components/layout/row.py

@@ -1,29 +0,0 @@
-"""
-# Row
-"""
-import solara
-import solara.lab
-from solara.website.utils import apidoc
-
-gap_size = solara.reactive("12px")
-justify = solara.reactive("space-around")
-
-
-@solara.component
-def Page():
-    with solara.Card("Row demo") as main:
-        with solara.Column():
-            solara.Text("Justify:")
-            solara.ToggleButtonsSingle(justify, values=["start", "center", "end", "space-around", "space-between", "space-evenly"])
-            solara.Select(
-                label="Gap size",
-                values=["0px", "4px", "8px", "12px", "16px", "20px", "24px"],
-            ).connect(gap_size)
-        with solara.Row(gap=gap_size.value, justify=justify.value):
-            colors = "green red orange brown yellow pink".split()
-            for color in colors:
-                solara.Button(label="Solara", color=color)
-    return main
-
-
-__doc__ += apidoc(solara.Row.f)  # type: ignore

solara/website/pages/documentation/components/layout/sidebar.py

@@ -1,23 +0,0 @@
-"""
-# Sidebar
-
-"""
-import solara
-import solara.lab
-from solara.website.utils import apidoc
-
-
-@solara.component
-def Page():
-    return solara.Markdown(
-        """
-
-    The sidebar can only be shown in embedded mode on this page.
-    Visit the [Scatter app demo](/apps/scatter) to see an example of a full sidebar used in Soalra server.
-
-    [![AppLayout screenshot](https://dxhl76zpt6fap.cloudfront.net/public/docs/app-layout.webp)](/apps/scatter)
-    """
-    )
-
-
-__doc__ += apidoc(solara.Sidebar.f)  # type: ignore

solara/website/pages/documentation/components/layout/vbox.py

@@ -1,19 +0,0 @@
-"""
-# VBox
-
-Lays out children in a vertical direction.
-"""
-
-import solara
-
-from ..common import ColorCard
-
-
-@solara.component
-def Page():
-    with solara.VBox() as main:
-        colors = "green red orange brown yellow pink".split()
-        with solara.VBox():
-            for color in colors:
-                ColorCard(color, color)
-    return main

solara/website/pages/documentation/components/output/__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/output/file_download.py

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

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

@@ -1,22 +0,0 @@
-"""# HTML
-"""
-
-import solara
-from solara.website.utils import apidoc
-
-
-@solara.component
-def Page():
-    html = """
-<h1>Custom html</h1>
-<ul>
-    <li>Item 1
-    <li>Item 2
-</ul>
-"""
-    with solara.VBox() as main:
-        solara.HTML(tag="div", unsafe_innerHTML=html)
-    return main
-
-
-__doc__ += apidoc(solara.HTML.f)  # type: ignore

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

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

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

@@ -1,59 +0,0 @@
-"""# Markdown
-"""
-
-
-import solara
-from solara.alias import rv
-from solara.website.utils import apidoc
-
-
-@solara.component
-def Page():
-    markdown_initial = """
-# Large
-## Smaller
-
-## List items
-
-    * item 1
-    * item 2
-
-
-## Code highlight support
-```python
-code = "formatted" and "supports highlighting"
-```
-
-
-## Mermaid support!
-See [Mermaid docs](https://mermaid-js.github.io/)
-
-```mermaid
-graph TD;
-    A-->B;
-    A-->C;
-    B-->D;
-    C-->D;
-```
-
-
-    """.strip()
-
-    markdown_text, set_markdown_text = solara.use_state(markdown_initial)
-    # with solara.GridFixed(columns=2) as main:
-    with solara.HBox(grow=True) as main:
-        with solara.VBox():
-            solara.Markdown("# Input text")
-            with solara.Padding(2):
-                with rv.Sheet(elevation=2):
-                    rv.Textarea(v_model=markdown_text, on_v_model=set_markdown_text, rows=30)
-        with solara.VBox():
-            solara.Markdown("# Renders like")
-            with solara.Padding(2):
-                with rv.Sheet(elevation=2):
-                    solara.Markdown(markdown_text)
-
-    return main
-
-
-__doc__ += apidoc(solara.Markdown.f)  # type: ignore

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

@@ -1,53 +0,0 @@
-"""# MarkdownEditor
-"""
-
-
-import solara
-from solara.alias import rv
-from solara.website.utils import apidoc
-
-
-@solara.component
-def Page():
-    markdown_initial = """
-# Large heading
-## Medium heading
-### Small heading
-
-
-## List items
-
-   * item 1
-   * item 2
-
-## Numbered items
-
-   1. item 1
-   2. item 2
-
-
-**bold** and *italic*, [GitHub link](https://github.com/widgetti/solara/)
-
-
-```
-preformatted code
-which respecs spaces
-and line breaks
-```
-
-    """.strip()
-
-    markdown_text, set_markdown_text = solara.use_state(markdown_initial)
-    with solara.HBox(grow=True) as main:
-        with solara.VBox():
-            with solara.Padding(2):
-                with rv.Sheet(elevation=2):
-                    solara.MarkdownEditor(markdown_text, on_value=set_markdown_text)
-                with rv.Sheet(elevation=2):
-                    solara.Markdown("# Raw markdown")
-                    solara.Preformatted(markdown_text)
-
-    return main
-
-
-__doc__ += apidoc(solara.MarkdownEditor.f)  # type: ignore