Module hosh.misc.identity

Some shortcuts to the null operand and to ease creating elements

Expand source code 
#  Copyright (c) 2021. Davi Pereira dos Santos
#  This file is part of the hosh project.
#  Please respect the license - more about this in the section (*) below.
#
#  hosh 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.
#
#  hosh 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 hosh.  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 is unethical regarding the effort and
#  time spent here.

"""Some shortcuts to the null operand and to ease creating elements"""
from hosh.groups import UT40_4
from hosh.hosh_ import Hosh


class Identity(Hosh):
    """
    Identity element

    An Identity object is an innocuous identifier that represents a real world process that does nothing,
    or an empty data structure.
    It is also useful as a shortcut to coerce some Python values directly to a Hosh object through multiplication.

    Parameters
    ----------
    version
        UT40_4, UT64.4 or other group changes the number of digits and robustness against collisions/ambiguity
    etype_inducer
        Element type of a future multiplication by a raw Python value: 'unordered', 'ordered', 'hybrid'
    """

    _u, _h = None, None

    def __init__(self, version, etype_inducer="ordered"):
        super().__init__([0, 0, 0, 0, 0, 0], version=version)
        self._etype_inducer = etype_inducer

    @property
    def u(self):
        """Shortcut to induce etype=unordered in the next operand, when it is not a ready Hosh object.
        default=Ordered, h=Hybrid and u=Unordered

        Usage:

        >>> from hosh import ø, Hosh
        >>> a = ø.u * b"654"
        >>> print(a)
        9_6a78c0056_____________________________
        >>> Hosh(b"654", "unordered") == a
        True
        """
        if self._u is None:
            self._u = Identity(self.version, etype_inducer="unordered")
        return self._u

    @property
    def h(self):
        """Shortcut to induce etype=hybrid in the next operand, when it is given as a bytes object.
        default=Ordered, h=Hybrid and u=Unordered

        Usage:

        >>> from hosh import Hosh, ø
        >>> a = ø.h * b"654"
        >>> print(a)
        eW_aebeb57cf1455dccdc1bd990950a03b0f2e29
        >>> Hosh(b"654", "hybrid") == a
        True
        """
        if self._h is None:
            self._h = Identity(self.version, etype_inducer="hybrid")
        return self._h


class ø(Identity):
    """
    40-digit identity element

    An Identity object is an innocuous identifier that represents a real world process that does nothing,
    or an empty data structure.
    It is also useful as a shortcut to coerce some Python values directly to a Hosh object through multiplication.

    Normal usage (as an already instantiated object:

    >>> from hosh import ø
    >>> ø.id
    '0000000000000000000000000000000000000000'
    >>> print(ø * 872696823986235926596245)
    00_dea47151b84085dfcc8b00000000000000000

    Parameters
    ----------
    etype_inducer
        Element type of a future multiplication by a raw Python value: 'unordered', 'ordered', 'hybrid'
    """

    def __init__(self, etype_inducer="ordered"):
        super().__init__(UT40_4, etype_inducer)


# class Ø(Identity):
#     """
#     64-digit identity element
#
#     An Identity object is an innocuous identifier that represents a real world process that does nothing,
#     or an empty data structure.
#     It is also useful as a shortcut to coerce some Python values directly to a Hosh object through multiplication.
#
#     Normal usage (as an already instantiated object:
#
#     >>> from hosh import Ø
#     >>> Ø.id
#     '0000000000000000000000000000000000000000000000000000000000000000'
#     >>> print(Ø * 872696823986235926596245)
#     00_00000000000000000000000000000000000000000b8cbfd58058b15174ad1
#
#     Parameters
#     ----------
#     etype_inducer
#         Element type of a future multiplication by a raw Python value: 'unordered', 'ordered', 'hybrid'
#     """
#
#     def __init__(self, etype_inducer="ordered"):
#         super().__init__("UT64.4", etype_inducer)

Classes

class Identity (version, etype_inducer='ordered')

Identity element

An Identity object is an innocuous identifier that represents a real world process that does nothing, or an empty data structure. It is also useful as a shortcut to coerce some Python values directly to a Hosh object through multiplication.

Parameters

version
UT40_4, UT64.4 or other group changes the number of digits and robustness against collisions/ambiguity
etype_inducer
Element type of a future multiplication by a raw Python value: 'unordered', 'ordered', 'hybrid'
Expand source code 
class Identity(Hosh):
    """
    Identity element

    An Identity object is an innocuous identifier that represents a real world process that does nothing,
    or an empty data structure.
    It is also useful as a shortcut to coerce some Python values directly to a Hosh object through multiplication.

    Parameters
    ----------
    version
        UT40_4, UT64.4 or other group changes the number of digits and robustness against collisions/ambiguity
    etype_inducer
        Element type of a future multiplication by a raw Python value: 'unordered', 'ordered', 'hybrid'
    """

    _u, _h = None, None

    def __init__(self, version, etype_inducer="ordered"):
        super().__init__([0, 0, 0, 0, 0, 0], version=version)
        self._etype_inducer = etype_inducer

    @property
    def u(self):
        """Shortcut to induce etype=unordered in the next operand, when it is not a ready Hosh object.
        default=Ordered, h=Hybrid and u=Unordered

        Usage:

        >>> from hosh import ø, Hosh
        >>> a = ø.u * b"654"
        >>> print(a)
        9_6a78c0056_____________________________
        >>> Hosh(b"654", "unordered") == a
        True
        """
        if self._u is None:
            self._u = Identity(self.version, etype_inducer="unordered")
        return self._u

    @property
    def h(self):
        """Shortcut to induce etype=hybrid in the next operand, when it is given as a bytes object.
        default=Ordered, h=Hybrid and u=Unordered

        Usage:

        >>> from hosh import Hosh, ø
        >>> a = ø.h * b"654"
        >>> print(a)
        eW_aebeb57cf1455dccdc1bd990950a03b0f2e29
        >>> Hosh(b"654", "hybrid") == a
        True
        """
        if self._h is None:
            self._h = Identity(self.version, etype_inducer="hybrid")
        return self._h

Ancestors

Subclasses

Instance variables

var h

Shortcut to induce etype=hybrid in the next operand, when it is given as a bytes object. default=Ordered, h=Hybrid and u=Unordered

Usage:

>>> from hosh import Hosh, ø
>>> a = ø.h * b"654"
>>> print(a)
eW_aebeb57cf1455dccdc1bd990950a03b0f2e29
>>> Hosh(b"654", "hybrid") == a
True
Expand source code 
@property
def h(self):
    """Shortcut to induce etype=hybrid in the next operand, when it is given as a bytes object.
    default=Ordered, h=Hybrid and u=Unordered

    Usage:

    >>> from hosh import Hosh, ø
    >>> a = ø.h * b"654"
    >>> print(a)
    eW_aebeb57cf1455dccdc1bd990950a03b0f2e29
    >>> Hosh(b"654", "hybrid") == a
    True
    """
    if self._h is None:
        self._h = Identity(self.version, etype_inducer="hybrid")
    return self._h
var u

Shortcut to induce etype=unordered in the next operand, when it is not a ready Hosh object. default=Ordered, h=Hybrid and u=Unordered

Usage:

>>> from hosh import ø, Hosh
>>> a = ø.u * b"654"
>>> print(a)
9_6a78c0056_____________________________
>>> Hosh(b"654", "unordered") == a
True
Expand source code 
@property
def u(self):
    """Shortcut to induce etype=unordered in the next operand, when it is not a ready Hosh object.
    default=Ordered, h=Hybrid and u=Unordered

    Usage:

    >>> from hosh import ø, Hosh
    >>> a = ø.u * b"654"
    >>> print(a)
    9_6a78c0056_____________________________
    >>> Hosh(b"654", "unordered") == a
    True
    """
    if self._u is None:
        self._u = Identity(self.version, etype_inducer="unordered")
    return self._u

Inherited members

class ø (etype_inducer='ordered')

40-digit identity element

An Identity object is an innocuous identifier that represents a real world process that does nothing, or an empty data structure. It is also useful as a shortcut to coerce some Python values directly to a Hosh object through multiplication.

Normal usage (as an already instantiated object:

>>> from hosh import ø
>>> ø.id
'0000000000000000000000000000000000000000'
>>> print(ø * 872696823986235926596245)
00_dea47151b84085dfcc8b00000000000000000

Parameters

etype_inducer
Element type of a future multiplication by a raw Python value: 'unordered', 'ordered', 'hybrid'
Expand source code 
class ø(Identity):
    """
    40-digit identity element

    An Identity object is an innocuous identifier that represents a real world process that does nothing,
    or an empty data structure.
    It is also useful as a shortcut to coerce some Python values directly to a Hosh object through multiplication.

    Normal usage (as an already instantiated object:

    >>> from hosh import ø
    >>> ø.id
    '0000000000000000000000000000000000000000'
    >>> print(ø * 872696823986235926596245)
    00_dea47151b84085dfcc8b00000000000000000

    Parameters
    ----------
    etype_inducer
        Element type of a future multiplication by a raw Python value: 'unordered', 'ordered', 'hybrid'
    """

    def __init__(self, etype_inducer="ordered"):
        super().__init__(UT40_4, etype_inducer)

Ancestors

Inherited members