science-synapse 2.7.2__tar.gz → 2.7.4__tar.gz

{science_synapse-2.7.2/science_synapse.egg-info → science_synapse-2.7.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: science-synapse
-Version: 2.7.2
+Version: 2.7.4
 Summary: Client library and CLI for the Synapse API
 Author: Science Team
 Author-email: team@science.xyz

{science_synapse-2.7.2 → science_synapse-2.7.4/science_synapse.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: science-synapse
-Version: 2.7.2
+Version: 2.7.4
 Summary: Client library and CLI for the Synapse API
 Author: Science Team
 Author-email: team@science.xyz

{science_synapse-2.7.2 → science_synapse-2.7.4}/science_synapse.egg-info/SOURCES.txt

@@ -52,6 +52,7 @@ synapse/cli/deploy_model.py
 synapse/cli/device_info_display.py
 synapse/cli/discover.py
 synapse/cli/files.py
+synapse/cli/gateware.py
 synapse/cli/offline_hdf5_plotter.py
 synapse/cli/offline_plot.py
 synapse/cli/peripherals.py
@@ -106,6 +107,14 @@ synapse/simulator/nodes/optical_stimulation.py
 synapse/simulator/nodes/spike_source.py
 synapse/tests/__init__.py
 synapse/tests/__init__.pyi
+synapse/tests/cli/__init__.py
+synapse/tests/cli/__init__.pyi
+synapse/tests/cli/conftest.py
+synapse/tests/cli/test_custom_gateware_packaging.py
+synapse/tests/cli/test_gateware_passthrough.py
+synapse/tests/cli/test_gateware_runner.py
+synapse/tests/cli/test_half_selectors.py
+synapse/tests/cli/test_license_mode.py
 synapse/tests/client/__init__.py
 synapse/tests/client/__init__.pyi
 synapse/tests/client/test_broadband_source.py

{science_synapse-2.7.2 → science_synapse-2.7.4}/setup.py

@@ -29,7 +29,7 @@ stamp_api_version()
 
 setup(
     name="science-synapse",
-    version="2.7.2",
+    version="2.7.4",
     description="Client library and CLI for the Synapse API",
     author="Science Team",
     author_email="team@science.xyz",

{science_synapse-2.7.2 → science_synapse-2.7.4}/synapse/_api_version.py

@@ -1,2 +1,2 @@
 # Generated from synapse-api/VERSION by setup.py. Do not edit.
-SYNAPSE_API_VERSION = "2.4.0"
+SYNAPSE_API_VERSION = "2.4.1"

science_synapse-2.7.4/synapse/api/query_pb2.py

@@ -0,0 +1,42 @@
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import runtime_version as _runtime_version
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+_runtime_version.ValidateProtobufRuntimeVersion(_runtime_version.Domain.PUBLIC, 5, 29, 0, '', 'api/query.proto')
+_sym_db = _symbol_database.Default()
+from ..api import channel_pb2 as api_dot_channel__pb2
+from ..api import status_pb2 as api_dot_status__pb2
+from ..api import tap_pb2 as api_dot_tap__pb2
+from ..api import device_pb2 as api_dot_device__pb2
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x0fapi/query.proto\x12\x07synapse\x1a\x11api/channel.proto\x1a\x10api/status.proto\x1a\rapi/tap.proto\x1a\x10api/device.proto"G\n\x0bSampleQuery\x12"\n\x08channels\x18\x01 \x03(\x0b2\x10.synapse.Channel\x12\x14\n\x0csample_count\x18\x02 \x01(\r">\n\x0eImpedanceQuery\x12\x15\n\relectrode_ids\x18\x01 \x03(\r\x12\x15\n\rperipheral_id\x18\x02 \x01(\r"&\n\rSelfTestQuery\x12\x15\n\rperipheral_id\x18\x01 \x01(\r"N\n\x14ImpedanceMeasurement\x12\x14\n\x0celectrode_id\x18\x01 \x01(\r\x12\x11\n\tmagnitude\x18\x02 \x01(\x02\x12\r\n\x05phase\x18\x03 \x01(\x02"H\n\x11ImpedanceResponse\x123\n\x0cmeasurements\x18\x01 \x03(\x0b2\x1d.synapse.ImpedanceMeasurement"Y\n\x0cSelfTestItem\x12\x11\n\ttest_name\x18\x01 \x01(\t\x12\x0e\n\x06passed\x18\x02 \x01(\x08\x12\x11\n\ttest_data\x18\x03 \x03(\r\x12\x13\n\x0btest_report\x18\x04 \x01(\t"L\n\x10SelfTestResponse\x12\x12\n\nall_passed\x18\x01 \x01(\x08\x12$\n\x05tests\x18\x02 \x03(\x0b2\x15.synapse.SelfTestItem"\xb2\x03\n\x0cQueryRequest\x123\n\nquery_type\x18\x01 \x01(\x0e2\x1f.synapse.QueryRequest.QueryType\x122\n\x0fimpedance_query\x18\x02 \x01(\x0b2\x17.synapse.ImpedanceQueryH\x00\x12,\n\x0csample_query\x18\x03 \x01(\x0b2\x14.synapse.SampleQueryH\x00\x121\n\x0fself_test_query\x18\x04 \x01(\x0b2\x16.synapse.SelfTestQueryH\x00\x121\n\x0flist_taps_query\x18\x05 \x01(\x0b2\x16.synapse.ListTapsQueryH\x00\x127\n\x12get_settings_query\x18\x06 \x01(\x0b2\x19.synapse.GetSettingsQueryH\x00"c\n\tQueryType\x12\t\n\x05kNone\x10\x00\x12\x0e\n\nkImpedance\x10\x01\x12\x0b\n\x07kSample\x10\x02\x12\r\n\tkSelfTest\x10\x03\x12\r\n\tkListTaps\x10\x04\x12\x10\n\x0ckGetSettings\x10\x05B\x07\n\x05query"<\n\x12StreamQueryRequest\x12&\n\x07request\x18\x01 \x01(\x0b2\x15.synapse.QueryRequest"\xb5\x02\n\rQueryResponse\x12\x1f\n\x06status\x18\x01 \x01(\x0b2\x0f.synapse.Status\x12\x0c\n\x04data\x18\x02 \x03(\r\x128\n\x12impedance_response\x18\x03 \x01(\x0b2\x1a.synapse.ImpedanceResponseH\x00\x127\n\x12self_test_response\x18\x04 \x01(\x0b2\x19.synapse.SelfTestResponseH\x00\x127\n\x12list_taps_response\x18\x05 \x01(\x0b2\x19.synapse.ListTapsResponseH\x00\x12=\n\x15get_settings_response\x18\x06 \x01(\x0b2\x1c.synapse.GetSettingsResponseH\x00B\n\n\x08response"\xcc\x01\n\x13StreamQueryResponse\x12!\n\x04code\x18\x01 \x01(\x0e2\x13.synapse.StatusCode\x12\x0f\n\x07message\x18\x02 \x01(\t\x12\x14\n\x0ctimestamp_ns\x18\x03 \x01(\x04\x12/\n\timpedance\x18\x04 \x01(\x0b2\x1a.synapse.ImpedanceResponseH\x00\x12.\n\tself_test\x18\x05 \x01(\x0b2\x19.synapse.SelfTestResponseH\x00B\n\n\x08responseb\x06proto3')
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'api.query_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+    DESCRIPTOR._loaded_options = None
+    _globals['_SAMPLEQUERY']._serialized_start = 98
+    _globals['_SAMPLEQUERY']._serialized_end = 169
+    _globals['_IMPEDANCEQUERY']._serialized_start = 171
+    _globals['_IMPEDANCEQUERY']._serialized_end = 233
+    _globals['_SELFTESTQUERY']._serialized_start = 235
+    _globals['_SELFTESTQUERY']._serialized_end = 273
+    _globals['_IMPEDANCEMEASUREMENT']._serialized_start = 275
+    _globals['_IMPEDANCEMEASUREMENT']._serialized_end = 353
+    _globals['_IMPEDANCERESPONSE']._serialized_start = 355
+    _globals['_IMPEDANCERESPONSE']._serialized_end = 427
+    _globals['_SELFTESTITEM']._serialized_start = 429
+    _globals['_SELFTESTITEM']._serialized_end = 518
+    _globals['_SELFTESTRESPONSE']._serialized_start = 520
+    _globals['_SELFTESTRESPONSE']._serialized_end = 596
+    _globals['_QUERYREQUEST']._serialized_start = 599
+    _globals['_QUERYREQUEST']._serialized_end = 1033
+    _globals['_QUERYREQUEST_QUERYTYPE']._serialized_start = 925
+    _globals['_QUERYREQUEST_QUERYTYPE']._serialized_end = 1024
+    _globals['_STREAMQUERYREQUEST']._serialized_start = 1035
+    _globals['_STREAMQUERYREQUEST']._serialized_end = 1095
+    _globals['_QUERYRESPONSE']._serialized_start = 1098
+    _globals['_QUERYRESPONSE']._serialized_end = 1407
+    _globals['_STREAMQUERYRESPONSE']._serialized_start = 1410
+    _globals['_STREAMQUERYRESPONSE']._serialized_end = 1614

{science_synapse-2.7.2 → science_synapse-2.7.4}/synapse/cli/__main__.py

@@ -83,7 +83,7 @@ def main():
     peripherals.add_commands(subparsers)
     settings.add_commands(subparsers)
     deploy_model.add_commands(subparsers)
-    args = parser.parse_args()
+    args = peripherals.parse_args_with_passthrough(parser)
 
     # If we need to setup the device URI, do that now
     args = setup_device_uri(args)

{science_synapse-2.7.2 → science_synapse-2.7.4}/synapse/cli/build.py

@@ -3,10 +3,11 @@ from __future__ import annotations
 import glob
 import json
 import os
+import re
 import shutil
 import subprocess
 import tempfile
-from typing import Any
+from typing import Any, Literal
 
 from rich import box
 from rich.console import Console
@@ -15,7 +16,7 @@ from rich.panel import Panel
 console = Console()
 
 
-def validate_manifest(manifest_path: str) -> dict[str, Any] | bool:
+def validate_manifest(manifest_path: str) -> dict[str, Any] | Literal[False]:
     """Return the parsed ``manifest.json`` dictionary or ``False`` on error."""
 
     try:
@@ -71,42 +72,137 @@ def ensure_docker() -> bool:
         return False
 
 
-def build_docker_image(app_dir: str, app_name: str | None = None) -> str:
-    """(Re)build the cross-compile SDK Docker image and return its tag."""
+_ARG_HOST_UID_RE = re.compile(r"^ARG HOST_UID\b", re.MULTILINE)
+
+
+def _resolve_host_uid() -> int:
+    """Return the invoking user's UID, falling back to 1000 on non-POSIX hosts."""
+    try:
+        return os.getuid()
+    except AttributeError:
+        console.print(
+            "[yellow]Warning:[/yellow] os.getuid() unavailable on this host; "
+            "falling back to HOST_UID=1000."
+        )
+        return 1000
+
+
+def _dockerfile_needs_host_uid(dockerfile_path: str) -> bool:
+    """Return True iff *dockerfile_path* declares ``ARG HOST_UID`` at line start."""
+    with open(dockerfile_path, "r", encoding="utf-8") as fp:
+        return bool(_ARG_HOST_UID_RE.search(fp.read()))
+
+
+def build_docker_image(
+    app_dir: str,
+    app_name: str | None = None,
+    roles: list[str] | None = None,
+) -> dict[str, str]:
+    """(Re)build the cross-compile SDK Docker image(s) and return role -> tag.
+
+    Discovers every ``*.Dockerfile`` directly under ``<app_dir>/Dockerfiles/``
+    and builds each as ``<app_name>-<role>:latest-<arch>`` where ``role`` is
+    the filename stem (e.g. ``gateware.Dockerfile`` -> ``gateware``). Returns
+    a dict mapping role -> image tag.
+
+    Back-compat: if ``<app_dir>/Dockerfiles/`` does not exist and
+    ``<app_dir>/Dockerfile`` does, builds the single legacy image tagged
+    ``<app_name>:latest-<arch>`` (no role suffix) and returns
+    ``{"driver": "<that tag>"}``.
+
+    If ``Dockerfiles/`` exists but is empty, or if neither path exists,
+    raises :class:`FileNotFoundError`.
+
+    For each Dockerfile whose contents contain a line matching
+    ``^ARG HOST_UID\\b`` the build additionally receives
+    ``--build-arg HOST_UID=<os.getuid()>``. On non-POSIX hosts (where
+    ``os.getuid()`` is unavailable) the value falls back to ``1000``.
+
+    Args:
+        app_dir, app_name: as before.
+        roles: when provided, restricts the build to Dockerfiles whose role
+            (filename stem) is in this list. If a requested role is not found
+            on disk, raises FileNotFoundError. When None (default), builds
+            every discovered Dockerfile. The back-compat legacy single-
+            ``./Dockerfile`` path is treated as role "driver"; pass
+            ``roles=["driver"]`` (or None) to consume it; passing
+            ``roles=["gateware"]`` against a legacy repo with no
+            ``Dockerfiles/`` raises FileNotFoundError.
+    """
 
     if app_name is None:
         app_name = os.path.basename(app_dir)
 
     arch_suffix = detect_arch()  # "arm64" or "amd64"
 
-    # Look for a Dockerfile at the top level of the app directory
-    dockerfile_path = os.path.join(app_dir, "Dockerfile")
-
-    if not os.path.exists(dockerfile_path):
+    dockerfiles_dir = os.path.join(app_dir, "Dockerfiles")
+    legacy_dockerfile = os.path.join(app_dir, "Dockerfile")
+
+    # Discovery: Dockerfiles/ wins over the legacy root ./Dockerfile.
+    discovered: list[tuple[str, str]] = []
+    is_legacy = False
+    if os.path.isdir(dockerfiles_dir):
+        for entry in sorted(os.listdir(dockerfiles_dir)):
+            if entry.endswith(".Dockerfile"):
+                role = entry[: -len(".Dockerfile")]
+                discovered.append((role, os.path.join(dockerfiles_dir, entry)))
+    elif os.path.exists(legacy_dockerfile):
+        discovered.append(("driver", legacy_dockerfile))
+        is_legacy = True
+
+    if not discovered:
         raise FileNotFoundError(
-            f"Expected Dockerfile not found at {dockerfile_path}. "
-            "Ensure your application provides the required Dockerfile."
+            f"Expected Dockerfile not found at {legacy_dockerfile} or any "
+            f"*.Dockerfile under {dockerfiles_dir}. Ensure your application "
+            "provides the required Dockerfile."
         )
 
-    image_tag = f"{app_name}:latest-{arch_suffix}"
+    if roles is not None:
+        requested = set(roles)
+        available = {role for role, _ in discovered}
+        missing = requested - available
+        if missing:
+            raise FileNotFoundError(
+                f"Requested roles {sorted(missing)} not found in {dockerfiles_dir}. "
+                f"Available roles: {sorted(available)}."
+            )
+        discovered = [(role, path) for role, path in discovered if role in requested]
+
+    tags: dict[str, str] = {}
+    for role, dockerfile_path in discovered:
+        image_tag = (
+            f"{app_name}:latest-{arch_suffix}"
+            if is_legacy
+            else f"{app_name}-{role}:latest-{arch_suffix}"
+        )
 
-    console.print(f"[yellow]Building Docker image [bold]{image_tag}[/bold]...[/yellow]")
-    subprocess.run(
-        [
-            "docker",
-            "build",
-            "-t",
-            image_tag,
-            "-f",
-            dockerfile_path,
-            ".",
-        ],
-        check=True,
-        cwd=app_dir,
-    )
+        build_args: list[str] = []
+        if _dockerfile_needs_host_uid(dockerfile_path):
+            host_uid = _resolve_host_uid()
+            build_args.extend(["--build-arg", f"HOST_UID={host_uid}"])
 
-    console.print(f"[green]Successfully built Docker image {image_tag}[/green]")
-    return image_tag
+        console.print(
+            f"[yellow]Building Docker image [bold]{image_tag}[/bold]...[/yellow]"
+        )
+        subprocess.run(
+            [
+                "docker",
+                "build",
+                "-t",
+                image_tag,
+                "-f",
+                dockerfile_path,
+                *build_args,
+                ".",
+            ],
+            check=True,
+            cwd=app_dir,
+        )
+
+        console.print(f"[green]Successfully built Docker image {image_tag}[/green]")
+        tags[role] = image_tag
+
+    return tags
 
 
 def build_app(
@@ -127,12 +223,9 @@ def build_app(
 
     console.print("[yellow]Binary not found, attempting to build...[/yellow]")
 
-    arch_suffix = detect_arch()
-    image_tag = f"{os.path.basename(app_dir)}:latest-{arch_suffix}"
-
     # Build (or rebuild) the Docker image – this function is idempotent.
     try:
-        image_tag = build_docker_image(app_dir, app_name)
+        image_tag = build_docker_image(app_dir, app_name)["driver"]
     except (subprocess.CalledProcessError, FileNotFoundError) as exc:
         console.print(
             f"[bold red]Error:[/bold red] Failed to build Docker image: {exc}"
@@ -317,10 +410,14 @@ WantedBy=multi-user.target
 
         lifecycle_scripts_tmp: list[str] = []
 
+        # 0o644 suffices for all three: fpm embeds each file's *contents* as a
+        # .deb maintainer script (--after-install / --before-remove /
+        # --after-remove below), and dpkg makes maintainer scripts executable
+        # itself at install time. The staging files' exec bits never ship.
         postinstall_path = os.path.join(staging_dir, "postinstall.sh")
         with open(postinstall_path, "w", encoding="utf-8") as fp:
             fp.write("#!/bin/bash\nset -e\nsystemctl daemon-reload\n")
-        os.chmod(postinstall_path, 0o755)
+        os.chmod(postinstall_path, 0o644)
         lifecycle_scripts_tmp.append(postinstall_path)
 
         preremove_path = os.path.join(staging_dir, "preremove.sh")
@@ -328,13 +425,13 @@ WantedBy=multi-user.target
             fp.write(
                 f"#!/bin/bash\nset -e\nsystemctl stop {app_name} || true\nsystemctl disable {app_name} || true\n"
             )
-        os.chmod(preremove_path, 0o755)
+        os.chmod(preremove_path, 0o644)
         lifecycle_scripts_tmp.append(preremove_path)
 
         postremove_path = os.path.join(staging_dir, "postremove.sh")
         with open(postremove_path, "w", encoding="utf-8") as fp:
             fp.write("#!/bin/bash\nset -e\nsystemctl daemon-reload\n")
-        os.chmod(postremove_path, 0o755)
+        os.chmod(postremove_path, 0o644)
         lifecycle_scripts_tmp.append(postremove_path)
 
         lib_dst_dir = os.path.join(staging_dir, "opt", "scifi", "lib")
@@ -538,15 +635,22 @@ def package_app(app_dir: str, app_name: str) -> bool:
     return build_deb_package(app_dir, app_name)
 
 
-def find_deb_package(dist_dir: str) -> str | None:
-    """Return the path to the .deb generated in *app_dir* or *None*."""
-    for file in os.listdir(dist_dir):
-        if file.endswith(".deb"):
-            return os.path.join(dist_dir, file)
+def find_deb_package(dist_dir: str, package_name: str | None = None) -> str | None:
+    """Return the path to a .deb generated in *dist_dir* or ``None``.
 
-    console.print(
-        f"[bold red]Error:[/bold red] Could not find .deb package in {dist_dir}"
-    )
+    With *package_name*, only ``<package_name>_*.deb`` matches — a peripheral
+    dist/ holds both the driver and the ``-gateware`` deb, and the driver name
+    is a strict prefix of the gateware name.
+    """
+    for file in sorted(os.listdir(dist_dir)):
+        if not file.endswith(".deb"):
+            continue
+        if package_name is not None and not file.startswith(f"{package_name}_"):
+            continue
+        return os.path.join(dist_dir, file)
+
+    wanted = f"{package_name} .deb package" if package_name else ".deb package"
+    console.print(f"[bold red]Error:[/bold red] Could not find {wanted} in {dist_dir}")
     return None
 
 

{science_synapse-2.7.2 → science_synapse-2.7.4}/synapse/cli/deploy.py

@@ -71,7 +71,13 @@ def create_metadata(file_path, console):
 
 
 def deploy_package(ip_address, deb_package_path):
-    """Deploy the package to the device"""
+    """Deploy a .deb package to the device via gRPC DeployApp streaming.
+
+    Returns True when the package was streamed and all device responses were
+    received without error; False on any failure (connection, gRPC, or I/O).
+    Callers can use the return value to decide whether to continue with
+    subsequent packages.
+    """
     package_filename = os.path.basename(deb_package_path)
     console.clear_live()
 
@@ -178,6 +184,7 @@ def deploy_package(ip_address, deb_package_path):
                 response_panel.renderable = Group(*display_items)
                 response_panel.border_style = "red"
                 live.refresh()
+                return False
 
         except Exception as e:
             # For the outer exception, also preserve any progress made
@@ -195,6 +202,9 @@ def deploy_package(ip_address, deb_package_path):
             response_panel.renderable = Group(*display_items)
             response_panel.border_style = "red"
             live.refresh()
+            return False
+
+    return True
 
 
 def deploy_cmd(args):