tensor-network-visualization 2.0.2__tar.gz → 2.0.3__tar.gz

{tensor_network_visualization-2.0.2/src/tensor_network_visualization.egg-info → tensor_network_visualization-2.0.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tensor-network-visualization
-Version: 2.0.2
+Version: 2.0.3
 Summary: Minimal Matplotlib visualizations for TensorKrowch, TensorNetwork, Quimb, TeNPy, and traced PyTorch/NumPy einsum tensor networks.
 Author: Alejandro Mata Ali
 License-Expression: MIT
@@ -27,10 +27,14 @@ Requires-Dist: matplotlib>=3.7
 Requires-Dist: networkx>=3.0
 Requires-Dist: numpy>=2.0
 Provides-Extra: dev
+Requires-Dist: bandit; extra == "dev"
 Requires-Dist: build; extra == "dev"
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: ruff; extra == "dev"
+Requires-Dist: setuptools; extra == "dev"
 Requires-Dist: pyright; extra == "dev"
+Requires-Dist: pip-audit; extra == "dev"
+Requires-Dist: twine; extra == "dev"
 Requires-Dist: ipython; extra == "dev"
 Requires-Dist: tensorkrowch; extra == "dev"
 Requires-Dist: tensornetwork; extra == "dev"

{tensor_network_visualization-2.0.2 → tensor_network_visualization-2.0.3}/README.md

@@ -62,20 +62,20 @@ Tensor-network libraries expose different Python objects. This package gives the
 visualization API so you can inspect structure, tensor values, contraction playback, and normalized
 graph exports without rewriting plotting code for every backend.
 
-The common entry points are:
-
-```python
-show_tensor_network(...)
-show_tensor_elements(...)
-show_tensor_comparison(...)
-translate_tensor_network(...)
-normalize_tensor_network(...)
-export_tensor_network_snapshot(...)
-```
-
-If you want code for another backend rather than a figure, `translate_tensor_network(...)` can turn
-supported TensorKrowch, TensorNetwork, Quimb, TeNPy, and traced `einsum` inputs into executable
-Python for `tensornetwork`, `quimb`, `einsum`, or `tensorkrowch`.
+The common entry points are:
+
+```python
+show_tensor_network(...)
+show_tensor_elements(...)
+show_tensor_comparison(...)
+translate_tensor_network(...)
+normalize_tensor_network(...)
+export_tensor_network_snapshot(...)
+```
+
+If you want code for another backend rather than a figure, `translate_tensor_network(...)` can turn
+supported TensorKrowch, TensorNetwork, Quimb, TeNPy, and traced `einsum` inputs into executable
+Python for `tensornetwork`, `quimb`, `einsum`, or `tensorkrowch`.
 
 ## Install
 
@@ -205,27 +205,27 @@ The repository examples are organized around the same launcher:
 python examples/run_demo.py <group> <demo>
 ```
 
-The gallery includes backend demos for TensorKrowch, TensorNetwork, Quimb, TeNPy, and `einsum`,
-plus three focused groups:
+The gallery includes backend demos for TensorKrowch, TensorNetwork, Quimb, TeNPy, and `einsum`,
+plus three focused groups:
 
 - `themes overview`: compares the `PlotConfig` visual presets for tensor-network figures.
 - `themes tensor_elements`: compares the `TensorElementsConfig` presets for `show_tensor_elements(...)`
   and the linked tensor inspector.
 - `placements`: shows object, list, 2D grid, 3D grid, manual positions, manual schemes, and named
   index inputs.
-- `geometry`: renders larger irregular, incomplete, triangular, pyramidal, circular, and
-  disconnected networks.
-
-There is also a dedicated translation demo:
-
-```bash
-python examples/translate_demo.py --source-engine tensornetwork --target-engine quimb --example mps
-```
-
-It generates Python code for the translated tensor network and can render the original and
-translated versions side by side for comparison.
-
-For batch checks, use:
+- `geometry`: renders larger irregular, incomplete, triangular, pyramidal, circular, and
+  disconnected networks.
+
+There is also a dedicated translation demo:
+
+```bash
+python examples/translate_demo.py --source-engine tensornetwork --target-engine quimb --example mps
+```
+
+It generates Python code for the translated tensor network and can render the original and
+translated versions side by side for comparison.
+
+For batch checks, use:
 
 ```bash
 python examples/run_all_examples.py --group engines --views 2d --list

{tensor_network_visualization-2.0.2 → tensor_network_visualization-2.0.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "tensor-network-visualization"
-version = "2.0.2"
+version = "2.0.3"
 description = "Minimal Matplotlib visualizations for TensorKrowch, TensorNetwork, Quimb, TeNPy, and traced PyTorch/NumPy einsum tensor networks."
 authors = [{ name = "Alejandro Mata Ali" }]
 readme = "README.md"
@@ -39,10 +39,14 @@ Issues = "https://github.com/DOKOS-TAYOS/Tensor-Network-Visualization/issues"
 
 [project.optional-dependencies]
 dev = [
+    "bandit",
     "build",
     "pytest",
     "ruff",
+    "setuptools",
     "pyright",
+    "pip-audit",
+    "twine",
     "ipython",
     "tensorkrowch",
     "tensornetwork",

{tensor_network_visualization-2.0.2 → tensor_network_visualization-2.0.3/src/tensor_network_visualization.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tensor-network-visualization
-Version: 2.0.2
+Version: 2.0.3
 Summary: Minimal Matplotlib visualizations for TensorKrowch, TensorNetwork, Quimb, TeNPy, and traced PyTorch/NumPy einsum tensor networks.
 Author: Alejandro Mata Ali
 License-Expression: MIT
@@ -27,10 +27,14 @@ Requires-Dist: matplotlib>=3.7
 Requires-Dist: networkx>=3.0
 Requires-Dist: numpy>=2.0
 Provides-Extra: dev
+Requires-Dist: bandit; extra == "dev"
 Requires-Dist: build; extra == "dev"
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: ruff; extra == "dev"
+Requires-Dist: setuptools; extra == "dev"
 Requires-Dist: pyright; extra == "dev"
+Requires-Dist: pip-audit; extra == "dev"
+Requires-Dist: twine; extra == "dev"
 Requires-Dist: ipython; extra == "dev"
 Requires-Dist: tensorkrowch; extra == "dev"
 Requires-Dist: tensornetwork; extra == "dev"

{tensor_network_visualization-2.0.2 → tensor_network_visualization-2.0.3}/src/tensor_network_visualization.egg-info/SOURCES.txt

@@ -159,6 +159,7 @@ tests/test_plotting.py
 tests/test_public_api.py
 tests/test_quimb_backend.py
 tests/test_render_performance_controls.py
+tests/test_security_config.py
 tests/test_show_tensor_network_throughput.py
 tests/test_snapshot_api.py
 tests/test_tenpy_backend.py

{tensor_network_visualization-2.0.2 → tensor_network_visualization-2.0.3}/src/tensor_network_visualization.egg-info/requires.txt

@@ -3,10 +3,14 @@ networkx>=3.0
 numpy>=2.0
 
 [dev]
+bandit
 build
 pytest
 ruff
+setuptools
 pyright
+pip-audit
+twine
 ipython
 tensorkrowch
 tensornetwork

{tensor_network_visualization-2.0.2 → tensor_network_visualization-2.0.3}/src/tensor_network_viz/_core/draw/hover.py

@@ -401,8 +401,8 @@ def _apply_saved_hover_state(
         )
         return
 
-    assert state.positions is not None
-    assert state.params is not None
+    if state.positions is None or state.params is None:
+        raise RuntimeError("3D hover registration requires resolved positions and parameters.")
     _register_3d_hover_labels(
         state.ax,
         state.figure,

{tensor_network_visualization-2.0.2 → tensor_network_visualization-2.0.3}/src/tensor_network_viz/_core/renderer.py

@@ -515,7 +515,8 @@ def _plot_graph(
         style,
         visible_tensor_count=count_visible_tensors(draw_graph),
     )
-    assert resolved_style.show_tensor_labels is not None
+    if resolved_style.show_tensor_labels is None:
+        raise RuntimeError("Auto display resolution did not resolve tensor-label visibility.")
     draw_positions = {
         node_id: geometry.positions[node_id]
         for node_id in draw_graph.nodes

{tensor_network_visualization-2.0.2 → tensor_network_visualization-2.0.3}/src/tensor_network_viz/_input_inspection.py

@@ -4,7 +4,7 @@ from collections.abc import Callable, Iterable
 from dataclasses import replace
 from functools import cache
 from itertools import tee
-from typing import Any
+from typing import Any, NoReturn
 
 from ._core.graph_utils import _is_unordered_collection
 from ._engine_specs import EngineName
@@ -108,7 +108,7 @@ def _is_grid_container(value: Any) -> bool:
     return isinstance(value, (list, tuple))
 
 
-def _raise_grid_error(message: str) -> None:
+def _raise_grid_error(message: str) -> NoReturn:
     raise VisualizationInputError(message)
 
 

{tensor_network_visualization-2.0.2 → tensor_network_visualization-2.0.3}/src/tensor_network_viz/_interaction/controller.py

@@ -389,7 +389,8 @@ class _InteractiveTensorFigureController:
     @property
     def current_scene(self) -> _InteractiveSceneState:
         scene = self._view_manager.current_scene(self.current_view)
-        assert scene is not None
+        if scene is None:
+            raise RuntimeError("Interactive scene is not available for the current view.")
         return scene
 
     @property
@@ -531,7 +532,8 @@ class _InteractiveTensorFigureController:
         )
 
     def _build_controls(self, scene: _InteractiveSceneState) -> None:
-        assert self.figure is not None
+        if self.figure is None:
+            raise RuntimeError("Interactive controls require an initialized figure.")
         self._controls_panel = _InteractiveControlsPanel(
             fig=self.figure,
             layout=self._controls_layout(scene),
@@ -547,7 +549,8 @@ class _InteractiveTensorFigureController:
         )
 
     def _ensure_focus_status_text(self) -> Text:
-        assert self.figure is not None
+        if self.figure is None:
+            raise RuntimeError("Focus status text requires an initialized figure.")
         if self._focus_status_text is None:
             self._focus_status_text = self.figure.text(
                 0.5,

{tensor_network_visualization-2.0.2 → tensor_network_visualization-2.0.3}/src/tensor_network_viz/_interaction/views.py

@@ -110,7 +110,8 @@ class _InteractiveViewManager:
 
     def rerender_cached_view(self, view: ViewName) -> _InteractiveSceneState:
         cache = self.view_caches[view]
-        assert cache.ax is not None
+        if cache.ax is None:
+            raise RuntimeError("Cached view cannot be re-rendered before its axes are built.")
         old_scene = cache.scene
         if old_scene is not None and old_scene.contraction_controls is not None:
             viewer = old_scene.contraction_controls._viewer
@@ -120,7 +121,8 @@ class _InteractiveViewManager:
                 viewer.hide_scheme_artists()
         fig, rendered_ax = self._render_view(view, cache.ax)
         scene = _scene_from_axes(rendered_ax)
-        assert scene is not None
+        if scene is None:
+            raise RuntimeError("Rendered axes did not expose an interactive scene.")
         cache.ax = rendered_ax
         cache.scene = scene
         scene.contraction_controls = get_contraction_controls(rendered_ax)

{tensor_network_visualization-2.0.2 → tensor_network_visualization-2.0.3}/src/tensor_network_viz/_tensor_elements_data.py

@@ -186,7 +186,8 @@ def _balanced_axes_for_shape(shape: tuple[int, ...]) -> tuple[int, ...]:
                 best_axes = candidate
                 best_score = score
                 best_rank_gap = rank_gap
-    assert best_axes is not None
+    if best_axes is None:
+        raise RuntimeError("Could not resolve a balanced tensor-axis split.")
     return best_axes
 
 
@@ -231,10 +232,12 @@ def _resolve_matrix_axes(
         return resolved_rows, resolved_cols
 
     if resolved_rows is None:
-        assert resolved_cols is not None
+        if resolved_cols is None:
+            raise RuntimeError("Column axes were not resolved.")
         resolved_rows = tuple(index for index in range(ndim) if index not in resolved_cols)
     if resolved_cols is None:
-        assert resolved_rows is not None
+        if resolved_rows is None:
+            raise RuntimeError("Row axes were not resolved.")
         resolved_cols = tuple(index for index in range(ndim) if index not in resolved_rows)
 
     if set(resolved_rows).intersection(resolved_cols):
@@ -405,7 +408,8 @@ def _resolve_tensor_analysis(
             fallback_index=0,
             fallback=fallback,
         )
-        assert slice_axis is not None
+        if slice_axis is None:
+            raise RuntimeError("Slice axis was not resolved for an active slice view.")
         slice_axis_name = original_axis_names[slice_axis]
         slice_axis_size = int(array.shape[slice_axis])
         requested_slice_index = (

{tensor_network_visualization-2.0.2 → tensor_network_visualization-2.0.3}/src/tensor_network_viz/_tensor_elements_rendering.py

@@ -278,7 +278,8 @@ def _render_panel(
         panel.main_ax.set_title(_panel_title(record, payload))
         return
 
-    assert isinstance(payload, _HeatmapPayload)
+    if not isinstance(payload, _HeatmapPayload):
+        raise TypeError(f"Unsupported tensor-elements payload: {type(payload).__name__!r}.")
     matrix = np.asarray(payload.matrix)
     metadata = payload.metadata
     style_key = payload.style_key

{tensor_network_visualization-2.0.2 → tensor_network_visualization-2.0.3}/src/tensor_network_viz/contraction_viewer.py

@@ -787,7 +787,8 @@ class ContractionViewer2D(_ContractionViewerBase):
         if fig is None:
             fig, ax_new = plt.subplots()
             ax = cast(Axes, ax_new)
-        assert ax is not None
+        if ax is None:
+            raise ValueError("ContractionViewer2D requires a 2D Axes when fig is provided.")
         if getattr(ax, "name", None) == "3d":
             raise TypeError("ContractionViewer2D requires a 2D Axes")
         super().__init__(
@@ -816,7 +817,8 @@ class ContractionViewer2D(_ContractionViewerBase):
         if fig is None:
             fig, ax_new = plt.subplots()
             ax = cast(Axes, ax_new)
-        assert ax is not None
+        if ax is None:
+            raise ValueError("ContractionViewer2D.from_rectangles requires a 2D Axes.")
         artists: list[Rectangle] = []
         for x, y, w, h in rectangles:
             r = Rectangle(
@@ -850,7 +852,8 @@ class ContractionViewer3D(_ContractionViewerBase):
         if fig is None:
             fig = plt.figure()
             ax = cast(Axes3D, fig.add_subplot(111, projection="3d"))
-        assert ax is not None
+        if ax is None:
+            raise ValueError("ContractionViewer3D requires Axes3D when fig is provided.")
         if not hasattr(ax, "zaxis"):
             raise TypeError("ContractionViewer3D requires Axes3D")
         super().__init__(
@@ -879,7 +882,8 @@ class ContractionViewer3D(_ContractionViewerBase):
         if fig is None:
             fig = plt.figure()
             ax = cast(Axes3D, fig.add_subplot(111, projection="3d"))
-        assert ax is not None
+        if ax is None:
+            raise ValueError("ContractionViewer3D.from_boxes requires Axes3D.")
         artists: list[Poly3DCollection] = []
         for mn, mx in boxes:
             mn = np.asarray(mn, dtype=float).ravel()[:3]

{tensor_network_visualization-2.0.2 → tensor_network_visualization-2.0.3}/tests/test_ci_workflow.py

@@ -22,7 +22,7 @@ def _parse_block_list_item(raw_value: str) -> str:
 
 
 def _load_workflow_text(text: str) -> dict[str, Any]:
-    workflow: dict[str, Any] = {"jobs": {}}
+    workflow: dict[str, Any] = {"jobs": {}, "permissions": {}}
     current_job_name: str | None = None
     current_step: dict[str, Any] | None = None
     current_matrix_key: str | None = None
@@ -48,6 +48,8 @@ def _load_workflow_text(text: str) -> dict[str, Any]:
             continue
 
         if current_job_name is None:
+            if indent == 2 and stripped.startswith("contents: "):
+                workflow["permissions"]["contents"] = stripped.split(": ", 1)[1].strip()
             continue
 
         if indent == 8 and stripped.startswith("os: "):
@@ -109,6 +111,10 @@ def _load_workflow() -> dict[str, Any]:
     return _load_workflow_text(Path(".github/workflows/ci.yml").read_text(encoding="utf-8"))
 
 
+def _workflow_text() -> str:
+    return Path(".github/workflows/ci.yml").read_text(encoding="utf-8")
+
+
 def _job_step_names(workflow: dict[str, Any], job_name: str) -> list[str]:
     return [step["name"] for step in workflow["jobs"][job_name]["steps"]]
 
@@ -153,8 +159,12 @@ jobs:
 
 def test_ci_workflow_declares_expected_jobs_and_runner_matrices() -> None:
     workflow = _load_workflow()
+    workflow_text = _workflow_text()
 
     assert set(workflow["jobs"]) == {"smoke-minimal", "wheel-smoke", "lint-and-test"}
+    assert workflow["permissions"]["contents"] == "read"
+    assert workflow_text.count("uses: actions/checkout@v6") == 3
+    assert workflow_text.count("uses: actions/setup-python@v6") == 3
     assert workflow["jobs"]["wheel-smoke"]["matrix"]["os"] == ["ubuntu-latest", "windows-latest"]
     assert workflow["jobs"]["wheel-smoke"]["matrix"]["python-version"] == ["3.12", "3.13"]
     assert workflow["jobs"]["lint-and-test"]["matrix"]["os"] == [
@@ -187,6 +197,9 @@ def test_ci_workflow_routes_core_checks_through_verify_script() -> None:
     assert _job_step(workflow, "lint-and-test", "Pytest")["run"] == (
         "python scripts/verify.py tests"
     )
+    assert _job_step(workflow, "lint-and-test", "Security")["run"] == (
+        "python scripts/verify.py security"
+    )
 
 
 def test_ci_workflow_keeps_minimal_and_packaging_smoke_guards() -> None:
@@ -196,7 +209,13 @@ def test_ci_workflow_keeps_minimal_and_packaging_smoke_guards() -> None:
     ]
 
     assert "python -m pip install -e . --no-deps" in minimal_install
-    for requirement in ("matplotlib==3.10.8", "networkx==3.6.1", "numpy==2.4.3", "quimb==1.13.0"):
+    for requirement in (
+        "matplotlib==3.10.9",
+        "networkx==3.6.1",
+        "numpy==2.4.5",
+        "pytest==9.0.3",
+        "quimb==1.14.0",
+    ):
         assert requirement in minimal_install
 
     wheel_step_names = _job_step_names(workflow, "wheel-smoke")
@@ -204,13 +223,21 @@ def test_ci_workflow_keeps_minimal_and_packaging_smoke_guards() -> None:
         "Install build tool",
         "Create wheel test venv",
         "Create sdist test venv",
+        "Install wheel (Linux)",
         "Install wheel (Windows)",
         "Smoke import and render (Windows)",
+        "Install sdist (Linux)",
         "Install sdist (Windows)",
         "Smoke sdist import and render (Windows)",
     ):
         assert step_name in wheel_step_names
 
+    wheel_linux_install = _job_step(workflow, "wheel-smoke", "Install wheel (Linux)")["run"]
+    assert ".tmp/package-dist/*.whl" in wheel_linux_install
+
+    wheel_windows_install = _job_step(workflow, "wheel-smoke", "Install wheel (Windows)")["run"]
+    assert "Get-ChildItem .tmp\\package-dist\\*.whl" in wheel_windows_install
+
     wheel_windows_smoke = _job_step(workflow, "wheel-smoke", "Smoke import and render (Windows)")[
         "run"
     ]
@@ -219,6 +246,12 @@ def test_ci_workflow_keeps_minimal_and_packaging_smoke_guards() -> None:
     assert "show_tensor_network(" in wheel_windows_smoke
     assert "engine='einsum'" in wheel_windows_smoke
 
+    sdist_linux_install = _job_step(workflow, "wheel-smoke", "Install sdist (Linux)")["run"]
+    assert ".tmp/package-dist/*.tar.gz" in sdist_linux_install
+
+    sdist_windows_install = _job_step(workflow, "wheel-smoke", "Install sdist (Windows)")["run"]
+    assert "Get-ChildItem .tmp\\package-dist\\*.tar.gz" in sdist_windows_install
+
     sdist_windows_smoke = _job_step(
         workflow,
         "wheel-smoke",

{tensor_network_visualization-2.0.2 → tensor_network_visualization-2.0.3}/tests/test_engineering_baseline.py

@@ -144,19 +144,22 @@ def test_dev_requirements_pin_verification_tools_and_use_editable_install() -> N
 
     assert "-e ." in lines
     assert {
-        "build==1.4.2",
-        "ipython==9.10.1",
-        "ipython==9.12.0",
-        "matplotlib==3.10.8",
+        "build==1.5.0",
+        "bandit==1.9.4",
+        "ipython==9.13.0",
+        "matplotlib==3.10.9",
         "networkx==3.6.1",
-        "numpy==2.4.3",
+        "numpy==2.4.5",
+        "pip-audit==2.10.0",
         "physics-tenpy==1.1.0",
-        "pyright==1.1.408",
-        "pytest==9.0.2",
-        "quimb==1.13.0",
-        "ruff==0.15.8",
+        "pyright==1.1.409",
+        "pytest==9.0.3",
+        "quimb==1.14.0",
+        "ruff==0.15.13",
+        "setuptools==81.0.0",
         "tensorkrowch==1.1.6",
         "tensornetwork==0.4.6",
+        "twine==6.2.0",
     }.issubset(set(lines))
 
 

tensor_network_visualization-2.0.3/tests/test_security_config.py

@@ -0,0 +1,31 @@
+from __future__ import annotations
+
+import ast
+from pathlib import Path
+
+
+def _python_source_files(root: Path) -> list[Path]:
+    return sorted(root.rglob("*.py"))
+
+
+def test_runtime_package_does_not_use_optimized_away_asserts() -> None:
+    assert_locations: list[str] = []
+    for path in _python_source_files(Path("src/tensor_network_viz")):
+        module = ast.parse(path.read_text(encoding="utf-8"))
+        for node in ast.walk(module):
+            if isinstance(node, ast.Assert):
+                assert_locations.append(f"{path}:{node.lineno}")
+
+    assert assert_locations == []
+
+
+def test_dependabot_updates_python_and_github_actions_manifests() -> None:
+    config_path = Path(".github/dependabot.yml")
+
+    text = config_path.read_text(encoding="utf-8")
+
+    assert 'package-ecosystem: "pip"' in text
+    assert 'package-ecosystem: "github-actions"' in text
+    assert 'directory: "/"' in text
+    assert 'interval: "weekly"' in text
+    assert 'timezone: "Europe/Madrid"' in text