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

solara/website/pages/{api → documentation/components/lab}/chat.py

@@ -5,15 +5,14 @@ These are the components available in Solara to build chat interfaces.
 Although they can be used together to create a pre-built chat interface, inserting custom components is also possible.
 For an example of how to use a custom message component, see the bottom of the page.
 
-Also check out the [Chatbot](/examples/ai/chatbot) example.
+Also check out the [Chatbot](/documentation/examples/ai/chatbot) example.
 
 # ChatBox
 """
 import solara
+from solara.website.components import NoPage
 from solara.website.utils import apidoc
 
-from . import NoPage
-
 title = "Chat Components"
 
 

solara/website/pages/{api → documentation/components/lab}/cookies_headers.py

@@ -42,7 +42,7 @@ def Page():
 
 """
 
-from . import NoPage
+from solara.website.components import NoPage
 
 title = "Cookies and Headers"
 Page = NoPage

solara/website/pages/{api → documentation/components/lab}/input_date.py

@@ -6,10 +6,9 @@ This page contains the two variants of datepickers available in solara
 # InputDate
 """
 import solara
+from solara.website.components import NoPage
 from solara.website.utils import apidoc
 
-from . import NoPage
-
 title = "InputDate"
 
 

solara/website/pages/{api → documentation/components/lab}/menu.py

@@ -6,10 +6,9 @@ This page contains the various kinds of menu elements available to use in solara
 # Menu
 """
 import solara
+from solara.website.components import NoPage
 from solara.website.utils import apidoc
 
-from . import NoPage
-
 title = "Menus"
 
 

solara/website/pages/{api → documentation/components/lab}/task.py

@@ -4,10 +4,9 @@
 import solara
 import solara.autorouting
 import solara.lab
+from solara.website.components import NoPage
 from solara.website.utils import apidoc
 
-from . import NoPage
-
 title = "Task"
 Page = NoPage
 __doc__ += apidoc(solara.lab.task)  # type: ignore

solara/website/pages/{api → documentation/components/lab}/theming.py

@@ -64,10 +64,9 @@ responds to the theme variant change.
 """
 
 import solara
+from solara.website.components import NoPage
 from solara.website.utils import apidoc
 
-from . import NoPage
-
 title = "Themes"
 Page = NoPage
 __doc__ += apidoc(solara.lab.ThemeToggle)  # type: ignore

solara/website/pages/{api → documentation/components/lab}/use_task.py

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

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

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

solara/website/pages/{api → documentation/components/layout}/app_bar.py

@@ -4,10 +4,9 @@
 """
 import solara
 import solara.lab
+from solara.website.components import NoPage
 from solara.website.utils import apidoc
 
-from . import NoPage
-
 title = "AppBar"
 
 Page = NoPage

solara/website/pages/{api → documentation/components/layout}/app_bar_title.py

@@ -4,10 +4,9 @@
 """
 import solara
 import solara.lab
+from solara.website.components import NoPage
 from solara.website.utils import apidoc
 
-from . import NoPage
-
 title = "AppBarTitle"
 
 Page = NoPage

solara/website/pages/{api → documentation/components/layout}/card.py

@@ -4,10 +4,9 @@
 """
 import solara
 import solara.lab
+from solara.website.components import NoPage
 from solara.website.utils import apidoc
 
-from . import NoPage
-
 title = "Card"
 
 Page = NoPage

solara/website/pages/{api → documentation/components/layout}/card_actions.py

@@ -4,10 +4,9 @@
 """
 import solara
 import solara.lab
+from solara.website.components import NoPage
 from solara.website.utils import apidoc
 
-from . import NoPage
-
 title = "CardActions"
 
 Page = NoPage

solara/website/pages/{api → documentation/components/layout}/griddraggable.py

@@ -8,7 +8,7 @@ import textwrap
 
 import solara
 
-from .common import ColorCard
+from ..common import ColorCard
 
 title = "GridDraggable"
 

solara/website/pages/{api → documentation/components/layout}/gridfixed.py

@@ -6,7 +6,7 @@ Lays out children in a grid with a fixed number of columns.
 
 import solara
 
-from .common import ColorCard
+from ..common import ColorCard
 
 title = "GridFixed"
 

solara/website/pages/{api → documentation/components/layout}/hbox.py

@@ -4,7 +4,7 @@ Lays out children in horizontal direction.
 """
 import solara
 
-from .common import ColorCard
+from ..common import ColorCard
 
 
 @solara.component

solara/website/pages/{api → documentation/components/layout}/vbox.py

@@ -6,7 +6,7 @@ Lays out children in a vertical direction.
 
 import solara
 
-from .common import ColorCard
+from ..common import ColorCard
 
 
 @solara.component

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

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

solara/website/pages/{api → documentation/components/output}/file_download.py

@@ -2,10 +2,9 @@
 
 """
 import solara
+from solara.website.components import NoPage
 from solara.website.utils import apidoc
 
-from . import NoPage
-
 Page = NoPage
 title = "FileDownload"
 

solara/website/pages/{api → documentation/components/output}/image.py

@@ -2,10 +2,9 @@
 
 """
 import solara
+from solara.website.components import NoPage
 from solara.website.utils import apidoc
 
-from . import NoPage
-
 Page = NoPage
 title = "Image"
 

solara/website/pages/{api → documentation/components/output}/tooltip.py

@@ -2,10 +2,9 @@
 
 """
 import solara
+from solara.website.components import NoPage
 from solara.website.utils import apidoc
 
-from . import NoPage
-
 Page = NoPage
 title = "Tooltip"
 

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

@@ -0,0 +1,9 @@
+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/__init__.py

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

solara/website/pages/{api → documentation/components/status}/error.py

@@ -2,9 +2,9 @@
 
 Solara has 4 types of alerts:
 
- * [Success](/api/success)
- * [Info](/api/info)
- * [Warning](/api/warning)
+ * [Success](/documentation/components/status/success)
+ * [Info](/documentation/components/status/info)
+ * [Warning](/documentation/components/status/warning)
  * Error (this page)
 
 

solara/website/pages/{api → documentation/components/status}/info.py

@@ -2,10 +2,10 @@
 
 Solara has 4 types of alerts:
 
- * [Success](/api/success)
+ * [Success](/documentation/components/status/success)
  * Info (this page)
- * [Warning](/api/warning)
- * [Error](/api/error)
+ * [Warning](/documentation/components/status/warning)
+ * [Error](/documentation/components/status/error)
 
 
 

solara/website/pages/{api → documentation/components/status}/progress.py

@@ -1,10 +1,9 @@
 """# ProgressLinear
 """
 import solara
+from solara.website.components import NoPage
 from solara.website.utils import apidoc
 
-from . import NoPage
-
 Page = NoPage
 
 

solara/website/pages/{api → documentation/components/status}/spinner.py

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

solara/website/pages/{api → documentation/components/status}/success.py

@@ -3,9 +3,9 @@
 Solara has 4 types of alerts:
 
  * Success (this page)
- * [Info](/api/info)
- * [Warning](/api/warning)
- * [Error](/api/error)
+ * [Info](/documentation/components/status/info)
+ * [Warning](/documentation/components/status/warning)
+ * [Error](/documentation/components/status/error)
 
 
 

solara/website/pages/{api → documentation/components/status}/warning.py

@@ -2,10 +2,10 @@
 
 Solara has 4 types of alerts:
 
- * [Success](/api/success)
- * [Info](/api/info)
+ * [Success](/documentation/components/status/success)
+ * [Info](/documentation/components/status/info)
  * Warning (this page)
- * [Error](/api/error)
+ * [Error](/documentation/components/status/error)
 
 
 

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

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

solara/website/pages/{api → documentation/components/viz}/plotly.py

@@ -10,6 +10,7 @@ This can be significantly faster than comparing he figure data directly.
 """
 
 import plotly.express as px
+
 import solara
 
 df = px.data.iris()

solara/website/pages/{examples → documentation/examples}/__init__.py

@@ -1,52 +1,12 @@
-# import inspect
-# import urllib.parse
-
 import solara
+from solara.website.components import Gallery
 
 title = "Examples"
 
 
 @solara.component
-def Page():
-    # show a gallery of all the examples
-    router = solara.use_router()
-    route_current = router.path_routes[-2]
-
-    for route in route_current.children:
-        if route.children:
-            solara.Markdown(f"## {route.label}\n" + (route.module.__doc__ or ""))
-            with solara.ColumnsResponsive(12, 6, 6, 6, 4):
-                for child in route.children:
-                    path = route.path + "/" + child.path
-                    if child.path in [
-                        "tokenizer",
-                        "sine",
-                        "authorization",
-                        "layout_demo",
-                        "multipage",
-                        "scatter",
-                        "scrolling",
-                        "tutorial_streamlit",
-                        "login_oauth",
-                        "pokemon_search",
-                        "altair",
-                        "bqplot",
-                        "ipyleaflet",
-                        "calculator",
-                        "countdown_timer",
-                        "todo",
-                    ]:
-                        image = route.path + "/" + child.path + ".png"
-                        image_url = "https://dxhl76zpt6fap.cloudfront.net/public/examples/" + image
-                    else:
-                        image_url = "https://dxhl76zpt6fap.cloudfront.net/public/logo.svg"
-
-                    path = getattr(child.module, "redirect", path)
-                    if path:
-                        with solara.Card(child.label, style="height: 100%;"):
-                            with solara.Link(path):
-                                with solara.Column(align="center"):
-                                    solara.Image(image_url, width="120px" if image_url.endswith(".svg") else "100%")
+def Page(route_external=None):
+    Gallery(route_external)
 
 
 @solara.component

solara/website/pages/{examples → documentation/examples}/general/custom_storage.py

@@ -10,7 +10,7 @@ function to get a unique id tied to the users browser. This can be used to store
 
 In case you want to store state/data scoped to a user, you can use a similar strategy, but use a unique identifier based on the user,
 instead of the session id. You can take a look at [Our oauth example](examples/general/login_oauth) or
-[the authorization example](/examples/apps/authorization) for inspiration.
+[the authorization example](/apps/authorization) for inspiration.
 
 """
 from typing import Dict

solara/website/pages/{examples → documentation/examples}/general/deploy_model.py

@@ -1,7 +1,8 @@
 """# Deploy model demo
 
-This show off a combination of [solara.lab.Menu](/api/menu) and [solara.lab.ConfirmationDialog](/api/confirmation_dialog)
-and [solara.use_thread](/api/use_thread) to demonstrate how to tune, fit and deploy a model.
+This show off a combination of [solara.lab.Menu](/documentation/components/lab/menu) and
+    [solara.lab.ConfirmationDialog](/documentation/components/lab/confirmation_dialog)
+and [solara.use_thread](/documentation/api/hooks/use_thread) to demonstrate how to tune, fit and deploy a model.
 The actually deployment is not real, but simulated by a thread that returns a boolean value on success and sleep for a while to
 similate the deployment taking time.
 
@@ -15,7 +16,6 @@ import time
 import numpy as np
 import pandas as pd
 import plotly.express as px
-
 import solara
 import solara.lab
 

solara/website/pages/{examples → documentation/examples}/general/login_oauth.py

@@ -54,7 +54,7 @@ def Page():
 
                     This is the raw user data from the auth provider.
 
-                    We use the `picture` field to display an avatar in the [AppBar](/api/appbar).
+                    We use the `picture` field to display an avatar in the [AppBar](/documentation/components/layout/app_bar).
                 """
                 )
                 sl.Preformatted(pprint.pformat(auth.user.value))

solara/website/pages/{examples → documentation/examples}/general/vue_component.py

@@ -4,7 +4,7 @@ Although many components can be made from the Python side, sometimes it is easie
 It can also be beneficial for performance, since instead of creating many widgets from the Python side we only send data to
 the frontend. If event handling is also done on the frontend, this reduces latency and makes you app feel much smoother.
 
-See [the API documentation on component_vue](/api/component_vue) for more information.
+See [the API documentation on component_vue](/documentation/api/utilities/component_vue) for more information.
 
 This example is based on [the vuetify docs](https://v2.vuetifyjs.com/en/components/sparklines/#custom-labels),
 Note that the "Go to report" button does not do anything yet.
@@ -14,7 +14,6 @@ Note that the "Go to report" button does not do anything yet.
 from typing import Callable
 
 import numpy as np
-
 import solara
 
 seed = solara.reactive(42)

solara/website/pages/{examples → documentation/examples}/libraries/altair.py

@@ -2,16 +2,15 @@
 
 [Altair](https://altair-viz.github.io/index.html) is a declarative statistical visualization library for Python.
 
-This example show how to use the [on_click handler](/api/altair) to display data for a specific day in the chart.
+This example show how to use the [on_click handler](/documentation/components/viz/altair) to display data for a specific day in the chart.
 
 Based on [an Altair example](https://altair-viz.github.io/gallery/annual_weather_heatmap.html)
 
 """
 import altair as alt
 import pandas as pd
-from vega_datasets import data
-
 import solara
+from vega_datasets import data
 
 # title = "Altair visualization"
 source = data.seattle_weather()

solara/website/pages/{examples → documentation/examples}/libraries/ipyleaflet_advanced.py

@@ -1,7 +1,7 @@
 """
 # ipyleaflet advanced
 
-Extends the [basic ipyleaflet example](/examples/libraries/ipyleaflet) with a marker that can be dragged around, and a
+Extends the [basic ipyleaflet example](/documentation/examples/libraries/ipyleaflet) with a marker that can be dragged around, and a
 dropdown to select the map style. Two buttons allow to reset the map to the default zoom and center and to zoom
 to the marker.
 """

solara/website/pages/{examples → documentation/examples}/utilities/countdown_timer.py

@@ -1,6 +1,6 @@
 """# Countdown timer.
 
-This example shows how to use [use_thread](/api/use_thread) to create a countdown timer.
+This example shows how to use [use_thread](/documentation/api/hooks/use_thread) to create a countdown timer.
 
 The UI code demonstrates a lot of conditional rendering.
 

solara/website/pages/{examples → documentation/examples}/visualization/plotly.py

@@ -8,12 +8,11 @@ Inspired by the dash documentation.
 ## Note
 
 Solara supports plotly and plotly express. Create your figure (not a figure widget)
-and pass it to the [FigurePlotly](/api/plotly) component.
+and pass it to the [FigurePlotly](/documentation/components/viz/plotly) component.
 
 """
 import pandas as pd
 import plotly.express as px
-
 import solara
 
 title = "Scatter plot using Plotly"

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

@@ -0,0 +1,12 @@
+from pathlib import Path
+
+import solara
+from solara.website.components.markdown import MarkdownWithMetadata
+
+title = "FAQ"
+HERE = Path(__file__)
+
+
+@solara.component
+def Page(route_external=None):
+    MarkdownWithMetadata(Path(HERE.parent / "content" / "99-faq.md").read_text())

solara/website/pages/{docs → documentation/faq}/content/99-faq.md

@@ -1,4 +1,7 @@
-
+---
+title: FAQ about Solara
+description: Answers to some common questions about using Solara, and building your app using the framework
+---
 # FAQ
 
 ## I am not interested in the server, I'm happy with Jupyter/Voila, what's in it for me?

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

@@ -0,0 +1,9 @@
+from pathlib import Path
+
+from solara.autorouting import generate_routes_directory
+from solara.website.components.markdown import MarkdownWithMetadata
+
+HERE = Path(__file__)
+# if we didn't put the content in the subdirectory, but pointed to the current file
+# we would include the current file recursively, causing an infinite loop
+routes = generate_routes_directory(HERE.parent / "content", MarkdownWithMetadata)

solara/website/pages/{docs/content/03-quickstart.md → documentation/getting_started/content/00-quickstart.md}

@@ -1,3 +1,8 @@
+---
+title: Solara Quickstart
+description: Get started with building web- and data-apps in pure python with Solara.
+---
+
 # Quickstart
 
 This 1-minute quickstart will get you to:
@@ -7,12 +12,12 @@ This 1-minute quickstart will get you to:
    * Run your script using Solara server.
    * (Optional) Reuse your code in the Jupyter notebook.
 
-If you are an existing ipywidget user and do not want to learn the component based method, you might want to skip the quickstart and directly go to the [IPywidgets user tutorial](/docs/tutorial/ipywidgets).
+If you are an existing ipywidget user and do not want to learn the component based method, you might want to skip the quickstart and directly go to the [IPywidgets user tutorial](/documentation/getting_started/tutorials/ipywidgets).
 
 ## Installation
 
 
-Run `pip install solara`, or follow the [Installation instructions](/docs/installing) for more detailed instructions.
+Run `pip install solara`, or follow the [Installation instructions](/documentation/getting_started/installing) for more detailed instructions.
 
 
 ## First script