ex4nicegui 0.5.1__py3-none-any.whl → 0.5.3__py3-none-any.whl

ex4nicegui/__init__.py

@@ -17,15 +17,12 @@ from ex4nicegui.utils.signals import (
     deep_ref,
     is_setter_ref,
     batch,
-)
-from ex4nicegui import tools
-from signe import batch
-from ex4nicegui.experimental_ import (
-    gridLayout as exp_ui,
+    is_reactive,
 )
 
 
 __all__ = [
+    "is_reactive",
     "rxui",
     "ref_computed",
     "effect",
@@ -46,4 +43,4 @@ __all__ = [
     "is_setter_ref",
 ]
 
-__version__ = "0.5.1"
+__version__ = "0.5.3"

ex4nicegui/bi/dataSourceFacade.py

@@ -21,7 +21,6 @@ from .elements.ui_range import ui_range
 from .elements.ui_echarts import ui_echarts
 from .elements.ui_aggrid import ui_aggrid
 from .elements.ui_table import ui_table
-from ex4nicegui.bi import types as bi_types
 
 if TYPE_CHECKING:
     from ex4nicegui.bi.elements.models import (
@@ -43,9 +42,7 @@ class DataSourceFacade(Generic[_TData]):
     @property
     def filtered_data(self) -> _TData:
         """Data after filtering"""
-        return cast(
-            _TData, self._dataSource.filtered_data
-        )
+        return cast(_TData, self._dataSource.filtered_data)
 
     def reload(self, data, reset_filters=True):
         """Reload the data source with the provided new data.
@@ -59,9 +56,7 @@ class DataSourceFacade(Generic[_TData]):
         if reset_filters:
             self.remove_filters()
 
-    def remove_filters(
-        self, *components: UiResult
-    ):
+    def remove_filters(self, *components: UiResult):
         """Remove the filter from the data source"""
         if len(components) == 0:
             # remove all
@@ -73,9 +68,7 @@ class DataSourceFacade(Generic[_TData]):
         self,
         column: str,
         *,
-        sort_options: Optional[
-            bi_types._TDuplicates_column_values_sort_options
-        ] = None,
+        sort_options: Optional[bi_types._TDuplicates_column_values_sort_options] = None,
         exclude_null_value=False,
         clearable=True,
         multiple=True,
@@ -97,11 +90,7 @@ class DataSourceFacade(Generic[_TData]):
         Returns:
             SelectResult: An instance of a user interface select box.
         """
-        kws = {
-            key: value
-            for key, value in locals().items()
-            if key not in ("kwargs")
-        }
+        kws = {key: value for key, value in locals().items() if key not in ("kwargs")}
         kws.update(kwargs)
         return ui_select(**kws)
 
@@ -124,11 +113,7 @@ class DataSourceFacade(Generic[_TData]):
         Returns:
             ui.aggrid: aggrid table.
         """
-        kws = {
-            key: value
-            for key, value in locals().items()
-            if key not in ("kwargs")
-        }
+        kws = {key: value for key, value in locals().items() if key not in ("kwargs")}
         kws.update(kwargs)
         return ui_aggrid(**kws)
 
@@ -152,11 +137,7 @@ class DataSourceFacade(Generic[_TData]):
         Returns:
             ui.table: ui.table.
         """
-        kws = {
-            key: value
-            for key, value in locals().items()
-            if key not in ("kwargs")
-        }
+        kws = {key: value for key, value in locals().items() if key not in ("kwargs")}
         kws.update(kwargs)
         return ui_table(**kws)
 
@@ -164,14 +145,10 @@ class DataSourceFacade(Generic[_TData]):
         self,
         column: str,
         *,
-        sort_options: Optional[
-            bi_types._TDuplicates_column_values_sort_options
-        ] = None,
+        sort_options: Optional[bi_types._TDuplicates_column_values_sort_options] = None,
         exclude_null_value=False,
         hide_filtered=True,
-        custom_options_map: Optional[
-            Union[Dict, Callable[[Any], Any]]
-        ] = None,
+        custom_options_map: Optional[Union[Dict, Callable[[Any], Any]]] = None,
         **kwargs,
     ):
         """
@@ -189,11 +166,7 @@ class DataSourceFacade(Generic[_TData]):
         Returns:
             RadioResult: An radio Selection.
         """
-        kws = {
-            key: value
-            for key, value in locals().items()
-            if key not in ("kwargs")
-        }
+        kws = {key: value for key, value in locals().items() if key not in ("kwargs")}
         kws.update(kwargs)
         return ui_radio(**kws)
 
@@ -213,11 +186,7 @@ class DataSourceFacade(Generic[_TData]):
         Returns:
             ui.radio: An Slider.
         """
-        kws = {
-            key: value
-            for key, value in locals().items()
-            if key not in ("kwargs")
-        }
+        kws = {key: value for key, value in locals().items() if key not in ("kwargs")}
         kws.update(kwargs)
         return ui_slider(**kws)
 
@@ -237,19 +206,13 @@ class DataSourceFacade(Generic[_TData]):
         Returns:
             QRange: An Range.
         """
-        kws = {
-            key: value
-            for key, value in locals().items()
-            if key not in ("kwargs")
-        }
+        kws = {key: value for key, value in locals().items() if key not in ("kwargs")}
         kws.update(kwargs)
         return ui_range(**kws)
 
     def ui_echarts(
         self,
-        fn: Callable[
-            [Any], Union[Dict, "pyecharts.Base"]
-        ],  # pyright: ignore
+        fn: Callable[[Any], Union[Dict, "pyecharts.Base"]],  # pyright: ignore  # noqa: F821
     ):
         """Create charts
 
@@ -295,15 +258,7 @@ class DataSourceFacade(Generic[_TData]):
         filter: bi_types._TFilterCallback[_TData],
     ):
         ele_id = element.id
-        key = self._dataSource.get_component_info_key(
-            ele_id
-        )
-        if not self._dataSource._component_map.has_record(
-            key
-        ):
-            self._dataSource._register_component(
-                ele_id
-            )
-        self._dataSource.send_filter(
-            ele_id, Filter(filter)
-        )
+        key = self._dataSource.get_component_info_key(ele_id)
+        if not self._dataSource._component_map.has_record(key):
+            self._dataSource._register_component(ele_id)
+        self._dataSource.send_filter(ele_id, Filter(filter))

ex4nicegui/bi/elements/text.py

@@ -1,4 +1,4 @@
-from typing import Callable, Any, Union
+from typing import Callable, Any
 from nicegui import ui
 from ex4nicegui.utils.signals import effect
 

ex4nicegui/bi/elements/ui_aggrid.py

@@ -1,5 +1,5 @@
 from __future__ import annotations
-from typing import TYPE_CHECKING, Any, Callable, Dict, Optional, Union
+from typing import TYPE_CHECKING, Callable, Dict, Optional, Union
 from nicegui import ui
 from ex4nicegui.bi.dataSource import DataSource
 from .models import UiResult
@@ -60,7 +60,7 @@ def ui_aggrid(
         cp._props["options"] = options
         cp.update()
 
-    info = self._dataSource._register_component(cp.id, on_source_update)
+    self._dataSource._register_component(cp.id, on_source_update)
 
     on_source_update()
 

ex4nicegui/bi/elements/ui_echarts.py

@@ -1,5 +1,5 @@
 from __future__ import annotations
-from typing import TYPE_CHECKING, Any, Callable, Dict, Optional, Union, cast
+from typing import TYPE_CHECKING, Any, Callable, Dict, Union, cast
 from nicegui.events import UiEventArguments
 from ex4nicegui.reactive import rxui
 from ex4nicegui.reactive.EChartsComponent.ECharts import (
@@ -36,7 +36,7 @@ class EChartsResult(UiResult[echarts]):
 
 def ui_echarts(
     self: DataSourceFacade,
-    fn: Callable[[Any], Union[Dict, "pyecharts.Base"]],  # pyright: ignore
+    fn: Callable[[Any], Union[Dict, "pyecharts.Base"]],  # pyright: ignore  # noqa: F821
     **kwargs,
 ):
     def create_options(data):
@@ -60,7 +60,7 @@ def ui_echarts(
         options = create_options(data)
         cp.element.update_options(options)
 
-    info = self._dataSource._register_component(ele_id, on_source_update)
+    self._dataSource._register_component(ele_id, on_source_update)
 
     cp.element.update_options(
         create_options(self._dataSource.get_filtered_data(cp.element))

ex4nicegui/bi/elements/ui_slider.py

@@ -28,7 +28,7 @@ class SliderResult(UiResult[ui.slider]):
 
     def _reset_state(self):
         min = self._init_data["min"]
-        max = self._init_data["max"]
+        max = self._init_data["max"]  # noqa: F841
         self._ref_value.value = min
         self.element.set_value(min)
 

ex4nicegui/bi/elements/ui_table.py

@@ -1,5 +1,5 @@
 from __future__ import annotations
-from typing import TYPE_CHECKING, Any, Callable, Dict, List, Optional, Union
+from typing import TYPE_CHECKING, Callable, Dict, List, Optional, Union
 from nicegui import ui
 from ex4nicegui.bi.dataSource import DataSource
 from .models import UiResult
@@ -52,7 +52,7 @@ def ui_table(
         cp.columns = _merge_columns(fixed_columns, opts["columns"])
         cp.update()
 
-    info = self._dataSource._register_component(cp.id, on_source_update)
+    self._dataSource._register_component(cp.id, on_source_update)
 
     on_source_update()
 

ex4nicegui/bi/protocols.py

@@ -5,7 +5,6 @@ from ex4nicegui.bi.types import (
     _TFilterCallback,
     _TDuplicates_column_values_sort_options,
 )
-from .types import _TFilterCallback
 from ex4nicegui.utils import common as utils_common
 
 

ex4nicegui/bi/types.py

@@ -1,6 +1,5 @@
 from __future__ import annotations
 from typing import Callable, Dict, Literal, TypeVar
-from typing import TYPE_CHECKING
 
 
 _TData = TypeVar("_TData")

ex4nicegui/experimental_/__init__.py

@@ -1 +1,5 @@
 from . import gridLayout as exp_ui
+
+__all__ = [
+    "exp_ui",
+]

ex4nicegui/experimental_/gridLayout/__init__.py

@@ -1 +1,8 @@
 from .index import column, row, item, grid_flex
+
+__all__ = [
+    "column",
+    "row",
+    "item",
+    "grid_flex",
+]

ex4nicegui/gsap/__init__.py

@@ -1 +1,12 @@
 from .gsap import set_defaults, from_, to, new, run_script
+from .timeline import Timeline as timeline
+
+
+__all__ = [
+    "set_defaults",
+    "from_",
+    "to",
+    "new",
+    "run_script",
+    "timeline",
+]

ex4nicegui/gsap/timeline.js

@@ -0,0 +1,56 @@
+import { gsap } from "gsap";
+import { convertDynamicProperties } from "../../static/utils/dynamic_properties.js";
+
+
+export default {
+  template: `<template></template>`,
+  data() {
+
+    const tl = gsap.timeline(this.defaults)
+    this.tl = tl
+
+    return {
+    }
+
+  },
+  mounted() {
+    document.addEventListener('DOMContentLoaded', () => {
+      /**
+       * @type any[]
+       */
+      const tasks = this.tasks
+      tasks.forEach(t => {
+        this[t.method](t.targets, t.vars, t.position)
+      })
+
+      this.scriptTasks.forEach(script => {
+        const fn = new Function('return ' + script)()
+        fn(this.tl, gsap)
+      })
+
+    })
+  },
+
+  methods: {
+    from(targets, vars, position) {
+      convertDynamicProperties(vars, false)
+      this.tl.from(targets, vars, position)
+    },
+    to(targets, vars, position) {
+      convertDynamicProperties(vars, false)
+      this.tl.to(targets, vars, position)
+    },
+    runScript(script) {
+      const fn = new Function('return ' + script)()
+      fn(this.tl, gsap)
+    },
+    callTimeline(name, ...args) {
+      this.tl[name](...args)
+    }
+  },
+  props: {
+    defaults: Object,
+    tasks: Array,
+    scriptTasks: Array,
+  },
+};

ex4nicegui/gsap/timeline.py

@@ -0,0 +1,78 @@
+import os
+from pathlib import Path
+from typing import Dict, Optional, Union
+from nicegui.element import Element
+from nicegui import context as ng_context
+
+
+class Timeline(
+    Element,
+    component="timeline.js",
+    exposed_libraries=["../libs/gsap/gsap.mjs"],
+    extra_libraries=["../libs/gsap/*.js", "../libs/gsap/utils/*.js"],
+):
+    def __init__(
+        self,
+        defaults: Optional[Dict] = None,
+    ) -> None:
+        super().__init__()
+        self._props["defaults"] = defaults or {}
+        self._props["tasks"] = []
+        self._props["scriptTasks"] = []
+
+    def from_(self, targets: str, vars: Dict, position: Optional[str] = None):
+        self.__try_run_task("from", targets, vars, position)
+        return self
+
+    def to(self, targets: str, vars: Dict, position: Optional[str] = None):
+        self.__try_run_task("to", targets, vars, position)
+        return self
+
+    def run_script(self, script: Union[str, Path]):
+        if isinstance(script, Path):
+            script = script.read_text("utf8")
+
+        script = os.linesep.join([s for s in script.splitlines() if s])
+        self.__try_run_script_task(script)
+        return self
+
+    def __try_run_script_task(self, script: str):
+        def fn():
+            self.run_method("runScript", script)
+
+        if ng_context.get_client().has_socket_connection:
+            fn()
+        else:
+            tasks = self._props["scriptTasks"]
+            tasks.append(script)
+
+    def __try_run_task(
+        self, name: str, targets: str, vars: Dict, position: Optional[str] = None
+    ):
+        def fn():
+            self.run_method(name, targets, vars)
+
+        if ng_context.get_client().has_socket_connection:
+            fn()
+        else:
+            tasks = self._props["tasks"]
+            tasks.append(
+                {"method": name, "targets": targets, "vars": vars, "position": position}
+            )
+
+    def pause(self):
+        self.run_method("callTimeline", "pause")
+
+    def play(self):
+        self.run_method("callTimeline", "play")
+
+    def resume(
+        self,
+    ):
+        self.run_method("callTimeline", "resume")
+
+    def seek(self, position: Optional[str] = None, suppressEvents=True):
+        self.run_method("callTimeline", "seek", position, suppressEvents)
+
+    def reverse(self):
+        self.run_method("callTimeline", "reverse")

ex4nicegui/layout/__init__.py

@@ -1,2 +1,13 @@
-from .gridFlex import *
-from .rxFlex import *
+from .gridFlex.gridFlex import grid_flex, grid_box, mark_area, item_position, GridFlex
+from .rxFlex.index import rx_column, rx_row
+
+
+__all__ = [
+    "grid_flex",
+    "grid_box",
+    "mark_area",
+    "item_position",
+    "GridFlex",
+    "rx_column",
+    "rx_row",
+]

ex4nicegui/layout/gridFlex/__init__.py

@@ -1 +1 @@
-from .gridFlex import grid_flex, grid_box, mark_area, item_position, GridFlex
+

ex4nicegui/layout/gridFlex/gridFlex.py

@@ -1,9 +1,7 @@
-from typing import Dict, Optional
+from typing import Dict, Optional, Union, Literal
 from nicegui import ui
 from nicegui.element import Element
 
-from typing_extensions import Literal
-from typing import Optional, Union
 from . import utils
 
 

ex4nicegui/layout/rxFlex/__init__.py

@@ -1 +0,0 @@
-from .index import rx_column, rx_row

ex4nicegui/layout/rxFlex/index.py

@@ -1,9 +1,19 @@
-from typing import Callable, List, Optional, Union, TypeVar, Generic
-from typing_extensions import Literal
-
-from ex4nicegui.layout import grid_box, mark_area
-from nicegui import ui, app
-from .types import *
+from typing import Callable, Union, TypeVar
+
+from nicegui import ui
+from .types import (
+    TColumn_Horizontal,
+    TColumn_Vertical,
+    TColumn_Item_Horizontal,
+    Column_Item_Horizontal_map,
+    Column_Horizontal_map,
+    Column_Vertical_map,
+    TRow_Horizontal,
+    TRow_Vertical,
+    TRow_Item_Vertical,
+    Row_Vertical_map,
+    Row_Horizontal_map,
+)
 
 _T_itemWraper_add_var = TypeVar("_T_itemWraper_add_var")
 

ex4nicegui/reactive/__init__.py

@@ -44,10 +44,11 @@ from .officials.number import NumberBindableUi as number
 from .officials.grid import GridBindableUi as grid
 from .officials.expansion import ExpansionBindableUi as expansion
 from .officials.linear_progress import LinearProgressBindableUi as linear_progress
+from .officials.knob import KnobBindableUi as knob
+from .officials.circular_progress import CircularProgressBindableUi as circular_progress
+from .q_pagination import PaginationBindableUi as q_pagination
 
-from .q_pagination import QPagination as q_pagination
 from .local_file_picker import local_file_picker
-from ex4nicegui.utils.signals import ref_computed, effect
 from .UseDraggable.UseDraggable import use_draggable
 from .useMouse.UseMouse import use_mouse
 
@@ -56,3 +57,57 @@ from .dropZone.dropZone import use_drag_zone
 from .fileWatcher import FilesWatcher
 from .mermaid.mermaid import Mermaid as mermaid
 from .vfor import vfor, VforStore
+from .vmodel import vmodel
+
+pagination = q_pagination
+
+
+__all__ = [
+    "circular_progress",
+    "knob",
+    "UploadResult",
+    "local_file_picker",
+    "use_draggable",
+    "use_mouse",
+    "use_pagination",
+    "use_drag_zone",
+    "FilesWatcher",
+    "vfor",
+    "VforStore",
+    "vmodel",
+    "html",
+    "aggird",
+    "button",
+    "card",
+    "card_actions",
+    "card_section",
+    "checkbox",
+    "color_picker",
+    "lazy_color_picker",
+    "date",
+    "drawer",
+    "echarts",
+    "icon",
+    "image",
+    "input",
+    "lazy_input",
+    "label",
+    "radio",
+    "row",
+    "select",
+    "slider",
+    "lazy_slider",
+    "switch",
+    "table",
+    "textarea",
+    "lazy_textarea",
+    "upload",
+    "column",
+    "number",
+    "grid",
+    "expansion",
+    "linear_progress",
+    "q_pagination",
+    "pagination",
+    "mermaid",
+]

ex4nicegui/reactive/fileWatcher.py

@@ -34,7 +34,7 @@ class FilesWatcher:
                 ):
                     for fn in self.callbacks:
                         fn(file)
-            except RuntimeError as e:
+            except RuntimeError:
                 return
 
         if asyncio.get_event_loop().is_running():

ex4nicegui/reactive/local_file_picker.py

@@ -1,4 +1,4 @@
-from typing import Any, Callable, Optional, cast, List
+from typing import Callable, Optional, List
 from typing_extensions import Literal
 from signe import signal, effect, computed
 from nicegui import ui, Tailwind

ex4nicegui/reactive/officials/button.py

@@ -4,7 +4,6 @@ from typing import (
     Optional,
 )
 from ex4nicegui.reactive.utils import ParameterClassifier
-from ex4nicegui.utils.apiEffect import ui_effect
 from ex4nicegui.utils.signals import (
     ReadonlyRef,
     _TMaybeRef as TMaybeRef,

ex4nicegui/reactive/officials/circular_progress.py

@@ -0,0 +1,64 @@
+from typing import (
+    Optional,
+)
+from ex4nicegui.reactive.utils import ParameterClassifier
+from ex4nicegui.utils.apiEffect import ui_effect
+
+from ex4nicegui.utils.signals import (
+    ReadonlyRef,
+    _TMaybeRef as TMaybeRef,
+    to_value,
+)
+from nicegui import ui
+from .base import BindableUi, DisableableMixin
+
+
+class CircularProgressBindableUi(
+    BindableUi[ui.circular_progress],
+    DisableableMixin,
+):
+    def __init__(
+        self,
+        value: TMaybeRef[float] = 0.0,
+        *,
+        min: TMaybeRef[float] = 0.0,  # pylint: disable=redefined-builtin
+        max: TMaybeRef[float] = 1.0,  # pylint: disable=redefined-builtin
+        size: Optional[TMaybeRef[str]] = "xl",
+        show_value: TMaybeRef[bool] = True,
+        color: Optional[TMaybeRef[str]] = "primary",
+    ) -> None:
+        pc = ParameterClassifier(
+            locals(),
+            maybeRefs=[
+                "value",
+                "min",
+                "max",
+                "color",
+                "size",
+                "show_value",
+            ],
+        )
+
+        value_kws = pc.get_values_kws()
+        element = ui.circular_progress(**value_kws)
+        super().__init__(element)  # type: ignore
+
+        for key, value in pc.get_bindings().items():
+            self.bind_prop(key, value)  # type: ignore
+
+    @property
+    def value(self):
+        return self.element.value
+
+    def bind_prop(self, prop: str, ref_ui: ReadonlyRef):
+        if prop == "value":
+            return self.bind_value(ref_ui)
+
+        return super().bind_prop(prop, ref_ui)
+
+    def bind_value(self, ref_ui: ReadonlyRef[float]):
+        @ui_effect
+        def _():
+            self.element.set_value(to_value(ref_ui))
+
+        return self