Module hoshmap.idict

Classes

class Idict (**kwargs)

>>> from hoshmap import _
>>> d = _ >> {"x":2}
>>> d.show(colored=False)
{
    x: 2,
    _id: "v2D2UVaKRzSIbUr-4rxpRYs0y0ChtLz7qDkWlwJq",
    _ids: {
        x: "k3PWYRxIEc0lEvD1f6rbnk.36RAD5AyfROy1aT29"
    }
}
>>> for k in d:
...     print(k)
x
_id
_ids
>>> "x" in d
True
>>> f = lambda x: x**2
>>> d >>= f, "->y"
>>> d.show(colored=False)
{
    x: 2,
    y: λ(x),
    _id: "opLgZ6Mu0zROyHw0mTZDfo4CjPOPWDNj06Tjf5xY",
    _ids: {
        x: "k3PWYRxIEc0lEvD1f6rbnk.36RAD5AyfROy1aT29",
        y: "FjLVN7qyJJN08OCOJyy-eMgxtm5J9jY-C8JofyUw"
    }
}
>>> d.y, d["y"]
(4, 4)
>>> (d >> (lambda w: w**2, "y:w->y")).y
16
>>> (d >> (lambda w: w**2, "y:w→y")).y   # <AltGr + y> = →
16
>>> d == {"x": 2, "y": 4}
True
>>> _ >> {"x": 3} == {"x": 3}
True
>>> from hoshmap import idict
>>> idict(x=3) == {"x": 3, "_id": idict(x=3).id}
True
>>> idict(x=3) == idict(x=3)
True
>>> idict(x=3).frozen == idict(x=3)
True
>>> idict(x=3) != {"x": 4}
True
>>> idict(x=3) != idict(x=4)
True
>>> idict(x=3).frozen != idict(x=4)
True
>>> idict(x=3) != {"y": 3}
True
>>> idict(x=3) != {"x": 3, "_id": (~idict(x=3).hosh).id}
True
>>> idict(x=3) != idict(y=3)
True
>>> d.show(colored=False)
{
    x: 2,
    y: 4,
    _id: "opLgZ6Mu0zROyHw0mTZDfo4CjPOPWDNj06Tjf5xY",
    _ids: {
        x: "k3PWYRxIEc0lEvD1f6rbnk.36RAD5AyfROy1aT29",
        y: "FjLVN7qyJJN08OCOJyy-eMgxtm5J9jY-C8JofyUw"
    }
}
>>> cache1 = {}
>>> cache2 = {}
>>> cache3 = {}
>>> def f(x, y):
...     print("Evaluated!")
...     return x * y
>>> d = idict(x=5, y=7) >> [[cache1]] >> (f, "x y→z") >> [cache2]
>>> cache1, cache2
({'A0G3Y7KNMLihDvpSJ3tB.zxshc6u1CbbiiYjCAAA': {'_ids': {'x': 'ecvgo-CBPi7wRWIxNzuo1HgHQCbdvR058xi6zmr2', 'y': 'eJCW9jGsdZTD6-AD9opKwjPIOWZ4R.T0CG2kdyzf'}}, 'ecvgo-CBPi7wRWIxNzuo1HgHQCbdvR058xi6zmr2': 5, 'eJCW9jGsdZTD6-AD9opKwjPIOWZ4R.T0CG2kdyzf': 7}, {})
>>> d.show(colored=False)
{
    x: 5,
    y: 7,
    z: λ(x y),
    _id: "1NrtWDN0QkFVOEGowa3cGm80n3djXL-WVeXrud0H",
    _ids: {
        x: "ecvgo-CBPi7wRWIxNzuo1HgHQCbdvR058xi6zmr2",
        y: "eJCW9jGsdZTD6-AD9opKwjPIOWZ4R.T0CG2kdyzf",
        z: "M-AbWXN6CXu4l2x31pFJHrif80iaSG2gcKQSk7aF"
    }
}
>>> cache1, cache2
({'A0G3Y7KNMLihDvpSJ3tB.zxshc6u1CbbiiYjCAAA': {'_ids': {'x': 'ecvgo-CBPi7wRWIxNzuo1HgHQCbdvR058xi6zmr2', 'y': 'eJCW9jGsdZTD6-AD9opKwjPIOWZ4R.T0CG2kdyzf'}}, 'ecvgo-CBPi7wRWIxNzuo1HgHQCbdvR058xi6zmr2': 5, 'eJCW9jGsdZTD6-AD9opKwjPIOWZ4R.T0CG2kdyzf': 7}, {})
>>> d.z
Evaluated!
35
>>> cache1, cache2, cache3
({'A0G3Y7KNMLihDvpSJ3tB.zxshc6u1CbbiiYjCAAA': {'_ids': {'x': 'ecvgo-CBPi7wRWIxNzuo1HgHQCbdvR058xi6zmr2', 'y': 'eJCW9jGsdZTD6-AD9opKwjPIOWZ4R.T0CG2kdyzf'}}, 'ecvgo-CBPi7wRWIxNzuo1HgHQCbdvR058xi6zmr2': 5, 'eJCW9jGsdZTD6-AD9opKwjPIOWZ4R.T0CG2kdyzf': 7}, {'1NrtWDN0QkFVOEGowa3cGm80n3djXL-WVeXrud0H': {'_ids': {'x': 'ecvgo-CBPi7wRWIxNzuo1HgHQCbdvR058xi6zmr2', 'y': 'eJCW9jGsdZTD6-AD9opKwjPIOWZ4R.T0CG2kdyzf', 'z': 'M-AbWXN6CXu4l2x31pFJHrif80iaSG2gcKQSk7aF'}}, 'M-AbWXN6CXu4l2x31pFJHrif80iaSG2gcKQSk7aF': 35}, {})
>>> e = idict(x=5, y=7) >> [cache1] >> (f, "x y→z") >> [cache3, cache2]
>>> e.show(colored=False)
{
    x: 5,
    y: 7,
    z: λ(x y),
    _id: "1NrtWDN0QkFVOEGowa3cGm80n3djXL-WVeXrud0H",
    _ids: {
        x: "ecvgo-CBPi7wRWIxNzuo1HgHQCbdvR058xi6zmr2",
        y: "eJCW9jGsdZTD6-AD9opKwjPIOWZ4R.T0CG2kdyzf",
        z: "M-AbWXN6CXu4l2x31pFJHrif80iaSG2gcKQSk7aF"
    }
}
>>> e.z
35
>>> cache3
{'1NrtWDN0QkFVOEGowa3cGm80n3djXL-WVeXrud0H': {'_ids': {'x': 'ecvgo-CBPi7wRWIxNzuo1HgHQCbdvR058xi6zmr2', 'y': 'eJCW9jGsdZTD6-AD9opKwjPIOWZ4R.T0CG2kdyzf', 'z': 'M-AbWXN6CXu4l2x31pFJHrif80iaSG2gcKQSk7aF'}}, 'M-AbWXN6CXu4l2x31pFJHrif80iaSG2gcKQSk7aF': 35}
>>> idict("1NrtWDN0QkFVOEGowa3cGm80n3djXL-WVeXrud0H", cache1 | cache3).show(colored=False)
{
    x: 5,
    y: 7,
    z: 35,
    _id: "1NrtWDN0QkFVOEGowa3cGm80n3djXL-WVeXrud0H",
    _ids: {
        x: "ecvgo-CBPi7wRWIxNzuo1HgHQCbdvR058xi6zmr2",
        y: "eJCW9jGsdZTD6-AD9opKwjPIOWZ4R.T0CG2kdyzf",
        z: "M-AbWXN6CXu4l2x31pFJHrif80iaSG2gcKQSk7aF"
    }
}

Expand source code

class Idict(Dict[str, VT]):
    """
    >>> from hoshmap import _
    >>> d = _ >> {"x":2}
    >>> d.show(colored=False)
    {
        x: 2,
        _id: "v2D2UVaKRzSIbUr-4rxpRYs0y0ChtLz7qDkWlwJq",
        _ids: {
            x: "k3PWYRxIEc0lEvD1f6rbnk.36RAD5AyfROy1aT29"
        }
    }
    >>> for k in d:
    ...     print(k)
    x
    _id
    _ids
    >>> "x" in d
    True
    >>> f = lambda x: x**2
    >>> d >>= f, "->y"
    >>> d.show(colored=False)
    {
        x: 2,
        y: λ(x),
        _id: "opLgZ6Mu0zROyHw0mTZDfo4CjPOPWDNj06Tjf5xY",
        _ids: {
            x: "k3PWYRxIEc0lEvD1f6rbnk.36RAD5AyfROy1aT29",
            y: "FjLVN7qyJJN08OCOJyy-eMgxtm5J9jY-C8JofyUw"
        }
    }
    >>> d.y, d["y"]
    (4, 4)
    >>> (d >> (lambda w: w**2, "y:w->y")).y
    16
    >>> (d >> (lambda w: w**2, "y:w→y")).y   # <AltGr + y> = →
    16
    >>> d == {"x": 2, "y": 4}
    True
    >>> _ >> {"x": 3} == {"x": 3}
    True
    >>> from hoshmap import idict
    >>> idict(x=3) == {"x": 3, "_id": idict(x=3).id}
    True
    >>> idict(x=3) == idict(x=3)
    True
    >>> idict(x=3).frozen == idict(x=3)
    True
    >>> idict(x=3) != {"x": 4}
    True
    >>> idict(x=3) != idict(x=4)
    True
    >>> idict(x=3).frozen != idict(x=4)
    True
    >>> idict(x=3) != {"y": 3}
    True
    >>> idict(x=3) != {"x": 3, "_id": (~idict(x=3).hosh).id}
    True
    >>> idict(x=3) != idict(y=3)
    True
    >>> d.show(colored=False)
    {
        x: 2,
        y: 4,
        _id: "opLgZ6Mu0zROyHw0mTZDfo4CjPOPWDNj06Tjf5xY",
        _ids: {
            x: "k3PWYRxIEc0lEvD1f6rbnk.36RAD5AyfROy1aT29",
            y: "FjLVN7qyJJN08OCOJyy-eMgxtm5J9jY-C8JofyUw"
        }
    }
    >>> cache1 = {}
    >>> cache2 = {}
    >>> cache3 = {}
    >>> def f(x, y):
    ...     print("Evaluated!")
    ...     return x * y
    >>> d = idict(x=5, y=7) >> [[cache1]] >> (f, "x y→z") >> [cache2]
    >>> cache1, cache2
    ({'A0G3Y7KNMLihDvpSJ3tB.zxshc6u1CbbiiYjCAAA': {'_ids': {'x': 'ecvgo-CBPi7wRWIxNzuo1HgHQCbdvR058xi6zmr2', 'y': 'eJCW9jGsdZTD6-AD9opKwjPIOWZ4R.T0CG2kdyzf'}}, 'ecvgo-CBPi7wRWIxNzuo1HgHQCbdvR058xi6zmr2': 5, 'eJCW9jGsdZTD6-AD9opKwjPIOWZ4R.T0CG2kdyzf': 7}, {})
    >>> d.show(colored=False)
    {
        x: 5,
        y: 7,
        z: λ(x y),
        _id: "1NrtWDN0QkFVOEGowa3cGm80n3djXL-WVeXrud0H",
        _ids: {
            x: "ecvgo-CBPi7wRWIxNzuo1HgHQCbdvR058xi6zmr2",
            y: "eJCW9jGsdZTD6-AD9opKwjPIOWZ4R.T0CG2kdyzf",
            z: "M-AbWXN6CXu4l2x31pFJHrif80iaSG2gcKQSk7aF"
        }
    }
    >>> cache1, cache2
    ({'A0G3Y7KNMLihDvpSJ3tB.zxshc6u1CbbiiYjCAAA': {'_ids': {'x': 'ecvgo-CBPi7wRWIxNzuo1HgHQCbdvR058xi6zmr2', 'y': 'eJCW9jGsdZTD6-AD9opKwjPIOWZ4R.T0CG2kdyzf'}}, 'ecvgo-CBPi7wRWIxNzuo1HgHQCbdvR058xi6zmr2': 5, 'eJCW9jGsdZTD6-AD9opKwjPIOWZ4R.T0CG2kdyzf': 7}, {})
    >>> d.z
    Evaluated!
    35
    >>> cache1, cache2, cache3
    ({'A0G3Y7KNMLihDvpSJ3tB.zxshc6u1CbbiiYjCAAA': {'_ids': {'x': 'ecvgo-CBPi7wRWIxNzuo1HgHQCbdvR058xi6zmr2', 'y': 'eJCW9jGsdZTD6-AD9opKwjPIOWZ4R.T0CG2kdyzf'}}, 'ecvgo-CBPi7wRWIxNzuo1HgHQCbdvR058xi6zmr2': 5, 'eJCW9jGsdZTD6-AD9opKwjPIOWZ4R.T0CG2kdyzf': 7}, {'1NrtWDN0QkFVOEGowa3cGm80n3djXL-WVeXrud0H': {'_ids': {'x': 'ecvgo-CBPi7wRWIxNzuo1HgHQCbdvR058xi6zmr2', 'y': 'eJCW9jGsdZTD6-AD9opKwjPIOWZ4R.T0CG2kdyzf', 'z': 'M-AbWXN6CXu4l2x31pFJHrif80iaSG2gcKQSk7aF'}}, 'M-AbWXN6CXu4l2x31pFJHrif80iaSG2gcKQSk7aF': 35}, {})
    >>> e = idict(x=5, y=7) >> [cache1] >> (f, "x y→z") >> [cache3, cache2]
    >>> e.show(colored=False)
    {
        x: 5,
        y: 7,
        z: λ(x y),
        _id: "1NrtWDN0QkFVOEGowa3cGm80n3djXL-WVeXrud0H",
        _ids: {
            x: "ecvgo-CBPi7wRWIxNzuo1HgHQCbdvR058xi6zmr2",
            y: "eJCW9jGsdZTD6-AD9opKwjPIOWZ4R.T0CG2kdyzf",
            z: "M-AbWXN6CXu4l2x31pFJHrif80iaSG2gcKQSk7aF"
        }
    }
    >>> e.z
    35
    >>> cache3
    {'1NrtWDN0QkFVOEGowa3cGm80n3djXL-WVeXrud0H': {'_ids': {'x': 'ecvgo-CBPi7wRWIxNzuo1HgHQCbdvR058xi6zmr2', 'y': 'eJCW9jGsdZTD6-AD9opKwjPIOWZ4R.T0CG2kdyzf', 'z': 'M-AbWXN6CXu4l2x31pFJHrif80iaSG2gcKQSk7aF'}}, 'M-AbWXN6CXu4l2x31pFJHrif80iaSG2gcKQSk7aF': 35}
    >>> idict("1NrtWDN0QkFVOEGowa3cGm80n3djXL-WVeXrud0H", cache1 | cache3).show(colored=False)
    {
        x: 5,
        y: 7,
        z: 35,
        _id: "1NrtWDN0QkFVOEGowa3cGm80n3djXL-WVeXrud0H",
        _ids: {
            x: "ecvgo-CBPi7wRWIxNzuo1HgHQCbdvR058xi6zmr2",
            y: "eJCW9jGsdZTD6-AD9opKwjPIOWZ4R.T0CG2kdyzf",
            z: "M-AbWXN6CXu4l2x31pFJHrif80iaSG2gcKQSk7aF"
        }
    }
    """

    # noinspection PyMissingConstructor
    def __init__(self, /, _dictionary=None, _frozen=None, **kwargs):
        from hoshmap.frozenidict import FrozenIdict

        # Build idict from id+cache.
        if isinstance(_dictionary, Hosh):
            _dictionary = Hosh.id
        if isinstance(_dictionary, str):
            if len(_dictionary) != 40:
                raise Exception(f"id should have lenght of 40, not {len(_dictionary)}")
            # TODO: checar for other types like Cache?
            if not isinstance(_frozen, (dict, Shelf, list)) and str(_frozen.__class__) not in [
                "<class 'shelchemy.core.Cache'>"
            ]:  # pragma: no cover
                raise Exception(
                    "An id argument was provided, but a dict-like cache (or list of caches) is missing as the second argument."
                )
            if kwargs:  # pragma: no cover
                raise Exception(
                    "Cannot pass more arguments when loading from cache (i.e., first argument is an id and the second argument is a dict-like cache)."
                )
            self.frozen = FrozenIdict.fromid(_dictionary, _frozen)
        else:
            self.frozen = _frozen or FrozenIdict(_dictionary, **kwargs)

    def __setitem__(self, key, value):
        if callable(value):
            if isinstance(key, tuple):
                key = ",".join(key)
            if not key.startswith("→") or not key.startswith("->"):
                key = f"→{key}"
            self.frozen = self.frozen >> (value, key)
        else:
            self.frozen = self.frozen >> {key: value}

    def __delitem__(self, key):
        from hoshmap.frozenidict import FrozenIdict

        data = self.frozen.data.copy()
        del data[key]
        del data["_id"]
        del data["_ids"]
        self.frozen = FrozenIdict(data)

    def __getitem__(self, item):
        return self.frozen[item]

    def __getattr__(self, item):
        if item in self.frozen:
            return self.frozen[item]
        return self.__getattribute__(item)

    def __rshift__(self, other):
        if isinstance(other, (Let, list, dict, tuple)):
            return (self.frozen >> other).unfrozen
        return NotImplemented

    @property
    def evaluated(self):
        return self.frozen.evaluated

    def evaluate(self):
        """
        >>> from hoshmap.value import LazyiVal
        >>> d = Idict(x=LazyiVal(lambda: 2, 0, 1, {}, {}))
        >>> d.show(colored=False)
        {
            x: λ(),
            _id: "ZGyJ22eP09N82Ry37mo4ZoZ.NDOaNQAY-4J6XYsM",
            _ids: {
                x: "B2DtWpFOLuSo46tXiP1jsfO7wH0xpFz4qgXdLjOu"
            }
        }
        >>> d.evaluate()
        >>> d.show(colored=False)
        {
            x: 2,
            _id: "ZGyJ22eP09N82Ry37mo4ZoZ.NDOaNQAY-4J6XYsM",
            _ids: {
                x: "B2DtWpFOLuSo46tXiP1jsfO7wH0xpFz4qgXdLjOu"
            }
        }
        >>> d.evaluated.show(colored=False)
        {
            x: 2,
            _id: "ZGyJ22eP09N82Ry37mo4ZoZ.NDOaNQAY-4J6XYsM",
            _ids: {
                x: "B2DtWpFOLuSo46tXiP1jsfO7wH0xpFz4qgXdLjOu"
            }
        }
        """
        self.frozen.evaluate()

    @property
    def hosh(self):
        return self.frozen.hosh

    @property
    def id(self):
        """
        >>> from hoshmap import idict
        >>> idict(x=3, y=5, _z=5).id == idict(x=3, y=5).id
        True
        """
        return self.hosh.id

    @property
    def ids(self):
        """
        >>> from hoshmap import idict
        >>> idict(x=3, y=5, _z=5).ids
        {'x': 'KGWjj0iyLAn1RG6RTGtsGE3omZraJM6xO.kvG5pr', 'y': 'ecvgo-CBPi7wRWIxNzuo1HgHQCbdvR058xi6zmr2', '_z': 'ecvgo-CBPi7wRWIxNzuo1HgHQCbdvR058xi6zmr2'}
        """
        return self.frozen.ids

    @staticmethod
    def fromdict(dictionary, ids):
        """Build an idict from values and pre-defined ids

        >>> from hosh import Hosh
        >>> from hoshmap.value import StrictiVal
        >>> print(Idict.fromdict({"x": 3, "y": 5, "z": StrictiVal(7)}, ids={"x": Hosh(b"x"), "y": Hosh(b"y").id}))
        {x: 3, y: 5, z: 7, _id: "uf--zyyiojm5Tl.vFKALuyGhZRO0e0eH9irosr0i", _ids: {x: "ue7X2I7fd9j0mLl1GjgJ2btdX1QFnb1UAQNUbFGh", y: "5yg5fDxFPxhEqzhoHgXpKyl5f078iBhd.pR0G2X0", z: "eJCW9jGsdZTD6-AD9opKwjPIOWZ4R.T0CG2kdyzf"}}
        """
        from hoshmap.frozenidict import FrozenIdict

        return FrozenIdict.fromdict(dictionary, ids).unfrozen

    @property
    def asdict(self):
        """
        >>> from hoshmap import idict
        >>> idict(x=3, y=5).asdict
        {'x': 3, 'y': 5, '_id': 'r5A2Mh6vRRO5rxi5nfXv1myeguGSTmqHuHev38qM', '_ids': {'x': 'KGWjj0iyLAn1RG6RTGtsGE3omZraJM6xO.kvG5pr', 'y': 'ecvgo-CBPi7wRWIxNzuo1HgHQCbdvR058xi6zmr2'}}
        """
        return self.frozen.asdict

    @property
    def asdicts(self):
        """
        >>> from hoshmap import idict
        >>> idict(x=3, y=5).asdict
        {'x': 3, 'y': 5, '_id': 'r5A2Mh6vRRO5rxi5nfXv1myeguGSTmqHuHev38qM', '_ids': {'x': 'KGWjj0iyLAn1RG6RTGtsGE3omZraJM6xO.kvG5pr', 'y': 'ecvgo-CBPi7wRWIxNzuo1HgHQCbdvR058xi6zmr2'}}
        """
        return self.frozen.asdicts

    def astext(self, colored=True, key_quotes=False):
        r"""
        >>> from hoshmap import idict
        >>> repr(idict(x=3, y=5)) == idict(x=3, y=5).astext()
        True
        >>> print(repr(idict(x=3, y=5)))
        {
            x: 3,
            y: 5,
            _id: r5A2Mh6vRRO5rxi5nfXv1myeguGSTmqHuHev38qM,
            _ids: {
                x: KGWjj0iyLAn1RG6RTGtsGE3omZraJM6xO.kvG5pr,
                y: ecvgo-CBPi7wRWIxNzuo1HgHQCbdvR058xi6zmr2
            }
        }
        """
        return self.frozen.astext(colored, key_quotes)

    def show(self, colored=True, key_quotes=False):
        r"""
        Textual representation of an idict object

        >>> from hoshmap import idict
        >>> from hoshmap.appearance import decolorize
        >>> d = idict(x=1,y=2)
        >>> d.show(colored=False)
        {
            x: 1,
            y: 2,
            _id: "41wHsGFMSo0vbD2n6zAXogYG9YE3FwzIRSqjWc8N",
            _ids: {
                x: "DYu5bfVvb6FOhBCWNsss4wsEWHZYTbKnsVgoWFvl",
                y: "k3PWYRxIEc0lEvD1f6rbnk.36RAD5AyfROy1aT29"
            }
        }
        """
        return self.frozen.show(colored, key_quotes)

    def __iter__(self):
        return iter(self.frozen)

    def __contains__(self, item):
        return item in self.frozen

    def __repr__(self):
        return repr(self.frozen)

    def __str__(self):
        return str(self.frozen)

    def __eq__(self, other):
        return self.frozen == other

    def __ne__(self, other):
        return not (self == other)

    def __reduce__(self):
        return self.frozen.__reduce__()

    def keys(self):
        """Generator of keys which don't start with '_'"""
        return self.frozen.keys()

    def values(self, evaluate=True):
        """Generator of field values (keys that don't start with '_')"""
        return self.frozen.values(evaluate)

    def items(self, evaluate=True):
        """Generator over field-value pairs

        Exclude ids and other items starting with '_'.

        >>> from hoshmap import idict
        >>> from hoshmap.appearance import decolorize
        >>> for k, v in idict(x=1, y=2).items():
        ...     print(k, v)
        x 1
        y 2
        """
        return self.frozen.items(evaluate)

    def metakeys(self):
        """Generator of keys which start with '_'"""
        return self.frozen.metakeys()

    def metavalues(self, evaluate=True):
        """Generator of field values (keys don't start with '_')"""
        return self.frozen.metavalues(evaluate)

    def metaitems(self, evaluate=True):
        """Generator over field-value pairs"""
        return self.frozen.metaitems(evaluate)

    def entries(self, evaluate=True):
        """Iterator over all entries

        Ignore id entries.

        >>> from hoshmap import idict
        >>> from hoshmap.appearance import decolorize
        >>> for k, v in idict(x=1, y=2).entries():
        ...     print(k, v)
        x 1
        y 2
        """
        return self.frozen.entries(evaluate)

    @property
    def fields(self):
        """
        List of keys which don't start with '_'

        >>> from hoshmap import idict
        >>> idict(x=3, y=5, _z=5).fields
        ['x', 'y']
        """
        return self.frozen.fields

    @property
    def aslist(self):
        return self.frozen.aslist

    @property
    def metafields(self):
        """
        List of keys which don't start with '_'

        >>> from hoshmap import idict
        >>> idict(x=3, y=5, _z=5).metafields
        ['_z']
        """
        return self.frozen.metafields

Ancestors

• builtins.dict
• typing.Generic

Static methods

def fromdict(dictionary, ids)

Build an idict from values and pre-defined ids

>>> from hosh import Hosh
>>> from hoshmap.value import StrictiVal
>>> print(Idict.fromdict({"x": 3, "y": 5, "z": StrictiVal(7)}, ids={"x": Hosh(b"x"), "y": Hosh(b"y").id}))
{x: 3, y: 5, z: 7, _id: "uf--zyyiojm5Tl.vFKALuyGhZRO0e0eH9irosr0i", _ids: {x: "ue7X2I7fd9j0mLl1GjgJ2btdX1QFnb1UAQNUbFGh", y: "5yg5fDxFPxhEqzhoHgXpKyl5f078iBhd.pR0G2X0", z: "eJCW9jGsdZTD6-AD9opKwjPIOWZ4R.T0CG2kdyzf"}}

Expand source code

@staticmethod
def fromdict(dictionary, ids):
    """Build an idict from values and pre-defined ids

    >>> from hosh import Hosh
    >>> from hoshmap.value import StrictiVal
    >>> print(Idict.fromdict({"x": 3, "y": 5, "z": StrictiVal(7)}, ids={"x": Hosh(b"x"), "y": Hosh(b"y").id}))
    {x: 3, y: 5, z: 7, _id: "uf--zyyiojm5Tl.vFKALuyGhZRO0e0eH9irosr0i", _ids: {x: "ue7X2I7fd9j0mLl1GjgJ2btdX1QFnb1UAQNUbFGh", y: "5yg5fDxFPxhEqzhoHgXpKyl5f078iBhd.pR0G2X0", z: "eJCW9jGsdZTD6-AD9opKwjPIOWZ4R.T0CG2kdyzf"}}
    """
    from hoshmap.frozenidict import FrozenIdict

    return FrozenIdict.fromdict(dictionary, ids).unfrozen

Instance variables

var asdict

>>> from hoshmap import idict
>>> idict(x=3, y=5).asdict
{'x': 3, 'y': 5, '_id': 'r5A2Mh6vRRO5rxi5nfXv1myeguGSTmqHuHev38qM', '_ids': {'x': 'KGWjj0iyLAn1RG6RTGtsGE3omZraJM6xO.kvG5pr', 'y': 'ecvgo-CBPi7wRWIxNzuo1HgHQCbdvR058xi6zmr2'}}

Expand source code

@property
def asdict(self):
    """
    >>> from hoshmap import idict
    >>> idict(x=3, y=5).asdict
    {'x': 3, 'y': 5, '_id': 'r5A2Mh6vRRO5rxi5nfXv1myeguGSTmqHuHev38qM', '_ids': {'x': 'KGWjj0iyLAn1RG6RTGtsGE3omZraJM6xO.kvG5pr', 'y': 'ecvgo-CBPi7wRWIxNzuo1HgHQCbdvR058xi6zmr2'}}
    """
    return self.frozen.asdict

var asdicts

>>> from hoshmap import idict
>>> idict(x=3, y=5).asdict
{'x': 3, 'y': 5, '_id': 'r5A2Mh6vRRO5rxi5nfXv1myeguGSTmqHuHev38qM', '_ids': {'x': 'KGWjj0iyLAn1RG6RTGtsGE3omZraJM6xO.kvG5pr', 'y': 'ecvgo-CBPi7wRWIxNzuo1HgHQCbdvR058xi6zmr2'}}

Expand source code

@property
def asdicts(self):
    """
    >>> from hoshmap import idict
    >>> idict(x=3, y=5).asdict
    {'x': 3, 'y': 5, '_id': 'r5A2Mh6vRRO5rxi5nfXv1myeguGSTmqHuHev38qM', '_ids': {'x': 'KGWjj0iyLAn1RG6RTGtsGE3omZraJM6xO.kvG5pr', 'y': 'ecvgo-CBPi7wRWIxNzuo1HgHQCbdvR058xi6zmr2'}}
    """
    return self.frozen.asdicts

var aslist

Expand source code

@property
def aslist(self):
    return self.frozen.aslist

var evaluated

Expand source code

@property
def evaluated(self):
    return self.frozen.evaluated

var fields

List of keys which don't start with '_'

>>> from hoshmap import idict
>>> idict(x=3, y=5, _z=5).fields
['x', 'y']

Expand source code

@property
def fields(self):
    """
    List of keys which don't start with '_'

    >>> from hoshmap import idict
    >>> idict(x=3, y=5, _z=5).fields
    ['x', 'y']
    """
    return self.frozen.fields

var hosh

Expand source code

@property
def hosh(self):
    return self.frozen.hosh

var id

>>> from hoshmap import idict
>>> idict(x=3, y=5, _z=5).id == idict(x=3, y=5).id
True

Expand source code

@property
def id(self):
    """
    >>> from hoshmap import idict
    >>> idict(x=3, y=5, _z=5).id == idict(x=3, y=5).id
    True
    """
    return self.hosh.id

var ids

>>> from hoshmap import idict
>>> idict(x=3, y=5, _z=5).ids
{'x': 'KGWjj0iyLAn1RG6RTGtsGE3omZraJM6xO.kvG5pr', 'y': 'ecvgo-CBPi7wRWIxNzuo1HgHQCbdvR058xi6zmr2', '_z': 'ecvgo-CBPi7wRWIxNzuo1HgHQCbdvR058xi6zmr2'}

Expand source code

@property
def ids(self):
    """
    >>> from hoshmap import idict
    >>> idict(x=3, y=5, _z=5).ids
    {'x': 'KGWjj0iyLAn1RG6RTGtsGE3omZraJM6xO.kvG5pr', 'y': 'ecvgo-CBPi7wRWIxNzuo1HgHQCbdvR058xi6zmr2', '_z': 'ecvgo-CBPi7wRWIxNzuo1HgHQCbdvR058xi6zmr2'}
    """
    return self.frozen.ids

var metafields

List of keys which don't start with '_'

>>> from hoshmap import idict
>>> idict(x=3, y=5, _z=5).metafields
['_z']

Expand source code

@property
def metafields(self):
    """
    List of keys which don't start with '_'

    >>> from hoshmap import idict
    >>> idict(x=3, y=5, _z=5).metafields
    ['_z']
    """
    return self.frozen.metafields

Methods

def astext(self, colored=True, key_quotes=False)

>>> from hoshmap import idict
>>> repr(idict(x=3, y=5)) == idict(x=3, y=5).astext()
True
>>> print(repr(idict(x=3, y=5)))
{
    x: 3,
    y: 5,
    _id: r5A2Mh6vRRO5rxi5nfXv1myeguGSTmqHuHev38qM,
    _ids: {
        x: KGWjj0iyLAn1RG6RTGtsGE3omZraJM6xO.kvG5pr,
        y: ecvgo-CBPi7wRWIxNzuo1HgHQCbdvR058xi6zmr2
    }
}

Expand source code

def astext(self, colored=True, key_quotes=False):
    r"""
    >>> from hoshmap import idict
    >>> repr(idict(x=3, y=5)) == idict(x=3, y=5).astext()
    True
    >>> print(repr(idict(x=3, y=5)))
    {
        x: 3,
        y: 5,
        _id: r5A2Mh6vRRO5rxi5nfXv1myeguGSTmqHuHev38qM,
        _ids: {
            x: KGWjj0iyLAn1RG6RTGtsGE3omZraJM6xO.kvG5pr,
            y: ecvgo-CBPi7wRWIxNzuo1HgHQCbdvR058xi6zmr2
        }
    }
    """
    return self.frozen.astext(colored, key_quotes)

def entries(self, evaluate=True)

Iterator over all entries

Ignore id entries.

>>> from hoshmap import idict
>>> from hoshmap.appearance import decolorize
>>> for k, v in idict(x=1, y=2).entries():
...     print(k, v)
x 1
y 2

Expand source code

def entries(self, evaluate=True):
    """Iterator over all entries

    Ignore id entries.

    >>> from hoshmap import idict
    >>> from hoshmap.appearance import decolorize
    >>> for k, v in idict(x=1, y=2).entries():
    ...     print(k, v)
    x 1
    y 2
    """
    return self.frozen.entries(evaluate)

def evaluate(self)

>>> from hoshmap.value import LazyiVal
>>> d = Idict(x=LazyiVal(lambda: 2, 0, 1, {}, {}))
>>> d.show(colored=False)
{
    x: λ(),
    _id: "ZGyJ22eP09N82Ry37mo4ZoZ.NDOaNQAY-4J6XYsM",
    _ids: {
        x: "B2DtWpFOLuSo46tXiP1jsfO7wH0xpFz4qgXdLjOu"
    }
}
>>> d.evaluate()
>>> d.show(colored=False)
{
    x: 2,
    _id: "ZGyJ22eP09N82Ry37mo4ZoZ.NDOaNQAY-4J6XYsM",
    _ids: {
        x: "B2DtWpFOLuSo46tXiP1jsfO7wH0xpFz4qgXdLjOu"
    }
}
>>> d.evaluated.show(colored=False)
{
    x: 2,
    _id: "ZGyJ22eP09N82Ry37mo4ZoZ.NDOaNQAY-4J6XYsM",
    _ids: {
        x: "B2DtWpFOLuSo46tXiP1jsfO7wH0xpFz4qgXdLjOu"
    }
}

Expand source code

def evaluate(self):
    """
    >>> from hoshmap.value import LazyiVal
    >>> d = Idict(x=LazyiVal(lambda: 2, 0, 1, {}, {}))
    >>> d.show(colored=False)
    {
        x: λ(),
        _id: "ZGyJ22eP09N82Ry37mo4ZoZ.NDOaNQAY-4J6XYsM",
        _ids: {
            x: "B2DtWpFOLuSo46tXiP1jsfO7wH0xpFz4qgXdLjOu"
        }
    }
    >>> d.evaluate()
    >>> d.show(colored=False)
    {
        x: 2,
        _id: "ZGyJ22eP09N82Ry37mo4ZoZ.NDOaNQAY-4J6XYsM",
        _ids: {
            x: "B2DtWpFOLuSo46tXiP1jsfO7wH0xpFz4qgXdLjOu"
        }
    }
    >>> d.evaluated.show(colored=False)
    {
        x: 2,
        _id: "ZGyJ22eP09N82Ry37mo4ZoZ.NDOaNQAY-4J6XYsM",
        _ids: {
            x: "B2DtWpFOLuSo46tXiP1jsfO7wH0xpFz4qgXdLjOu"
        }
    }
    """
    self.frozen.evaluate()

def items(self, evaluate=True)

Generator over field-value pairs

Exclude ids and other items starting with '_'.

>>> from hoshmap import idict
>>> from hoshmap.appearance import decolorize
>>> for k, v in idict(x=1, y=2).items():
...     print(k, v)
x 1
y 2

Expand source code

def items(self, evaluate=True):
    """Generator over field-value pairs

    Exclude ids and other items starting with '_'.

    >>> from hoshmap import idict
    >>> from hoshmap.appearance import decolorize
    >>> for k, v in idict(x=1, y=2).items():
    ...     print(k, v)
    x 1
    y 2
    """
    return self.frozen.items(evaluate)

def keys(self)

Generator of keys which don't start with '_'

Expand source code

def keys(self):
    """Generator of keys which don't start with '_'"""
    return self.frozen.keys()

def metaitems(self, evaluate=True)

Generator over field-value pairs

Expand source code

def metaitems(self, evaluate=True):
    """Generator over field-value pairs"""
    return self.frozen.metaitems(evaluate)

def metakeys(self)

Generator of keys which start with '_'

Expand source code

def metakeys(self):
    """Generator of keys which start with '_'"""
    return self.frozen.metakeys()

def metavalues(self, evaluate=True)

Generator of field values (keys don't start with '_')

Expand source code

def metavalues(self, evaluate=True):
    """Generator of field values (keys don't start with '_')"""
    return self.frozen.metavalues(evaluate)

def show(self, colored=True, key_quotes=False)

Textual representation of an idict object

>>> from hoshmap import idict
>>> from hoshmap.appearance import decolorize
>>> d = idict(x=1,y=2)
>>> d.show(colored=False)
{
    x: 1,
    y: 2,
    _id: "41wHsGFMSo0vbD2n6zAXogYG9YE3FwzIRSqjWc8N",
    _ids: {
        x: "DYu5bfVvb6FOhBCWNsss4wsEWHZYTbKnsVgoWFvl",
        y: "k3PWYRxIEc0lEvD1f6rbnk.36RAD5AyfROy1aT29"
    }
}

Expand source code

def show(self, colored=True, key_quotes=False):
    r"""
    Textual representation of an idict object

    >>> from hoshmap import idict
    >>> from hoshmap.appearance import decolorize
    >>> d = idict(x=1,y=2)
    >>> d.show(colored=False)
    {
        x: 1,
        y: 2,
        _id: "41wHsGFMSo0vbD2n6zAXogYG9YE3FwzIRSqjWc8N",
        _ids: {
            x: "DYu5bfVvb6FOhBCWNsss4wsEWHZYTbKnsVgoWFvl",
            y: "k3PWYRxIEc0lEvD1f6rbnk.36RAD5AyfROy1aT29"
        }
    }
    """
    return self.frozen.show(colored, key_quotes)

def values(self, evaluate=True)

Generator of field values (keys that don't start with '_')

Expand source code

def values(self, evaluate=True):
    """Generator of field values (keys that don't start with '_')"""
    return self.frozen.values(evaluate)