summaryrefslogtreecommitdiffstats
path: root/contrib/python/propcache/tests/test_init.py
blob: 6bcffe7faa6b5eb33d8671929117c569ea3e2dc1 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
"""Test imports can happen from top-level."""

import pytest

import propcache
from propcache import _helpers


def test_api_at_top_level() -> None:
    """Verify the public API is accessible at top-level."""
    assert propcache.cached_property is not None
    assert propcache.under_cached_property is not None
    assert propcache.cached_property is _helpers.cached_property
    assert propcache.under_cached_property is _helpers.under_cached_property


@pytest.mark.parametrize(
    "prop_name",
    ("cached_property", "under_cached_property"),
)
def test_public_api_is_discoverable_in_dir(prop_name: str) -> None:
    """Verify the public API is discoverable programmatically."""
    assert prop_name in dir(propcache)


def test_importing_invalid_attr_raises() -> None:
    """Verify importing an invalid attribute raises an AttributeError."""
    match = r"^module 'propcache' has no attribute 'invalid_attr'$"
    with pytest.raises(AttributeError, match=match):
        propcache.invalid_attr


def test_import_error_invalid_attr() -> None:
    """Verify importing an invalid attribute raises an ImportError."""
    # No match here because the error is raised by the import system
    # and may vary between Python versions.
    with pytest.raises(ImportError):
        from propcache import invalid_attr  # noqa: F401


def test_no_wildcard_imports() -> None:
    """Verify wildcard imports are prohibited."""
    assert not propcache.__all__