arcsecond 3.20.1__tar.gz → 4.0.0__tar.gz

arcsecond-4.0.0/.gitattributes

@@ -0,0 +1,6 @@
+# The packaged compose template is compared byte for byte with what an
+# installation holds; a CRLF checkout on Windows would make every file look
+# customised. Markdown and YAML stay LF everywhere.
+*.yml text eol=lf
+*.yaml text eol=lf
+*.md text eol=lf

{arcsecond-3.20.1 → arcsecond-4.0.0}/.github/workflows/tests.yml

@@ -40,6 +40,28 @@ jobs:
           name: coverage
           path: coverage.xml
 
+  # The CLI's operators run it on Windows — the observatory PC — and until
+  # now nothing here ever executed it there. No Docker on this runner; this
+  # covers the pure-Python paths: path handling, the console, the registry
+  # backend of the proxy's login item, and every Windows branch in the suite.
+  tests-windows:
+    runs-on: windows-latest
+
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          python-version: '3.12'
+          enable-cache: true
+
+      - name: Install dependencies
+        run: uv sync --extra webcam --group dev
+
+      - name: Test
+        run: uv run pytest -q tests/
+
   scan:
     runs-on: ubuntu-latest
     needs: tests

{arcsecond-3.20.1 → arcsecond-4.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: arcsecond
-Version: 3.20.1
+Version: 4.0.0
 Summary: CLI for arcsecond.io
 Project-URL: Homepage, https://github.com/arcsecond-io/cli
 Project-URL: Issues, https://github.com/arcsecond-io/cli/issues
@@ -40,12 +40,8 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.12
 Requires-Dist: alpyca==3.1.2
 Requires-Dist: click>=8
-Requires-Dist: configparser
-Requires-Dist: docker
 Requires-Dist: httpx
-Requires-Dist: py-machineid
 Requires-Dist: tqdm<5.0.0,>=4.67.1
-Requires-Dist: wait-for-it
 Provides-Extra: webcam
 Requires-Dist: aiohttp>=3.9; extra == 'webcam'
 Requires-Dist: opencv-python-headless<5,>=4.10; extra == 'webcam'
@@ -62,6 +58,39 @@ public and private ones.
 
 [Read the docs](https://docs.arcsecond.io/cli)
 
+## Running Arcsecond.local
+
+The CLI owns the whole lifecycle of a self-hosted installation; there is no
+`docker` command to type:
+
+```bash
+$ arcsecond setup --lan-host 192.168.1.42   # writes .env and docker-compose.yml
+$ arcsecond start                           # first run downloads the images
+$ arcsecond status
+$ arcsecond logs backend -f
+$ arcsecond restart backend worker          # after editing .env
+$ arcsecond update                          # newer images, refreshed compose file
+$ arcsecond stop
+```
+
+Every one of these finds the installation in the current folder, or in the
+folder `arcsecond setup` last ran in, or where `--dir` points.
+
+## Which server the CLI talks to
+
+The CLI points at one API server at a time — the cloud by default, or a
+server you registered, typically your own Arcsecond.local — and every command
+follows that pointer:
+
+```bash
+$ arcsecond api                     # list them, * marks the current one
+$ arcsecond api use local           # `setup` registered `local` for you
+$ arcsecond login                   # on that server
+```
+
+Credentials are kept per server. For a script or a cron job, `ARCSECOND_API=<name>`
+selects a server for that process alone, without moving the pointer.
+
 ## Configuration
 
 Credentials and settings live in `~/.config/arcsecond/`, alongside the list of

{arcsecond-3.20.1 → arcsecond-4.0.0}/README.md

@@ -9,6 +9,39 @@ public and private ones.
 
 [Read the docs](https://docs.arcsecond.io/cli)
 
+## Running Arcsecond.local
+
+The CLI owns the whole lifecycle of a self-hosted installation; there is no
+`docker` command to type:
+
+```bash
+$ arcsecond setup --lan-host 192.168.1.42   # writes .env and docker-compose.yml
+$ arcsecond start                           # first run downloads the images
+$ arcsecond status
+$ arcsecond logs backend -f
+$ arcsecond restart backend worker          # after editing .env
+$ arcsecond update                          # newer images, refreshed compose file
+$ arcsecond stop
+```
+
+Every one of these finds the installation in the current folder, or in the
+folder `arcsecond setup` last ran in, or where `--dir` points.
+
+## Which server the CLI talks to
+
+The CLI points at one API server at a time — the cloud by default, or a
+server you registered, typically your own Arcsecond.local — and every command
+follows that pointer:
+
+```bash
+$ arcsecond api                     # list them, * marks the current one
+$ arcsecond api use local           # `setup` registered `local` for you
+$ arcsecond login                   # on that server
+```
+
+Credentials are kept per server. For a script or a cron job, `ARCSECOND_API=<name>`
+selects a server for that process alone, without moving the pointer.
+
 ## Configuration
 
 Credentials and settings live in `~/.config/arcsecond/`, alongside the list of

{arcsecond-3.20.1 → arcsecond-4.0.0}/arcsecond/alpaca/commands.py

@@ -1,14 +1,14 @@
 """
 Click command group: ``arcsecond alpaca``.
 
-First citizen: ``arcsecond alpaca probe dome`` — a read-only diagnostic that
-captures what surface a given Alpaca dome server exposes (device metadata,
-``SupportedActions``, ``CommandString`` / ``CommandBool`` / ``CommandBlind``
-passthrough behaviour, and local host hints when the target is this machine).
-
-Structure leaves room for ``arcsecond alpaca probe telescope`` /
-``probe camera`` / ``probe focuser`` and ``arcsecond alpaca discover`` later
-under the same group.
+``arcsecond alpaca probe dome`` and ``arcsecond alpaca probe telescope`` are
+read-only diagnostics that capture what surface a given Alpaca device server
+exposes (device metadata, ``SupportedActions``, ``CommandString`` /
+``CommandBool`` / ``CommandBlind`` passthrough behaviour, and local host hints
+when the target is this machine), one JSON report per run.
+
+Structure leaves room for ``probe camera`` / ``probe focuser`` and
+``arcsecond alpaca discover`` later under the same group.
 """
 
 from __future__ import annotations
@@ -17,11 +17,14 @@ import json
 import os
 from datetime import datetime, timezone
 from pathlib import Path
+from typing import Callable
 
 import click
 
 from ..errors import ArcsecondError
-from .dome_probe import HOST_HINTS_REASON_LOCAL, ProbeProgress, probe_dome
+from .dome_probe import probe_dome
+from .probe import HOST_HINTS_REASON_LOCAL, ProbeProgress, ProbeResult
+from .telescope_probe import probe_telescope
 
 
 @click.group(name="alpaca", help="Diagnostics for local ASCOM Alpaca devices.")
@@ -122,20 +125,10 @@ def _format_progress(label: str, ok: bool, detail: str | None) -> str:
     return f"  {tag} {label}{suffix}"
 
 
-@probe_group.command(
-    name="dome",
-    help=(
-        "Probe a local Alpaca dome device read-only and write a JSON report.\n\n"
-        "Captures device metadata, SupportedActions, and the behaviour of the "
-        "legacy CommandString / CommandBool / CommandBlind passthroughs. "
-        "Useful for figuring out whether a proprietary driver (e.g. TCSGalil) "
-        "exposes any vendor-specific extension surface beyond the standard "
-        "ASCOM IDome interface. Local host hints (open ports, COM ProgIDs) "
-        "are added when HOST is this machine."
-    ),
-)
-@_add_options(_COMMON_OPTIONS)
-def probe_dome_cmd(
+def _run_probe(
+    kind: str,
+    runner: Callable[..., ProbeResult],
+    *,
     host: str,
     port: int,
     device_number: int,
@@ -144,10 +137,11 @@ def probe_dome_cmd(
     collect_host_info: bool | None,
     output_path: str | None,
 ) -> None:
-    output_path = output_path or _default_output_path("dome")
+    """Drive one probe from the terminal: banner, progress lines, report, summary."""
+    output_path = output_path or _default_output_path(kind)
 
     click.echo(
-        click.style("Alpaca dome probe", bold=True)
+        click.style(f"Alpaca {kind} probe", bold=True)
         + f" → {protocol}://{host}:{port} (device {device_number})"
     )
     if allow_active:
@@ -163,7 +157,7 @@ def probe_dome_cmd(
     )
 
     try:
-        result = probe_dome(
+        result = runner(
             host=host,
             port=port,
             device_number=device_number,
@@ -192,3 +186,38 @@ def probe_dome_cmd(
     click.echo(f"  SupportedActions: {supported_n} entries")
     click.echo(f"  Host hints:       {_describe_host_hints(result.report)}")
     click.echo(f"  Report written to {click.style(os.fspath(output_path), fg='cyan')}")
+
+
+@probe_group.command(
+    name="dome",
+    help=(
+        "Probe a local Alpaca dome device read-only and write a JSON report.\n\n"
+        "Captures device metadata, SupportedActions, and the behaviour of the "
+        "legacy CommandString / CommandBool / CommandBlind passthroughs. "
+        "Useful for figuring out whether a proprietary driver (e.g. TCSGalil) "
+        "exposes any vendor-specific extension surface beyond the standard "
+        "ASCOM IDome interface. Local host hints (open ports, COM ProgIDs) "
+        "are added when HOST is this machine."
+    ),
+)
+@_add_options(_COMMON_OPTIONS)
+def probe_dome_cmd(**options) -> None:
+    _run_probe("dome", probe_dome, **options)
+
+
+@probe_group.command(
+    name="telescope",
+    help=(
+        "Probe a local Alpaca telescope (mount) device read-only and write a "
+        "JSON report.\n\n"
+        "Captures device metadata, optics, site, pointing and tracking state, "
+        "capabilities, CanMoveAxis and AxisRates per movable axis, "
+        "SupportedActions, and the behaviour of the legacy CommandString / "
+        "CommandBool / CommandBlind passthroughs. Never moves the mount. "
+        "Local host hints (open ports, COM ProgIDs) are added when HOST is "
+        "this machine."
+    ),
+)
+@_add_options(_COMMON_OPTIONS)
+def probe_telescope_cmd(**options) -> None:
+    _run_probe("telescope", probe_telescope, **options)

arcsecond-4.0.0/arcsecond/alpaca/dome_probe.py

@@ -0,0 +1,90 @@
+"""
+Read-only diagnostic for an ASCOM Alpaca *dome* device.
+
+The standard ASCOM Alpaca ``IDome`` interface only exposes a single
+``OpenShutter`` / ``CloseShutter`` pair. Multi-shutter domes (e.g. DFM domes
+driven by TCSGalil) coordinate their shutters internally; if the driver does
+not advertise per-shutter custom actions via ``SupportedActions``, there is
+no canonical client-side way to drive the upper and lower shutters
+independently. This probe writes down exactly what surface a dome server
+exposes, so that decision can be made on evidence.
+
+The engine, the report layout and the safety rules live in :mod:`.probe`;
+this module only says which dome properties to read.
+"""
+
+from __future__ import annotations
+
+from typing import Any, Callable, Iterable
+
+from .probe import ProbeProgress, ProbeResult
+from .probe import iter_probe_labels as _iter_probe_labels
+from .probe import probe_device
+
+# Read-only device descriptors and dome state, in the order we want them
+# presented in the report. Names are PascalCase to match the alpyca surface.
+_READ_ONLY_PROPERTIES: tuple[str, ...] = (
+    "Name",
+    "Description",
+    "DriverInfo",
+    "DriverVersion",
+    "InterfaceVersion",
+    "ShutterStatus",
+    "Altitude",
+    "Azimuth",
+    "AtHome",
+    "AtPark",
+    "Slewing",
+    "Slaved",
+    "CanFindHome",
+    "CanPark",
+    "CanSetAltitude",
+    "CanSetPark",
+    "CanSetShutter",
+    "CanSlave",
+    "CanSyncAzimuth",
+)
+
+
+def probe_dome(
+    host: str,
+    port: int,
+    device_number: int = 0,
+    *,
+    protocol: str = "http",
+    allow_active: bool = False,
+    collect_host_info: bool | None = None,
+    dome_factory: Callable[[str, int, str], Any] | None = None,
+    progress: ProbeProgress | None = None,
+) -> ProbeResult:
+    """
+    Build a JSON-serialisable diagnostic report for an Alpaca dome at
+    ``protocol://host:port`` (device_number). See :func:`.probe.probe_device`
+    for the ``collect_host_info`` semantics.
+
+    ``dome_factory(address, device_number, protocol)`` is only there for
+    tests — production callers leave it ``None`` and the real
+    ``alpaca.dome.Dome`` is used.
+    """
+    if dome_factory is None:
+        from alpaca.dome import Dome  # local import: keep cost off cold paths
+
+        dome_factory = Dome
+
+    return probe_device(
+        "dome",
+        host,
+        port,
+        device_number,
+        properties=_READ_ONLY_PROPERTIES,
+        device_factory=dome_factory,
+        protocol=protocol,
+        allow_active=allow_active,
+        collect_host_info=collect_host_info,
+        progress=progress,
+    )
+
+
+def iter_probe_labels() -> Iterable[str]:
+    """Convenience for tests / docs: enumerate the labels emitted by a run."""
+    return _iter_probe_labels(_READ_ONLY_PROPERTIES)