Module `hdict.expression.step.cache`

Expand source code

#  Copyright (c) 2023. Davi Pereira dos Santos
#  This file is part of the hdict project.
#  Please respect the license - more about this in the section (*) below.
#
#  hdict is free software: you can redistribute it and/or modify
#  it under the terms of the GNU General Public License as published by
#  the Free Software Foundation, either version 3 of the License, or
#  (at your option) any later version.
#
#  hdict is distributed in the hope that it will be useful,
#  but WITHOUT ANY WARRANTY; without even the implied warranty of
#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
#  GNU General Public License for more details.
#
#  You should have received a copy of the GNU General Public License
#  along with hdict.  If not, see <http://www.gnu.org/licenses/>.
#
#  (*) Removing authorship by any means, e.g. by distribution of derived
#  works or verbatim, obfuscated, compiled or rewritten versions of any
#  part of this work is illegal and it is unethical regarding the effort and
#  time spent here.
#

from hdict.expression.step.step import AbsStep


class cache(AbsStep):
    """
    >>> from hdict import _, hdict, cache, apply
    >>> storage = {}
    >>> d = hdict(x=3, y=5) >> apply(lambda x, y: x / y).z
    >>> d.show(colored=False)
    {
        x: 3,
        y: 5,
        z: λ(x y),
        _id: IIh20mb2BGUx9XMCDwzTr4y7v-JaGin3eEHvx692,
        _ids: {
            x: KGWjj0iyLAn1RG6RTGtsGE3omZraJM6xO.kvG5pr,
            y: ecvgo-CBPi7wRWIxNzuo1HgHQCbdvR058xi6zmr2,
            z: GC-BMZNVRagHxgUynUadKUYA1kZ8GzcUj6OKWstQ
        }
    }
    >>> d >>= cache(storage)
    >>> d.show(colored=False)
    {
        x: 3,
        y: 5,
        z: ↑↓ cached at `dict`·,
        _id: IIh20mb2BGUx9XMCDwzTr4y7v-JaGin3eEHvx692,
        _ids: {
            x: KGWjj0iyLAn1RG6RTGtsGE3omZraJM6xO.kvG5pr,
            y: ecvgo-CBPi7wRWIxNzuo1HgHQCbdvR058xi6zmr2,
            z: GC-BMZNVRagHxgUynUadKUYA1kZ8GzcUj6OKWstQ
        }
    }
    >>> d.evaluate()
    >>> d.show(colored=False)
    {
        x: 3,
        y: 5,
        z: 0.6,
        _id: IIh20mb2BGUx9XMCDwzTr4y7v-JaGin3eEHvx692,
        _ids: {
            x: KGWjj0iyLAn1RG6RTGtsGE3omZraJM6xO.kvG5pr,
            y: ecvgo-CBPi7wRWIxNzuo1HgHQCbdvR058xi6zmr2,
            z: GC-BMZNVRagHxgUynUadKUYA1kZ8GzcUj6OKWstQ
        }
    }
    """

    def __init__(self, storage: dict, *fields):
        self.storage = storage
        self.fields = fields

    def __repr__(self):
        return f"↑↓`{type(self.storage).__name__}`"

Classes

class cache (storage: dict, *fields)

>>> from hdict import _, hdict, cache, apply
>>> storage = {}
>>> d = hdict(x=3, y=5) >> apply(lambda x, y: x / y).z
>>> d.show(colored=False)
{
    x: 3,
    y: 5,
    z: λ(x y),
    _id: IIh20mb2BGUx9XMCDwzTr4y7v-JaGin3eEHvx692,
    _ids: {
        x: KGWjj0iyLAn1RG6RTGtsGE3omZraJM6xO.kvG5pr,
        y: ecvgo-CBPi7wRWIxNzuo1HgHQCbdvR058xi6zmr2,
        z: GC-BMZNVRagHxgUynUadKUYA1kZ8GzcUj6OKWstQ
    }
}
>>> d >>= cache(storage)
>>> d.show(colored=False)
{
    x: 3,
    y: 5,
    z: ↑↓ cached at <code>dict</code>·,
    _id: IIh20mb2BGUx9XMCDwzTr4y7v-JaGin3eEHvx692,
    _ids: {
        x: KGWjj0iyLAn1RG6RTGtsGE3omZraJM6xO.kvG5pr,
        y: ecvgo-CBPi7wRWIxNzuo1HgHQCbdvR058xi6zmr2,
        z: GC-BMZNVRagHxgUynUadKUYA1kZ8GzcUj6OKWstQ
    }
}
>>> d.evaluate()
>>> d.show(colored=False)
{
    x: 3,
    y: 5,
    z: 0.6,
    _id: IIh20mb2BGUx9XMCDwzTr4y7v-JaGin3eEHvx692,
    _ids: {
        x: KGWjj0iyLAn1RG6RTGtsGE3omZraJM6xO.kvG5pr,
        y: ecvgo-CBPi7wRWIxNzuo1HgHQCbdvR058xi6zmr2,
        z: GC-BMZNVRagHxgUynUadKUYA1kZ8GzcUj6OKWstQ
    }
}

Expand source code

class cache(AbsStep):
    """
    >>> from hdict import _, hdict, cache, apply
    >>> storage = {}
    >>> d = hdict(x=3, y=5) >> apply(lambda x, y: x / y).z
    >>> d.show(colored=False)
    {
        x: 3,
        y: 5,
        z: λ(x y),
        _id: IIh20mb2BGUx9XMCDwzTr4y7v-JaGin3eEHvx692,
        _ids: {
            x: KGWjj0iyLAn1RG6RTGtsGE3omZraJM6xO.kvG5pr,
            y: ecvgo-CBPi7wRWIxNzuo1HgHQCbdvR058xi6zmr2,
            z: GC-BMZNVRagHxgUynUadKUYA1kZ8GzcUj6OKWstQ
        }
    }
    >>> d >>= cache(storage)
    >>> d.show(colored=False)
    {
        x: 3,
        y: 5,
        z: ↑↓ cached at `dict`·,
        _id: IIh20mb2BGUx9XMCDwzTr4y7v-JaGin3eEHvx692,
        _ids: {
            x: KGWjj0iyLAn1RG6RTGtsGE3omZraJM6xO.kvG5pr,
            y: ecvgo-CBPi7wRWIxNzuo1HgHQCbdvR058xi6zmr2,
            z: GC-BMZNVRagHxgUynUadKUYA1kZ8GzcUj6OKWstQ
        }
    }
    >>> d.evaluate()
    >>> d.show(colored=False)
    {
        x: 3,
        y: 5,
        z: 0.6,
        _id: IIh20mb2BGUx9XMCDwzTr4y7v-JaGin3eEHvx692,
        _ids: {
            x: KGWjj0iyLAn1RG6RTGtsGE3omZraJM6xO.kvG5pr,
            y: ecvgo-CBPi7wRWIxNzuo1HgHQCbdvR058xi6zmr2,
            z: GC-BMZNVRagHxgUynUadKUYA1kZ8GzcUj6OKWstQ
        }
    }
    """

    def __init__(self, storage: dict, *fields):
        self.storage = storage
        self.fields = fields

    def __repr__(self):
        return f"↑↓`{type(self.storage).__name__}`"

Classes

Ancestors