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

solara/components/file_drop.vue

@@ -1,6 +1,18 @@
 <template>
   <div ref="dropzone" class="solara-file-drop" effectAllowed="move">
-    {{ (file_info && file_info.length === 1) ? file_info[0].name : label }}
+    <template v-if="file_info && file_info.length > 0">
+      <template v-if="multiple">
+        <div v-for="file in file_info">
+          {{ file.name }}
+        </div>
+      </template>
+      <template v-else>
+        {{ file_info[0].name }}
+      </template>
+    </template>
+    <template v-else>
+      {{ label }}
+    </template>
   </div>
 </template>
 
@@ -16,16 +28,17 @@ module.exports = {
       event.preventDefault();
       const items = await Promise.all([...event.dataTransfer.items]);
       const files = items.map(i => i.webkitGetAsEntry())
-      const fileHolder = files.filter(f => f.isFile)[0]
-      const file = await new Promise((rs, rj) => fileHolder.file(rs, rj))
+      const fileHolders = files.filter(f => f.isFile)
+      const nativeFilesPromises = fileHolders.map(fileHolder => new Promise((rs, rj) => fileHolder.file(rs, rj)))
+      const nativeFiles = await Promise.all(nativeFilesPromises)
 
-      this.native_file_info = [file]
+      this.native_file_info = nativeFiles
       this.file_info = this.native_file_info.map(
-          ({name, isFile, size}) => ({
-            name,
-            isFile,
-            size,
-          }));
+        ({name, size}) => ({
+          name,
+          isFile: true,
+          size,
+        }));
     });
   },
   methods: {
@@ -64,6 +77,7 @@ module.exports = {
   height: 100px;
   border: 1px dashed gray;
   margin: 8px 0;
-  padding: 8px
+  padding: 8px;
+  overflow: auto;
 }
 </style>

solara/components/head.py

@@ -1,7 +1,6 @@
 from typing import List
 
 import reacton
-
 import solara
 
 
@@ -9,7 +8,7 @@ import solara
 def Head(children: List[reacton.core.Element] = []):
     """A component that manager the "head" tag of the page to avoid duplicate tags, such as titles.
 
-    Currently only supports the [title](/api/title) tag as child, e.g.:
+    Currently only supports the [title](/documentation/components/page/title) tag as child, e.g.:
 
     ```python
     import solara

solara/components/head_tag.py

@@ -2,9 +2,8 @@ from typing import Optional
 
 import ipyvuetify as vy
 import reacton.core
-import traitlets
-
 import solara
+import traitlets
 
 
 class HeadTagWidget(vy.VuetifyTemplate):
@@ -19,7 +18,7 @@ class HeadTagWidget(vy.VuetifyTemplate):
 def HeadTag(tagname: str, key=None, attributes: Optional[dict] = None):
     """Add a child element to head element, or replace a meta tag with the same tagname and key.
 
-    This component should be used inside a [Head](/api/head) component, e.g.:
+    This component should be used inside a [Head](/documentation/components/page/head) component, e.g.:
 
     ```python
     import solara

solara/components/link.py

@@ -2,7 +2,6 @@ from typing import Dict, List, Union
 
 import ipyvue as vue
 import reacton.ipyvue as vuer
-
 import solara
 
 
@@ -18,8 +17,8 @@ def Link(
 
     See also:
 
-     * [Multipage](/docs/howto/multipage).
-     * [Understanding Routing](/docs/understanding/routing).
+     * [Multipage](/documentation/advanced/howto/multipage).
+     * [Understanding Routing](/documentation/advanced/understanding/routing).
 
     Most common usage is in combination with a button, e.g.:
 
@@ -32,7 +31,7 @@ def Link(
     ## Arguments
 
      * path_or_route: the path or route to navigate to. Paths should be absolute, e.g. '/fruit/banana'.
-       If a route is given, [`resolve_path`](/api/resolve_path)] will be used to resolve to the absolute path.
+       If a route is given, [`resolve_path`](/documentation/api/routing/resolve_path)] will be used to resolve to the absolute path.
      * children: the children of the link. If a child is clicked, the link will be followed.
      * nofollow: If True, the link will not be followed by web crawlers (such as google).
      * style: CSS styles to apply to the HTML link element. Either a string or a dictionary.

solara/components/meta.py

@@ -9,7 +9,7 @@ from .head_tag import HeadTag
 def Meta(name: Optional[str] = None, property: Optional[str] = None, content: Optional[str] = None):
     """Add a meta tag to the head element, or replace a meta tag with the same name and or property.
 
-    This component should be used inside a [Head](/api/head) component, e.g.:
+    This component should be used inside a [Head](/documentation/components/page/head) component, e.g.:
 
     ```python
     import solara

solara/components/misc.py

@@ -3,7 +3,6 @@ from typing import Any, Callable, Dict, List, Union
 
 import reacton
 import reacton.ipyvuetify as v
-
 import solara
 import solara.widgets
 from solara.util import _combine_classes
@@ -159,7 +158,7 @@ def HBox(children=[], grow=True, align_items="stretch", classes: List[str] = [])
 def Row(children=[], gap="12px", justify="start", margin: int = 0, classes: List[str] = [], style: Union[str, Dict[str, str], None] = None):
     """Lays out children in a row, side by side, with the given gap between them.
 
-    See also [Column](/api/column).
+    See also [Column](/documentation/components/layout/column).
 
     Example with three children side by side:
 
@@ -200,7 +199,7 @@ def Row(children=[], gap="12px", justify="start", margin: int = 0, classes: List
 def Column(children=[], gap="12px", align="stretch", margin: int = 0, classes: List[str] = [], style: Union[str, Dict[str, str], None] = None):
     """Lays out children in a column on top of each other, with the given gap between them.
 
-    See also [Row](/api/row).
+    See also [Row](/documentation/components/layout/row).
 
     Example with three children on top of each other:
 
@@ -287,17 +286,14 @@ def FigurePlotly(
             "plotly_hover": on_hover,
             "plotly_unhover": on_unhover,
             "plotly_selected": on_selection,
-            "plotly_deselect": on_deselect
+            "plotly_deselect": on_deselect,
         }
-        
+
         callback = event_mapping.get(event_type)
         if callback:
             callback(data)
 
-    fig_element = FigureWidget.element(
-        on__js2py_pointsCallback=on_points_callback,
-        on__js2py_relayout=on_relayout
-    )
+    fig_element = FigureWidget.element(on__js2py_pointsCallback=on_points_callback, on__js2py_relayout=on_relayout)
 
     def update_data():
         fig_widget: FigureWidget = solara.get_widget(fig_element)

solara/datatypes.py

@@ -114,8 +114,8 @@ class Route:
 
     ## See also
 
-     * [Multipage](/docs/howto/multipage).
-     * [Understanding Routing](/docs/understanding/routing).
+     * [Multipage](/documentation/advanced/howto/multipage).
+     * [Understanding Routing](/documentation/advanced/understanding/routing).
 
     """
 

solara/hooks/use_reactive.py

@@ -13,7 +13,7 @@ def use_reactive(
 
     It is a useful alternative to `use_state` when you want to use a
     reactive variable for the component state.
-    See also [our documentation on state management](/docs/fundamentals/state-management).
+    See also [our documentation on state management](/documentation/getting_started/fundamentals/state-management).
 
     If the variable passed is a reactive variable, it will be returned instead and no
     new reactive variable will be created. This is useful for implementing component
@@ -92,7 +92,7 @@ def use_reactive(
     except RuntimeError as e:
         raise RuntimeError(
             "use_reactive must be called from a component function, inside the render function.\n"
-            "Do not call it top level, use [solara.reactive()](https://solara.dev/api/reactive) instead."
+            "Do not call it top level, use [solara.reactive()](https://solara.dev/documentation/api/utilities/reactive) instead."
         ) from e
     on_change_ref.current = on_change
 

solara/lab/components/confirmation_dialog.py

@@ -60,7 +60,7 @@ def ConfirmationDialog(
 ):
     """A dialog used to confirm a user action.
 
-    (*Note: [This component is experimental and its API may change in the future](/docs/lab).*)
+    (*Note: [This component is experimental and its API may change in the future](/documentation/getting_started/lab).*)
 
     By default, has a title, a text explaining the
     decision to be made, and two buttons "OK" and "Cancel".

solara/lab/components/tabs.py

@@ -17,9 +17,9 @@ def Tab(
 ):
     """An item in a Tabs component.
 
-    (*Note: [This component is experimental and its API may change in the future](/docs/lab).*)
+    (*Note: [This component is experimental and its API may change in the future](/documentation/getting_started/lab).*)
 
-    Should be a direct child of a [Tabs](/api/tabs).
+    Should be a direct child of a [Tabs](/documentation/components/lab/tabs).
 
     ## Arguments
      * `label`: The label of the tab.
@@ -62,12 +62,12 @@ def Tabs(
 ):
     """A tabbed container showing one tab at a time.
 
-    (*Note: [This component is experimental and its API may change in the future](/docs/lab).*)
+    (*Note: [This component is experimental and its API may change in the future](/documentation/getting_started/lab).*)
 
-    Note that if Tabs are used as a child of the [AppBar](/api/appbar) component, the tabs
+    Note that if Tabs are used as a child of the [AppBar](/documentation/components/layout/app_bar) component, the tabs
     will be placed under the app bar. See our [authorization app](/apps/authorization) for an example.
 
-    If the children [Tab](/api/tab) elements are passed a `path_or_route` argument, the active tab
+    If the children [Tab](/documentation/components/lab/tab) elements are passed a `path_or_route` argument, the active tab
     will be based on the path of the current page.
 
 
@@ -89,7 +89,7 @@ def Tabs(
 
     ### Tabs with content
 
-    This is usually only used when the tabs are placed in the [AppBar](/api/appbar) component.
+    This is usually only used when the tabs are placed in the [AppBar](/documentation/components/layout/app_bar) component.
 
     ```solara
     import solara

solara/reactive.py

@@ -14,7 +14,7 @@ def reactive(value: T) -> Reactive[T]:
     Solara web applications. They provide an easy-to-use mechanism for keeping
     track of the changing state of data and for propagating those changes to
     the appropriate UI components. For managing local or component-specific
-    state, consider using the [`solara.use_state()`](/api/use_state) function.
+    state, consider using the [`solara.use_state()`](/documentation/api/hooks/use_state) function.
 
 
     Reactive variables can be accessed using the `.value` attribute. To modify

solara/routing.py

@@ -101,7 +101,7 @@ def use_route_level():
 def use_router() -> Router:
     """Returns the current router object.
 
-    See also [Understanding Routing](/docs/understanding/routing).
+    See also [Understanding Routing](/documentation/advanced/understanding/routing).
 
     `use_router` returns the current router object. This is useful to build custom routing.
 
@@ -123,7 +123,7 @@ def use_router() -> Router:
         router = solara.use_router()
 
         def redirect():
-            router.push(f"/api/use_route")
+            router.push(f"/documentation/api/routing/use_route")
 
         solara.Button("Navigate using an event", on_click=redirect)
     ```
@@ -138,7 +138,7 @@ def use_route(
 ) -> Tuple[Optional[solara.Route], List[solara.Route]]:
     """Returns (if found) the current route that matches the pathname, or None
 
-    See also [Understanding Routing](/docs/understanding/routing).
+    See also [Understanding Routing](/documentation/advanced/understanding/routing).
 
     `use_route` returns (if found) the current route that matches the pathname, or None. It also returns all resolved routes of that level
     (i.e. all siblings and itself). This return tuple is useful to build custom navigation (e.g. using tabs or buttons).
@@ -166,9 +166,10 @@ def use_route(
 
     Note that all routes are relative, since a component does not know if it is embedded into a larger application, which may also do routing.
     Therefore you should never use the `route.path` for navigation since the route object has no knowledge of the full url
-    (e.g. `/api/use_route/fruit/banana`) but only knows its small piece of the pathname (e.g. `banana`)
+    (e.g. `/documentation/api/routing/use_route/fruit/banana`) but only knows its small piece of the pathname (e.g. `banana`)
 
-    Use [`resolve_path`](/api/resolve_path) to request the full url for navigation, or simply use the `Link` component that can do this for us.
+    Use [`resolve_path`](/documentation/api/routing/resolve_path) to request the full url for navigation,
+        or simply use the `Link` component that can do this for us.
 
     If the current route has children, any child component that calls `use_route` will return the matched route and its siblings of our children.
 
@@ -229,12 +230,12 @@ def resolve_path(path_or_route: Union[str, solara.Route], level=0) -> str:
 
     ## Arguments
 
-     * path_or_route: a path string or a [`solara.Route`](/api/route) object to resolve.
+     * path_or_route: a path string or a [`solara.Route`](/documentation/api/routing/route) object to resolve.
 
     ## See also
 
-     * [Multipage](/docs/howto/multipage).
-     * [Understanding Routing](/docs/understanding/routing).
+     * [Multipage](/documentation/advanced/howto/multipage).
+     * [Understanding Routing](/documentation/advanced/understanding/routing).
 
 
     """

solara/server/app.py

@@ -1,3 +1,4 @@
+import dataclasses
 import importlib.util
 import logging
 import os
@@ -5,6 +6,7 @@ import pickle
 import sys
 import threading
 import traceback
+import warnings
 from enum import Enum
 from pathlib import Path
 from typing import Any, Dict, List, Optional, cast
@@ -14,6 +16,7 @@ import reacton
 from reacton.core import Element, render
 
 import solara
+from solara.util import nested_get
 
 from . import kernel_context, patch, reload, settings
 from .kernel import Kernel
@@ -149,9 +152,24 @@ class AppScript:
                 routes = solara.generate_routes(mod)
 
         app = solara.autorouting.RenderPage(self.app_name)
-        if not hasattr(routes[0].module, self.app_name) and routes[0].children:
+
+        # when the root moduled defined routes, skip the enclosing route object
+        if len(routes) == 1 and routes[0].module and hasattr(routes[0].module, "routes"):
+            if routes[0].component:
+                warnings.warn(
+                    f"{self.name} has a component defined, but you are also defining routes."
+                    " To avoid confusing, consider renaming the {self.app_name} component."
+                )
             routes = routes[0].children
 
+        if self.app_name != "Page":
+            # if we specified the app name, we replace the component
+            if len(routes) > 1:
+                raise ValueError(f"App {self.name} has multiple routes, but a default app name was given: {self.app_name}")
+            assert len(routes) == 1
+            component = nested_get(routes[0].module.__dict__, self.app_name, None)
+            routes = [dataclasses.replace(routes[0], component=component)]
+
         if settings.ssg.build_path is None:
             settings.ssg.build_path = self.directory.parent.resolve() / "build"
 
@@ -231,6 +249,31 @@ class AppScript:
 
             solara.lab.toestand.ConnectionStore._type_counter.clear()
 
+            # we need to remove callbacks that are added in the app code
+            # which will be re-executed after the reload and we do not
+            # want to keep executing the old ones.
+            for kc in kernel_context._on_kernel_start_callbacks.copy():
+                callback, path, module, cleanup = kc
+                will_reload = False
+                if module is not None:
+                    module_name = module.__name__
+                    if module_name in reload.reloader.get_reload_module_names():
+                        will_reload = True
+                elif path is not None:
+                    if str(path.resolve()).startswith(str(self.directory)):
+                        will_reload = True
+                    else:
+                        logger.warning(
+                            "script %s is not in the same directory as the app %s but is using on_kernel_start, "
+                            "this might lead to multiple entries, and might indicate a bug.",
+                            path,
+                            self.directory,
+                        )
+
+                if will_reload:
+                    logger.info("reload: Removing on_kernel_start callback: %s (since it will be added when reloaded)", callback)
+                    cleanup()
+
             context_values = list(kernel_context.contexts.values())
             # save states into the context so the hot reload will
             # keep the same state

solara/server/assets/style.css

@@ -23,6 +23,12 @@ code::before {
     box-shadow: unset !important;
 }
 
+.v-application--wrap .v-application--wrap {
+  /* disable min-height: 100vh set by vuetify for nested apps */
+  min-height: unset;
+}
+
+
 div.highlight pre code {
     /* box-shadow: 0 2px 1px -1px rgb(0 0 0 / 20%), 0 1px 1px 0 rgb(0 0 0 / 14%), 0 1px 3px 0 rgb(0 0 0 / 12%); */
     /* border: 1px #333 solid; */

solara/server/esm.py

@@ -2,15 +2,22 @@
 # in the future, we may want to move the esm features of ipyreact
 # into a separate package, and then we can import it unconditionally
 import logging
+import threading
+from collections import defaultdict
 from pathlib import Path
 from typing import Dict, List, Tuple, Union
 
 import ipyreact.importmap
 import ipyreact.module
 
+from solara.server import kernel_context
+
 logger = logging.getLogger("solara.server.esm")
+lock = threading.Lock()
 
 _modules: Dict[str, Tuple[Union[str, Path], List[str]]] = {}
+_modules_added_per_kernel: Dict[str, Dict[str, ipyreact.module.Module]] = defaultdict(dict)
+_import_map_per_kernel: Dict[str, ipyreact.importmap.ImportMap] = {}
 
 
 # in solara server, we'll monkey patch ipyreact.module with this
@@ -29,10 +36,20 @@ def get_module_names():
 
 
 def create_modules():
+    kernel_id = kernel_context.get_current_context().id
+    _modules_added = _modules_added_per_kernel[kernel_id]
     logger.info("define modules %s", _modules)
     widgets = {}
-    for name, (module, dependencies) in _modules.items():
-        widgets[name] = create_module(name, module, dependencies=dependencies)
+    with lock:
+        for name, (module, dependencies) in _modules.items():
+            if name not in _modules_added:
+                _modules_added[name] = create_module(name, module, dependencies=dependencies)
+                logger.info("create module %s %s %s", name, module, dependencies)
+            else:
+                _modules_added[name].code = module if not isinstance(module, Path) else module.read_text(encoding="utf8")
+                _modules_added[name].dependencies = dependencies
+                logger.info("update module %s %s %s", name, module, dependencies)
+            widgets[name] = _modules_added[name]
     return widgets
 
 
@@ -41,5 +58,12 @@ def create_module(name, module: Union[str, Path], dependencies: List[str]):
 
 
 def create_import_map():
-    logger.info("create import map %s", ipyreact.importmap._effective_import_map)
-    return ipyreact.importmap.ImportMap(import_map=ipyreact.importmap._effective_import_map)
+    kernel_id = kernel_context.get_current_context().id
+    with lock:
+        if kernel_id not in _import_map_per_kernel:
+            _import_map_per_kernel[kernel_id] = ipyreact.importmap.ImportMap(import_map=ipyreact.importmap._effective_import_map)
+            logger.info("create import map %s", ipyreact.importmap._effective_import_map)
+        else:
+            _import_map_per_kernel[kernel_id].import_map = ipyreact.importmap._effective_import_map
+            logger.info("update import map %s", ipyreact.importmap._effective_import_map)
+    return

solara/server/kernel_context.py

@@ -1,13 +1,22 @@
 import asyncio
+
+try:
+    import contextvars
+except ModuleNotFoundError:
+    contextvars = None  # type: ignore
+
 import dataclasses
 import enum
+import inspect
 import logging
 import os
 import pickle
 import threading
 import time
+import typing
 from pathlib import Path
-from typing import Any, Callable, Dict, List, Optional, cast
+from types import FrameType, ModuleType
+from typing import Any, Callable, Dict, List, NamedTuple, Optional, cast
 
 import ipywidgets as widgets
 import reacton
@@ -36,11 +45,46 @@ class PageStatus(enum.Enum):
     CLOSED = "closed"
 
 
-_on_kernel_start_callbacks: List[Callable[[], Optional[Callable[[], None]]]] = []
+class _on_kernel_callback_entry(NamedTuple):
+    callback: Callable[[], Optional[Callable[[], None]]]
+    callpoint: Optional[Path]
+    module: Optional[ModuleType]
+    cleanup: Callable[[], None]
+
+
+_on_kernel_start_callbacks: List[_on_kernel_callback_entry] = []
+
+
+def _find_root_module_frame() -> Optional[FrameType]:
+    # basically the module where the call stack origined from
+    current_frame = inspect.currentframe()
+    root_module_frame = None
+
+    while current_frame is not None:
+        if current_frame.f_code.co_name == "<module>":
+            root_module_frame = current_frame
+            break
+        current_frame = current_frame.f_back
+
+    return root_module_frame
 
 
-def on_kernel_start(f: Callable[[], Optional[Callable[[], None]]]):
-    _on_kernel_start_callbacks.append(f)
+def on_kernel_start(f: Callable[[], Optional[Callable[[], None]]]) -> Callable[[], None]:
+    root = _find_root_module_frame()
+    path: Optional[Path] = None
+    module: Optional[ModuleType] = None
+    if root is not None:
+        path_str = inspect.getsourcefile(root)
+        module = inspect.getmodule(root)
+        if path_str is not None:
+            path = Path(path_str)
+
+    def cleanup():
+        return _on_kernel_start_callbacks.remove(kce)
+
+    kce = _on_kernel_callback_entry(f, path, module, cleanup)
+    _on_kernel_start_callbacks.append(kce)
+    return cleanup
 
 
 @dataclasses.dataclass
@@ -74,7 +118,7 @@ class VirtualKernelContext:
 
     def __post_init__(self):
         with self:
-            for f in _on_kernel_start_callbacks:
+            for (f, *_) in _on_kernel_start_callbacks:
                 cleanup = f()
                 if cleanup:
                     self.on_close(cleanup)
@@ -255,12 +299,35 @@ def create_dummy_context():
     return kernel_context
 
 
+if contextvars is not None:
+    if typing.TYPE_CHECKING:
+        async_context_id = contextvars.ContextVar[str]("async_context_id")
+    else:
+        async_context_id = contextvars.ContextVar("async_context_id")
+    async_context_id.set("default")
+else:
+    async_context_id = None
+
+
 def get_current_thread_key() -> str:
-    thread = threading.current_thread()
-    return get_thread_key(thread)
+    if not solara.server.settings.kernel.threaded:
+        if async_context_id is not None:
+            try:
+                key = async_context_id.get()
+            except LookupError:
+                raise RuntimeError("no kernel context set")
+        else:
+            raise RuntimeError("No threading support, and no contextvars support (Python 3.6 is not supported for this)")
+    else:
+        thread = threading.current_thread()
+        key = get_thread_key(thread)
+    return key
 
 
 def get_thread_key(thread: threading.Thread) -> str:
+    if not solara.server.settings.kernel.threaded:
+        if async_context_id is not None:
+            return async_context_id.get()
     thread_key = thread._name + str(thread._ident)  # type: ignore
     return thread_key
 
@@ -318,6 +385,7 @@ def initialize_virtual_kernel(session_id: str, kernel_id: str, websocket: websoc
             widgets.register_comm_target(kernel)
             appmodule.register_solara_comm_target(kernel)
     with context:
+        assert has_current_context()
         assert kernel is Kernel.instance()
         kernel.shell_stream = WebsocketStreamWrapper(websocket, "shell")
         kernel.control_stream = WebsocketStreamWrapper(websocket, "control")

solara/server/patch.py

@@ -295,7 +295,10 @@ def _WidgetContextAwareThread__bootstrap(self):
         # we need to call this manually, because set_context_for_thread
         # uses this, and the original _bootstrap calls it too late for us
         self._set_ident()
+        if kernel_context.async_context_id is not None:
+            kernel_context.async_context_id.set(self.current_context.id)
         kernel_context.set_context_for_thread(self.current_context, self)
+
         shell = self.current_context.kernel.shell
         shell.display_pub.register_hook(shell.display_in_reacton_hook)
     try:

solara/server/reload.py

@@ -152,13 +152,13 @@ class Reloader:
             self._first = False
 
     def _on_change(self, name):
-        # used for testing
-        self.reload_event_next.set()
         # flag that we need to reload all modules next time
         self.requires_reload = True
         # and forward callback
         if self.on_change:
             self.on_change(name)
+        # used for testing
+        self.reload_event_next.set()
 
     def close(self):
         self.watcher.close()

solara/server/server.py

@@ -13,7 +13,6 @@ import ipyvue
 import ipywidgets
 import jinja2
 import requests
-
 import solara
 import solara.routing
 import solara.settings
@@ -35,6 +34,7 @@ ipykernel_major = int(ipykernel.__version__.split(".")[0])
 ipywidgets_major = int(ipywidgets.__version__.split(".")[0])
 cache_memory = solara.cache.Memory(max_items=128)
 vue3 = ipyvue.__version__.startswith("3")
+_redirects: Dict[str, str] = {}
 
 # first look at the project directory, then the builtin solara directory
 
@@ -302,9 +302,9 @@ def read_root(path: str, root_path: str = "", render_kwargs={}, use_nbextensions
             code = content_utf8
         elif embed:
             content_utf8 = content.decode("utf-8")
-            code = f"<style>/*\npath={path}\n*/\n{content_utf8}</style>"
+            code = f'<style class="solara-template-css">/*\npath={path}\n*/\n{content_utf8}</style>'
         else:
-            code = f'<link rel="stylesheet" type="text/css" href="{url}">'
+            code = f'<link rel="stylesheet" type="text/css" href="{url}" class="solara-template-css">'
         return Markup(code)
 
     def include_js(path: str, module=False) -> Markup: