Merge branch 'main' into dependabot/pip/plotly-5.24.0

DEPENDENCIES.md

@@ -1,19 +1,19 @@
 # Included Web Dependencies
 
-- vue: 3.3.6 ([MIT](https://opensource.org/licenses/MIT))
-- quasar: 2.13.0 ([MIT](https://opensource.org/licenses/MIT))
-- tailwindcss: 3.2.0 ([MIT](https://opensource.org/licenses/MIT))
-- socket.io: 4.7.2 ([MIT](https://opensource.org/licenses/MIT))
-- es-module-shims: 1.8.0 ([MIT](https://opensource.org/licenses/MIT))
-- aggrid: 30.2.0 ([MIT](https://opensource.org/licenses/MIT))
+- vue: 3.4.38 ([MIT](https://opensource.org/licenses/MIT))
+- quasar: 2.16.9 ([MIT](https://opensource.org/licenses/MIT))
+- tailwindcss: 3.4.10 ([MIT](https://opensource.org/licenses/MIT))
+- socket.io: 4.7.5 ([MIT](https://opensource.org/licenses/MIT))
+- es-module-shims: 1.10.0 ([MIT](https://opensource.org/licenses/MIT))
+- aggrid: 32.1.0 ([MIT](https://opensource.org/licenses/MIT))
 - codemirror: 6.0.1 ([MIT](https://opensource.org/licenses/MIT))
-- echarts: 5.4.3 ([Apache-2.0](https://opensource.org/licenses/Apache-2.0))
+- echarts: 5.5.1 ([Apache-2.0](https://opensource.org/licenses/Apache-2.0))
 - echarts-gl: 2.0.9 ([BSD-3-Clause](https://opensource.org/licenses/BSD-3-Clause))
 - leaflet: 1.9.4 ([BSD-2-Clause](https://opensource.org/licenses/BSD-2-Clause))
 - leaflet-draw: 1.0.4 ([MIT](https://opensource.org/licenses/MIT))
-- mermaid: 10.5.1 ([MIT](https://opensource.org/licenses/MIT))
-- nipplejs: 0.10.1 ([MIT](https://opensource.org/licenses/MIT))
-- plotly: 2.27.0 ([MIT](https://opensource.org/licenses/MIT))
-- three: 0.157.0 ([MIT](https://opensource.org/licenses/MIT))
-- tween: 21.0.0 ([MIT](https://opensource.org/licenses/MIT))
-- vanilla-jsoneditor: 0.18.10 ([ISC](https://opensource.org/licenses/ISC))
+- mermaid: 11.0.2 ([MIT](https://opensource.org/licenses/MIT))
+- nipplejs: 0.10.2 ([MIT](https://opensource.org/licenses/MIT))
+- plotly: 2.35.0 ([MIT](https://opensource.org/licenses/MIT))
+- three: 0.168.0 ([MIT](https://opensource.org/licenses/MIT))
+- tween: 25.0.0 ([MIT](https://opensource.org/licenses/MIT))
+- vanilla-jsoneditor: 0.23.8 ([ISC](https://opensource.org/licenses/ISC))

examples/chat_with_ai/requirements.txt

@@ -1,3 +1,4 @@
-langchain>=0.0.142
+langchain>=0.2
+langchain-community
 langchain_openai
 nicegui

examples/node_module_integration/.gitignore

@@ -0,0 +1,2 @@
+node_modules/
+package-lock.json

examples/node_module_integration/README.md

@@ -0,0 +1,30 @@
+# Use Bundled Node Modules as Third-party Dependencies
+
+This example demonstrates how to use multiple third-party node modules as dependencies in a NiceGUI app.
+The app uses the [is-odd](https://www.npmjs.com/package/is-odd) node modules to check if a number is even or odd.
+We chose this package to demonstrate a very simple node module which has a dependency itself,
+namely the [is-number](https://www.npmjs.com/package/is-number) package.
+Using NPM, we can easily install both packages and bundle them into a single file which can be used in the app.
+The package.json file defines the is-odd dependency and some dev dependencies for bundling the node module,
+the webpack.config.js file specifies the entry point for the node module,
+and number_checker.js as well as number_checker.py define a new UI element to be used in the NiceGUI app main.py.
+
+1. First, install all third-party node modules (assuming you have NPM installed):
+
+   ```bash
+   npm install
+   ```
+
+   This will create a node_modules directory containing the is-odd and is-number modules as well as some dev dependencies.
+
+2. Now bundle the node module:
+
+   ```bash
+   npm run build
+   ```
+
+3. Finally, you can run the app as usual:
+
+   ```bash
+   python3 main.py
+   ```

examples/node_module_integration/main.py

@@ -0,0 +1,19 @@
+#!/usr/bin/env python3
+from number_checker import NumberChecker
+
+from nicegui import ui
+
+
+@ui.page('/')
+def page():
+    number_checker = NumberChecker()
+    number = ui.number(value=42.0)
+
+    async def check():
+        even = await number_checker.is_even(number.value)
+        ui.notify(f'{number.value} is {"even" if even else "odd"}')
+
+    ui.button('Check', on_click=check)
+
+
+ui.run()

examples/node_module_integration/number_checker.js

@@ -0,0 +1,13 @@
+export default {
+  async mounted() {
+    await import("is-odd");
+  },
+  methods: {
+    isOdd(number) {
+      return isOdd(number);
+    },
+    isEven(number) {
+      return !isOdd(number);
+    },
+  },
+};

examples/node_module_integration/number_checker.py

@@ -0,0 +1,19 @@
+from nicegui import ui
+
+
+class NumberChecker(ui.element, component='number_checker.js', dependencies=['dist/is-odd.js']):
+
+    def __init__(self) -> None:
+        """NumberChecker
+
+        A number checker based on the `is-odd <https://www.npmjs.com/package/is-odd>`_ NPM package.
+        """
+        super().__init__()
+
+    async def is_odd(self, number: int) -> bool:
+        """Check if a number is odd."""
+        return await self.run_method('isOdd', number)
+
+    async def is_even(self, number: int) -> bool:
+        """Check if a number is even."""
+        return await self.run_method('isEven', number)

examples/node_module_integration/package.json

@@ -0,0 +1,15 @@
+{
+  "scripts": {
+    "build": "webpack --config webpack.config.js"
+  },
+  "dependencies": {
+    "is-odd": "^3.0.1"
+  },
+  "devDependencies": {
+    "@babel/core": "^7.24.5",
+    "@babel/preset-env": "^7.24.5",
+    "babel-loader": "^9.1.3",
+    "webpack": "^5.91.0",
+    "webpack-cli": "^5.1.4"
+  }
+}

examples/node_module_integration/webpack.config.js

@@ -0,0 +1,26 @@
+const path = require("path");
+
+module.exports = {
+  entry: "is-odd/index.js",
+  mode: "development",
+  output: {
+    path: path.resolve(__dirname, "dist"),
+    filename: "is-odd.js",
+    library: "isOdd",
+    libraryTarget: "umd",
+  },
+  module: {
+    rules: [
+      {
+        test: /\.js$/,
+        exclude: /node_modules/,
+        use: {
+          loader: "babel-loader",
+          options: {
+            presets: ["@babel/preset-env"],
+          },
+        },
+      },
+    ],
+  },
+};

examples/signature_pad/.gitignore

@@ -0,0 +1,2 @@
+node_modules/
+package-lock.json

examples/signature_pad/README.md

@@ -0,0 +1,20 @@
+# Use Node Modules as Third-party Dependencies
+
+This example demonstrates how to use third-party node modules as dependencies in a NiceGUI app.
+The app uses the [signature_pad](https://www.npmjs.com/package/signature_pad) node module to create a signature pad.
+In package.json, the signature_pad module is listed as a dependency,
+while signature_pad.js and signature_pad.py define the new UI element which can be used in main.py.
+
+1. First, install the third-party node modules (assuming you have NPM installed):
+
+   ```bash
+   npm install
+   ```
+
+   This will create a node_modules directory containing the signature_pad module.
+
+2. Now you can run the app as usual:
+
+   ```bash
+   python3 main.py
+   ```

examples/signature_pad/main.py

@@ -0,0 +1,9 @@
+#!/usr/bin/env python3
+from signature_pad import SignaturePad
+
+from nicegui import ui
+
+pad = SignaturePad().classes('border')
+ui.button('Clear', on_click=pad.clear)
+
+ui.run()

examples/signature_pad/package.json

@@ -0,0 +1,5 @@
+{
+  "dependencies": {
+    "signature_pad": "^4.1.7"
+  }
+}

examples/signature_pad/signature_pad.js

@@ -0,0 +1,16 @@
+import SignaturePad from "signature_pad";
+
+export default {
+  template: "<canvas></canvas>",
+  props: {
+    options: Array,
+  },
+  mounted() {
+    this.pad = new SignaturePad(this.$el, this.options);
+  },
+  methods: {
+    clear() {
+      this.pad.clear();
+    },
+  },
+};

examples/signature_pad/signature_pad.py

@@ -0,0 +1,20 @@
+from typing import Dict, Optional
+
+from nicegui import ui
+
+
+class SignaturePad(ui.element,
+                   component='signature_pad.js',
+                   dependencies=['node_modules/signature_pad/dist/signature_pad.min.js']):
+
+    def __init__(self, options: Optional[Dict] = None) -> None:
+        """SignaturePad
+
+        An element that integrates the `Signature Pad library <https://szimek.github.io/signature_pad/>`_.
+        """
+        super().__init__()
+        self._props['options'] = options or {}
+
+    def clear(self):
+        """Clear the signature."""
+        self.run_method('clear')

examples/table_and_slots/main.py

@@ -25,7 +25,7 @@
         with table.row():
             with table.cell():
                 ui.button(on_click=lambda: (
-                    table.add_rows({'id': time.time(), 'name': new_name.value, 'age': new_age.value}),
+                    table.add_row({'id': time.time(), 'name': new_name.value, 'age': new_age.value}),
                     new_name.set_value(None),
                     new_age.set_value(None),
                 ), icon='add').props('flat fab-mini')
@@ -35,7 +35,7 @@
                 new_age = ui.number('Age')
 
 ui.label().bind_text_from(table, 'selected', lambda val: f'Current selection: {val}')
-ui.button('Remove', on_click=lambda: table.remove_rows(*table.selected)) \
+ui.button('Remove', on_click=lambda: table.remove_rows(table.selected)) \
     .bind_visibility_from(table, 'selected', backward=lambda val: bool(val))
 
 ui.run()

nicegui/app/app.py

@@ -32,7 +32,7 @@ class State(Enum):
 class App(FastAPI):
 
     def __init__(self, **kwargs) -> None:
-        super().__init__(**kwargs)
+        super().__init__(**kwargs, docs_url=None, redoc_url=None, openapi_url=None)
         self.native = NativeConfig()
         self.storage = Storage()
         self.urls = ObservableSet()

nicegui/client.py

@@ -90,8 +90,9 @@ def is_auto_index_client(self) -> bool:
 
     @property
     def ip(self) -> Optional[str]:
-        """Return the IP address of the client, or None if the client is not connected."""
-        return self.environ['asgi.scope']['client'][0] if self.environ else None  # pylint: disable=unsubscriptable-object
+        """Return the IP address of the client, or None if it is an
+        `auto-index page <https://nicegui.io/documentation/section_pages_routing#auto-index_page>`_."""
+        return self.request.client.host if self.request is not None and self.request.client is not None else None
 
     @property
     def has_socket_connection(self) -> bool:
@@ -180,11 +181,7 @@ async def disconnected(self, check_interval: float = 0.1) -> None:
             await asyncio.sleep(check_interval)
         self.is_waiting_for_disconnect = False
 
-    def run_javascript(self, code: str, *,
-                       respond: Optional[bool] = None,  # DEPRECATED
-                       timeout: float = 1.0,
-                       check_interval: float = 0.01,  # DEPRECATED
-                       ) -> AwaitableResponse:
+    def run_javascript(self, code: str, *, timeout: float = 1.0) -> AwaitableResponse:
         """Execute JavaScript on the client.
 
         The client connection must be established before this method is called.
@@ -198,19 +195,6 @@ def run_javascript(self, code: str, *,
 
         :return: AwaitableResponse that can be awaited to get the result of the JavaScript code
         """
-        if respond is True:
-            helpers.warn_once('The "respond" argument of run_javascript() has been removed. '
-                              'Now the method always returns an AwaitableResponse that can be awaited. '
-                              'Please remove the "respond=True" argument.')
-        if respond is False:
-            raise ValueError('The "respond" argument of run_javascript() has been removed. '
-                             'Now the method always returns an AwaitableResponse that can be awaited. '
-                             'Please remove the "respond=False" argument and call the method without awaiting.')
-        if check_interval != 0.01:
-            helpers.warn_once('The "check_interval" argument of run_javascript() and similar methods has been removed. '
-                              'Now the method automatically returns when receiving a response without checking regularly in an interval. '
-                              'Please remove the "check_interval" argument.')
-
         request_id = str(uuid.uuid4())
         target_id = self._temporary_socket_id or self.id
 
@@ -311,7 +295,7 @@ def remove_elements(self, elements: Iterable[Element]) -> None:
             element._handle_delete()  # pylint: disable=protected-access
             element._deleted = True  # pylint: disable=protected-access
             self.outbox.enqueue_delete(element)
-            del self.elements[element.id]
+            self.elements.pop(element.id, None)
 
     def remove_all_elements(self) -> None:
         """Remove all elements from the client."""

nicegui/context.py

@@ -2,7 +2,6 @@
 
 from typing import TYPE_CHECKING, List
 
-from . import helpers
 from .slot import Slot
 
 if TYPE_CHECKING:
@@ -11,21 +10,6 @@
 
 class Context:
 
-    def get_slot_stack(self) -> List[Slot]:
-        """Return the slot stack of the current asyncio task. (DEPRECATED, use context.slot_stack instead)"""
-        helpers.warn_once('context.get_slot_stack() is deprecated, use context.slot_stack instead')
-        return self.slot_stack
-
-    def get_slot(self) -> Slot:
-        """Return the current slot. (DEPRECATED, use context.slot instead)"""
-        helpers.warn_once('context.get_slot() is deprecated, use context.slot instead')
-        return self.slot
-
-    def get_client(self) -> Client:
-        """Return the current client. (DEPRECATED, use context.client instead)"""
-        helpers.warn_once('context.get_client() is deprecated, use context.client instead')
-        return self.client
-
     @property
     def slot_stack(self) -> List[Slot]:
         """Return the slot stack of the current asyncio task."""