Skip to content

fixtures

pyvider.testmode.fixtures

Pyvider Test Mode Fixtures.

Provides pytest fixtures for testing Pyvider components that require test mode, particularly test-only resources and data sources.

Fixtures: - provider_with_test_mode: Enables test mode for test-only components

Example usage

@pytest.mark.usefixtures("provider_with_test_mode") async def test_test_only_resource(): ... # Test mode is enabled, test-only components can be accessed ... # Test proceeds with test mode enabled

Functions

provider_with_test_mode 

provider_with_test_mode(
    provider_in_hub: Any,
) -> Generator[None]

Enable test mode for test-only components.

This fixture creates and registers a ProviderContext with test_mode_enabled=True, allowing tests to access components marked with test_only=True (like pyvider_private_state_verifier).

The fixture depends on the provider_in_hub fixture to ensure the provider is registered before enabling test mode.

Yields:

Type Description
Generator[None]

None
Example

@pytest.mark.usefixtures("provider_with_test_mode") async def test_private_state_verifier(): ... # Test mode is enabled, can access test-only resources ... # ... test implementation ...

Note

This fixture automatically cleans up the provider_context registration on teardown to ensure test isolation.

Source code in pyvider/testmode/fixtures.py 
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
@pytest.fixture
def provider_with_test_mode(provider_in_hub: Any) -> Generator[None]:
    """
    Enable test mode for test-only components.

    This fixture creates and registers a ProviderContext with test_mode_enabled=True,
    allowing tests to access components marked with test_only=True (like
    pyvider_private_state_verifier).

    The fixture depends on the provider_in_hub fixture to ensure the provider
    is registered before enabling test mode.

    Yields:
        None

    Example:
        >>> @pytest.mark.usefixtures("provider_with_test_mode")
        >>> async def test_private_state_verifier():
        ...     # Test mode is enabled, can access test-only resources
        ...     # ... test implementation ...

    Note:
        This fixture automatically cleans up the provider_context registration
        on teardown to ensure test isolation.
    """
    from attrs import define

    from pyvider.hub import hub
    from pyvider.providers.context import ProviderContext

    @define
    class TestConfig:
        pyvider_testmode: bool = True

    # Create and register provider context with test mode enabled
    context = ProviderContext(config=TestConfig(), test_mode_enabled=True)
    hub.register("singleton", "provider_context", context)

    yield

    # Clean up
    hub.unregister("singleton", "provider_context")