- Status
- runnable in repo test
- Industry
- Cross-industry
- Language
- Python
- Framework
- pytest
- CI
- any
- Fulfilment
- BUILD_DATASET
- Profile
- healthcare-integration
About this example
All data is synthetic. DataNivra provisions approved test data into a customer-controlled target; it does not run these tests. Credentials for the target are never returned by DataNivra — your runner holds its own.
Why test data matters
A coding agent that reproduces a bug must get exactly the same data definition on every attempt.
What is requested
100 routine-care and 50 claim-denial members, pinned to profile version 1.
Policy gates
Pinned profile version (and optionally its checksum); same request, same request_checksum.
What is provisioned
A certified synthetic dataset.
Expected output
planTestDataRequest returns the same request_checksum every time; the created request records it.
Cleanup
Fixture releases.
Files
request.yamlexample.pytest_with_datanivra.py
Run
- A tenant administrator defines and a second person approves the profile (
datanivra test-data define ../../profiles/healthcare-integration.yaml --submit, thendatanivra policies approve). datanivra test-data validate request.yaml && datanivra test-data plan request.yaml- Run the example with
DATANIVRA_BASE_URLand a session or workload token.
Files
Exactly as they are in the examples repository. Every value is a synthetic placeholder; nothing here is a credential.
request.yaml
# yaml-language-server: $schema=../../../../packages/contracts/schemas/v1/manifests/test-data-request.schema.json
# DataNivra test-data-request manifest (apiVersion datanivra.io/v1alpha1). Validate: datanivra test-data validate <file>
apiVersion: datanivra.io/v1alpha1
kind: TestDataRequest
metadata:
name: bug-repro-4711
spec:
profile: { name: healthcare-integration, version: 1 }
scenarios:
- { scenario_code: HC_ROUTINE_CARE, count: 100 }
- { scenario_code: HC_CLAIM_DENIALS, count: 50 }
purpose_ref: BUG-4711
examples/test-data-api/scenarios/18-agent-bug-reproduction-pin/request.yaml
example.py
"""Agent-driven bug reproduction with a pinned request — provision approved test data through the Python SDK.
``provision`` only asks DataNivra for data from the approved ``healthcare-integration`` profile; your own test
suite runs against the approved target with its own, separately managed database access.
"""
from __future__ import annotations
from pathlib import Path
from datanivra_contracts.testdata import TestDataRequest
from datanivra_sdk import DataNivraClient
from datanivra_sdk.testdata import TestDataClient
REQUEST = Path(__file__).with_name("request.yaml")
def provision(api: DataNivraClient, *, idempotency_key: str | None = None) -> TestDataRequest:
"""Create (or, for the same key, return) the request; DENIED raises ``DataNivraApiError``."""
return TestDataClient(api).request(REQUEST, idempotency_key=idempotency_key)
examples/test-data-api/scenarios/18-agent-bug-reproduction-pin/example.py
test_with_datanivra.py
"""Agent-driven bug reproduction with a pinned request (pytest).
Run in your CI with ``DATANIVRA_BASE_URL`` and a token (``datanivra login --workload-identity ...``
or ``DATANIVRA_TOKEN``). The data is released after the session, even when tests fail.
"""
from __future__ import annotations
import os
from collections.abc import Iterator
import pytest
from datanivra_contracts.testdata import TestDataRequest
from datanivra_sdk import DataNivraClient
from datanivra_sdk.testdata import TestDataClient
from example import REQUEST
@pytest.fixture(scope="session")
def test_data() -> Iterator[TestDataRequest]:
api = DataNivraClient(os.environ["DATANIVRA_BASE_URL"], token=os.environ["DATANIVRA_TOKEN"])
with TestDataClient(api).acquire(REQUEST, idempotency_key=os.environ.get("CI_RUN_KEY")) as request:
yield request
def test_bug_reproduces_on_pinned_data(test_data: TestDataRequest) -> None:
# Your assertions run against your application and the approved target environment
# ``test_data.environment_id``; DataNivra only returns metadata (ids, states, digests).
assert test_data.state.value == "READY"
examples/test-data-api/scenarios/18-agent-bug-reproduction-pin/test_with_datanivra.py
The profile it uses: healthcare-integration
A tenant administrator defines this profile and a second person approves it; requests can only ask for what it allows. All profiles
healthcare-integration.yaml
# yaml-language-server: $schema=../../../packages/contracts/schemas/v1/manifests/test-data-profile.schema.json
# DataNivra test-data-profile manifest (apiVersion datanivra.io/v1alpha1). Validate: datanivra test-data validate <file>
# Placeholder ids (00000000-0000-4000-8000-0000000000NN): replace with your ids.
# 01 = approved target environment, 11 = certified dataset, 21 = customer agent,
# 99 = workload identity trust (datanivra workload-identities list).
apiVersion: datanivra.io/v1alpha1
kind: TestDataProfile
metadata:
name: healthcare-integration
description: Synthetic members (patients) and their encounters (appointments) for integration tests
spec:
fulfilment: BUILD_DATASET
build:
business_domain: patient encounters
pack_id: healthcare
dataset_kind: SYNTHETIC_ONLY
target_environment_id: 00000000-0000-4000-8000-000000000001
retention_days: 1
max_total_records: 3000
scenarios:
- {
pack_id: healthcare,
scenario_code: HC_ROUTINE_CARE,
kind: NORMAL,
default_count: 500,
max_count: 500,
}
- {
pack_id: healthcare,
scenario_code: HC_CHRONIC_CARE,
kind: HIGH_VOLUME,
default_count: 2000,
max_count: 2000,
}
- {
pack_id: healthcare,
scenario_code: HC_CLAIM_DENIALS,
kind: RARE,
default_count: 50,
max_count: 400,
included_by_default: false,
}
- {
pack_id: healthcare,
scenario_code: HC_ABNORMAL_LABS,
kind: BOUNDARY,
default_count: 50,
max_count: 200,
included_by_default: false,
}
automation:
workload_identity_ids: [00000000-0000-4000-8000-000000000099]
max_total_records: 2500
max_live_requests: 10
max_requests_per_hour: 60
escalate_out_of_envelope: true
audit_tags: [HEALTHCARE_SYNTHETIC]