"""
VCR.py configuration for recording/replaying HTTP interactions.

This allows tests to run fast by replaying recorded API responses instead of
making real HTTP calls every time.
"""

import vcr

# Configure VCR instance
my_vcr = vcr.VCR(
    # Store cassettes in tests/cassettes/ directory
    cassette_library_dir="tests/cassettes",
    # Record mode: once = record once, then replay
    # Use 'new_episodes' to record new interactions but replay existing ones
    record_mode="once",
    # Match requests by method and URI
    match_on=["method", "scheme", "host", "port", "path", "query"],
    # Filter out sensitive data from recordings
    filter_headers=["authorization", "x-api-key"],
    # Decode compressed responses for better diffs
    decode_compressed_response=True,
    # Serialize as YAML for human-readable diffs
    serializer="yaml",
    # Path transformer to organize cassettes
    path_transformer=vcr.VCR.ensure_suffix(".yaml"),
)


def scrub_request(request):
    """Remove sensitive data from recorded requests."""
    # Add any request scrubbing logic here
    return request


def scrub_response(response):
    """Remove sensitive data from recorded responses."""
    # Add any response scrubbing logic here
    return response


# Register request/response scrubbers
my_vcr.before_record_request = scrub_request
my_vcr.before_record_response = scrub_response