PyPI - instaui - Versions diffs - 0.1.19__py2.py3-none-any.whl → 0.2.1__py2.py3-none-any.whl - Mend

instaui 0.1.19py2.py3-none-any.whl → 0.2.1py2.py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (53) hide show

instaui/arco/component_types.py +389 -182
instaui/arco/components/input.py +1 -1
instaui/arco/components/typography.py +1 -1
instaui/boot_info.py +2 -2
instaui/components/component.py +9 -7
instaui/components/element.py +11 -8
instaui/components/html/button.py +2 -2
instaui/components/html/input.py +2 -2
instaui/components/html/range.py +2 -2
instaui/components/html/select.py +3 -2
instaui/components/html/textarea.py +2 -2
instaui/components/html/ul.py +2 -2
instaui/components/match.py +2 -2
instaui/components/mixins.py +16 -0
instaui/components/vfor.py +8 -6
instaui/event/web_event.py +25 -2
instaui/fastapi_server/_utils.py +5 -21
instaui/fastapi_server/dependency_router.py +5 -1
instaui/fastapi_server/event_router.py +5 -5
instaui/fastapi_server/middlewares.py +12 -0
instaui/fastapi_server/request_context.py +5 -4
instaui/fastapi_server/server.py +5 -1
instaui/fastapi_server/watch_router.py +2 -2
instaui/js/fn.py +5 -1
instaui/patch_update.py +54 -0
instaui/pre_setup.py +45 -0
instaui/response.py +64 -0
instaui/runtime/_app.py +5 -1
instaui/spa_router/_file_base_utils.py +1 -1
instaui/static/insta-ui.esm-browser.prod.js +1400 -1391
instaui/static/insta-ui.js.map +1 -1
instaui/static/templates/web.html +5 -3
instaui/static/templates/webview.html +4 -2
instaui/static/templates/zero.html +4 -2
instaui/template/web_template.py +1 -0
instaui/template/webview_template.py +1 -0
instaui/template/zero_template.py +1 -0
instaui/ui/__init__.py +31 -6
instaui/ui/__init__.pyi +4 -0
instaui/ui_functions/server.py +10 -1
instaui/ui_functions/ui_types.py +6 -2
instaui/vars/mixin_types/element_binding.py +5 -1
instaui/vars/mixin_types/observable.py +1 -1
instaui/vars/vue_computed.py +5 -2
instaui/watch/web_watch.py +11 -0
instaui/webview/api.py +2 -23
instaui/webview/resource.py +2 -0
instaui/zero/func.py +2 -0
{instaui-0.1.19.dist-info → instaui-0.2.1.dist-info}/METADATA +4 -3
{instaui-0.1.19.dist-info → instaui-0.2.1.dist-info}/RECORD +52 -49
instaui/webview/func.py +0 -114
{instaui-0.1.19.dist-info → instaui-0.2.1.dist-info}/WHEEL +0 -0
{instaui-0.1.19.dist-info → instaui-0.2.1.dist-info}/licenses/LICENSE +0 -0

instaui/static/templates/web.html CHANGED Viewed

@@ -24,8 +24,8 @@
 <body>
   {{ sse_html(model.is_debug) }}
-  <div id="app">
-    <insta-ui :config="config"></insta-ui>
+  <div id="app">
+    <insta-ui :config="config" :meta="meta"></insta-ui>
   </div>
   <script type="importmap">
@@ -52,11 +52,13 @@
     const None = undefined;
     const appConfig = {{model.config_dict | safe}};
+    const meta = {mode: 'web',version:'{{model.version | safe}}',debug:{{model.is_debug}}}
     const app = createApp({
       setup() {
         return {
-          config:appConfig
+          config:appConfig,
+          meta,
         }
       }
     })

instaui/static/templates/webview.html CHANGED Viewed

@@ -23,7 +23,7 @@
 <body>
   <div id="app">
-    <insta-ui :config="config"></insta-ui>
+    <insta-ui :config="config" :meta="meta"></insta-ui>
   </div>
   <script type="importmap">
@@ -49,6 +49,7 @@
     const None = undefined;
     const appConfig = {{model.config_dict | safe}};
+    const meta = {mode: 'webview',version:'{{model.version | safe}}'}
     window.addEventListener('pywebviewready',async () => {
       const app = createApp({
@@ -59,7 +60,8 @@
         {% endif %}
         setup() {
           return {
-            config:appConfig
+            config:appConfig,
+            meta,
           }
         }
       })

instaui/static/templates/zero.html CHANGED Viewed

@@ -23,7 +23,7 @@
 <body>
   <div id="app">
-    <insta-ui :config="config"></insta-ui>
+    <insta-ui :config="config" :meta="meta"></insta-ui>
   </div>
   <script type="importmap">
@@ -49,11 +49,13 @@
     const None = undefined;
     const appConfig = {{model.config_dict | safe}};
+    const meta = {mode: 'zero',version:'{{model.version | safe}}',debug:true}
     const app = createApp({
       setup() {
         return {
-          config:appConfig
+          config:appConfig,
+          meta,
         }
       }
     })

instaui/template/web_template.py CHANGED Viewed

@@ -12,6 +12,7 @@ _html_template = env.get_template("web.html")
 @dataclass
 class WebTemplateModel:
+    version: str
     vue_js_link: str
     instaui_js_link: str
     config_dict: typing.Dict[str, typing.Any] = field(default_factory=dict)

instaui/template/webview_template.py CHANGED Viewed

@@ -16,6 +16,7 @@ class WebViewVueAppComponent:
 @dataclass
 class WebViewTemplateModel:
+    version: str
     vue_js_code: str
     instaui_js_code: str
     config_dict: typing.Dict[str, typing.Any] = field(default_factory=dict)

instaui/template/zero_template.py CHANGED Viewed

@@ -24,6 +24,7 @@ class ZeroVueAppComponent:
 @dataclass
 class ZeroTemplateModel:
+    version: str
     vue_js_code: _TCodeOrPath
     instaui_js_code: _TCodeOrPath
     config_dict: typing.Dict[str, typing.Any] = field(default_factory=dict)

instaui/ui/__init__.py CHANGED Viewed

@@ -61,6 +61,8 @@ __all__ = [
     "experimental",
     "skip_output",
     "str_format",
+    "pre_setup_action",
+    "patch_set",
     "on_page_request_lifespan",
     "webview",
     "code",
@@ -132,13 +134,36 @@ from instaui.ui_functions.ui_types import TBindable, is_bindable
 from .events import on_page_request_lifespan
 from instaui.extra_libs._import_error import show_error  # noqa: E402, F401
 from instaui.js.fn import JsFn as js_fn
+from instaui.pre_setup import PreSetupAction as pre_setup_action
+from instaui.patch_update import patch_set
 # -- dynamic imports
 from instaui.systems.module_system import LazyModule as _LazyModule
-markdown = _LazyModule('instaui.components.markdown.markdown', 'Markdown')
-webview = _LazyModule('instaui.webview', 'WebviewWrapper')
-use_shadcn_classless = _LazyModule('instaui.shadcn_classless._index', 'use_shadcn_classless')
+markdown = _LazyModule("instaui.components.markdown.markdown", "Markdown")
+webview = _LazyModule("instaui.webview", "WebviewWrapper")
+use_shadcn_classless = _LazyModule(
+    "instaui.shadcn_classless._index", "use_shadcn_classless"
+)
 # -- extra libs
-mermaid = _LazyModule('instaui.extra_libs._mermaid', 'mermaid', import_error_callback=show_error('Mermaid is not installed. Please run "pip install instaui-mermaid" to install it.'),)
-code = _LazyModule('instaui.extra_libs._shiki_code', 'code', import_error_callback=show_error('Shiki is not installed. Please run "pip install instaui-shiki" to install it.'),)
-echarts = _LazyModule('instaui.extra_libs._echarts', 'echarts', import_error_callback=show_error('Echarts is not installed. Please run "pip install instaui-echarts" to install it.'),)
+mermaid = _LazyModule(
+    "instaui.extra_libs._mermaid",
+    "mermaid",
+    import_error_callback=show_error(
+        'Mermaid is not installed. Please run "pip install instaui-mermaid" to install it.'
+    ),
+)
+code = _LazyModule(
+    "instaui.extra_libs._shiki_code",
+    "code",
+    import_error_callback=show_error(
+        'Shiki is not installed. Please run "pip install instaui-shiki" to install it.'
+    ),
+)
+echarts = _LazyModule(
+    "instaui.extra_libs._echarts",
+    "echarts",
+    import_error_callback=show_error(
+        'Echarts is not installed. Please run "pip install instaui-echarts" to install it.'
+    ),
+)

instaui/ui/__init__.pyi CHANGED Viewed

@@ -61,6 +61,8 @@ __all__ = [
     "experimental",
     "skip_output",
     "str_format",
+    "pre_setup_action",
+    "patch_set",
     "on_page_request_lifespan",
     "webview",
     "code",
@@ -132,6 +134,8 @@ from instaui.ui_functions.ui_types import TBindable, is_bindable
 from .events import on_page_request_lifespan
 from instaui.extra_libs._import_error import show_error  # noqa: E402, F401
 from instaui.js.fn import JsFn as js_fn
+from instaui.pre_setup import PreSetupAction as pre_setup_action
+from instaui.patch_update import patch_set
 # -- dynamic imports
 from instaui.components.markdown.markdown import Markdown as markdown

instaui/ui_functions/server.py CHANGED Viewed

@@ -3,9 +3,18 @@ from instaui.runtime.context import get_context
 def create_server(
-    debug: bool = True,
+    debug: bool = False,
     use_gzip: Union[int, bool] = True,
 ):
+    """
+    Create a new server instance.
+    Note: When deploy to production, you need to set `debug=False`
+    Args:
+        debug (bool): Whether to run in debug mode. In debug mode, it has the development hot-reload feature. Defaults to False.
+        use_gzip (Union[int, bool], optional):  Whether to use gzip compression. If an integer is provided, it will be used as the minimum response size for compression. If True, the default minimum size of 500 bytes will be used. If False, compression will not be used. Defaults to True.
+    """
     from instaui.fastapi_server.server import Server
     context = get_context()

instaui/ui_functions/ui_types.py CHANGED Viewed

@@ -7,7 +7,11 @@ _T = TypeVar("_T")
 def is_bindable(obj: Any):
-    return isinstance(obj, (CanInputMixin, CanOutputMixin,ObservableMixin, ElementBindingMixin))
+    return isinstance(
+        obj, (CanInputMixin, CanOutputMixin, ObservableMixin, ElementBindingMixin)
+    )
-TBindable = Union[CanInputMixin, CanOutputMixin,ObservableMixin, ElementBindingMixin[_T]]
+TBindable = Union[
+    CanInputMixin, CanOutputMixin, ObservableMixin, ElementBindingMixin[_T]
+]

instaui/vars/mixin_types/element_binding.py CHANGED Viewed

@@ -1,4 +1,4 @@
-from typing import Dict, Generic, TypeVar
+from typing import Dict, Generic, TypeVar, Protocol
 from abc import ABC, abstractmethod
 T = TypeVar("T")
@@ -8,3 +8,7 @@ class ElementBindingMixin(ABC, Generic[T]):
     @abstractmethod
     def _to_element_binding_config(self) -> Dict:
         pass
+class ElementBindingProtocol(Protocol):
+    def _to_element_binding_config(self) -> Dict: ...

instaui/vars/mixin_types/observable.py CHANGED Viewed

@@ -4,4 +4,4 @@ from abc import ABC, abstractmethod
 class ObservableMixin(ABC):
     @abstractmethod
     def _to_observable_config(self):
-        pass
+        pass

instaui/vars/vue_computed.py CHANGED Viewed

@@ -6,7 +6,10 @@ from instaui.common.jsonable import Jsonable
 from instaui.runtime._app import get_current_scope
 from instaui.vars.path_var import PathVar
 from instaui.vars.mixin_types.var_type import VarMixin
-from instaui.vars.mixin_types.element_binding import ElementBindingMixin
+from instaui.vars.mixin_types.element_binding import (
+    ElementBindingMixin,
+    ElementBindingProtocol,
+)
 from instaui.vars.mixin_types.py_binding import CanInputMixin
 from instaui.vars.mixin_types.pathable import CanPathPropMixin
 from instaui.vars.mixin_types.str_format_binding import StrFormatBindingMixin
@@ -28,7 +31,7 @@ class VueComputed(
     def __init__(
         self,
         fn_code: str,
-        bindings: Optional[Mapping[str, Union[ElementBindingMixin, Any]]] = None,
+        bindings: Optional[Mapping[str, Union[ElementBindingProtocol, Any]]] = None,
     ) -> None:
         self.code = fn_code
         self._bindings = bindings

instaui/watch/web_watch.py CHANGED Viewed

@@ -12,6 +12,7 @@ from instaui.handlers import watch_handler
 from instaui.vars.mixin_types.py_binding import CanOutputMixin
 from instaui.vars.mixin_types.common_type import TObservableInput
 from instaui._helper import observable_helper
+from instaui import pre_setup as _pre_setup
 _SYNC_TYPE = "sync"
 _ASYNC_TYPE = "async"
@@ -30,8 +31,11 @@ class WebWatch(Jsonable, typing.Generic[P, R]):
         deep: typing.Union[bool, int] = True,
         once: bool = False,
         flush: typing.Optional[_types.TFlush] = None,
+        pre_setup: typing.Optional[typing.Dict] = None,
         _debug: typing.Optional[typing.Any] = None,
     ) -> None:
+        if pre_setup:
+            _pre_setup._check_args(pre_setup)
         inputs = observable_helper.auto_made_inputs_to_slient(inputs, outputs)
         get_current_scope().register_web_watch(self)
@@ -47,6 +51,7 @@ class WebWatch(Jsonable, typing.Generic[P, R]):
         self._once = once
         self._flush = flush
         self._debug = _debug
+        self._pre_setup = pre_setup
     def __call__(self, *args: P.args, **kwargs: P.kwargs) -> R:
         return self._fn(*args, **kwargs)
@@ -93,6 +98,8 @@ class WebWatch(Jsonable, typing.Generic[P, R]):
                 data["once"] = self._once
             if self._flush is not None:
                 data["flush"] = self._flush
+            if self._pre_setup:
+                data["preSetup"] = _pre_setup.convert_config(self._pre_setup)
             return data
@@ -107,6 +114,7 @@ def watch(
     deep: typing.Union[bool, int] = True,
     once: bool = False,
     flush: typing.Optional[_types.TFlush] = None,
+    pre_setup: typing.Optional[typing.Dict] = None,
     _debug: typing.Optional[typing.Any] = None,
 ):
     """
@@ -128,6 +136,8 @@ def watch(
                                       - 'sync': Execute immediately on change
                                       - 'post': Batch updates and execute after current tick
                                       - 'pre': Execute before render phase (if applicable)
+        pre_setup (typing.Optional[typing.Dict], optional): A dictionary of pre-setup actions to be executed before the event executes.
     # Example:
     .. code-block:: python
@@ -169,6 +179,7 @@ def watch(
             deep=deep,
             once=once,
             flush=flush,
+            pre_setup=pre_setup,
             _debug=_debug,
         )

instaui/webview/api.py CHANGED Viewed

@@ -1,10 +1,10 @@
-from typing import Any, Dict
+from typing import Dict
 from instaui.runtime._app import get_app_slot
 from instaui.handlers import watch_handler
 from instaui.handlers import event_handler
-from instaui.skip import is_skip_output
+from instaui.response import response_data
 class Api:
@@ -28,7 +28,6 @@ class Api:
         update_app_page_info(data)
         args = [bind for bind in data.get("bind", [])]
         result = handler.fn(*handler.get_handler_args(args))
@@ -50,23 +49,3 @@ def update_app_page_info(data: Dict):
 def _get_binds_from_data(data: Dict):
     return data.get("input", [])
-def response_data(outputs_binding_count: int, result: Any):
-    data = {}
-    if outputs_binding_count > 0:
-        if not isinstance(result, tuple):
-            result = [result]
-        result_infos = [(r, int(is_skip_output(r))) for r in result]
-        if len(result_infos) == 1 and result_infos[0][1] == 1:
-            return data
-        data["values"] = [0 if info[1] == 1 else info[0] for info in result_infos]
-        skips = [info[1] for info in result_infos]
-        if sum(skips) > 0:
-            data["skips"] = skips
-    return data

instaui/webview/resource.py CHANGED Viewed

@@ -5,6 +5,7 @@ import shutil
 from typing import Callable, Optional
 from urllib.parse import quote
+from instaui.version import __version__ as _INSTAUI_VERSION
 from instaui.html_tools import to_config_data
 from instaui.runtime._app import get_app_slot, get_default_app_slot
 from instaui.systems import file_system
@@ -48,6 +49,7 @@ def resource_to_assets(
             favicon_url = file_to_assets(consts.FAVICON_PATH)
     model = webview_template.WebViewTemplateModel(
+        version=_INSTAUI_VERSION,
         vue_js_code=file_to_assets(consts.VUE_ES_JS_PATH),
         instaui_js_code=file_to_assets(consts.APP_ES_JS_PATH),
         css_links=[

instaui/zero/func.py CHANGED Viewed

@@ -1,6 +1,7 @@
 from __future__ import annotations
 import itertools
 from pathlib import Path
+from instaui.version import __version__ as _INSTA_VERSION
 import instaui.consts as consts
 from instaui.runtime._app import get_app_slot, get_default_app_slot
 from instaui.template import render_zero_html
@@ -37,6 +38,7 @@ def get_template_model():
     config_data = to_config_data()
     model = zero_template.ZeroTemplateModel(
+        version=_INSTA_VERSION,
         vue_js_code=consts.VUE_ES_JS_PATH,
         instaui_js_code=consts.APP_ES_JS_PATH,
         css_links=[

{instaui-0.1.19.dist-info → instaui-0.2.1.dist-info}/METADATA RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: instaui
-Version: 0.1.19
+Version: 0.2.1
 Summary: insta-ui is a Python-based UI library for rapidly building user interfaces.
 Author-email: CrystalWindSnake <568166495@qq.com>
 License-Expression: MIT
@@ -91,7 +91,8 @@ def home():
     ui.label("=")
     ui.label(result).style({"color": text_color})
-ui.server().run()
+# when you deploy your web application, you need to set debug=False.
+ui.server(debug=True).run()
 ```
 Replace `ui.server().run()` with `ui.webview().run()` to switch to Web View mode:
@@ -99,7 +100,7 @@ Replace `ui.server().run()` with `ui.webview().run()` to switch to Web View mode
 ```python
 ...
-# ui.server().run()
+# ui.server(debug=True).run()
 ui.webview().run()
 ```

instaui 0.1.19__py2.py3-none-any.whl → 0.2.1__py2.py3-none-any.whl

instaui 0.1.19py2.py3-none-any.whl → 0.2.1py2.py3-none-any.whl