Skip to content

lazydict

LazyDict

Bases: Mapping[K, V]

Lazily build a dictionary from an array of items.

Source code in pyiceberg/utils/lazydict.py 
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
72
class LazyDict(Mapping[K, V]):
    """Lazily build a dictionary from an array of items."""

    __slots__ = ("_contents", "_dict")

    # Since Python's type system is not powerful enough to express the type of the
    # contents of the dictionary, we use specify the type as a sequence of either K or V
    # values.
    #
    # Rather than spending the runtime cost of checking the type of each item, we presume
    # that the developer has correctly used the class and that the contents are valid.
    def __init__(self, contents: Sequence[Sequence[Union[K, V]]]):
        self._contents = contents
        self._dict: Optional[Dict[K, V]] = None

    def _build_dict(self) -> Dict[K, V]:
        self._dict = {}
        for item in self._contents:
            self._dict.update(dict(zip(cast(Sequence[K], item[::2]), cast(Sequence[V], item[1::2]))))

        return self._dict

    def __getitem__(self, key: K, /) -> V:
        """Return the value for the given key."""
        source = self._dict or self._build_dict()
        return source[key]

    def __iter__(self) -> Iterator[K]:
        """Return an iterator over the keys of the dictionary."""
        source = self._dict or self._build_dict()
        return iter(source)

    def __len__(self) -> int:
        """Return the number of items in the dictionary."""
        source = self._dict or self._build_dict()
        return len(source)

    def __dict__(self) -> Dict[K, V]:  # type: ignore
        """Convert the lazy dict in a dict."""
        return self._dict or self._build_dict()

__dict__()

Convert the lazy dict in a dict.

Source code in pyiceberg/utils/lazydict.py 
70
71
72
def __dict__(self) -> Dict[K, V]:  # type: ignore
    """Convert the lazy dict in a dict."""
    return self._dict or self._build_dict()

__getitem__(key)

Return the value for the given key.

Source code in pyiceberg/utils/lazydict.py 
55
56
57
58
def __getitem__(self, key: K, /) -> V:
    """Return the value for the given key."""
    source = self._dict or self._build_dict()
    return source[key]

__iter__()

Return an iterator over the keys of the dictionary.

Source code in pyiceberg/utils/lazydict.py 
60
61
62
63
def __iter__(self) -> Iterator[K]:
    """Return an iterator over the keys of the dictionary."""
    source = self._dict or self._build_dict()
    return iter(source)

__len__()

Return the number of items in the dictionary.

Source code in pyiceberg/utils/lazydict.py 
65
66
67
68
def __len__(self) -> int:
    """Return the number of items in the dictionary."""
    source = self._dict or self._build_dict()
    return len(source)