pyvis-optimized 4.3.1__tar.gz → 4.4.0__tar.gz

{pyvis_optimized-4.3.1 → pyvis_optimized-4.4.0}/CHANGELOG.md

@@ -4,6 +4,33 @@ All notable changes to this project are documented in this file.
 
 
 
+## [4.4.0] - 2026-09-06
+
+### Breaking Changes
+- **Python 3.10 is now the minimum.** 3.9 is dropped. Under 3.9 the resolver
+  silently installed Shiny 1.5.0 while development targeted 1.7.0, so the
+  version actually being tested was not the version being shipped.
+
+### Added
+- `network_destroy(session, output_id)` and `PyVisNetworkController.destroy()`
+  tear down the client-side network without removing its element. Intended for
+  `session.on_destroy` / `session.on_ended`, so a closing session releases the
+  vis instance instead of leaving it registered.
+- End-to-end tests that run a real Shiny app in a real browser, covering the
+  module UI, the namespaced output id, and the `show_controls` physics path.
+
+### Fixed
+- A resize callback scheduled just before teardown no longer runs against a
+  destroyed network. Disconnecting the ResizeObserver stops new callbacks but
+  does not cancel a pending debounce timer, so the late call raised "Cannot
+  read properties of undefined (reading 'setSize')" during a re-render.
+- The browser test harness now loads `styles.css`, so the flex layout the
+  canvas sizing depends on is present and resize behaviour is observed
+  faithfully rather than against collapsed block flow.
+
+### Changed
+- Bundled vis-network upgraded from 10.0.2 to 10.1.2.
+
 ## [4.3.1] - 2026-09-06
 
 Packaging-only release. 4.3.0 was tagged but never published: both publish

{pyvis_optimized-4.3.1/pyvis_optimized.egg-info → pyvis_optimized-4.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyvis-optimized
-Version: 4.3.1
+Version: 4.4.0
 Summary: A Python network graph visualization library - Optimized Edition
 Author-email: Jose Unpingco <datascience@westhealth.org>
 Maintainer: PyVis Contributors
@@ -17,21 +17,20 @@ Classifier: Intended Audience :: Science/Research
 Classifier: License :: OSI Approved :: BSD License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Scientific/Engineering :: Visualization
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: >=3.9
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE_BSD.txt
 Requires-Dist: jinja2>=2.9.6
 Requires-Dist: networkx>=1.11
 Requires-Dist: jsonpickle>=1.4.1
 Provides-Extra: shiny
-Requires-Dist: shiny>=0.6.0; extra == "shiny"
+Requires-Dist: shiny>=1.0; extra == "shiny"
 Requires-Dist: htmltools; extra == "shiny"
 Provides-Extra: notebook
 Requires-Dist: ipython>=5.3.0; extra == "notebook"
@@ -70,7 +69,7 @@ PyVis is a Python library for creating and visualizing interactive network graph
 
 ## Installation
 
-**Requires Python >= 3.9**
+**Requires Python >= 3.10**
 
 ```bash
 pip install pyvis-optimized
@@ -102,7 +101,7 @@ pip install .
 | [jinja2](https://jinja.palletsprojects.com/) >= 2.9.6 | HTML template rendering |
 | [jsonpickle](https://jsonpickle.github.io/) >= 1.4.1 | JSON serialization |
 
-Optional: [ipython](https://ipython.org/) >= 5.3.0 (`pyvis-optimized[notebook]`), [shiny](https://shiny.posit.co/py/) >= 0.6.0 and [htmltools](https://pypi.org/project/htmltools/) (`pyvis-optimized[shiny]`)
+Optional: [ipython](https://ipython.org/) >= 5.3.0 (`pyvis-optimized[notebook]`), [shiny](https://shiny.posit.co/py/) >= 1.0 and [htmltools](https://pypi.org/project/htmltools/) (`pyvis-optimized[shiny]`)
 
 ## Quick Start
 
@@ -228,6 +227,7 @@ See the [Shiny Integration Guide](docs/SHINY_INTEGRATION_GUIDE.md) for complete
 
 - **[API Reference](docs/API_REFERENCE.md)** — Complete reference for Network class, typed options (44 dataclasses), Shiny integration, and all public methods
 - **[Shiny Integration Guide](docs/SHINY_INTEGRATION_GUIDE.md)** — Detailed guide for using PyVis with Shiny for Python
+- **[Releasing](docs/RELEASING.md)** — How a release is cut and published to PyPI and anaconda.org, and how to retry a failed one
 
 ## Testing
 
@@ -235,7 +235,7 @@ See the [Shiny Integration Guide](docs/SHINY_INTEGRATION_GUIDE.md) for complete
 pytest pyvis/tests/ --ignore=pyvis/tests/test_html.py -v
 ```
 
-That command runs 480 tests covering core network operations, typed options, Shiny integration, security, error handling, and regression tests for edge cases. The full suite is 484 (run `pytest --co` for the current count); the four extra are the Playwright browser tests in `test_html.py`, which need `pip install pyvis-optimized[test]` followed by `python -m playwright install chromium`.
+That command runs 474 tests covering core network operations, typed options, Shiny integration, security, error handling, and regression tests for edge cases. The full suite is 495 (run `pytest --co` for the current count); the extra 21 are the Playwright browser tests in `test_html.py`, `test_bindings_js.py`, and `test_shiny_e2e.py`, which need `pip install pyvis-optimized[test]` followed by `python -m playwright install chromium`.
 
 ## Versioning
 
@@ -260,7 +260,7 @@ pyvis/
     shiny/              # Shiny for Python integration
         wrapper.py      # Controller, standalone functions, rendering
         bindings.js     # JavaScript binding for vis-network
-    tests/              # 484 tests across 28 modules (see `pytest --co` for current count)
+    tests/              # 495 tests across 29 modules (see `pytest --co` for current count)
 auto_version.py         # Version bump + changelog + tag script
 ```
 

{pyvis_optimized-4.3.1 → pyvis_optimized-4.4.0}/README.md

@@ -17,7 +17,7 @@ PyVis is a Python library for creating and visualizing interactive network graph
 
 ## Installation
 
-**Requires Python >= 3.9**
+**Requires Python >= 3.10**
 
 ```bash
 pip install pyvis-optimized
@@ -49,7 +49,7 @@ pip install .
 | [jinja2](https://jinja.palletsprojects.com/) >= 2.9.6 | HTML template rendering |
 | [jsonpickle](https://jsonpickle.github.io/) >= 1.4.1 | JSON serialization |
 
-Optional: [ipython](https://ipython.org/) >= 5.3.0 (`pyvis-optimized[notebook]`), [shiny](https://shiny.posit.co/py/) >= 0.6.0 and [htmltools](https://pypi.org/project/htmltools/) (`pyvis-optimized[shiny]`)
+Optional: [ipython](https://ipython.org/) >= 5.3.0 (`pyvis-optimized[notebook]`), [shiny](https://shiny.posit.co/py/) >= 1.0 and [htmltools](https://pypi.org/project/htmltools/) (`pyvis-optimized[shiny]`)
 
 ## Quick Start
 
@@ -175,6 +175,7 @@ See the [Shiny Integration Guide](docs/SHINY_INTEGRATION_GUIDE.md) for complete
 
 - **[API Reference](docs/API_REFERENCE.md)** — Complete reference for Network class, typed options (44 dataclasses), Shiny integration, and all public methods
 - **[Shiny Integration Guide](docs/SHINY_INTEGRATION_GUIDE.md)** — Detailed guide for using PyVis with Shiny for Python
+- **[Releasing](docs/RELEASING.md)** — How a release is cut and published to PyPI and anaconda.org, and how to retry a failed one
 
 ## Testing
 
@@ -182,7 +183,7 @@ See the [Shiny Integration Guide](docs/SHINY_INTEGRATION_GUIDE.md) for complete
 pytest pyvis/tests/ --ignore=pyvis/tests/test_html.py -v
 ```
 
-That command runs 480 tests covering core network operations, typed options, Shiny integration, security, error handling, and regression tests for edge cases. The full suite is 484 (run `pytest --co` for the current count); the four extra are the Playwright browser tests in `test_html.py`, which need `pip install pyvis-optimized[test]` followed by `python -m playwright install chromium`.
+That command runs 474 tests covering core network operations, typed options, Shiny integration, security, error handling, and regression tests for edge cases. The full suite is 495 (run `pytest --co` for the current count); the extra 21 are the Playwright browser tests in `test_html.py`, `test_bindings_js.py`, and `test_shiny_e2e.py`, which need `pip install pyvis-optimized[test]` followed by `python -m playwright install chromium`.
 
 ## Versioning
 
@@ -207,7 +208,7 @@ pyvis/
     shiny/              # Shiny for Python integration
         wrapper.py      # Controller, standalone functions, rendering
         bindings.js     # JavaScript binding for vis-network
-    tests/              # 484 tests across 28 modules (see `pytest --co` for current count)
+    tests/              # 495 tests across 29 modules (see `pytest --co` for current count)
 auto_version.py         # Version bump + changelog + tag script
 ```
 

{pyvis_optimized-4.3.1 → pyvis_optimized-4.4.0}/pyproject.toml

@@ -7,7 +7,7 @@ name = "pyvis-optimized"
 dynamic = ["version"]
 description = "A Python network graph visualization library - Optimized Edition"
 readme = "README.md"
-requires-python = ">=3.9"
+requires-python = ">=3.10"
 license = {text = "BSD"}
 authors = [
     {name = "Jose Unpingco", email = "datascience@westhealth.org"}
@@ -23,7 +23,6 @@ classifiers = [
     "License :: OSI Approved :: BSD License",
     "Operating System :: OS Independent",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
@@ -41,7 +40,7 @@ dependencies = [
 [project.optional-dependencies]
 # Shiny integration support
 shiny = [
-    "shiny>=0.6.0",
+    "shiny>=1.0",
     "htmltools",
 ]
 
@@ -105,7 +104,7 @@ python_functions = "test_*"
 
 [tool.black]
 line-length = 100
-target-version = ['py39', 'py310', 'py311', 'py312', 'py313']
+target-version = ['py310', 'py311', 'py312', 'py313']
 include = '\.pyi?$'
 exclude = '''
 /(
@@ -122,7 +121,7 @@ exclude = '''
 '''
 
 [tool.mypy]
-python_version = "3.9"
+python_version = "3.10"
 warn_return_any = true
 warn_unused_configs = true
 disallow_untyped_defs = false

pyvis_optimized-4.4.0/pyvis/_version.py

@@ -0,0 +1 @@
+__version__ = '4.4.0'

{pyvis_optimized-4.3.1 → pyvis_optimized-4.4.0}/pyvis/shiny/__init__.py

@@ -151,6 +151,7 @@ from .wrapper import (
     network_open_cluster,
     network_set_options,
     network_set_theme,
+    network_destroy,
     network_toggle_manipulation,
     network_set_edge_edit_mode,
     network_set_node_template_mode,
@@ -196,6 +197,7 @@ __all__ = [
     'network_open_cluster',
     'network_set_options',
     'network_set_theme',
+    'network_destroy',
     'network_toggle_manipulation',
     'network_set_edge_edit_mode',
     'network_set_node_template_mode',

{pyvis_optimized-4.3.1 → pyvis_optimized-4.4.0}/pyvis/shiny/bindings.js

@@ -1037,7 +1037,15 @@ if (typeof Shiny !== 'undefined') {
             }
 
             // === RESIZE OBSERVER ===
+            // The handler is debounced, so a callback can already be scheduled
+            // when the instance is torn down by a re-render or an explicit
+            // destroy. Disconnecting the observer stops new callbacks but does
+            // not cancel a pending timer, and the late call would then reach a
+            // destroyed vis network ("Cannot read properties of undefined
+            // (reading 'setSize')"). Bail out unless this ref is still the
+            // registered instance for this output.
             var resizeHandler = pyvisDebounce(function() {
+                if (window.pyvisNetworks[outputId] !== ref) return;
                 network.setSize(canvasDiv.offsetWidth + 'px', canvasDiv.offsetHeight + 'px');
                 network.redraw();
             }, 150);
@@ -1198,6 +1206,14 @@ if (typeof Shiny !== 'undefined') {
                     .replace(/pyvis-theme-\w+/, 'pyvis-theme-' + newTheme);
                 break;
 
+            // Explicit teardown, for a server that knows the output is going
+            // away (e.g. from session.on_destroy) before the DOM node is
+            // removed. Releases the vis network, its DataSets, the resize
+            // observer and the global keydown handler.
+            case 'destroy':
+                pyvisDestroy(outputId);
+                break;
+
             // Queries - responses sent back as Shiny inputs
             case 'getPositions':
                 Shiny.setInputValue(outputId + '_response_positions',

{pyvis_optimized-4.3.1 → pyvis_optimized-4.4.0}/pyvis/shiny/wrapper.py

@@ -156,6 +156,7 @@ __all__ = [
     'network_open_cluster',
     'network_set_options',
     'network_set_theme',
+    'network_destroy',
     'network_toggle_manipulation',
     'network_set_edge_edit_mode',
     'network_set_node_template_mode',
@@ -825,6 +826,20 @@ if SHINY_AVAILABLE:
             """
             network_set_theme(self.session, self.output_id, theme)
 
+        def destroy(self):
+            """Tear down the client-side network and release its resources.
+
+            Intended for session lifecycle hooks, which Shiny gained in 1.6.1::
+
+                ctrl = PyVisNetworkController("network", session)
+                session.on_destroy(ctrl.destroy)
+
+            Removing the output element from the DOM already triggers the same
+            teardown; this covers the case where the element outlives the
+            network.
+            """
+            network_destroy(self.session, self.output_id)
+
         # === Manipulation ===
 
         def toggle_manipulation(self, enabled: bool) -> None:
@@ -1102,6 +1117,23 @@ def network_set_theme(session: 'Session', output_id: str, theme: str):
     _send_network_command(session, output_id, "setTheme", {"theme": theme})
 
 
+def network_destroy(session: 'Session', output_id: str):
+    """Tear down the client-side network and release its resources.
+
+    Frees the vis-network instance, its DataSets, the resize observer and the
+    document-level keydown handler for this output. The output element itself
+    is left in place; re-rendering builds a fresh network.
+
+    Removing the output from the DOM already triggers the same teardown, so
+    this is for the case where the server knows the network is finished with
+    while the element survives. Pair it with session lifecycle hooks::
+
+        ctrl = PyVisNetworkController("network", session)
+        session.on_destroy(ctrl.destroy)   # or session.on_ended(...)
+    """
+    _send_network_command(session, output_id, "destroy")
+
+
 def network_toggle_manipulation(session: 'Session', output_id: str, enabled: bool):
     """Show or hide the native manipulation toolbar.