arcsecond 3.7.2__tar.gz → 3.8.0__tar.gz

arcsecond-3.8.0/.docker/Dockerfile_postgres

@@ -0,0 +1,2 @@
+ARG BASE_IMAGE=postgres:16
+FROM ${BASE_IMAGE}

arcsecond-3.8.0/.docker/Dockerfile_redis

@@ -0,0 +1,2 @@
+ARG BASE_IMAGE=redis:7.4
+FROM ${BASE_IMAGE}

arcsecond-3.8.0/.github/dependabot.yml

@@ -0,0 +1,11 @@
+# To get started with Dependabot version updates, you'll need to specify which
+# package ecosystems to update and where the package manifests are located.
+# Please see the documentation for all configuration options:
+# https://help.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
+
+version: 2
+updates:
+  - package-ecosystem: "pip"
+    directory: "/" # Location of package manifests
+    schedule:
+      interval: "weekly"

arcsecond-3.8.0/.github/workflows/docsdeploy.yml

@@ -0,0 +1,30 @@
+name: Deploy Docs
+
+on: [push]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+    - name: Setup node
+      uses: actions/setup-node@v4
+      with:
+        node-version: '20.x'
+    - name: Cache node modules
+      uses: actions/cache@v4
+      with:
+        path: ~/.npm
+        key: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }}
+        restore-keys: |
+          ${{ runner.os }}-node-
+    - run: npm ci
+      env:
+        NODE_AUTH_TOKEN: ${{ secrets.READ_PACKAGE_TOKEN }}
+        CI: true
+        node-version: '20.x'
+        cache: 'npm'
+    - name: Deploy docs
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      run: ./deploy.sh

arcsecond-3.8.0/.github/workflows/pythonpublish.yml

@@ -0,0 +1,57 @@
+name: Upload Python Package to Pypi
+
+on:
+  release:
+    types: [ published ]
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+
+    steps:
+      - name: Validate release tag and version (X.Y.Z and matches pyproject)
+        shell: bash
+        run: |
+          TAG="${{ github.event.release.tag_name }}"
+          echo "Release tag: $TAG"
+          if ! [[ "$TAG" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+            echo "Tag must be X.Y.Z (e.g. 1.2.3). Got: $TAG"
+            exit 1
+          fi
+
+      - uses: actions/checkout@v4
+
+      - name: Validate pyproject.toml version matches tag
+        run: |
+          python - <<'PY'
+          import pathlib
+          import tomllib
+
+          tag = "${{ github.event.release.tag_name }}"
+
+          data = tomllib.loads(pathlib.Path("pyproject.toml").read_text(encoding="utf-8"))
+          py_ver = data["project"]["version"]
+
+          print(f"pyproject.toml version: {py_ver}")
+          if py_ver != tag:
+            raise SystemExit(f"Version mismatch: tag={tag} but pyproject.toml={py_ver}")
+          PY
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+
+      - name: Build distributions
+        run: |
+          python -m pip install --upgrade pip
+          pip install build
+          python -m build
+
+      - name: Publish to PyPI (OIDC)
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist

arcsecond-3.8.0/.github/workflows/tests.yml

@@ -0,0 +1,90 @@
+name: Run Tests
+
+on:
+  push:
+    branches: [ '*' ]
+  pull_request:
+    branches: [ '*' ]
+
+jobs:
+  tests:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: [ '3.10', '3.11', '3.12', '3.13' ]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v4
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - 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 .
+
+      - 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
+
+      - name: Test without coverage
+        if: matrix.python-version != '3.12'
+        run: pytest -vvs tests/
+
+      - name: Upload coverage artifact (only on 3.12)
+        if: matrix.python-version == '3.12'
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage
+          path: coverage.xml
+
+  scan:
+    runs-on: ubuntu-latest
+    needs: tests
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Download coverage artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: coverage
+          path: .
+
+      - name: SonarQube Scan
+        uses: SonarSource/sonarcloud-github-action@master
+        env:
+          SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }}
+
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: '3.12'
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install flake8 black isort
+
+      - name: Lint with flake8
+        run: |
+          flake8 arcsecond tests --count --select=E9,F63,F7,F82 --show-source --statistics
+
+      - name: Check formatting with black
+        run: |
+          black --check arcsecond tests
+
+      - name: Check imports with isort
+        run: |
+          isort --check-only --profile black arcsecond tests

arcsecond-3.8.0/.gitignore

@@ -0,0 +1,22 @@
+*.pyc
+
+dist/
+build/
+*.egg-info/
+
+.tox/
+.coverage
+.pytest_cache
+.idea
+
+venv
+/env
+.DS_Store
+node_modules
+
+/docs/.vitepress/cache
+
+*.tar
+
+/coverage.xml
+.env

arcsecond-3.8.0/Makefile

@@ -0,0 +1,63 @@
+ARCH ?= amd64
+TAG ?= latest
+
+IMAGE_API = arcsecond-api-linux-$(ARCH)
+IMAGE_WEB = arcsecond-web-linux-$(ARCH)
+IMAGE_REDIS = arcsecond-redis-linux-$(ARCH)
+IMAGE_POSTGRES = arcsecond-postgres-linux-$(ARCH)
+
+IMAGE_API_OCI = arcsecond-api
+IMAGE_WEB_OCI = arcsecond-web
+IMAGE_REDIS_OCI = arcsecond-redis
+IMAGE_POSTGRES_OCI = arcsecond-postgres
+
+# Paths
+DOCKERFILE_API = ../arcsecond-back/.docker/Dockerfile
+CONTEXT_API = ../arcsecond-back
+
+DOCKERFILE_WEB = ../arcsecond-front/.docker/Dockerfile
+CONTEXT_WEB = ../arcsecond-front
+
+DOCKERFILE_REDIS = ./.docker/Dockerfile_redis
+DOCKERFILE_POSTGRES = ./.docker/Dockerfile_postgres
+
+# Build and save each image
+
+arcsecond-api-linux:
+	docker build --platform linux/$(ARCH) -t $(IMAGE_API):$(TAG) -f $(DOCKERFILE_API) $(CONTEXT_API)
+	docker save $(IMAGE_API):$(TAG) -o tars/$(IMAGE_API)_$(TAG).tar
+
+arcsecond-web-linux:
+	docker build --platform linux/$(ARCH) -t $(IMAGE_WEB):$(TAG) -f $(DOCKERFILE_WEB) $(CONTEXT_WEB)
+	docker save $(IMAGE_WEB):$(TAG) -o tars/$(IMAGE_WEB)_$(TAG).tar
+
+arcsecond-redis-linux:
+	docker build --platform linux/$(ARCH) -t $(IMAGE_REDIS):7.4 -f $(DOCKERFILE_REDIS) .
+	docker save $(IMAGE_REDIS):7.4 -o tars/$(IMAGE_REDIS)_7.4.tar
+
+arcsecond-postgres-linux:
+	docker build --platform linux/$(ARCH) -t $(IMAGE_POSTGRES):16 -f $(DOCKERFILE_POSTGRES) .
+	docker save $(IMAGE_POSTGRES):16 -o tars/$(IMAGE_POSTGRES)_16.tar
+
+arcsecond-api-oci:
+	docker buildx build --platform 'linux/amd64,linux/arm64' -o 'type=oci,dest=-' -t $(IMAGE_API_OCI):$(TAG) -f $(DOCKERFILE_API) $(CONTEXT_API) > tars/$(IMAGE_API_OCI)_$(TAG).tar
+
+arcsecond-web-oci:
+	docker buildx build --platform 'linux/amd64,linux/arm64' -o 'type=oci,dest=-' -t $(IMAGE_WEB_OCI):$(TAG) -f $(DOCKERFILE_WEB) $(CONTEXT_WEB) > tars/$(IMAGE_WEB_OCI)_$(TAG).tar
+
+arcsecond-redis-oci:
+	docker buildx build --platform 'linux/amd64,linux/arm64' -o 'type=oci,dest=-' -t $(IMAGE_REDIS_OCI):$(TAG) -f $(DOCKERFILE_REDIS) . > tars/$(IMAGE_REDIS_OCI)_$(TAG).tar
+
+arcsecond-postgres-oci:
+	docker buildx build --platform 'linux/amd64,linux/arm64' -o 'type=oci,dest=-' -t $(IMAGE_POSTGRES_OCI):$(TAG) -f $(DOCKERFILE_POSTGRES) . > tars/$(IMAGE_POSTGRES_OCI)_$(TAG).tar
+
+.PHONY: core aux clean
+
+core: arcsecond-api-linux arcsecond-web-linux
+
+aux: arcsecond-redis-linux arcsecond-postgres-linux
+
+oci: arcsecond-api-oci arcsecond-web-oci arcsecond-redis-oci arcsecond-postgres-oci
+
+clean:
+	rm -f arcsecond-*.tar tars/*

{arcsecond-3.7.2 → arcsecond-3.8.0}/PKG-INFO

@@ -1,9 +1,10 @@
 Metadata-Version: 2.4
 Name: arcsecond
-Version: 3.7.2
+Version: 3.8.0
 Summary: CLI for arcsecond.io
-Home-page: https://github.com/arcsecond-io/cli
-Author: Cedric Foellmi
+Project-URL: Homepage, https://github.com/arcsecond-io/cli
+Project-URL: Issues, https://github.com/arcsecond-io/cli/issues
+Project-URL: Documentation, https://docs.arcsecond.io
 Author-email: Cedric Foellmi <cedric@arcsecond.io>
 License: MIT License
         
@@ -26,11 +27,7 @@ License: MIT License
         LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
         OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
         SOFTWARE.
-        
-Project-URL: Homepage, https://github.com/arcsecond-io/cli
-Project-URL: Issues, https://github.com/arcsecond-io/cli/issues
-Project-URL: Documentation, https://docs.arcsecond.io
-Platform: any
+License-File: LICENSE
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
@@ -39,19 +36,16 @@ Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-License-File: LICENSE
+Requires-Dist: aiohttp>=3.9
 Requires-Dist: click>=8
 Requires-Dist: configparser
 Requires-Dist: docker
 Requires-Dist: httpx
-Requires-Dist: tqdm<5.0.0,>=4.67.1
+Requires-Dist: opencv-python-headless<5,>=4.10
 Requires-Dist: py-machineid
+Requires-Dist: tqdm<5.0.0,>=4.67.1
 Requires-Dist: wait-for-it
-Dynamic: author
-Dynamic: home-page
-Dynamic: license-file
-Dynamic: platform
+Description-Content-Type: text/markdown
 
 [![Deploy Docs](https://github.com/arcsecond-io/cli/actions/workflows/docsdeploy.yml/badge.svg)](https://github.com/arcsecond-io/cli/actions/workflows/docsdeploy.yml) [![Downloads](http://pepy.tech/badge/arcsecond)](http://pepy.tech/project/arcsecond)
 [![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Farcsecond-io%2Fcli.svg?type=shield)](https://app.fossa.com/projects/git%2Bgithub.com%2Farcsecond-io%2Fcli?ref=badge_shield)
@@ -83,4 +77,4 @@ env/bin/activate` is needed when you restart a debugging session.
 
 
 ## License
-[![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Farcsecond-io%2Fcli.svg?type=large)](https://app.fossa.com/projects/git%2Bgithub.com%2Farcsecond-io%2Fcli?ref=badge_large)
+[![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Farcsecond-io%2Fcli.svg?type=large)](https://app.fossa.com/projects/git%2Bgithub.com%2Farcsecond-io%2Fcli?ref=badge_large)

{arcsecond-3.7.2 → arcsecond-3.8.0}/arcsecond/__init__.py

@@ -1,4 +1,9 @@
-from .api import ArcsecondAPI, ArcsecondAPIEndpoint, ArcsecondConfig
+from .api import (
+    ArcsecondAPI,
+    ArcsecondAPIEndpoint,
+    ArcsecondConfig,
+    ArcsecondTargetListsResource,
+)
 from .cloud.uploader import (
     AllSkyCameraImageFileUploader,
     AllSkyCameraImageUploadContext,
@@ -7,6 +12,7 @@ from .cloud.uploader import (
 )
 from .cloud.uploader.walker import walk_folder_and_upload_files
 from .errors import ArcsecondError
+from .targets import ArcsecondTargetPayloadPlan, plan_target_payload
 
 name = "arcsecond"
 
@@ -15,9 +21,12 @@ __all__ = [
     "ArcsecondError",
     "ArcsecondConfig",
     "ArcsecondAPIEndpoint",
+    "ArcsecondTargetListsResource",
+    "ArcsecondTargetPayloadPlan",
     "DatasetUploadContext",
     "DatasetFileUploader",
     "AllSkyCameraImageFileUploader",
     "AllSkyCameraImageUploadContext",
+    "plan_target_payload",
     "walk_folder_and_upload_files",
 ]

arcsecond-3.8.0/arcsecond/__version__.py

@@ -0,0 +1,11 @@
+"""
+Version is defined in pyproject.toml (project.version).
+"""
+
+from importlib.metadata import PackageNotFoundError, version
+
+try:
+    __version__ = version("arcsecond")
+except PackageNotFoundError:
+    # Fallback for running from a source checkout without installing.
+    __version__ = "0.0.0"

arcsecond-3.8.0/arcsecond/api/__init__.py

@@ -0,0 +1,11 @@
+from .config import ArcsecondConfig
+from .endpoint import ArcsecondAPIEndpoint
+from .main import ArcsecondAPI
+from .resources import ArcsecondTargetListsResource
+
+__all__ = [
+    "ArcsecondAPI",
+    "ArcsecondConfig",
+    "ArcsecondAPIEndpoint",
+    "ArcsecondTargetListsResource",
+]

{arcsecond-3.7.2 → arcsecond-3.8.0}/arcsecond/api/endpoint.py

@@ -12,6 +12,13 @@ WRITABLE_MEMBERSHIPS = ["superadmin", "admin", "member"]
 
 
 class ArcsecondAPIEndpoint(object):
+    """
+    Generic REST endpoint wrapper for Arcsecond resources.
+
+    It owns transport-level CRUD plus resource-agnostic conveniences such as
+    payload merging, `find_one()`, and `upsert()`.
+    """
+
     def __init__(
         self,
         config: ArcsecondConfig,
@@ -57,6 +64,30 @@ class ArcsecondAPIEndpoint(object):
     def _detail_url(self, uuid_or_id):
         return self._build_url(self.__path, str(uuid_or_id))
 
+    def _build_payload(self, json=None, **fields):
+        payload = {}
+        if json:
+            payload.update(json)
+        payload.update({key: value for key, value in fields.items() if value is not None})
+        return payload or None
+
+    def _extract_results(self, response):
+        if isinstance(response, dict):
+            if isinstance(response.get("results"), list):
+                return response["results"]
+            if response:
+                return [response]
+        elif isinstance(response, list):
+            return response
+        return []
+
+    def _extract_identifier(self, resource, identifier_fields=("uuid", "id", "pk")):
+        for key in identifier_fields:
+            value = resource.get(key)
+            if value is not None:
+                return value
+        return None
+
     def list(self, **filters):
         return self._perform_request(self._list_url(**filters), "get")
 
@@ -65,16 +96,20 @@ class ArcsecondAPIEndpoint(object):
             self._detail_url(id_name_uuid), "get", headers=headers
         )
 
-    def create(self, json=None, files=None, headers=None):
+    def create(self, json=None, files=None, headers=None, **fields):
         return self._perform_request(
-            self._list_url(), "post", json=json, files=files, headers=headers
+            self._list_url(),
+            "post",
+            json=self._build_payload(json=json, **fields),
+            files=files,
+            headers=headers,
         )
 
-    def update(self, id_name_uuid, json=None, files=None, headers=None):
+    def update(self, id_name_uuid, json=None, files=None, headers=None, **fields):
         return self._perform_request(
             self._detail_url(id_name_uuid),
             "patch",
-            json=json,
+            json=self._build_payload(json=json, **fields),
             files=files,
             headers=headers,
         )
@@ -82,6 +117,44 @@ class ArcsecondAPIEndpoint(object):
     def delete(self, id_name_uuid):
         return self._perform_request(self._detail_url(id_name_uuid), "delete")
 
+    def find_one(self, **filters):
+        response, error = self.list(**filters)
+        if error:
+            return None, error
+
+        results = self._extract_results(response)
+        if len(results) == 0:
+            return None, None
+        if len(results) > 1:
+            return (
+                None,
+                ArcsecondError(
+                    f"Expected one '{self.path}' match for filters {filters}, got {len(results)}."
+                ),
+            )
+        return results[0], None
+
+    def upsert(self, match_field="name", json=None, **fields):
+        payload = self._build_payload(json=json, **fields)
+        if payload is None:
+            return None, ArcsecondError("Cannot upsert an empty payload.")
+
+        match_value = payload.get(match_field)
+        if match_value in (None, ""):
+            return self.create(json=payload)
+
+        existing, error = self.find_one(**{match_field: match_value})
+        if error:
+            return None, error
+        if existing is None:
+            return self.create(json=payload)
+
+        identifier = self._extract_identifier(existing)
+        if identifier is None:
+            return None, ArcsecondError(f"Could not find an identifier for '{match_value}'.")
+
+        return self.update(identifier, json=payload)
+
     def _perform_request(self, url, method_name, json=None, files=None, headers=None):
         if self.__config.verbose:
             click.echo(f"Sending {method_name} request to {url}")

{arcsecond-3.7.2 → arcsecond-3.8.0}/arcsecond/api/main.py

@@ -8,6 +8,7 @@ from arcsecond.options import State
 from .config import ArcsecondConfig
 from .constants import API_AUTH_PATH_VERIFY
 from .endpoint import ArcsecondAPIEndpoint
+from .resources import ArcsecondTargetListsResource
 
 __all__ = [
     "ArcsecondAPI",
@@ -40,6 +41,10 @@ class ArcsecondAPI(object):
         self.calibrations = ArcsecondAPIEndpoint(
             self.config, "calibrations", self.subdomain
         )
+        self.targets = ArcsecondAPIEndpoint(self.config, "targets", self.subdomain)
+        self.targetlists = ArcsecondTargetListsResource(
+            self.config, "targetlists", self.subdomain
+        )
 
         self.datapackages = ArcsecondAPIEndpoint(
             self.config, "datapackages", self.subdomain

arcsecond-3.8.0/arcsecond/api/resources.py

@@ -0,0 +1,114 @@
+from arcsecond.errors import ArcsecondError
+
+from .endpoint import ArcsecondAPIEndpoint
+
+
+class ArcsecondTargetListsResource(ArcsecondAPIEndpoint):
+    """Target-list specific helpers built on top of the generic endpoint contract."""
+
+    target_relation_keys = ("targets", "target_uuids", "target_ids")
+
+    def _ensure_iterable(self, values):
+        if values is None:
+            return None
+        if isinstance(values, (str, int)):
+            return [values]
+        return list(values)
+
+    def _normalise_target_references(self, targets):
+        values = self._ensure_iterable(targets)
+        if values is None:
+            return None
+
+        refs = []
+        for target in values:
+            if isinstance(target, dict):
+                ref = (
+                    target.get("uuid")
+                    or target.get("id")
+                    or target.get("pk")
+                    or target.get("name")
+                )
+                if ref is None:
+                    raise ArcsecondError(
+                        "Target dictionaries must include one of: uuid, id, pk or name."
+                    )
+                refs.append(ref)
+            else:
+                refs.append(target)
+        return refs
+
+    def _target_key_from_payload(self, payload, target_key=None):
+        if target_key:
+            return target_key
+        for key in self.target_relation_keys:
+            if payload and key in payload:
+                return key
+        return self.target_relation_keys[0]
+
+    def _build_payload(self, json=None, targets=None, target_key=None, **fields):
+        payload = super()._build_payload(json=json, **fields) or {}
+        normalised_targets = self._normalise_target_references(targets)
+        if normalised_targets is not None:
+            payload[self._target_key_from_payload(payload, target_key=target_key)] = (
+                normalised_targets
+            )
+        return payload or None
+
+    def create(self, json=None, targets=None, target_key=None, **fields):
+        payload = self._build_payload(
+            json=json, targets=targets, target_key=target_key, **fields
+        )
+        return ArcsecondAPIEndpoint.create(self, json=payload)
+
+    def update(self, id_name_uuid, json=None, targets=None, target_key=None, **fields):
+        payload = self._build_payload(
+            json=json, targets=targets, target_key=target_key, **fields
+        )
+        return ArcsecondAPIEndpoint.update(self, id_name_uuid, json=payload)
+
+    def upsert(self, match_field="name", json=None, targets=None, target_key=None, **fields):
+        payload = self._build_payload(
+            json=json, targets=targets, target_key=target_key, **fields
+        )
+        return super().upsert(match_field=match_field, json=payload)
+
+    def _read_target_refs(self, target_list, target_key=None):
+        key = self._target_key_from_payload(target_list or {}, target_key=target_key)
+        raw_targets = (target_list or {}).get(key, [])
+        refs = self._normalise_target_references(raw_targets) or []
+        return key, refs
+
+    def set_targets(self, id_name_uuid, targets, target_key=None):
+        target_key = self._target_key_from_payload({}, target_key=target_key)
+        return self.update(id_name_uuid, **{target_key: self._normalise_target_references(targets)})
+
+    def clear_targets(self, id_name_uuid, target_key=None):
+        return self.set_targets(id_name_uuid, [], target_key=target_key)
+
+    def add_targets(self, id_name_uuid, targets, target_key=None):
+        target_list, error = self.read(id_name_uuid)
+        if error:
+            return None, error
+
+        key, current_refs = self._read_target_refs(target_list, target_key=target_key)
+        for ref in self._normalise_target_references(targets) or []:
+            if ref not in current_refs:
+                current_refs.append(ref)
+        return self.update(id_name_uuid, **{key: current_refs})
+
+    def remove_targets(self, id_name_uuid, targets, target_key=None):
+        target_list, error = self.read(id_name_uuid)
+        if error:
+            return None, error
+
+        key, current_refs = self._read_target_refs(target_list, target_key=target_key)
+        refs_to_remove = set(self._normalise_target_references(targets) or [])
+        remaining_refs = [ref for ref in current_refs if ref not in refs_to_remove]
+        return self.update(id_name_uuid, **{key: remaining_refs})
+
+    def add_target(self, id_name_uuid, target, target_key=None):
+        return self.add_targets(id_name_uuid, [target], target_key=target_key)
+
+    def remove_target(self, id_name_uuid, target, target_key=None):
+        return self.remove_targets(id_name_uuid, [target], target_key=target_key)

{arcsecond-3.7.2 → arcsecond-3.8.0}/arcsecond/cli.py

@@ -10,6 +10,7 @@ from arcsecond.cloud import (
     upload_data,
 )
 from arcsecond.hosting import setup
+from arcsecond.webcam import commands as webcam
 
 from . import __version__
 from .options import State
@@ -59,3 +60,6 @@ main.add_command(upload_data)
 
 # Allow to try arcsecond by installing a local version
 main.add_command(setup)
+
+# Native webcam proxy — lets Docker containers reach USB webcams on the host.
+main.add_command(webcam.webcam)

{arcsecond-3.7.2 → arcsecond-3.8.0}/arcsecond/hosting/docker/docker-compose.yml

@@ -35,6 +35,12 @@ services:
     depends_on:
       - db
       - broker
+    # Allows the backend to reach the host machine via host.docker.internal.
+    # Required on Linux; Docker Desktop on Windows/macOS adds this automatically.
+    # Used by the webcam proxy: set WEBCAM_PROXY_URL=http://host.docker.internal:8765
+    # in your .env file and run `arcsecond webcam start` on the host.
+    extra_hosts:
+      - "host.docker.internal:host-gateway"
     env_file:
       # You must have a .env file with secret keys beside this yml file.
       - .env