arcsecond 3.11.0__tar.gz → 3.13.0__tar.gz

{arcsecond-3.11.0 → arcsecond-3.13.0}/.github/workflows/pythonpublish.yml

@@ -25,14 +25,15 @@ jobs:
 
       - uses: actions/checkout@v5
 
-      - name: Set up Python
-        uses: actions/setup-python@v6
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
         with:
           python-version: '3.12'
+          enable-cache: true
 
       - name: Validate pyproject.toml version matches tag
         run: |
-          python - <<'PY'
+          uv run python - <<'PY'
           import os, pathlib, tomllib
 
           tag = os.environ["GITHUB_REF_NAME"]
@@ -45,10 +46,7 @@ jobs:
           PY
 
       - name: Build distributions
-        run: |
-          python -m pip install --upgrade pip
-          pip install build
-          python -m build
+        run: uv build
 
       - name: Publish to PyPI (OIDC)
         uses: pypa/gh-action-pypi-publish@release/v1

{arcsecond-3.11.0 → arcsecond-3.13.0}/.github/workflows/tests.yml

@@ -16,26 +16,22 @@ jobs:
     steps:
       - uses: actions/checkout@v5
 
-      - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v6
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
         with:
           python-version: ${{ matrix.python-version }}
+          enable-cache: true
 
       - name: Install dependencies
-        run: |
-          python -m pip install --upgrade pip
-          if [ -f requirements.txt ]; then pip install -r requirements.txt; fi
-          pip install pytest pytest-cov respx
-          pip install -e .
+        run: uv sync --extra webcam --group dev
 
       - name: Test with coverage (only on 3.12)
         if: matrix.python-version == '3.12'
-        run: |
-          pytest -vvs tests/ --cov=arcsecond --cov-report=xml:coverage.xml
+        run: uv run pytest -vvs tests/ --cov=arcsecond --cov-report=xml:coverage.xml
 
       - name: Test without coverage
         if: matrix.python-version != '3.12'
-        run: pytest -vvs tests/
+        run: uv run pytest -vvs tests/
 
       - name: Upload coverage artifact (only on 3.12)
         if: matrix.python-version == '3.12'
@@ -58,7 +54,7 @@ jobs:
           path: .
 
       - name: SonarQube Scan
-        uses: SonarSource/sonarqube-scan-action@v5
+        uses: SonarSource/sonarqube-scan-action@v6
         env:
           SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }}
 
@@ -67,24 +63,20 @@ jobs:
     steps:
       - uses: actions/checkout@v5
 
-      - name: Set up Python
-        uses: actions/setup-python@v6
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
         with:
           python-version: '3.12'
+          enable-cache: true
 
-      - name: Install dependencies
-        run: |
-          python -m pip install --upgrade pip
-          pip install flake8 black isort
+      - name: Install dev dependencies
+        run: uv sync --group dev
 
       - name: Lint with flake8
-        run: |
-          flake8 arcsecond tests --count --select=E9,F63,F7,F82 --show-source --statistics
+        run: uv run flake8 arcsecond tests --count --select=E9,F63,F7,F82 --show-source --statistics
 
       - name: Check formatting with black
-        run: |
-          black --check arcsecond tests
+        run: uv run black --check arcsecond tests
 
       - name: Check imports with isort
-        run: |
-          isort --check-only --profile black arcsecond tests
+        run: uv run isort --check-only --profile black arcsecond tests

{arcsecond-3.11.0 → arcsecond-3.13.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: arcsecond
-Version: 3.11.0
+Version: 3.13.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
@@ -36,6 +36,7 @@ Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.9
+Requires-Dist: alpyca==3.1.2
 Requires-Dist: click>=8
 Requires-Dist: configparser
 Requires-Dist: docker
@@ -61,20 +62,19 @@ public and private ones.
 
 # Development
 
-To start developing the arcsecond CLI, fork the project, `git clone` it, 
-then, in the arcsecond-cli folder, do 
-(assuming [virtualenv](https://virtualenv.pypa.io/en/stable/) is installed):
+The project uses [uv](https://docs.astral.sh/uv/) for environment and
+dependency management. After forking and cloning:
 
 ```bash
 $ cd ~/arcsecond-cli
-$ virtualenv --python=pythonX.Y env
-$ source env/bin/activate
-$ pip install -e .
-``` 
+$ uv sync --extra webcam --group dev
+$ uv run arcsecond --help
+$ uv run pytest
+```
 
-The last line ensure you can call the "locally installed" version of the 
-code of that folder. Once done one first time, only the `source 
-env/bin/activate` is needed when you restart a debugging session.
+`uv sync` creates `.venv/` and installs the project with its `webcam` extra
+and the `dev` dependency group (pytest, black, flake8, isort). Prefix
+commands with `uv run` or activate the venv with `source .venv/bin/activate`.
 
 
 ## License

{arcsecond-3.11.0 → arcsecond-3.13.0}/README.md

@@ -11,20 +11,19 @@ public and private ones.
 
 # Development
 
-To start developing the arcsecond CLI, fork the project, `git clone` it, 
-then, in the arcsecond-cli folder, do 
-(assuming [virtualenv](https://virtualenv.pypa.io/en/stable/) is installed):
+The project uses [uv](https://docs.astral.sh/uv/) for environment and
+dependency management. After forking and cloning:
 
 ```bash
 $ cd ~/arcsecond-cli
-$ virtualenv --python=pythonX.Y env
-$ source env/bin/activate
-$ pip install -e .
-``` 
-
-The last line ensure you can call the "locally installed" version of the 
-code of that folder. Once done one first time, only the `source 
-env/bin/activate` is needed when you restart a debugging session.
+$ uv sync --extra webcam --group dev
+$ uv run arcsecond --help
+$ uv run pytest
+```
+
+`uv sync` creates `.venv/` and installs the project with its `webcam` extra
+and the `dev` dependency group (pytest, black, flake8, isort). Prefix
+commands with `uv run` or activate the venv with `source .venv/bin/activate`.
 
 
 ## License

{arcsecond-3.11.0 → arcsecond-3.13.0}/arcsecond/__init__.py

@@ -5,8 +5,6 @@ from .api import (
     ArcsecondTargetListsResource,
 )
 from .cloud.uploader import (
-    AllSkyCameraImageFileUploader,
-    AllSkyCameraImageUploadContext,
     DatasetFileUploader,
     DatasetUploadContext,
 )
@@ -25,8 +23,6 @@ __all__ = [
     "ArcsecondTargetPayloadPlan",
     "DatasetUploadContext",
     "DatasetFileUploader",
-    "AllSkyCameraImageFileUploader",
-    "AllSkyCameraImageUploadContext",
     "plan_target_payload",
     "walk_folder_and_upload_files",
 ]

arcsecond-3.13.0/arcsecond/alpaca/commands.py

@@ -0,0 +1,180 @@
+"""
+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 optional local host hints).
+
+Structure leaves room for ``arcsecond alpaca probe telescope`` /
+``probe camera`` / ``probe focuser`` and ``arcsecond alpaca discover`` later
+under the same group.
+"""
+
+from __future__ import annotations
+
+import json
+import os
+from datetime import datetime, timezone
+from pathlib import Path
+
+import click
+
+from ..errors import ArcsecondError
+from .dome_probe import ProbeProgress, probe_dome
+
+
+@click.group(name="alpaca", help="Diagnostics for local ASCOM Alpaca devices.")
+def alpaca_group() -> None:
+    pass
+
+
+@alpaca_group.group(name="probe", help="Inspect an Alpaca device read-only.")
+def probe_group() -> None:
+    pass
+
+
+_COMMON_OPTIONS = [
+    click.option(
+        "--host",
+        required=True,
+        metavar="HOST",
+        help="Alpaca server hostname or IP (without scheme).",
+    ),
+    click.option(
+        "--port",
+        type=int,
+        required=True,
+        metavar="PORT",
+        help="Alpaca server TCP port (e.g. 11111).",
+    ),
+    click.option(
+        "--device-number",
+        type=int,
+        default=0,
+        show_default=True,
+        help="Alpaca device number on the server.",
+    ),
+    click.option(
+        "--protocol",
+        type=click.Choice(["http", "https"], case_sensitive=False),
+        default="http",
+        show_default=True,
+        help="Protocol to reach the Alpaca server with.",
+    ),
+    click.option(
+        "--allow-active",
+        is_flag=True,
+        default=False,
+        help=(
+            "Also send CommandBlind and active-class probes. OFF by default "
+            "to keep the run safe on real hardware."
+        ),
+    ),
+    click.option(
+        "--collect-host-info",
+        is_flag=True,
+        default=False,
+        help=(
+            "Additionally collect best-effort local OS hints (open ports, "
+            "COM ProgIDs matching TCS/Galil). Read-only."
+        ),
+    ),
+    click.option(
+        "--output",
+        "output_path",
+        type=click.Path(dir_okay=False, writable=True, resolve_path=True),
+        default=None,
+        help="Where to write the JSON report. Defaults to cwd with a UTC timestamp.",
+    ),
+]
+
+
+def _add_options(options):
+    def _wrap(fn):
+        for opt in reversed(options):
+            fn = opt(fn)
+        return fn
+
+    return _wrap
+
+
+def _default_output_path(kind: str) -> str:
+    stamp = datetime.now(timezone.utc).strftime("%Y%m%dT%H%M%SZ")
+    return str(Path.cwd() / f"alpaca_{kind}_probe_{stamp}.json")
+
+
+def _format_progress(label: str, ok: bool, detail: str | None) -> str:
+    tag = click.style("[OK ]", fg="green") if ok else click.style("[ERR]", fg="red")
+    suffix = f" — {detail}" if detail else ""
+    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."
+    ),
+)
+@_add_options(_COMMON_OPTIONS)
+def probe_dome_cmd(
+    host: str,
+    port: int,
+    device_number: int,
+    protocol: str,
+    allow_active: bool,
+    collect_host_info: bool,
+    output_path: str | None,
+) -> None:
+    output_path = output_path or _default_output_path("dome")
+
+    click.echo(
+        click.style("Alpaca dome probe", bold=True)
+        + f" → {protocol}://{host}:{port} (device {device_number})"
+    )
+    if allow_active:
+        click.echo(
+            click.style("  ⚠  ", fg="yellow")
+            + "--allow-active is ON: CommandBlind and active-class probes will be sent."
+        )
+
+    progress = ProbeProgress(
+        on_probe=lambda label, ok, detail: click.echo(
+            _format_progress(label, ok, detail)
+        )
+    )
+
+    try:
+        result = probe_dome(
+            host=host,
+            port=port,
+            device_number=device_number,
+            protocol=protocol.lower(),
+            allow_active=allow_active,
+            collect_host_info=collect_host_info,
+            progress=progress,
+        )
+    except RuntimeError as exc:
+        raise ArcsecondError(str(exc)) from exc
+
+    try:
+        with open(output_path, "w", encoding="utf-8") as fp:
+            json.dump(result.report, fp, indent=2, sort_keys=False)
+            fp.write("\n")
+    except OSError as exc:
+        raise ArcsecondError(f"Could not write report to {output_path}: {exc}") from exc
+
+    counts = result.counts
+    supported = result.report.get("supported_actions", {})
+    supported_n = len(supported.get("value") or []) if supported.get("ok") else 0
+
+    click.echo("")
+    click.echo(click.style("Summary", bold=True))
+    click.echo(f"  Probes:           {counts.ok}/{counts.total} OK")
+    click.echo(f"  SupportedActions: {supported_n} entries")
+    click.echo(f"  Report written to {click.style(os.fspath(output_path), fg='cyan')}")