instaui 0.1.8__tar.gz → 0.1.10__tar.gz

instaui-0.1.10/.gitignore

@@ -0,0 +1,4 @@
+/temp/
+__tests/testing_web/resources/**/_routes.py
+# py-instaui/static/*.*
+__tests/testing_webview/webview_assets

instaui-0.1.10/PKG-INFO

@@ -0,0 +1,153 @@
+Metadata-Version: 2.4
+Name: instaui
+Version: 0.1.10
+Summary: insta-ui is a Python-based UI library for rapidly building user interfaces.
+Author-email: CrystalWindSnake <568166495@qq.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: gui,ui,web
+Requires-Python: <3.13,>=3.8
+Requires-Dist: jinja2>=3.1.6
+Requires-Dist: orjson>=3.10.15
+Requires-Dist: pydantic>=2.10.6
+Requires-Dist: typing-extensions>=4.13.2
+Provides-Extra: all
+Requires-Dist: fastapi[standard]; extra == 'all'
+Requires-Dist: pywebview; extra == 'all'
+Requires-Dist: uvicorn; extra == 'all'
+Provides-Extra: web
+Requires-Dist: fastapi[standard]; extra == 'web'
+Requires-Dist: pydantic<3.0.0,>=2.10.6; extra == 'web'
+Requires-Dist: uvicorn; extra == 'web'
+Provides-Extra: webview
+Requires-Dist: pydantic<3.0.0,>=2.10.6; extra == 'webview'
+Requires-Dist: pywebview; extra == 'webview'
+Description-Content-Type: text/markdown
+
+# insta-ui
+
+<div align="center">
+
+English| [简体中文](./README.md)
+
+</div>
+
+## 📖 Introduction
+insta-ui is a Python-based UI library for quickly building user interfaces.
+
+## ⚙️ Features
+Three modes:
+
+- Web mode: Generate web (stateless) applications.
+- Web View mode: Generate web view applications that can be packaged as native apps (no need to start a web server).
+- Zero mode: Generate pure HTML files that run directly in browsers without any dependencies.
+
+ 
+## 📦 Installation
+
+Zero mode:
+
+```
+pip install instaui -U
+```
+
+web mode
+
+```
+pip install instaui[web] -U
+```
+
+Web View mode
+```
+pip install instaui[webview] -U
+```
+
+
+## 🖥️ Quick Start
+Below is a simple example of number summation. The result color changes dynamically based on the sum:
+
+```python
+from instaui import ui, arco
+arco.use()
+
+@ui.page('/')
+def home():
+    num1 = ui.state(0)
+    num2 = ui.state(0)
+
+    # Automatically recalculates result when num1 or num2 changes 
+    @ui.computed(inputs=[num1, num2])
+    def result(num1: int, num2: int):
+        return num1 + num2
+
+    # Automatically updates text_color when result changes
+    @ui.computed(inputs=[result])
+    def text_color(result: int):
+        return "red" if result % 2 == 0 else "blue"
+
+    # UI components  
+    arco.input_number(num1)
+    ui.label("+")
+    arco.input_number(num2)
+    ui.label("=")
+    ui.label(result).style({"color": text_color})
+
+ui.server().run()
+```
+
+Replace `ui.server().run()` with `ui.webview().run()` to switch to Web View mode:
+
+```python
+...
+
+# ui.server().run()
+ui.webview().run()
+```
+
+To execute computations on the client side instead of the server, use `ui.js_computed` instead of `ui.computed`:
+
+```python
+from instaui import ui, arco
+arco.use()
+
+@ui.page('/')
+def home():
+    num1 = ui.state(0)
+    num2 = ui.state(0)
+
+    result = ui.js_computed(inputs=[num1, num2], code="(num1, num2) => num1 + num2")
+    text_color = ui.js_computed(inputs=[result], code="(result) => result % 2 === 0? 'red' : 'blue'")
+
+    # UI components
+    ...
+
+...
+
+```
+
+In this case, all interactions will run on the client side. Use `Zero mode` to generate a standalone HTML file:
+
+```python
+from instaui import ui, arco,zero
+arco.use()
+
+@ui.page('/')
+def home():
+    num1 = ui.state(0)
+    num2 = ui.state(0)
+
+    result = ui.js_computed(inputs=[num1, num2], code="(num1, num2) => num1 + num2")
+    text_color = ui.js_computed(inputs=[result], code="(result) => result % 2 === 0? 'red' : 'blue'")
+
+    # UI components
+    arco.input_number(num1)
+    ui.label("+")
+    arco.input_number(num2)
+    ui.label("=")
+    ui.label(result).style({"color": text_color})
+
+with zero() as z:
+    home()
+    z.to_html('index.html')
+
+```

instaui-0.1.10/README.md

@@ -0,0 +1,127 @@
+# insta-ui
+
+<div align="center">
+
+English| [简体中文](./README.md)
+
+</div>
+
+## 📖 Introduction
+insta-ui is a Python-based UI library for quickly building user interfaces.
+
+## ⚙️ Features
+Three modes:
+
+- Web mode: Generate web (stateless) applications.
+- Web View mode: Generate web view applications that can be packaged as native apps (no need to start a web server).
+- Zero mode: Generate pure HTML files that run directly in browsers without any dependencies.
+
+ 
+## 📦 Installation
+
+Zero mode:
+
+```
+pip install instaui -U
+```
+
+web mode
+
+```
+pip install instaui[web] -U
+```
+
+Web View mode
+```
+pip install instaui[webview] -U
+```
+
+
+## 🖥️ Quick Start
+Below is a simple example of number summation. The result color changes dynamically based on the sum:
+
+```python
+from instaui import ui, arco
+arco.use()
+
+@ui.page('/')
+def home():
+    num1 = ui.state(0)
+    num2 = ui.state(0)
+
+    # Automatically recalculates result when num1 or num2 changes 
+    @ui.computed(inputs=[num1, num2])
+    def result(num1: int, num2: int):
+        return num1 + num2
+
+    # Automatically updates text_color when result changes
+    @ui.computed(inputs=[result])
+    def text_color(result: int):
+        return "red" if result % 2 == 0 else "blue"
+
+    # UI components  
+    arco.input_number(num1)
+    ui.label("+")
+    arco.input_number(num2)
+    ui.label("=")
+    ui.label(result).style({"color": text_color})
+
+ui.server().run()
+```
+
+Replace `ui.server().run()` with `ui.webview().run()` to switch to Web View mode:
+
+```python
+...
+
+# ui.server().run()
+ui.webview().run()
+```
+
+To execute computations on the client side instead of the server, use `ui.js_computed` instead of `ui.computed`:
+
+```python
+from instaui import ui, arco
+arco.use()
+
+@ui.page('/')
+def home():
+    num1 = ui.state(0)
+    num2 = ui.state(0)
+
+    result = ui.js_computed(inputs=[num1, num2], code="(num1, num2) => num1 + num2")
+    text_color = ui.js_computed(inputs=[result], code="(result) => result % 2 === 0? 'red' : 'blue'")
+
+    # UI components
+    ...
+
+...
+
+```
+
+In this case, all interactions will run on the client side. Use `Zero mode` to generate a standalone HTML file:
+
+```python
+from instaui import ui, arco,zero
+arco.use()
+
+@ui.page('/')
+def home():
+    num1 = ui.state(0)
+    num2 = ui.state(0)
+
+    result = ui.js_computed(inputs=[num1, num2], code="(num1, num2) => num1 + num2")
+    text_color = ui.js_computed(inputs=[result], code="(result) => result % 2 === 0? 'red' : 'blue'")
+
+    # UI components
+    arco.input_number(num1)
+    ui.label("+")
+    arco.input_number(num2)
+    ui.label("=")
+    ui.label(result).style({"color": text_color})
+
+with zero() as z:
+    home()
+    z.to_html('index.html')
+
+```

{instaui-0.1.8 → instaui-0.1.10}/instaui/_helper/observable_helper.py

@@ -1,6 +1,6 @@
 import typing
 from instaui.vars.mixin_types.observable import ObservableMixin
-from instaui.vars.mixin_types.py_binding import CanInputMixin
+from instaui.vars.mixin_types.py_binding import CanInputMixin, CanOutputMixin
 from instaui.ui_functions.input_slient_data import InputSilentData
 
 from instaui.vars.mixin_types.common_type import TObservableInput
@@ -33,3 +33,13 @@ def analyze_observable_inputs(inputs: typing.List[TObservableInput]):
             result_inputs.append(input)
 
     return result_inputs, slients, datas
+
+
+def auto_made_inputs_to_slient(
+    inputs: typing.Optional[typing.Sequence[TObservableInput]],
+    outputs: typing.Optional[typing.Sequence[CanOutputMixin]],
+):
+    if inputs is None or outputs is None:
+        return inputs
+
+    return [InputSilentData(input) if input in outputs else input for input in inputs]

{instaui-0.1.8 → instaui-0.1.10}/instaui/arco/components/select.py

@@ -10,6 +10,9 @@ from instaui.arco import component_types
 from instaui.event.event_mixin import EventMixin
 from ._utils import handle_props, try_setup_vmodel
 
+
+_TSelectValue = typing.Union[str, int, typing.Sequence[str], typing.Sequence[int]]
+
 _OPTIONS_TRANSLATE_JS: typing.Final = r"""(options)=>{
     if (Array.isArray(options)){
         const obj = {};
@@ -27,7 +30,7 @@ class Select(Element):
     def __init__(
         self,
         options: TMaybeRef[typing.Union[typing.Sequence, typing.Dict]],
-        value: typing.Optional[TMaybeRef[typing.Union[str, int]]] = None,
+        value: typing.Optional[TMaybeRef[_TSelectValue]] = None,
         **kwargs: Unpack[component_types.TSelect],
     ):
         super().__init__("a-select")