dara-core 1.21.4__py3-none-any.whl → 1.21.5__py3-none-any.whl

dara/core/defaults.py

@@ -34,7 +34,7 @@ from dara.core.interactivity.actions import (
     UpdateVariableDef,
 )
 from dara.core.internal.cache_store import CacheStore
-from dara.core.router import Link, LinkDef, MenuLink, MenuLinkDef, Outlet, OutletDef
+from dara.core.router import Link, LinkDef, MenuLink, MenuLinkDef, Navigate, NavigateDef, Outlet, OutletDef
 from dara.core.visual.components import (
     DefaultFallbackDef,
     DynamicComponent,
@@ -90,6 +90,7 @@ CORE_COMPONENTS: Dict[str, ComponentTypeAnnotation] = {
     For.__name__: ForDef,
     Link.__name__: LinkDef,
     Outlet.__name__: OutletDef,
+    Navigate.__name__: NavigateDef,
     PoweredByCausalens.__name__: PoweredByCausalensDef,
     ThemeProvider.__name__: ThemeProviderDef,
 }

dara/core/router/components.py

@@ -3,6 +3,7 @@ from typing import Annotated, Any, Literal, Optional, Union
 from pydantic import BaseModel, BeforeValidator
 
 from dara.core.definitions import ComponentInstance, JsComponentDef, StyledComponentInstance, transform_raw_css
+from dara.core.interactivity import ClientVariable
 
 
 class RouterPath(BaseModel):
@@ -31,6 +32,30 @@ class Outlet(ComponentInstance):
     """
 
 
+NavigateDef = JsComponentDef(name='Navigate', js_module='@darajs/core', py_module='dara.core')
+
+
+class Navigate(ComponentInstance):
+    """
+    Navigate component immediately redirects to the specified route when rendered.
+    Can be useful for defining default redirects in some pages.
+
+    ```python
+    from dara.core.router import Navigate
+
+    def MyPage():
+        # always redirects to /some-route
+        return Navigate(to='/some-route')
+    ```
+    """
+
+    to: Union[str, RouterPath, ClientVariable]
+
+    replace: bool = False
+
+    relative: Literal['route', 'path'] = 'route'
+
+
 LinkDef = JsComponentDef(name='Link', js_module='@darajs/core', py_module='dara.core')
 
 
@@ -91,7 +116,7 @@ class Link(StyledComponentInstance):
     ```
     """
 
-    to: Union[str, RouterPath]
+    to: Union[str, RouterPath, ClientVariable]
     """
     Can be a string or RouterPath object
     """

dara/core/umd/dara.core.umd.cjs

@@ -56822,7 +56822,7 @@ Please change the parent <Route path="${parentPath}"> to <Route path="${parentPa
       }
     );
   }
-  function Navigate({
+  function Navigate$1({
     to,
     replace: replace22,
     state,
@@ -64016,7 +64016,7 @@ ${String(error)}`;
     MemoryRouter,
     Meta,
     NavLink,
-    Navigate,
+    Navigate: Navigate$1,
     NavigationType: Action,
     Outlet,
     PrefetchPageLinks,
@@ -74646,7 +74646,7 @@ body,
                 // fallback route, redirect to first navigatable path
                 {
                   path: "*",
-                  element: /* @__PURE__ */ React__namespace.createElement(Navigate, { to: defaultPath })
+                  element: /* @__PURE__ */ React__namespace.createElement(Navigate$1, { to: defaultPath })
                 }
               ]
             }
@@ -98207,6 +98207,7 @@ body,
     const [style, css2] = useComponentStyles(props);
     const [activeStyle, activeCss] = useComponentStyles(props, true, "active_css");
     const [inactiveStyle, inactiveCss] = useComponentStyles(props, false, "inactive_css");
+    const [to] = useVariable(props.to);
     const preloadRoute = usePreloadRoute();
     const preloadTimeoutRef = React__namespace.useRef(null);
     const clearPreloadTimeout = React__namespace.useCallback(() => {
@@ -98219,17 +98220,17 @@ body,
       if (!props.prefetch) {
         return;
       }
-      preloadRoute(props.to);
-    }, [props.prefetch, preloadRoute, props.to]);
+      preloadRoute(to);
+    }, [props.prefetch, preloadRoute, to]);
     const handleDelayedPreload = React__namespace.useCallback(() => {
       if (!props.prefetch) {
         return;
       }
       clearPreloadTimeout();
       preloadTimeoutRef.current = window.setTimeout(() => {
-        preloadRoute(props.to);
+        preloadRoute(to);
       }, 20);
-    }, [props.prefetch, props.to, clearPreloadTimeout, preloadRoute]);
+    }, [props.prefetch, to, clearPreloadTimeout, preloadRoute]);
     const handleMouseMove = React__namespace.useCallback(() => {
       handleDelayedPreload();
     }, [handleDelayedPreload]);
@@ -98249,7 +98250,7 @@ body,
       {
         id: props.id_,
         className: props.className,
-        to: props.to,
+        to,
         end: props.end,
         caseSensitive: props.case_sensitive,
         replace: props.replace,
@@ -98594,6 +98595,11 @@ body,
     const { suspend } = useFallbackCtx();
     return /* @__PURE__ */ React__namespace.createElement(fallbackCtx.Provider, { value: { suspend: false } }, /* @__PURE__ */ React__namespace.createElement(ForImpl, { ...props, suspend }));
   }
+  function Navigate(props) {
+    const { to, ...rest } = props;
+    const [toValue] = useVariable(to);
+    return /* @__PURE__ */ React.createElement(Navigate$1, { to: toValue, ...rest });
+  }
   const StyledDiv = injectCss(styled.div`
     /* empty */
 `);
@@ -98632,6 +98638,7 @@ body,
   exports.LoaderError = LoaderError;
   exports.Menu = Menu;
   exports.MenuLink = MenuLink;
+  exports.Navigate = Navigate;
   exports.NavigateTo = NavigateTo;
   exports.Notifications = index$1;
   exports.Notify = Notify;

{dara_core-1.21.4.dist-info → dara_core-1.21.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: dara-core
-Version: 1.21.4
+Version: 1.21.5
 Summary: Dara Framework Core
 Home-page: https://dara.causalens.com/
 License: Apache-2.0
@@ -21,10 +21,10 @@ Requires-Dist: cachetools (>=5.0.0,<6.0.0)
 Requires-Dist: certifi (>=2024.7.4)
 Requires-Dist: click (==8.1.3)
 Requires-Dist: colorama (>=0.4.6,<0.5.0)
-Requires-Dist: create-dara-app (==1.21.4)
+Requires-Dist: create-dara-app (==1.21.5)
 Requires-Dist: croniter (>=1.0.15,<3.0.0)
 Requires-Dist: cryptography (>=42.0.4)
-Requires-Dist: dara-components (==1.21.4) ; extra == "all"
+Requires-Dist: dara-components (==1.21.5) ; extra == "all"
 Requires-Dist: exceptiongroup (>=1.1.3,<2.0.0)
 Requires-Dist: fastapi (>=0.115.0,<0.116.0)
 Requires-Dist: fastapi_vite_dara (==0.4.0)
@@ -55,7 +55,7 @@ Description-Content-Type: text/markdown
 
 # Dara Application Framework
 
-<img src="https://github.com/causalens/dara/blob/v1.21.4/img/dara_light.svg?raw=true">
+<img src="https://github.com/causalens/dara/blob/v1.21.5/img/dara_light.svg?raw=true">
 
 ![Master tests](https://github.com/causalens/dara/actions/workflows/tests.yml/badge.svg?branch=master)
 [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://www.apache.org/licenses/LICENSE-2.0)
@@ -100,7 +100,7 @@ source .venv/bin/activate
 dara start
 ```
 
-![Dara App](https://github.com/causalens/dara/blob/v1.21.4/img/components_gallery.png?raw=true)
+![Dara App](https://github.com/causalens/dara/blob/v1.21.5/img/components_gallery.png?raw=true)
 
 Note: `pip` installation uses [PEP 660](https://peps.python.org/pep-0660/) `pyproject.toml`-based editable installs which require `pip >= 21.3` and `setuptools >= 64.0.0`. You can upgrade both with:
 
@@ -117,9 +117,9 @@ Explore some of our favorite apps - a great way of getting started and getting t
 
 | Dara App                                                                                                 | Description                                                                                                                                                                                                       |
 | -------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| ![Large Language Model](https://github.com/causalens/dara/blob/v1.21.4/img/llm.png?raw=true)              | Demonstrates how to use incorporate a LLM chat box into your decision app to understand model insights                                                                                                            |
-| ![Plot Interactivity](https://github.com/causalens/dara/blob/v1.21.4/img/plot_interactivity.png?raw=true) | Demonstrates how to enable the user to interact with plots, trigger actions based on clicks, mouse movements and other interactions with `Bokeh` or `Plotly` plots                                                |
-| ![Graph Editor](https://github.com/causalens/dara/blob/v1.21.4/img/graph_viewer.png?raw=true)             | Demonstrates how to use the `CausalGraphViewer` component to display your graphs or networks, customising the displayed information through colors and tooltips, and updating the page based on user interaction. |
+| ![Large Language Model](https://github.com/causalens/dara/blob/v1.21.5/img/llm.png?raw=true)              | Demonstrates how to use incorporate a LLM chat box into your decision app to understand model insights                                                                                                            |
+| ![Plot Interactivity](https://github.com/causalens/dara/blob/v1.21.5/img/plot_interactivity.png?raw=true) | Demonstrates how to enable the user to interact with plots, trigger actions based on clicks, mouse movements and other interactions with `Bokeh` or `Plotly` plots                                                |
+| ![Graph Editor](https://github.com/causalens/dara/blob/v1.21.5/img/graph_viewer.png?raw=true)             | Demonstrates how to use the `CausalGraphViewer` component to display your graphs or networks, customising the displayed information through colors and tooltips, and updating the page based on user interaction. |
 
 Check out our [App Gallery](https://dara.causalens.com/gallery) for more inspiration!
 
@@ -146,9 +146,9 @@ And the supporting UI packages and tools.
 - `ui-utils` - miscellaneous utility functions
 - `ui-widgets` - widget components
 
-More information on the repository structure can be found in the [CONTRIBUTING.md](https://github.com/causalens/dara/blob/v1.21.4/CONTRIBUTING.md) file.
+More information on the repository structure can be found in the [CONTRIBUTING.md](https://github.com/causalens/dara/blob/v1.21.5/CONTRIBUTING.md) file.
 
 ## License
 
-Dara is open-source and licensed under the [Apache 2.0 License](https://github.com/causalens/dara/blob/v1.21.4/LICENSE).
+Dara is open-source and licensed under the [Apache 2.0 License](https://github.com/causalens/dara/blob/v1.21.5/LICENSE).
 

{dara_core-1.21.4.dist-info → dara_core-1.21.5.dist-info}/RECORD

@@ -11,7 +11,7 @@ dara/core/cli.py,sha256=V__LAK3ozWGsVTEQHqvJwqSfpC3o6R76YGABJ-YVoSE,8185
 dara/core/configuration.py,sha256=caPebHNUmYqh9czEBwQiIDjGrH8ltsphayZICj1CRhc,23489
 dara/core/css.py,sha256=UkNZ6n7RDBLsHmpZvn_a3K2nAwxVggQJbQMKNbgXONA,1753
 dara/core/data_utils.py,sha256=RD5_GdyGyGr1LVThCo8mpuOMWrd9_c1iyRqjuyoarXM,12578
-dara/core/defaults.py,sha256=J1-IX4nKcE6kXzqx7kq1ereU4MKXiMitZxSZo2rs7-U,4681
+dara/core/defaults.py,sha256=y-PU4DhF3uEEfrFmlJnenM8jhnQDTDaOU5kuAYZE2gw,4740
 dara/core/definitions.py,sha256=I4TUJ6zu968T4PNmeqbC-u-DfiKay-4XxurLNASkDz0,18358
 dara/core/http.py,sha256=-OzbCHlYSnfVnw2492C_UmaWOI5oSONfWk03eEGxSRI,4761
 dara/core/interactivity/__init__.py,sha256=ZppwTvxaCsaAdf0qX6j1qTcmbj6wxVcbiaMZfwTVKtU,2679
@@ -90,10 +90,10 @@ dara/core/metrics/utils.py,sha256=inR1Ab5hmWZY2lsgGwLCQOEdyhCD9PumU52X2JbwlKY,22
 dara/core/persistence.py,sha256=ZUmfAjcTwk_oYyaulDrtpiCwIg8vaOw8uTZd2qT4nNo,19410
 dara/core/router/__init__.py,sha256=yGI_MgLQU37ircCtYVNjnhqCjWQxKd5amoNqvMyrhOs,121
 dara/core/router/compat.py,sha256=WAVzDcJFJOVoIQ5inplIhXD58TWsWwTTebTCqpG4nGs,3137
-dara/core/router/components.py,sha256=MDaiQ8Y0-94EH0Jm4j7p9S141k8G4osSbOKSTSu3aOM,4433
+dara/core/router/components.py,sha256=K6bj04_ZPJcU9JQjaxPJkbUeaHtA_jeJNEvCqQbDf3A,5090
 dara/core/router/dependency_graph.py,sha256=AyjSk3DuvCgACrgpID4oSpms1X6GQJUbt-scY5X_LN4,2305
 dara/core/router/router.py,sha256=1r3rFGiftOXC6GP66hKqTdcVNDRJsZWBWvL74wNG4dA,29719
-dara/core/umd/dara.core.umd.cjs,sha256=yL5RNTVCKf39V2ItxpFhMmwBZqFz4BdowFDjrKfH3NU,5148073
+dara/core/umd/dara.core.umd.cjs,sha256=WT-s5ykdLYVEyxpwQ6hYBN_z-Ir72T1RGVLYRNus4j0,5148319
 dara/core/umd/style.css,sha256=yT3PKpi2sKI2-kQIF8xtVbTPQqgpK7-Ua7tfzDPuSsI,4095881
 dara/core/visual/__init__.py,sha256=QN0wbG9HPQ_vXh8BO8DnBXeYLIENVTNtRmYzZf1lx7c,577
 dara/core/visual/components/__init__.py,sha256=nmCsnMLXeZAjkhMYz-mIFodpVY-69IO1fvwwXbFlMQ4,2447
@@ -120,8 +120,8 @@ dara/core/visual/themes/__init__.py,sha256=aM4mgoIYo2neBSw5FRzswsht7PUKjLthiHLmF
 dara/core/visual/themes/dark.py,sha256=UQGDooOc8ric73eHs9E0ltYP4UCrwqQ3QxqN_fb4PwY,1942
 dara/core/visual/themes/definitions.py,sha256=5g83t24w8Ar51Cl9REBJfCU7_DtlashBQeUTKDg3D1M,2862
 dara/core/visual/themes/light.py,sha256=-Tviq8oEwGbdFULoDOqPuHO0UpAZGsBy8qFi0kAGolQ,1944
-dara_core-1.21.4.dist-info/LICENSE,sha256=r9u1w2RvpLMV6YjuXHIKXRBKzia3fx_roPwboGcLqCc,10944
-dara_core-1.21.4.dist-info/METADATA,sha256=B3_u4qs8ZbvfSgO4LKfnS4IUTGM6hhFXEE_O7UUHryo,7534
-dara_core-1.21.4.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-dara_core-1.21.4.dist-info/entry_points.txt,sha256=H__D5sNIGuPIhVam0DChNL-To5k8Y7nY7TAFz9Mz6cc,139
-dara_core-1.21.4.dist-info/RECORD,,
+dara_core-1.21.5.dist-info/LICENSE,sha256=r9u1w2RvpLMV6YjuXHIKXRBKzia3fx_roPwboGcLqCc,10944
+dara_core-1.21.5.dist-info/METADATA,sha256=7oehCtNZ2YNrDUpbrT4kgEJJ63XqSnfDVmzpu18yN90,7534
+dara_core-1.21.5.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+dara_core-1.21.5.dist-info/entry_points.txt,sha256=H__D5sNIGuPIhVam0DChNL-To5k8Y7nY7TAFz9Mz6cc,139
+dara_core-1.21.5.dist-info/RECORD,,