dara-core 1.21.0__py3-none-any.whl → 1.21.2__py3-none-any.whl

dara/core/configuration.py

@@ -55,6 +55,7 @@ from dara.core.definitions import (
 )
 from dara.core.interactivity.actions import ActionImpl, ResetVariables
 from dara.core.interactivity.any_variable import AnyVariable
+from dara.core.interactivity.client_variable import ClientVariable
 from dara.core.internal.encoder_registry import Encoder
 from dara.core.internal.import_discovery import (
     create_action_definition,
@@ -525,14 +526,14 @@ class ConfigurationBuilder:
 
     def set_theme(
         self,
-        main_theme: Optional[Union[ThemeDef, Literal['light'], Literal['dark']]] = None,
+        main_theme: Optional[Union[ThemeDef, ClientVariable, Literal['light'], Literal['dark']]] = None,
         base_theme: Optional[Union[Literal['light'], Literal['dark']]] = None,
     ):
         """
         Sets the color theme of the app. Takes ThemeDef models for the app, and reverts
         to the default themes if they are not supplied.
 
-        :param main_theme: ThemeDef defining colors for the app, alternatively can be either 'light' or 'dark' to use default Dara colors
+        :param main_theme: ThemeDef defining colors for the app, a string 'light' or 'dark' to use default Dara colors, or a Variable containing one of the before
         """
         if isinstance(main_theme, str):
             if main_theme in ('dark', 'light'):

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, Outlet, OutletDef
+from dara.core.router import Link, LinkDef, MenuLink, MenuLinkDef, Outlet, OutletDef
 from dara.core.visual.components import (
     DefaultFallbackDef,
     DynamicComponent,
@@ -44,8 +44,6 @@ from dara.core.visual.components import (
     ForDef,
     Menu,
     MenuDef,
-    MenuLink,
-    MenuLinkDef,
     PoweredByCausalens,
     PoweredByCausalensDef,
     ProgressTracker,
@@ -55,6 +53,8 @@ from dara.core.visual.components import (
     RowFallbackDef,
     SideBarFrame,
     SideBarFrameDef,
+    ThemeProvider,
+    ThemeProviderDef,
     TopBarFrame,
     TopBarFrameDef,
 )
@@ -91,6 +91,7 @@ CORE_COMPONENTS: Dict[str, ComponentTypeAnnotation] = {
     Link.__name__: LinkDef,
     Outlet.__name__: OutletDef,
     PoweredByCausalens.__name__: PoweredByCausalensDef,
+    ThemeProvider.__name__: ThemeProviderDef,
 }
 
 # These actions are provided by the core JS of this module

dara/core/definitions.py

@@ -123,7 +123,7 @@ class ComponentInstance(BaseModel):
     Definition of a Component Instance
     """
 
-    uid: Optional[str] = Field(default_factory=lambda: str(uuid.uuid4()))
+    uid: str = Field(default_factory=lambda: str(uuid.uuid4()))
 
     js_module: ClassVar[Optional[str]] = None
     """

dara/core/interactivity/plain_variable.py

@@ -284,7 +284,7 @@ class Variable(ClientVariable, Generic[VariableType]):
         assert isinstance(self.store, BackendStore), 'This method can only be used with a BackendStore'
         return await self.store.write(value, notify=notify, ignore_channel=ignore_channel)
 
-    async def write_partial(self, data: Union[List[Dict[str, Any]], Any], notify: bool = True):
+    async def write_partial(self, data: Union[List[Dict[str, Any]], Any], notify: bool = True, in_place: bool = False):
         """
         Apply partial updates to the variable's BackendStore using JSON Patch operations or automatic diffing.
         Raises an error if the variable does not have a BackendStore attached.
@@ -294,9 +294,13 @@ class Variable(ClientVariable, Generic[VariableType]):
 
         :param data: Either a list of JSON patch operations (RFC 6902) or a full object to diff against current value
         :param notify: whether to broadcast the patches to clients
+        :param in_place: whether to apply the patches in-place or return a new value.
+        When set to True, the value will be mutated when applying the patches rather than deep-cloned.
+        This is recommended when the updated value is large and deep-cloning it can be expensive; however, users should exercise
+        caution when using the option as previous results retrieved from `variable.read()` will potentially be mutated, depending on the backend used.
         """
         assert isinstance(self.store, BackendStore), 'This method can only be used with a BackendStore'
-        return await self.store.write_partial(data, notify=notify)
+        return await self.store.write_partial(data, notify=notify, in_place=in_place)
 
     async def read(self):
         """