dara-core 1.20.1a1__py3-none-any.whl → 1.20.1a3__py3-none-any.whl

dara/core/visual/components/__init__.py

@@ -16,11 +16,11 @@ limitations under the License.
 """
 
 from inspect import isclass
-from typing import Optional  # needed for model_rebuild
+from typing import Optional  # needed for model_rebuild # noqa: F401
 
 from pydantic import BaseModel
 
-from dara.core.interactivity import Variable  # needed for model_rebuild
+from dara.core.interactivity import Variable  # needed for model_rebuild # noqa: F401
 from dara.core.visual.components.dynamic_component import (
     DynamicComponent,
     DynamicComponentDef,

dara/core/visual/components/fallback.py

@@ -15,12 +15,13 @@ See the License for the specific language governing permissions and
 limitations under the License.
 """
 
-from typing import ClassVar
+from typing import ClassVar, Optional, Union  # noqa: F401
 
-from dara.core.definitions import BaseFallback, JsComponentDef
+from dara.core.definitions import BaseFallback, ComponentInstance, JsComponentDef, StyledComponentInstance  # noqa: F401
 
 DefaultFallbackDef = JsComponentDef(name='DefaultFallback', js_module='@darajs/core', py_module='dara.core')
 RowFallbackDef = JsComponentDef(name='RowFallback', js_module='@darajs/core', py_module='dara.core')
+CustomFallbackDef = JsComponentDef(name='CustomFallback', js_module='@darajs/core', py_module='dara.core')
 
 
 class Fallback:
@@ -47,7 +48,7 @@ class Fallback:
           but will suspend and show a fallback UI after the given timeout if the new state is not ready.
         """
 
-        py_component: ClassVar[str] = 'DefaultFallback'
+        py_component: ClassVar[Union[str, None]] = 'DefaultFallback'
 
     class Row(BaseFallback):
         """
@@ -72,4 +73,29 @@ class Fallback:
           but will suspend and show a fallback UI after the given timeout if the new state is not ready.
         """
 
-        py_component: ClassVar[str] = 'RowFallback'
+        py_component: ClassVar[Union[str, None]] = 'RowFallback'
+
+    class Custom(BaseFallback):
+        """
+        Custom placeholder for a row of content.
+        Accepts any other Dara component in `component` prop.
+
+        :param component: The component to render in place of the actual UI if it has not finished loading.
+        :param suspend_render: bool or int, optional
+
+        Determines the suspense behavior of the component during state updates.
+
+        - If True, the component will always use suspense during state updates.
+          This means the component will suspend rendering and show a fallback UI until the new state is ready.
+
+        - If False, the component will always show the previous state while loading the new state.
+          This means the component will never suspend during state updates. The fallback UI will only
+          be shown on the first render.
+
+        - If a positive integer (default is 200), this denotes the threshold in milliseconds.
+          The component will show the previous state while loading the new state,
+          but will suspend and show a fallback UI after the given timeout if the new state is not ready.
+        """
+
+        py_component: ClassVar[Union[str, None]] = 'CustomFallback'
+        component: StyledComponentInstance

dara/core/visual/components/for_cmp.py

@@ -39,7 +39,8 @@ class For(ComponentInstance):
     # Renders a list of Text component where each item is the corresponding item in the list
     For(
         items=my_list,
-        renderer=Text(text=my_list.list_item)
+        renderer=Text(text=my_list.list_item),
+        placeholder=Text('No items') # fallback component to render if the data source is empty
     )
     ```
 
@@ -139,6 +140,7 @@ class For(ComponentInstance):
 
     :param items: The data source to render the template component for.
     :param renderer: The template component to render for each item in the data source.
+    :param placeholder: The component to render if the data source is empty, i.e. there are no items.
     :param key_accessor: The key accessor to use for the data source. If not provided, the key will be the index of the item in the data source.
     Can be a dotted path to access a nested path in the list item.
     :param virtualization: The virtualization configuration for the component. If provided, the component will be virtualized.
@@ -146,5 +148,6 @@ class For(ComponentInstance):
 
     items: AnyVariable
     renderer: ComponentInstance
+    placeholder: Optional[ComponentInstance] = None
     key_accessor: Optional[str] = None
     virtualization: Optional[VirtualizationConfig] = None

dara/core/visual/css/__init__.py

@@ -18,7 +18,6 @@ limitations under the License.
 # generated by datamodel-codegen:
 #   filename:  css-schema.json
 #   timestamp: 2022-07-07T11:51:57+00:00
-# pylint: disable=line-too-long
 
 from __future__ import annotations
 
@@ -383,11 +382,11 @@ class CSSProperties(DaraBaseModel):
         default=None,
         description='The **`animation-name`** CSS property specifies the names of one or more `@keyframes` at-rules describing the animation or animations to apply to the element.\n\n**Syntax**: `[ none | <keyframes-name> ]#`\n\n**Initial value**: `none`\n\n| Chrome  | Firefox | Safari  |  Edge  |   IE   |\n| :-----: | :-----: | :-----: | :----: | :----: |\n| **43**  | **16**  |  **9**  | **12** | **10** |\n| 3 _-x-_ | 5 _-x-_ | 4 _-x-_ |        |        |',
     )
-    animationPlayState: Literal[
-        '-moz-initial', 'inherit', 'initial', 'paused', 'revert', 'running', 'unset', None
-    ] = Field(
-        default=None,
-        description='The **`animation-play-state`** CSS property sets whether an animation is running or paused.\n\n**Syntax**: `<single-animation-play-state>#`\n\n**Initial value**: `running`\n\n| Chrome  | Firefox | Safari  |  Edge  |   IE   |\n| :-----: | :-----: | :-----: | :----: | :----: |\n| **43**  | **16**  |  **9**  | **12** | **10** |\n| 3 _-x-_ | 5 _-x-_ | 4 _-x-_ |        |        |',
+    animationPlayState: Literal['-moz-initial', 'inherit', 'initial', 'paused', 'revert', 'running', 'unset', None] = (
+        Field(
+            default=None,
+            description='The **`animation-play-state`** CSS property sets whether an animation is running or paused.\n\n**Syntax**: `<single-animation-play-state>#`\n\n**Initial value**: `running`\n\n| Chrome  | Firefox | Safari  |  Edge  |   IE   |\n| :-----: | :-----: | :-----: | :----: | :----: |\n| **43**  | **16**  |  **9**  | **12** | **10** |\n| 3 _-x-_ | 5 _-x-_ | 4 _-x-_ |        |        |',
+        )
     )
     animationTimingFunction: Literal[
         '-moz-initial',
@@ -3507,11 +3506,11 @@ class CSSProperties(DaraBaseModel):
     )
     colorInterpolation: Optional[Property.ColorInterpolation] = None
     colorRendering: Optional[Property.ColorRendering] = None
-    colorScheme: Literal[
-        '-moz-initial', 'dark', 'inherit', 'initial', 'light', 'normal', 'revert', 'unset', None
-    ] = Field(
-        default=None,
-        description='The **`color-scheme`** CSS property allows an element to indicate which color schemes it can comfortably be rendered in.\n\n**Syntax**: `normal | [ light | dark | <custom-ident> ]+`\n\n**Initial value**: `normal`\n\n| Chrome | Firefox | Safari |  Edge  | IE  |\n| :----: | :-----: | :----: | :----: | :-: |\n| **81** |   No    | **13** | **81** | No  |',
+    colorScheme: Literal['-moz-initial', 'dark', 'inherit', 'initial', 'light', 'normal', 'revert', 'unset', None] = (
+        Field(
+            default=None,
+            description='The **`color-scheme`** CSS property allows an element to indicate which color schemes it can comfortably be rendered in.\n\n**Syntax**: `normal | [ light | dark | <custom-ident> ]+`\n\n**Initial value**: `normal`\n\n| Chrome | Firefox | Safari |  Edge  | IE  |\n| :----: | :-----: | :----: | :----: | :-: |\n| **81** |   No    | **13** | **81** | No  |',
+        )
     )
     columnCount: Literal['-moz-initial', 'auto', 'inherit', 'initial', 'revert', 'unset', None] = Field(
         default=None,
@@ -4422,11 +4421,11 @@ class CSSProperties(DaraBaseModel):
         default=None,
         description='The **`font-stretch`** CSS property selects a normal, condensed, or expanded face from a font.\n\n**Syntax**: `<font-stretch-absolute>`\n\n**Initial value**: `normal`\n\n| Chrome | Firefox | Safari |  Edge  |  IE   |\n| :----: | :-----: | :----: | :----: | :---: |\n| **60** |  **9**  | **11** | **12** | **9** |',
     )
-    fontStyle: Literal[
-        '-moz-initial', 'inherit', 'initial', 'italic', 'normal', 'oblique', 'revert', 'unset', None
-    ] = Field(
-        default=None,
-        description='The **`font-style`** CSS property sets whether a font should be styled with a normal, italic, or oblique face from its `font-family`.\n\n**Syntax**: `normal | italic | oblique <angle>?`\n\n**Initial value**: `normal`\n\n| Chrome | Firefox | Safari |  Edge  |  IE   |\n| :----: | :-----: | :----: | :----: | :---: |\n| **1**  |  **1**  | **1**  | **12** | **4** |',
+    fontStyle: Literal['-moz-initial', 'inherit', 'initial', 'italic', 'normal', 'oblique', 'revert', 'unset', None] = (
+        Field(
+            default=None,
+            description='The **`font-style`** CSS property sets whether a font should be styled with a normal, italic, or oblique face from its `font-family`.\n\n**Syntax**: `normal | italic | oblique <angle>?`\n\n**Initial value**: `normal`\n\n| Chrome | Firefox | Safari |  Edge  |  IE   |\n| :----: | :-----: | :----: | :----: | :---: |\n| **1**  |  **1**  | **1**  | **12** | **4** |',
+        )
     )
     fontSynthesis: Literal[
         '-moz-initial', 'inherit', 'initial', 'none', 'revert', 'small-caps', 'style', 'unset', 'weight', None
@@ -4586,11 +4585,11 @@ class CSSProperties(DaraBaseModel):
         default=None,
         description='The **`grid-auto-columns`** CSS property specifies the size of an implicitly-created grid column track or pattern of tracks.\n\n**Syntax**: `<track-size>+`\n\n**Initial value**: `auto`\n\n| Chrome | Firefox |  Safari  |  Edge  |             IE              |\n| :----: | :-----: | :------: | :----: | :-------------------------: |\n| **57** | **70**  | **10.1** | **16** | **10** _(-ms-grid-columns)_ |',
     )
-    gridAutoFlow: Literal[
-        '-moz-initial', 'column', 'dense', 'inherit', 'initial', 'revert', 'row', 'unset', None
-    ] = Field(
-        default=None,
-        description='The **`grid-auto-flow`** CSS property controls how the auto-placement algorithm works, specifying exactly how auto-placed items get flowed into the grid.\n\n**Syntax**: `[ row | column ] || dense`\n\n**Initial value**: `row`\n\n| Chrome | Firefox |  Safari  |  Edge  | IE  |\n| :----: | :-----: | :------: | :----: | :-: |\n| **57** | **52**  | **10.1** | **16** | No  |',
+    gridAutoFlow: Literal['-moz-initial', 'column', 'dense', 'inherit', 'initial', 'revert', 'row', 'unset', None] = (
+        Field(
+            default=None,
+            description='The **`grid-auto-flow`** CSS property controls how the auto-placement algorithm works, specifying exactly how auto-placed items get flowed into the grid.\n\n**Syntax**: `[ row | column ] || dense`\n\n**Initial value**: `row`\n\n| Chrome | Firefox |  Safari  |  Edge  | IE  |\n| :----: | :-----: | :------: | :----: | :-: |\n| **57** | **52**  | **10.1** | **16** | No  |',
+        )
     )
     gridAutoRows: Optional[Union[float_, str]] = Field(
         default=None,
@@ -4662,11 +4661,11 @@ class CSSProperties(DaraBaseModel):
         default=None,
         description='The **`hyphens`** CSS property specifies how words should be hyphenated when text wraps across multiple lines. It can prevent hyphenation entirely, hyphenate at manually-specified points within the text, or let the browser automatically insert hyphens where appropriate.\n\n**Syntax**: `none | manual | auto`\n\n**Initial value**: `manual`\n\n|  Chrome  | Firefox |    Safari     |  Edge  |      IE      |\n| :------: | :-----: | :-----------: | :----: | :----------: |\n|  **55**  | **43**  | **5.1** _-x-_ | **79** | **10** _-x-_ |\n| 13 _-x-_ | 6 _-x-_ |               |        |              |',
     )
-    imageOrientation: Literal[
-        '-moz-initial', 'flip', 'from-image', 'inherit', 'initial', 'revert', 'unset', None
-    ] = Field(
-        default=None,
-        description='The **`image-orientation`** CSS property specifies a layout-independent correction to the orientation of an image. It should _not_ be used for any other orientation adjustments; instead, the `transform` property should be used with the `rotate` `<transform-function>`.\n\n**Syntax**: `from-image | <angle> | [ <angle>? flip ]`\n\n**Initial value**: `from-image`\n\n| Chrome | Firefox |  Safari  |  Edge  | IE  |\n| :----: | :-----: | :------: | :----: | :-: |\n| **81** | **26**  | **13.1** | **81** | No  |',
+    imageOrientation: Literal['-moz-initial', 'flip', 'from-image', 'inherit', 'initial', 'revert', 'unset', None] = (
+        Field(
+            default=None,
+            description='The **`image-orientation`** CSS property specifies a layout-independent correction to the orientation of an image. It should _not_ be used for any other orientation adjustments; instead, the `transform` property should be used with the `rotate` `<transform-function>`.\n\n**Syntax**: `from-image | <angle> | [ <angle>? flip ]`\n\n**Initial value**: `from-image`\n\n| Chrome | Firefox |  Safari  |  Edge  | IE  |\n| :----: | :-----: | :------: | :----: | :-: |\n| **81** | **26**  | **13.1** | **81** | No  |',
+        )
     )
     imageRendering: Optional[Property.ImageRendering] = Field(
         default=None,
@@ -5024,11 +5023,11 @@ class CSSProperties(DaraBaseModel):
         default=None,
         description='The **`line-height-step`** CSS property sets the step unit for line box heights. When the property is set, line box heights are rounded up to the closest multiple of the unit.\n\n**Syntax**: `<length>`\n\n**Initial value**: `0`\n\n| Chrome | Firefox | Safari | Edge | IE  |\n| :----: | :-----: | :----: | :--: | :-: |\n|  n/a   |   No    |   No   | n/a  | No  |',
     )
-    listStyle: Literal[
-        '-moz-initial', 'inherit', 'initial', 'inside', 'none', 'outside', 'revert', 'unset', None
-    ] = Field(
-        default=None,
-        description="The **`list-style`** CSS shorthand property allows you set all the list style properties at once.\n\n**Syntax**: `<'list-style-type'> || <'list-style-position'> || <'list-style-image'>`\n\n| Chrome | Firefox | Safari |  Edge  |  IE   |\n| :----: | :-----: | :----: | :----: | :---: |\n| **1**  |  **1**  | **1**  | **12** | **4** |",
+    listStyle: Literal['-moz-initial', 'inherit', 'initial', 'inside', 'none', 'outside', 'revert', 'unset', None] = (
+        Field(
+            default=None,
+            description="The **`list-style`** CSS shorthand property allows you set all the list style properties at once.\n\n**Syntax**: `<'list-style-type'> || <'list-style-position'> || <'list-style-image'>`\n\n| Chrome | Firefox | Safari |  Edge  |  IE   |\n| :----: | :-----: | :----: | :----: | :---: |\n| **1**  |  **1**  | **1**  | **12** | **4** |",
+        )
     )
     listStyleImage: Literal['-moz-initial', 'inherit', 'initial', 'none', 'revert', 'unset', None] = Field(
         default=None,

dara/core/visual/dynamic_component.py

@@ -14,8 +14,12 @@ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and
 limitations under the License.
 """
+
+import contextlib
 import json
 import uuid
+from collections import OrderedDict
+from collections.abc import Mapping
 from contextvars import ContextVar
 from functools import wraps
 from inspect import Parameter, Signature, isclass, signature
@@ -24,24 +28,18 @@ from typing import (
     Callable,
     ClassVar,
     Dict,
-    Mapping,
     Optional,
-    OrderedDict,
     Union,
     overload,
 )
 
+import anyio
 from fastapi.encoders import jsonable_encoder
 
 from dara.core.base_definitions import BaseTask
 from dara.core.definitions import BaseFallback, ComponentInstance, PyComponentDef
-from dara.core.interactivity import (
-    AnyDataVariable,
-    AnyVariable,
-    DerivedVariable,
-    UrlVariable,
-    Variable,
-)
+from dara.core.interactivity import AnyVariable
+from dara.core.interactivity.state_variable import StateVariable
 from dara.core.internal.cache_store import CacheStore
 from dara.core.internal.dependency_resolution import resolve_dependency
 from dara.core.internal.encoder_registry import deserialize
@@ -63,8 +61,7 @@ class PyComponentInstance(ComponentInstance):
 
 # sync/async simple
 @overload
-def py_component(function: Callable) -> Callable[..., PyComponentInstance]:
-    ...
+def py_component(function: Callable) -> Callable[..., PyComponentInstance]: ...
 
 
 # sync/async with args
@@ -72,19 +69,18 @@ def py_component(function: Callable) -> Callable[..., PyComponentInstance]:
 def py_component(
     function: None = None,
     *,
-    placeholder: Optional[BaseFallback] = None,
-    fallback: Optional[BaseFallback] = None,
+    placeholder: Optional[Union[BaseFallback, ComponentInstance]] = None,
+    fallback: Optional[Union[BaseFallback, ComponentInstance]] = None,
     track_progress: Optional[bool] = False,
     polling_interval: Optional[int] = None,
-) -> Callable[[Callable], Callable[..., PyComponentInstance]]:
-    ...
+) -> Callable[[Callable], Callable[..., PyComponentInstance]]: ...
 
 
 def py_component(
     function: Optional[Callable] = None,
     *,
-    placeholder: Optional[BaseFallback] = None,
-    fallback: Optional[BaseFallback] = None,
+    placeholder: Optional[Union[BaseFallback, ComponentInstance]] = None,
+    fallback: Optional[Union[BaseFallback, ComponentInstance]] = None,
     track_progress: Optional[bool] = False,
     polling_interval: Optional[int] = None,
 ) -> Union[Callable[..., PyComponentInstance], Callable[[Callable], Callable[..., PyComponentInstance]]]:
@@ -160,10 +156,9 @@ def py_component(
             for key, value in all_kwargs.items():
                 if key in func.__annotations__:
                     valid_value = True
-                    try:
+                    # The type is either not set or something tricky to verify, e.g. union
+                    with contextlib.suppress(Exception):
                         valid_value = isinstance(value, (func.__annotations__[key], AnyVariable))
-                    except Exception:
-                        pass  # The type is either not set or something tricky to verify, e.g. union
                     if not valid_value:
                         raise TypeError(
                             f'Argument: {key} was passed as a {type(value)}, but it should be '
@@ -174,6 +169,12 @@ def py_component(
             dynamic_kwargs: Dict[str, AnyVariable] = {}
             static_kwargs: Dict[str, Any] = {}
             for key, kwarg in all_kwargs.items():
+                if isinstance(kwarg, StateVariable):
+                    raise ValueError(
+                        'StateVariable cannot be used as input to py_component. '
+                        'StateVariables are internal variables for tracking DerivedVariable client state and using them as inputs would create complex dependencies that are '
+                        'difficult to debug. Consider using the StateVariable with an If component or SwitchVariable.'
+                    )
                 if isinstance(kwarg, AnyVariable):
                     dynamic_kwargs[key] = kwarg
                 else:
@@ -200,9 +201,7 @@ def py_component(
         params = OrderedDict()
         for var_name, typ in func.__annotations__.items():
             if isclass(typ):
-                new_type = Union[
-                    typ, Variable[typ], DerivedVariable[typ], UrlVariable[typ], AnyDataVariable  # type: ignore
-                ]
+                new_type = Union[typ, AnyVariable]
                 if old_signature.parameters.get(var_name) is not None:
                     params[var_name] = old_signature.parameters[var_name].replace(annotation=new_type)
                 new_annotations[var_name] = new_type
@@ -210,8 +209,8 @@ def py_component(
         _inner_func.__signature__ = Signature(  # type: ignore
             parameters=list(params.values()), return_annotation=old_signature.return_annotation
         )
-        _inner_func.__wrapped_by__ = py_component   # type: ignore
-        return _inner_func   # type: ignore
+        _inner_func.__wrapped_by__ = py_component  # type: ignore
+        return _inner_func  # type: ignore
 
     # If decorator is called with no optional argument then the function is passed as first argument
     if function:
@@ -251,12 +250,15 @@ async def render_component(
         annotations = definition.func.__annotations__
         resolved_dyn_kwargs = {}
 
-        for key, value in values.items():
-            val = await resolve_dependency(value, store, task_mgr)
+        async def _resolve_kwarg(val: Any, key: str):
+            val = await resolve_dependency(val, store, task_mgr)
             typ = annotations.get(key)
-
             resolved_dyn_kwargs[key] = deserialize(val, typ)
 
+        async with anyio.create_task_group() as tg:
+            for key, value in values.items():
+                tg.start_soon(_resolve_kwarg, value, key)
+
         # Merge resolved dynamic kwargs with static kwargs received
         resolved_kwargs = {**resolved_dyn_kwargs, **static_kwargs}
 
@@ -290,6 +292,7 @@ async def render_component(
             eng_logger.info(
                 f'PyComponent {definition.func.__name__} returning task', {'uid': definition.name, 'task_id': task}
             )
+            task_mgr.register_task(task)
 
             return task
 

dara/core/visual/progress_updater.py

@@ -16,9 +16,10 @@ limitations under the License.
 """
 
 import inspect
+from collections import OrderedDict
 from functools import wraps
 from inspect import Signature, signature
-from typing import Callable, OrderedDict
+from typing import Callable
 
 
 class ProgressUpdater:
@@ -145,13 +146,13 @@ def track_progress(func=None):
 
         _inner_func = _sync_inner_func
 
-    _inner_func.__signature__ = Signature(
+    _inner_func.__signature__ = Signature(  # type: ignore
         parameters=list(params.values()),
         return_annotation=old_signature.return_annotation,
     )
 
     # Store metadata on the wrapped function - keep a reference to the function wrapped and the decorator itself
     _inner_func.__wrapped__ = func
-    _inner_func.__wrapped_by__ = track_progress
+    _inner_func.__wrapped_by__ = track_progress  # type: ignore
 
     return _inner_func

{dara_core-1.20.1a1.dist-info → dara_core-1.20.1a3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: dara-core
-Version: 1.20.1a1
+Version: 1.20.1a3
 Summary: Dara Framework Core
 Home-page: https://dara.causalens.com/
 License: Apache-2.0
@@ -17,13 +17,14 @@ Provides-Extra: all
 Requires-Dist: aiorwlock (>=1.4.0,<2.0.0)
 Requires-Dist: anyio (>=4.0.0)
 Requires-Dist: async-asgi-testclient (>=1.4.11,<2.0.0)
+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.20.1-alpha.1)
+Requires-Dist: create-dara-app (==1.20.1-alpha.3)
 Requires-Dist: croniter (>=1.0.15,<3.0.0)
 Requires-Dist: cryptography (>=42.0.4)
-Requires-Dist: dara-components (==1.20.1-alpha.1) ; extra == "all"
+Requires-Dist: dara-components (==1.20.1-alpha.3) ; 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)
@@ -33,7 +34,7 @@ Requires-Dist: jinja2 (>=2.1.1,<3.2.0)
 Requires-Dist: jsonpatch (>=1.33)
 Requires-Dist: odfpy
 Requires-Dist: openpyxl
-Requires-Dist: packaging (>=23.1,<24.0)
+Requires-Dist: packaging (>=23.1)
 Requires-Dist: pandas (>=1.1.0,<3.0.0)
 Requires-Dist: prometheus-client (>=0.14.1,<0.15.0)
 Requires-Dist: pyarrow
@@ -54,7 +55,7 @@ Description-Content-Type: text/markdown
 
 # Dara Application Framework
 
-<img src="https://github.com/causalens/dara/blob/v1.20.1-alpha.1/img/dara_light.svg?raw=true">
+<img src="https://github.com/causalens/dara/blob/v1.20.1-alpha.3/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)
@@ -99,7 +100,7 @@ source .venv/bin/activate
 dara start
 ```
 
-![Dara App](https://github.com/causalens/dara/blob/v1.20.1-alpha.1/img/components_gallery.png?raw=true)
+![Dara App](https://github.com/causalens/dara/blob/v1.20.1-alpha.3/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:
 
@@ -116,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.20.1-alpha.1/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.20.1-alpha.1/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.20.1-alpha.1/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.20.1-alpha.3/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.20.1-alpha.3/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.20.1-alpha.3/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!
 
@@ -145,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.20.1-alpha.1/CONTRIBUTING.md) file.
+More information on the repository structure can be found in the [CONTRIBUTING.md](https://github.com/causalens/dara/blob/v1.20.1-alpha.3/CONTRIBUTING.md) file.
 
 ## License
 
-Dara is open-source and licensed under the [Apache 2.0 License](https://github.com/causalens/dara/blob/v1.20.1-alpha.1/LICENSE).
+Dara is open-source and licensed under the [Apache 2.0 License](https://github.com/causalens/dara/blob/v1.20.1-alpha.3/LICENSE).
 

dara_core-1.20.1a3.dist-info/RECORD

@@ -0,0 +1,119 @@
+dara/core/__init__.py,sha256=wcVLfKdziyk6yH50o55A4kAsaJIBoIMGd9RR4igTttw,2159
+dara/core/actions.py,sha256=rC5Tu79AFNWMv0CJuchBnoy6pETIFh_1RTSqxrolArI,947
+dara/core/auth/__init__.py,sha256=H0bJoXff5wIRZmHvvQ3y9p5SXA9lM8OuLCGceYGqfb0,851
+dara/core/auth/base.py,sha256=qxmiIzx-n2g4ZWicgxsYtHjiB14AemOWM_GNxcr98mE,3294
+dara/core/auth/basic.py,sha256=8ebWpHx53ObkuzTHIKSRdtsmKq0R5v8RuQXhZcnpTsA,4933
+dara/core/auth/definitions.py,sha256=wTsFWzX7bGHTU_vxGW50pqcmB_AmhETIIUdGB5UrMBU,3467
+dara/core/auth/routes.py,sha256=0o5KXApRbkL0F5qFsarQk_cq5lbQ3QfIHR_mwLRgBEY,7217
+dara/core/auth/utils.py,sha256=iEWP5qwfH17Mi-5t3sP-DNMUrWN0oSRk96NhieY2Zw4,7334
+dara/core/base_definitions.py,sha256=ptc6OSx-qElWWSuZB4-06kWmnj6hekpKR47eeB36igQ,16915
+dara/core/cli.py,sha256=V__LAK3ozWGsVTEQHqvJwqSfpC3o6R76YGABJ-YVoSE,8185
+dara/core/configuration.py,sha256=gi5AmdxyRSgegcNKFtnHshsMRz8fznswt60JlNZp-3s,22374
+dara/core/css.py,sha256=UkNZ6n7RDBLsHmpZvn_a3K2nAwxVggQJbQMKNbgXONA,1753
+dara/core/data_utils.py,sha256=RD5_GdyGyGr1LVThCo8mpuOMWrd9_c1iyRqjuyoarXM,12578
+dara/core/defaults.py,sha256=Sa7ZU4QvPndaJm-oXrVn9gRfkdUgFtsX8RkSRhf16JQ,4306
+dara/core/definitions.py,sha256=ykxPR4qYXafzsDxN4j3AN-pScSm-1Tx3SS3OWdFJ_k8,18839
+dara/core/http.py,sha256=-OzbCHlYSnfVnw2492C_UmaWOI5oSONfWk03eEGxSRI,4761
+dara/core/interactivity/__init__.py,sha256=ZppwTvxaCsaAdf0qX6j1qTcmbj6wxVcbiaMZfwTVKtU,2679
+dara/core/interactivity/actions.py,sha256=1emp5K18R1DK1b8R_j_8wVrVlNdRlHe7D3mVOTfwb_o,48188
+dara/core/interactivity/any_data_variable.py,sha256=GhT6lzCDRlQtYG2gNNUHq4th7K3RacqDfkjaq7o4mCc,317
+dara/core/interactivity/any_variable.py,sha256=b6aMOZZc9Q4IFPPjuIbFgqYdw52-6QRsxNRj5ohZeL0,13648
+dara/core/interactivity/client_variable.py,sha256=bFc4gmKKVfAvZHmv5Y2ME1VMTxSM_v_0lcmyRNTLOKk,2320
+dara/core/interactivity/condition.py,sha256=69tdxgLqNbU-AlwHTWFdp-hvxGDugNnb_McDrz0mDtE,1575
+dara/core/interactivity/data_variable.py,sha256=cJ7ssuNotvbK01MJFPYJ_0zBAC4PAIOERIVR948G0Dk,2535
+dara/core/interactivity/derived_data_variable.py,sha256=N2cNcFmHxmNixJ_sfF_VGqYrzEA4b90aNL0RUmuMpRA,3696
+dara/core/interactivity/derived_variable.py,sha256=RTessKdELHfKK-ApC4KfhUS8neMADctCE0WXJirqHa4,32393
+dara/core/interactivity/filtering.py,sha256=rXv9ye_HqYFdZCDJ5x22AKSS_gIXB-zJDxxi4FuqAvo,9752
+dara/core/interactivity/loop_variable.py,sha256=eiw9AVYzE7-qkBtww0qxYAGtG5SknKs_MMd6GD1gi8M,2994
+dara/core/interactivity/non_data_variable.py,sha256=I-Nm5nEbt06X62xiUeAZsiutH-nPTY0iGJDurzbQB3M,189
+dara/core/interactivity/plain_variable.py,sha256=MlfQpmI1HBrKI3xOI_BDlvrdXpoTKdqj4sQ0kZOqlr0,12603
+dara/core/interactivity/server_variable.py,sha256=jtE0BqfNXz9W4BaWuaP29hqNRW_LZpYPROV2Xv-JL1E,11223
+dara/core/interactivity/state_variable.py,sha256=1sSQjjjwedR9_IVPIk9h39ywR4hklYoTUMPy3FA6TVU,2487
+dara/core/interactivity/switch_variable.py,sha256=RTFVeB5joWh7-zjx-miP0OjYmDW8GbgkWZHLUsMasiY,14177
+dara/core/interactivity/tabular_variable.py,sha256=aw9wIzhkoWA-YyAfNWTZPmW0OAa-4yOb_dN55jrhu9w,3366
+dara/core/interactivity/url_variable.py,sha256=iJ78QC2J_fCJ1K_hjksMwyzGBHOywBLAHBWdw-PYL1I,2301
+dara/core/internal/__init__.py,sha256=QN0wbG9HPQ_vXh8BO8DnBXeYLIENVTNtRmYzZf1lx7c,577
+dara/core/internal/cache_store/__init__.py,sha256=7JCmQwNIMzfyLZGnsk0BbT1EdDFO_PRZz86E9ATcC6c,139
+dara/core/internal/cache_store/base_impl.py,sha256=LsUht9zS6lU8i6FO8JPTNNQTvMHH0PbFxxW_WjPZ_o4,1367
+dara/core/internal/cache_store/cache_store.py,sha256=MtaPHDMKnN_4O9axU4CO2Q-SmzqpHbDQxVxWGNFhqRc,8617
+dara/core/internal/cache_store/keep_all.py,sha256=gzxDozXTpDInGySQLKB-1BrUsXYsQgzOKoujmwKxbDM,2469
+dara/core/internal/cache_store/lru.py,sha256=YRzmBIG5l5a5_MZxMoa3ajLImmKhA0I8IdCNBsMIV5A,5366
+dara/core/internal/cache_store/ttl.py,sha256=m2w6ElfKemD6uysLyZAfXytnstUdI8oJP8Up4GuWCQY,4985
+dara/core/internal/cgroup.py,sha256=yKCTY8RxyxnNy-Mw4tfzeZew1dL8qw381gHBVE96-OA,3217
+dara/core/internal/custom_response.py,sha256=aSPonh8AdRjioTk1MaPwdaJHkO4R4aG_osGAGCIHbtg,1341
+dara/core/internal/dependency_resolution.py,sha256=7_M1Mrhdb17wuuOHnbKjnCu1a0okAr904HkBiQxo0I8,10326
+dara/core/internal/devtools.py,sha256=kzbmkDd-PHc2epCQ6D-bTm7G_2algxDOiyhzJWK0QlI,2620
+dara/core/internal/download.py,sha256=_AciKp4ZsJxq60LRnvhLsA7KNWMDAXRbSKpin8-vBmU,3589
+dara/core/internal/encoder_registry.py,sha256=KTYBLIGHpJDOLzCp_9899D7EIISK0zxCKbn4Gktllxk,11200
+dara/core/internal/execute_action.py,sha256=luO5mTFj5Pl5H1Pxtsw5qNBnb64kL5fKBLad5tpzT6Q,7018
+dara/core/internal/hashing.py,sha256=Iz3FyiroHc_bC8AEtSUFFAIHh6j4Bq_EvxLqInIkAUM,1124
+dara/core/internal/import_discovery.py,sha256=oyBZayWhfZma4bg-8bamnS4QO1Oba9geGtez_BHut38,8128
+dara/core/internal/multi_resource_lock.py,sha256=mUoc6KKk8mpLGCXfa6nFd60yNuas4b6wsAk8VrvGDxI,2496
+dara/core/internal/normalization.py,sha256=N7NNzrOCIuCHqFBxZ3s5kKBeP57_949FzI-B6onTLAo,6071
+dara/core/internal/pandas_utils.py,sha256=-t7wa7ydPqA_yJlF3ib1awJRfm7m69ULIeZwkWWD_f4,6549
+dara/core/internal/pool/__init__.py,sha256=pBbXE5GR3abVC9Lg3i0QxfdmsrBDMJUYAYb0SiAEBkk,657
+dara/core/internal/pool/channel.py,sha256=TbyIE-PnfzzsQYhl3INOs5UIHHbF_h9bMFne5FjbWlQ,4948
+dara/core/internal/pool/definitions.py,sha256=27dtsyHsztc7zgr2axMWCn1O9pBNI_VKByGxjvKHBGc,4649
+dara/core/internal/pool/task_pool.py,sha256=MqzUtoGEjeXdpCdTmBXQmQt582u0suiL5vwrsj1slhY,17780
+dara/core/internal/pool/utils.py,sha256=HoNlHy2V0VmX5Xm2cqsFbPIOV74E2MslzTFgyNRmiB0,5411
+dara/core/internal/pool/worker.py,sha256=eBi3FS652goZxu9chaRT89eHDvqJW0aHjt8I5UgyESA,6808
+dara/core/internal/port_utils.py,sha256=3NN94CubNrIYQKmPM4SEwstY-UMqsbbe1M_JhyPcncA,1654
+dara/core/internal/registries.py,sha256=1lY9xrggiyUlM32pPyzFEfflW3_37QGOxTDrfWQ4CN4,3659
+dara/core/internal/registry.py,sha256=TJsD6eUQIBvcuTn_x3371pF-gxo6VtHUX5h-haca-00,4372
+dara/core/internal/registry_lookup.py,sha256=RlT6Np658GCykdOXeLA6Gm1BTBcdDbhtOJDwJUB3Tkc,2430
+dara/core/internal/routing.py,sha256=qe0U-gqXnzkm6osvpipJV6DE2ePqhtXBVGD1JSRrTOo,21148
+dara/core/internal/scheduler.py,sha256=rmj-NnHHToWBPuteKlf0RmKcav2Hz0Z9-l4uyrAGKSI,13069
+dara/core/internal/settings.py,sha256=DxRvXcelawaKemTcX6JIVIilibn0XO5Bd98dCXau4zg,3937
+dara/core/internal/store.py,sha256=Z4EUMwHR0DR-TVCL9csSGYE3toxh15iRpBP2c7MUgr8,6442
+dara/core/internal/tasks.py,sha256=WgQcgyChnUe4Dy16dw4LpFAcSECVoxFjVJHkPnfZFaA,34790
+dara/core/internal/utils.py,sha256=nUnwy1BLW9HUQro9ASAYb-AlNJkbaT_bQ1bE2e1q1wo,9088
+dara/core/internal/websocket.py,sha256=rcipt5XY48akMuLHFdvUUIgNLqzJx7ovLeiPsYVMELM,21953
+dara/core/jinja/index.html,sha256=1gkCFiihXOUH7vp7tT5gH8mKeJB4KqNg394xO3a0usI,1208
+dara/core/jinja/index_autojs.html,sha256=u1diDUnRT4djZqN1T6lIE01GhlfL6SJ_yLYcyapruss,1342
+dara/core/js_tooling/custom_js_scaffold/index.tsx,sha256=FEzSV5o5Nyzxw6eXvGLi7BkEBkXf3brV34_7ATLnY7o,68
+dara/core/js_tooling/custom_js_scaffold/local-js-component.tsx,sha256=Ojsyeh9MYJnH_XJXGkSc8PAUZIqJcqcGTu_uRITo_88,709
+dara/core/js_tooling/js_utils.py,sha256=X8KZLGjdrVk7K8SEg-lrGbbT6W-rp81YMq9lHhK60Jo,26948
+dara/core/js_tooling/statics/favicon.ico,sha256=CJP26erMMIwQB8FFmyhoUJ-Cx1cXEopiVGxFwyxcpo0,47068
+dara/core/js_tooling/statics/tsconfig.json,sha256=ubnFjwvPHbx2F7wVWsU2VHLDeEnnOwXkTIk7hLNY8ZM,446
+dara/core/js_tooling/templates/.npmrc,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+dara/core/js_tooling/templates/_entry.template.tsx,sha256=oTeiSLDmq4J-2pM7qjA2RgUocT6Rla7BNwyEAJGvdCc,161
+dara/core/js_tooling/templates/_entry_autojs.template.tsx,sha256=c9eNln0iLHUjhxsgXsF67hPcu4coloh0luvrhdM4ETM,202
+dara/core/js_tooling/templates/dara.config.json,sha256=RZG_R_xJv_5rYIoz2QZulcG49wD0JURTzshtAzG_di4,84
+dara/core/js_tooling/templates/vite.config.template.ts,sha256=W-R9LtXPMv7vQkqMawMmeFrjaQ22xrGU0iYyS_nHkh4,1199
+dara/core/log_configs/logging.yaml,sha256=YJyD18psAmSVz6587dcEOyoulLuRFFu1g8yMXl1ylM0,706
+dara/core/logging.py,sha256=8kJPQfRpivxzJXpmsK6-sYnWjR_VBDHzIelD1rstIeM,13260
+dara/core/main.py,sha256=uw1BI4dSN-TowmnIUNLMDqL6I5t-3qeQsnVN9J73nGc,18507
+dara/core/metrics/__init__.py,sha256=2UqpWHv-Ie58QLJIHJ9Szfjq8xifAuwy5FYGUIFwWtI,823
+dara/core/metrics/cache.py,sha256=c1PSst_oZZvuVzBXYWdpf8Sbb97u6q0HS2dlsEVLpQU,2632
+dara/core/metrics/runtime.py,sha256=YP-6Dz0GeI9_Yr7bUk_-OqShyFySGH_AKpDO126l6es,1833
+dara/core/metrics/utils.py,sha256=inR1Ab5hmWZY2lsgGwLCQOEdyhCD9PumU52X2JbwlKY,2251
+dara/core/persistence.py,sha256=10Hrvb2z5c9r0Hof7gpiiWfuKAAu6TLqLKoiZA9KpZo,18901
+dara/core/umd/dara.core.umd.js,sha256=2FPBTzK4IaVT56k3R9TcMQJh8z2wYbjJSm39LzAMLHQ,4722215
+dara/core/umd/style.css,sha256=YQtQ4veiSktnyONl0CU1iU1kKfcQhreH4iASi1MP7Ak,4095007
+dara/core/visual/__init__.py,sha256=QN0wbG9HPQ_vXh8BO8DnBXeYLIENVTNtRmYzZf1lx7c,577
+dara/core/visual/components/__init__.py,sha256=wuGRk8bogiLWPOXAF-Fo4F6_L__0tBrI2p2SqgH2lnE,2385
+dara/core/visual/components/dynamic_component.py,sha256=w7rxrM9ZTNvkHymkAto_s9UKg7EE8VrlpL9QdRe4sgY,692
+dara/core/visual/components/fallback.py,sha256=cnuPcblmQ1gyzZHrwHtrD5C5Bo7-JXeiMO0KZ1ACbPM,4764
+dara/core/visual/components/for_cmp.py,sha256=HykNfue2YzjZjWiWaJakLZmbdd_M7IfUi9kNhG2mLOE,6347
+dara/core/visual/components/invalid_component.py,sha256=Q6O9rAwVUNZXjEmliAKLfWf2lsyYK5JhgQvMM6jVco8,901
+dara/core/visual/components/menu.py,sha256=ied87GzIoZgmEINgX3WahBqofn-WK1PIBZAgMjR-Bxg,928
+dara/core/visual/components/progress_tracker.py,sha256=5p_nEJf7RK2oPimXL4YhAN7v0Jcx2HHQzlLxPr7Co38,1705
+dara/core/visual/components/raw_string.py,sha256=jtG9hDZz3s-sCg__Eg4__XkD80OhnNaWiRo-W88LK4M,921
+dara/core/visual/components/router_content.py,sha256=ZFJBuT-Vpn4yvbzgt5IGQbBqiWFhYfHa6mgB2O8Xt8I,978
+dara/core/visual/components/sidebar_frame.py,sha256=rXkPQF9TORuAgbMMx-BL_XDVE-CKcZHY9XV9-gZr_FI,1242
+dara/core/visual/components/topbar_frame.py,sha256=7L4Bi7Ba_gdfS6yoduXQ3k0-XQaNuahmkumyfzlpzzY,1255
+dara/core/visual/components/types.py,sha256=uH2IGufr4-I8cNbZgnEd3YbqoPFgyqG91rfNXZVG7a0,686
+dara/core/visual/css/Property.py,sha256=XJzlMeASyrquhXmaQZvrsgin3xlVfm94dHRY9aJkhXk,43028
+dara/core/visual/css/__init__.py,sha256=r2W1B5yRQhmxBRoRyldzOopaobb2sgkEh_mUjWUvtko,367328
+dara/core/visual/dynamic_component.py,sha256=hlOBRm3V1DlDAzyi--wWDOqC_bD-ofq5LXa4Mn5hBk0,14302
+dara/core/visual/progress_updater.py,sha256=IdtWihnMYk8hqsHqDd0nzuuHeQu8wjnZT42s0oSq9ro,5895
+dara/core/visual/template.py,sha256=y0KJU2913Q10y1TVMpTVnIxIoUsabzYfpUHEGuX2QyM,5707
+dara/core/visual/themes/__init__.py,sha256=aM4mgoIYo2neBSw5FRzswsht7PUKjLthiHLmFIkyRKw,794
+dara/core/visual/themes/dark.py,sha256=UQGDooOc8ric73eHs9E0ltYP4UCrwqQ3QxqN_fb4PwY,1942
+dara/core/visual/themes/definitions.py,sha256=nS_gQvOzCt5hTmj74d0_siq_9QWuj6wNuir4VCHy0Dk,2779
+dara/core/visual/themes/light.py,sha256=-Tviq8oEwGbdFULoDOqPuHO0UpAZGsBy8qFi0kAGolQ,1944
+dara_core-1.20.1a3.dist-info/LICENSE,sha256=r9u1w2RvpLMV6YjuXHIKXRBKzia3fx_roPwboGcLqCc,10944
+dara_core-1.20.1a3.dist-info/METADATA,sha256=Jrg1bcuLIad7biNR3YcRyqnkL5t3GMIPEZ3QxZqp9Fo,7608
+dara_core-1.20.1a3.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+dara_core-1.20.1a3.dist-info/entry_points.txt,sha256=H__D5sNIGuPIhVam0DChNL-To5k8Y7nY7TAFz9Mz6cc,139
+dara_core-1.20.1a3.dist-info/RECORD,,