naja-schematic 0.1.0__py3-none-any.whl

naja_schematic/__init__.py

@@ -0,0 +1,21 @@
+"""naja-schematic: interactive schematic viewer for najaeda netlists.
+
+- In a notebook (Jupyter, Colab, VSCode): ``naja_schematic.show()`` displays
+  the design currently loaded with najaeda.
+- From a shell: ``naja-schematic --verilog design.v --open`` serves the
+  viewer page and opens it in a browser.
+"""
+__version__ = "0.1.0"
+
+from .protocol import diagnosis_response, handle_request
+
+
+def show(height=600, diagnosis=None):
+    """Display a view of the loaded design in the current notebook; see
+    naja_schematic.widget.show()."""
+    # Imported lazily: the CLI/server path doesn't need anywidget/IPython.
+    from .widget import show as _show
+    return _show(height=height, diagnosis=diagnosis)
+
+
+__all__ = ["__version__", "show", "handle_request", "diagnosis_response"]

naja_schematic/__main__.py

@@ -0,0 +1,3 @@
+from .server import main
+
+main()

naja_schematic/_bundle.py

@@ -0,0 +1,31 @@
+"""Locating the viewer files shipped in static/.
+
+naja-schematic.js is the WASM viewer built as a single-file, modularized
+Emscripten bundle (-DNAJA_SCHEMATIC_WASM_MODULE=ON); release wheels carry it
+in static/, but it is a build product and not checked in. For a development
+checkout, point NAJA_SCHEMATIC_BUNDLE at a locally built one instead.
+"""
+import os
+from pathlib import Path
+
+STATIC_DIR = Path(__file__).parent / "static"
+BUNDLE_NAME = "naja-schematic.js"
+
+# The only files the HTTP server hands out (no path traversal to worry about).
+_SERVED = {"index.html", BUNDLE_NAME}
+
+
+def bundle_path():
+    """Path of the viewer bundle, or None if this install has none."""
+    override = os.environ.get("NAJA_SCHEMATIC_BUNDLE")
+    path = Path(override) if override else STATIC_DIR / BUNDLE_NAME
+    return path if path.is_file() else None
+
+
+def static_file(name):
+    if name not in _SERVED:
+        return None
+    if name == BUNDLE_NAME:
+        return bundle_path()
+    path = STATIC_DIR / name
+    return path if path.is_file() else None