Chris CoutinhoandClaude Opus 4.8
89522ca572
Adds the consumer-driven Pact for the gateway's async batch OCR routes, consumed
by GatewayBatchOcrClient. The embedding gateway is a separate provider
(astrolabe-cloud-gateway) from the existing `astrolabe` credentials pact, so it
gets its own fixture + pact file.
Interactions (only the fields the single-document client reads are pinned, so the
contract is robust to the gateway's additive OcrBatchJobOut fields):
- POST /v1/ocr/batch -> 202 { job_id } (namespaced <provider>/<id>)
- GET /v1/ocr/batch/{job_id} -> pending / succeeded (per-page markdown) / failed
The gateway is unauthenticated today, so no bearer is sent (matching the
M2M-optional client). Provider-side: this publishes a pact the gateway's
verification job must now satisfy — it needs provider-state handlers
(pending/succeeded/failed jobs) + a Mistral stub on the astrolabe-cloud-website
side (its verification was a deliberate no-op until a consumer pact existed).
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
61 lines
2.1 KiB
Python
61 lines
2.1 KiB
Python
"""Fixtures shared by the Pact contract tests (ADR-029).
|
|
|
|
The consumer tests build a fresh ``Pact`` per test and merge their interaction
|
|
into a single pact file under ``tests/contract/pacts/``. A session-scoped
|
|
autouse fixture wipes that directory once at the start of a run so merged pacts
|
|
never accumulate stale interactions across runs (``write_file(overwrite=False)``
|
|
merges into whatever is already on disk).
|
|
"""
|
|
|
|
import shutil
|
|
from pathlib import Path
|
|
|
|
import pytest
|
|
from pact import Pact
|
|
|
|
# Pact participant names. These MUST match the names used on the provider side
|
|
# and in the broker, so keep them in sync with the provider repos' pact tests.
|
|
CONSUMER = "nextcloud-mcp-server"
|
|
PROVIDER = "astrolabe"
|
|
# The embedding gateway is a *separate* provider (astrolabe-cloud-website,
|
|
# services/embedding-gateway). Its provider-verification job
|
|
# (test_gateway_provider_verification.py, PROVIDER_NAME="astrolabe-cloud-gateway")
|
|
# picks up this consumer's pact from the broker.
|
|
GATEWAY_PROVIDER = "astrolabe-cloud-gateway"
|
|
|
|
PACT_DIR = Path(__file__).parent / "pacts"
|
|
|
|
|
|
@pytest.fixture(scope="session", autouse=True)
|
|
def _clean_pact_dir():
|
|
"""Start each session from an empty pacts directory."""
|
|
if PACT_DIR.exists():
|
|
shutil.rmtree(PACT_DIR)
|
|
PACT_DIR.mkdir(parents=True, exist_ok=True)
|
|
yield
|
|
|
|
|
|
@pytest.fixture
|
|
def consumer_pact():
|
|
"""A fresh Pact (consumer=nextcloud-mcp-server, provider=astrolabe).
|
|
|
|
The interaction added by each test is merged into the shared pact file on
|
|
teardown.
|
|
"""
|
|
pact = Pact(CONSUMER, PROVIDER).with_specification("V4")
|
|
yield pact
|
|
pact.write_file(PACT_DIR, overwrite=False)
|
|
|
|
|
|
@pytest.fixture
|
|
def gateway_consumer_pact():
|
|
"""A fresh Pact (consumer=nextcloud-mcp-server, provider=astrolabe-cloud-gateway).
|
|
|
|
Separate from ``consumer_pact`` because the embedding gateway is a distinct
|
|
provider — its interactions merge into their own pact file, verified by the
|
|
gateway's provider job (Deck #332).
|
|
"""
|
|
pact = Pact(CONSUMER, GATEWAY_PROVIDER).with_specification("V4")
|
|
yield pact
|
|
pact.write_file(PACT_DIR, overwrite=False)
|