arrayview 0.31.3__tar.gz → 0.33.0__tar.gz

{arrayview-0.31.3 → arrayview-0.33.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: arrayview
-Version: 0.31.3
+Version: 0.33.0
 Summary: Fast multi-dimensional array viewer
 Project-URL: Home, https://github.com/oscarvanderheide/arrayview
 Project-URL: Source, https://github.com/oscarvanderheide/arrayview
@@ -21,6 +21,7 @@ Requires-Dist: matplotlib>=3.9.0
 Requires-Dist: nibabel>=5.3.3
 Requires-Dist: numpy>=2.4.2
 Requires-Dist: pillow>=12.1.1
+Requires-Dist: pydicom>=3.0
 Requires-Dist: pyqt5>=5.15; sys_platform == 'linux'
 Requires-Dist: pyqtwebengine>=5.15; sys_platform == 'linux'
 Requires-Dist: python-multipart>=0.0.22
@@ -49,9 +50,14 @@ It is meant to feel simple but there's more to it than meets the eye.
 Curious? Give it a try with
 ```bash
 uvx arrayview your_array.npy
+uvx arrayview path/to/dicom-series/
 ```
 
+Press `v` for the three-plane ortho view. `Shift+3` replaces the current slice,
+or all three ortho panes, with interactive 3D cutaway renders.
+Drop another file onto an open viewer to compare, open separately, or overlay it.
+
 
 Check the [docs](https://oscarvanderheide.github.io/arrayview/) to learn more. 
 
-**Warning**: Arrayview is still under active development. Things may break or change without warning.
+**Warning**: Arrayview is still under active development. Things may break or change without warning.

{arrayview-0.31.3 → arrayview-0.33.0}/README.md

@@ -13,9 +13,14 @@ It is meant to feel simple but there's more to it than meets the eye.
 Curious? Give it a try with
 ```bash
 uvx arrayview your_array.npy
+uvx arrayview path/to/dicom-series/
 ```
 
+Press `v` for the three-plane ortho view. `Shift+3` replaces the current slice,
+or all three ortho panes, with interactive 3D cutaway renders.
+Drop another file onto an open viewer to compare, open separately, or overlay it.
+
 
 Check the [docs](https://oscarvanderheide.github.io/arrayview/) to learn more. 
 
-**Warning**: Arrayview is still under active development. Things may break or change without warning.
+**Warning**: Arrayview is still under active development. Things may break or change without warning.

{arrayview-0.31.3 → arrayview-0.33.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "arrayview"
-version = "0.31.3"
+version = "0.33.0"
 description = "Fast multi-dimensional array viewer"
 readme = { file = "README.md", content-type = "text/markdown" }
 requires-python = ">=3.12"
@@ -27,6 +27,7 @@ dependencies = [
     "nibabel>=5.3.3",
     "numpy>=2.4.2",
     "pillow>=12.1.1",
+    "pydicom>=3.0",
     "pywebview>=6.1",
     "PyQt5>=5.15; sys_platform == 'linux'",
     "PyQtWebEngine>=5.15; sys_platform == 'linux'",
@@ -47,6 +48,9 @@ arrayview-codex = "arrayview._codex_open:main"
 [tool.hatch.build.targets.wheel]
 packages = ["src/arrayview"]
 
+[tool.hatch.build.targets.sdist]
+only-include = ["src/arrayview", "tests"]
+
 [tool.uv.sources]
 qmricolors = { git = "https://github.com/oscarvanderheide/qmricolors.git" }
 

{arrayview-0.31.3 → arrayview-0.33.0}/src/arrayview/__init__.py

@@ -7,14 +7,12 @@ __all__ = [
     "arrayview",
     "view",
     "view_batch",
-    "view_dir",
-    "view_dir_patterns",
     "zarr_chunk_preset",
 ]
 
 
 def __getattr__(name: str):
-    if name in {"arrayview", "view", "view_dir", "view_dir_patterns", "ViewHandle"}:
+    if name in {"arrayview", "view", "ViewHandle"}:
         from arrayview import _launcher
 
         return getattr(_launcher, name)

{arrayview-0.31.3 → arrayview-0.33.0}/src/arrayview/_app.py

@@ -128,7 +128,6 @@ from arrayview._vscode import (  # noqa: F401
     _ensure_vscode_extension,
     _configure_vscode_port_preview,
     _open_via_signal_file,
-    _schedule_remote_open_retries,
     _write_vscode_signal,
     _print_viewer_location,
     _open_browser,

arrayview-0.33.0/src/arrayview/_codex_open.py

@@ -0,0 +1,137 @@
+"""Codex-app helper for safely loading one file into ArrayView.
+
+Usage:
+    uv run arrayview-codex path/to/file.nii
+"""
+
+from __future__ import annotations
+
+import argparse
+import os
+import subprocess
+import sys
+import uuid
+
+from arrayview._instance_registry import InstanceRegistry
+from arrayview._launch_plan import (
+    Invocation,
+    LaunchIntent,
+    Registration,
+    create_launch_context,
+)
+from arrayview._launcher import (
+    _find_server_port,
+    _load_session_from_filepath,
+    _port_in_use,
+    _revalidate_launch_server,
+    _server_alive,
+    _server_pid,
+    _wait_for_port,
+)
+
+
+def _start_loaded_server(
+    filepath: str, port: int, sid: str, name: str
+) -> subprocess.Popen[bytes]:
+    script = (
+        "from arrayview._launcher import _serve_daemon; "
+        f"_serve_daemon({filepath!r}, {port}, {sid!r}, name={name!r}, persist=True)"
+    )
+    proc = subprocess.Popen(
+        [sys.executable, "-c", script],
+        stdin=subprocess.DEVNULL,
+        stdout=subprocess.DEVNULL,
+        stderr=subprocess.DEVNULL,
+        start_new_session=True,
+    )
+    if not _wait_for_port(port, timeout=15.0, tcp_only=True):
+        if proc.poll() is None:
+            proc.terminate()
+        raise RuntimeError(f"ArrayView server failed to start on port {port}")
+    if not _server_alive(port, timeout=2.0):
+        if proc.poll() is None:
+            proc.terminate()
+        raise RuntimeError(f"ArrayView server on port {port} did not become healthy")
+    actual_pid = _server_pid(port)
+    if actual_pid != proc.pid:
+        if proc.poll() is None:
+            proc.terminate()
+        raise RuntimeError(
+            f"Port {port} was claimed by another process while ArrayView was starting"
+        )
+    return proc
+
+
+def _open_codex_file(filepath: str, requested_port: int) -> str:
+    context = create_launch_context(
+        LaunchIntent(
+            Invocation.CODEX,
+            requested_port,
+            requested_window="browser",
+            persistent=True,
+        )
+    )
+    if not context.plan.ok:
+        raise ValueError(f"Invalid launch request: {context.plan.failure.value}")
+
+    name = os.path.basename(filepath)
+    expected_server_id = None
+    with InstanceRegistry().startup_lock(timeout=20.0):
+        port = context.plan.effective_port
+        already_running = context.plan.registration is Registration.HTTP_LOAD
+        if already_running:
+            port = _revalidate_launch_server(context, port)
+            expected_server_id = context.evidence.server.server_instance_id
+        else:
+            if _port_in_use(port):
+                port, appeared_running = _find_server_port(port + 1)
+                if appeared_running or _port_in_use(port):
+                    raise RuntimeError("Could not find a free port for ArrayView")
+            if not 1 <= port <= 65535 or _port_in_use(port):
+                raise RuntimeError("Could not find a free port for ArrayView")
+            sid = uuid.uuid4().hex
+            _start_loaded_server(filepath, port, sid, name)
+
+    if already_running:
+        result = _load_session_from_filepath(
+            port,
+            filepath,
+            name,
+            expected_server_id=expected_server_id,
+            release_on_disconnect=True,
+        )
+        if "error" in result:
+            raise RuntimeError(f"ArrayView server rejected the file: {result['error']}")
+        sid = str(result["sid"])
+
+    return f"http://localhost:{port}/?sid={sid}"
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(
+        prog="arrayview-codex",
+        description=(
+            "Load one file into a compatible ArrayView server, starting one on "
+            "a free port when needed, and print the Codex app browser URL."
+        ),
+    )
+    parser.add_argument("file", help="Array file to load")
+    parser.add_argument("--port", type=int, default=8000, help="Preferred port")
+    args = parser.parse_args()
+
+    filepath = os.path.abspath(args.file)
+    if not os.path.isfile(filepath):
+        print(f"Error: file not found: {filepath}", file=sys.stderr)
+        return 1
+
+    try:
+        url = _open_codex_file(filepath, args.port)
+    except (OSError, RuntimeError, TimeoutError, ValueError) as exc:
+        print(f"Error: {exc}", file=sys.stderr)
+        return 1
+    print(url)
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

{arrayview-0.31.3 → arrayview-0.33.0}/src/arrayview/_config.py

@@ -6,7 +6,7 @@ import os
 
 CONFIG_PATH = os.path.expanduser("~/.arrayview/config.toml")
 
-_VALID_WINDOW_MODES = {"browser", "vscode", "native", "inline"}
+_VALID_WINDOW_MODES = {"browser", "vscode", "native", "inline", "none"}
 _VALID_ENV_KEYS = {"default", "terminal", "vscode", "jupyter", "ssh", "julia"}