Files
gps-denied-onboard/tests/conftest.py
T
Oleksandr Bezdieniezhnykh 3b7265757b [AZ-306] C6 FaissDescriptorIndex (faiss-cpu, HNSW32)
Production-default DescriptorIndex strategy backed by the faiss-cpu
PyPI wheel (>=1.7,<2.0). Implements the AZ-303 Protocol surface end
to end: HNSW32 + IndexIDMap2 search, atomic three-file rebuild
(.index + .sha256 sidecar + .meta.json), triple-consistency load
check, mmap-backed reads with IO_FLAG_MMAP|IO_FLAG_READ_ONLY, optional
warm-up query at construction, FAISS RuntimeError rewrap to
IndexUnavailableError / IndexBuildError, and FaissDescriptorIndex.from_config
classmethod wired into runtime_root.storage_factory.

The original spec required a custom pybind11 wrapper over a vendored
FAISS HEAD; the user opted for the upstream faiss-cpu wheel after
research fact #92 confirmed ARM64 wheel availability for Jetson and
the existing pyproject.toml already pinned faiss-cpu. cpp/faiss_index/
placeholder removed; BUILD_FAISS_INDEX flag retained as a
runtime/factory gate (no native target). Spec rewritten end-to-end and
archived to _docs/02_tasks/done/.

C6TileCacheConfig extended with faiss_index_path and
faiss_warmup_query_path fields. tests/conftest.py sets
KMP_DUPLICATE_LIB_OK=TRUE to remediate the macOS faiss/torch libomp
duplicate-load abort during pytest (no-op on CI Linux). 21 new tests
cover AC-1..12 + 2 NFRs + from_config smoke; AZ-303 protocol-conformance
fake updated with from_config classmethod.

Tests: 124/124 c6_tile_cache pass; 1334 project-wide pass; 1
pre-existing OKVIS2 submodule failure unrelated.

Doc sync: module-layout.md, components/08_c6_tile_cache/description.md
§5, batch_35_cycle1_report.md.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-05-13 04:01:37 +03:00

53 lines
1.9 KiB
Python

"""Top-level pytest fixtures.
Heavy fixtures (Postgres bring-up, ArduPilot SITL, Derkachi corpus mount) are added
incrementally by the components that need them. AZ-263 ships only the smoke-level
scaffolding.
Tier-2-only tests are guarded by `pytest.mark.tier2` and auto-skipped on Tier-1.
"""
from __future__ import annotations
# AZ-306: faiss-cpu and torch each ship their own copy of libomp on macOS;
# loading both into the same process triggers `OMP: Error #15` and an abort
# inside FAISS native code. Setting `KMP_DUPLICATE_LIB_OK` here — BEFORE
# any test module imports either library — opts into the documented
# Intel OpenMP "duplicate-load tolerated" mode, which is the standard
# remediation for mixed-runtime scientific stacks on macOS dev hosts.
# CI Linux images don't need this; the setdefault keeps it a no-op there.
import os as _os
_os.environ.setdefault("KMP_DUPLICATE_LIB_OK", "TRUE")
import os
from collections.abc import Iterator
import pytest
from gps_denied_onboard.fdr_client.fakes import FakeFdrSink
def pytest_collection_modifyitems(config: pytest.Config, items: list[pytest.Item]) -> None:
"""Auto-skip `tier2` tests when GPS_DENIED_TIER != 2."""
if os.environ.get("GPS_DENIED_TIER") == "2":
return
skip_tier2 = pytest.mark.skip(reason="Tier-2-only test; set GPS_DENIED_TIER=2 to run")
skip_gpu = pytest.mark.skip(reason="GPU-only test")
skip_docker = pytest.mark.skip(reason="Requires Docker compose services")
for item in items:
if "tier2" in item.keywords:
item.add_marker(skip_tier2)
if "gpu" in item.keywords:
item.add_marker(skip_gpu)
if "docker" in item.keywords:
item.add_marker(skip_docker)
@pytest.fixture
def fake_fdr_sink() -> Iterator[FakeFdrSink]:
"""Default-configuration FakeFdrSink with overrun policy disabled (AZ-275 AC-5)."""
sink = FakeFdrSink(producer_id="test.producer")
yield sink
sink.flush()