xloft 0.5.1__py3-none-any.whl → 0.9.6__py3-none-any.whl

xloft/__init__.py

@@ -1,17 +1,35 @@
-"""(XLOFT) X-Library of tools.
-
-Modules exported by this package:
-
-- `namedtuple`- Class imitates the behavior of the _named tuple_.
-- `human` - A collection of instruments for converting data to format is convenient for humans.
-"""
-
-from __future__ import annotations
-
-__all__ = (
-    "to_human_size",
-    "NamedTuple",
-)
-
-from xloft.human import to_human_size
-from xloft.namedtuple import NamedTuple
+#  ____  ____  _____       ___   ________  _________
+# |_  _||_  _||_   _|    .'   `.|_   __  ||  _   _  |
+#   \ \  / /    | |     /  .-.  \ | |_ \_||_/ | | \_|
+#    > `' <     | |   _ | |   | | |  _|       | |
+#  _/ /'`\ \_  _| |__/ |\  `-'  /_| |_       _| |_
+# |____||____||________| `.___.'|_____|     |_____|
+#
+#
+# Copyright (c) 2025 Gennady Kostyunin
+# XLOFT is free software under terms of the MIT License.
+# Repository https://github.com/kebasyaty/xloft
+#
+"""(XLOFT) X-Library of tools.
+
+Modules exported by this package:
+
+- `namedtuple`- Class imitates the behavior of the _named tuple_.
+- `converters` - Collection of tools for converting data.
+- `itis` - Tools for determining something.
+"""
+
+from __future__ import annotations
+
+__all__ = (
+    "int_to_roman",
+    "roman_to_int",
+    "to_human_size",
+    "is_number",
+    "is_palindrome",
+    "NamedTuple",
+)
+
+from xloft.converters import int_to_roman, roman_to_int, to_human_size
+from xloft.itis import is_number, is_palindrome
+from xloft.namedtuple import NamedTuple

xloft/converters/__init__.py

@@ -0,0 +1,19 @@
+"""Collection of tools for converting data.
+
+The module contains the following functions:
+
+- `to_human_size(n_bytes)` - Returns a humanized string: 200 bytes | 1 KB | 1.5 MB etc.
+- `int_to_roman` - Convert an integer to Roman.
+- `roman_to_int` - Convert to integer from Roman.
+"""
+
+from __future__ import annotations
+
+__all__ = (
+    "to_human_size",
+    "int_to_roman",
+    "roman_to_int",
+)
+
+from xloft.converters.human_size import to_human_size
+from xloft.converters.roman import int_to_roman, roman_to_int

xloft/converters/human_size.py

@@ -0,0 +1,39 @@
+"""Converts the number of bytes into a human-readable format.
+
+The module contains the following functions:
+
+- `to_human_size(n_bytes)` - Returns a humanized string: 200 bytes | 1 KB | 1.5 MB etc.
+"""
+
+from __future__ import annotations
+
+__all__ = ("to_human_size",)
+
+import math
+
+
+def to_human_size(n_bytes: int) -> str:
+    """Converts the number of bytes into a human-readable format.
+
+    Examples:
+        >>> from xloft import to_human_size
+        >>> to_human_size(200)
+        200 bytes
+        >>> to_human_size(1048576)
+        1 MB
+        >>> to_human_size(1048575)
+        1023.999 KB
+
+    Args:
+        n_bytes: The number of bytes.
+
+    Returns:
+        Returns a humanized string: 200 bytes | 1 KB | 1.5 MB etc.
+    """
+    idx: int = math.floor(math.log(n_bytes) / math.log(1024))
+    ndigits: int = [0, 3, 6, 9, 12][idx]
+    human_size: int | float = n_bytes if n_bytes < 1024 else abs(round(n_bytes / pow(1024, idx), ndigits))
+    order = ["bytes", "KB", "MB", "GB", "TB"][idx]
+    if math.modf(human_size)[0] == 0.0:
+        human_size = int(human_size)
+    return f"{human_size} {order}"

xloft/converters/roman.py

@@ -0,0 +1,116 @@
+"""Convert an integer to Roman and vice versa.
+
+The module contains the following functions:
+
+- `int_to_roman` - Convert an integer to Roman.
+- `roman_to_int` - Convert to integer from Roman.
+"""
+
+from __future__ import annotations
+
+__all__ = (
+    "int_to_roman",
+    "roman_to_int",
+)
+
+ROMAN = [
+    (1000, "M"),
+    (900, "CM"),
+    (500, "D"),
+    (400, "CD"),
+    (100, "C"),
+    (90, "XC"),
+    (50, "L"),
+    (40, "XL"),
+    (10, "X"),
+    (9, "IX"),
+    (5, "V"),
+    (4, "IV"),
+    (1, "I"),
+]
+
+
+def int_to_roman(number: int) -> str:
+    """Convert an integer to Roman.
+
+    Examples:
+        >>> from xloft import int_to_roman
+        >>> int_to_roman(1994)
+        MCMXCIV
+
+    Args:
+        number (int): Integer.
+
+    Returns:
+        Roman numeral string.
+    """
+    result = ""
+    for arabic, roman in ROMAN:
+        (factor, number) = divmod(number, arabic)
+        result += roman * factor
+    return result
+
+
+def roman_to_int(roman: str) -> int:
+    """Convert to integer from Roman.
+
+    Examples:
+        >>> from xloft import roman_to_int
+        >>> roman_to_int("MCMXCIV")
+        1994
+
+    Args:
+        roman (str): Roman numeral string.
+
+    Returns:
+        Integer.
+    """
+    i_count = roman.count("I")
+    v_count = roman.count("V")
+    x_count = roman.count("X")
+    l_count = roman.count("L")
+    c_count = roman.count("C")
+    d_count = roman.count("D")
+    m_count = roman.count("M")
+
+    iv_count = roman.count("IV")
+    i_count -= iv_count
+    v_count -= iv_count
+
+    ix_count = roman.count("IX")
+    i_count -= ix_count
+    x_count -= ix_count
+
+    xl_count = roman.count("XL")
+    x_count -= xl_count
+    l_count -= xl_count
+
+    xc_count = roman.count("XC")
+    x_count -= xc_count
+    c_count -= xc_count
+
+    cd_count = roman.count("CD")
+    c_count -= cd_count
+    d_count -= cd_count
+
+    cm_count = roman.count("CM")
+    c_count -= cm_count
+    m_count -= cm_count
+
+    total = 0
+    total += 1 * i_count
+    total += 5 * v_count
+    total += 10 * x_count
+    total += 50 * l_count
+    total += 100 * c_count
+    total += 500 * d_count
+    total += 1000 * m_count
+
+    total += 4 * iv_count
+    total += 9 * ix_count
+    total += 40 * xl_count
+    total += 90 * xc_count
+    total += 400 * cd_count
+    total += 900 * cm_count
+
+    return total

xloft/errors.py

@@ -1,26 +1,32 @@
-"""XLOT Exceptions."""
-
-from __future__ import annotations
-
-
-class XLOTException(Exception):
-    """Root Custom Exception."""
-
-    def __init__(self, *args, **kwargs) -> None:  # type: ignore[no-untyped-def]# noqa: D107
-        super().__init__(*args, **kwargs)
-
-
-class AttributeDoesNotSetValue(XLOTException):
-    """Exception is raised if the attribute does not setting value."""
-
-    def __init__(self, attribute_name: str) -> None:  # noqa: D107
-        self.message = f"The attribute `{attribute_name}` does not setting value!"
-        super().__init__(self.message)
-
-
-class AttributeCannotBeDelete(XLOTException):
-    """Exception is raised if the attribute cannot be delete."""
-
-    def __init__(self, attribute_name: str) -> None:  # noqa: D107
-        self.message = f"The attribute `{attribute_name}` cannot be delete!"
-        super().__init__(self.message)
+"""XLOT Exceptions."""
+
+from __future__ import annotations
+
+__all__ = (
+    "XLOTException",
+    "AttributeDoesNotSetValueError",
+    "AttributeCannotBeDeleteError",
+)
+
+
+class XLOTException(Exception):
+    """Root Custom Exception."""
+
+    def __init__(self, *args, **kwargs) -> None:  # type: ignore[no-untyped-def]# noqa: D107
+        super().__init__(*args, **kwargs)
+
+
+class AttributeDoesNotSetValueError(XLOTException):
+    """Exception is raised if the attribute does not setting value."""
+
+    def __init__(self, attribute_name: str) -> None:  # noqa: D107
+        self.message = f"The attribute `{attribute_name}` does not setting value!"
+        super().__init__(self.message)
+
+
+class AttributeCannotBeDeleteError(XLOTException):
+    """Exception is raised if the attribute cannot be delete."""
+
+    def __init__(self, attribute_name: str) -> None:  # noqa: D107
+        self.message = f"The attribute `{attribute_name}` cannot be delete!"
+        super().__init__(self.message)

xloft/itis.py

@@ -0,0 +1,60 @@
+"""Tools for determining something.
+
+The module contains the following functions:
+
+- `is_number` - Check if a string is a number.
+- `is_palindrome` - Check if a string is a palindrome.
+"""
+
+from __future__ import annotations
+
+__all__ = (
+    "is_number",
+    "is_palindrome",
+)
+
+
+def is_number(value: str) -> bool:
+    """Check if a string is a number.
+
+    Only decimal numbers.
+
+    Examples:
+        >>> from xloft import is_number
+        >>> is_number("123")
+        True
+
+    Args:
+        value (str): Some kind of string.
+
+    Returns:
+        True, if the string is a number.
+    """
+    try:
+        float(value)
+        return True
+    except ValueError:
+        return False
+
+
+def is_palindrome(value: str) -> bool:
+    """Check if a string is a palindrome.
+
+    Examples:
+        >>> from xloft import is_palindrome
+        >>> is_palindrome("Go hang a salami, I'm a lasagna hog")
+        True
+
+    Args:
+        value (str): Alpha-numeric string.
+
+    Returns:
+        Boolean value.
+    """
+    if not isinstance(value, str):
+        raise TypeError("The value is not a string!")
+    if not len(value):
+        raise ValueError("The string must not be empty!")
+    string_list = [char.lower() for char in value if char.isalnum()]
+    reverse_list = string_list[::-1]
+    return reverse_list == string_list

xloft/namedtuple.py

@@ -1,257 +1,206 @@
-"""This module contains the implementation of the `NamedTuple` class.
-
-`NamedTuple` class imitates the behavior of the _named tuple_.
-
-Examples:
-    >>> from xloft import NamedTuple
-    >>> nt = NamedTuple(x=10, y="Hello", _id="507c7f79bcf86cd7994f6c0e")
-    >>> nt.x
-    10
-    >>> nt.y
-    Hello
-    >>> nt._id
-    507c7f79bcf86cd7994f6c0e
-    >>> nt.z
-    KeyError
-    >>> len(nt)
-    3
-    >>> nt.keys()
-    ["x", "y", "_id"]
-    >>> nt.values()
-    [10, "Hello", "507c7f79bcf86cd7994f6c0e"]
-    >>> nt.has_key("x")
-    True
-    >>> nt.has_key("z")
-    False
-    >>> nt.has_value(10)
-    True
-    >>> nt.has_value([1, 2, 3])
-    False
-    >>> nt.get("x")
-    10
-    >>> nt.get("z")
-    None
-    >>> d = nt.to_dict()
-    >>> d["x"]
-    10
-    >>> for key, val in nt.items():
-    ...     print(f"Key: {key}, Value: {val}")
-    "Key: x, Value: 10"
-    "Key: y, Value: Hello"
-    "Key: _id, value: 507c7f79bcf86cd7994f6c0e"
-    >>> nt.update("x", 20)
-    >>> nt.x
-    20
-    >>> nt.update("z", [1, 2, 3])
-    KeyError
-    >>> nt["z"] = [1, 2, 3]
-    TypeError
-    >>> nt.x = 20
-    Error: AttributeDoesNotSetValue
-    >>> del nt.x
-    Error: AttributeCannotBeDelete
-"""
-
-from __future__ import annotations
-
-from typing import Any
-
-from xloft.errors import (
-    AttributeCannotBeDelete,
-    AttributeDoesNotSetValue,
-)
-
-
-class NamedTuple:
-    """This class imitates the behavior of the _named tuple_."""
-
-    def __init__(self, **kwargs: dict[str, Any]) -> None:  # noqa: D107
-        self.__dict__["_jWjSaNy1RbtQinsN_keys"] = []
-        for name, value in kwargs.items():
-            self.__dict__[name] = value
-            self._jWjSaNy1RbtQinsN_keys.append(name)
-
-    def __len__(self) -> int:
-        """Get the number of elements.
-
-        Examples:
-            >>> from xloft import NamedTuple
-            >>> nt = NamedTuple(x=10, y="Hello")
-            >>> len(nt)
-            2
-
-        Returns:
-            The number of elements in the tuple.
-        """
-        return len(self._jWjSaNy1RbtQinsN_keys)
-
-    def __getattr__(self, name: str) -> Any:
-        """Getter.
-
-        Examples:
-            >>> from xloft import NamedTuple
-            >>> nt = NamedTuple(x=10, y="Hello")
-            >>> nt.x
-            10
-
-        Args:
-            name: Key name.
-
-        Returns:
-            Value of key.
-        """
-        return self.__dict__[name]
-
-    def __setattr__(self, name: str, value: Any) -> None:
-        """Blocked Setter."""
-        raise AttributeDoesNotSetValue(name)
-
-    def __delattr__(self, name: str) -> None:
-        """Blocked Deleter."""
-        raise AttributeCannotBeDelete(name)
-
-    def get(self, key: str) -> Any:
-        """Return the value for key if key is in the dictionary, else `None`.
-
-        Args:
-            key: Key name.
-
-        Examples:
-            >>> from xloft import NamedTuple
-            >>> nt = NamedTuple(x=10, y="Hello")
-            >>> nt.get("x")
-            10
-
-        Returns:
-            Value of key.
-        """
-        value = self.__dict__.get(key)
-        if value is not None:
-            return value
-        return None
-
-    def update(self, key: str, value: Any) -> None:
-        """Update a value of key.
-
-        Attention: This is an uncharacteristic action for the type `tuple`.
-
-        Args:
-            key: Key name.
-            value: Value of key.
-
-        Examples:
-            >>> from xloft import NamedTuple
-            >>> nt = NamedTuple(x=10, y="Hello")
-            >>> nt.update("x", 20)
-            >>> nt.x
-            20
-
-        Returns:
-            None
-        """
-        keys: list[str] = self._jWjSaNy1RbtQinsN_keys
-        if key not in keys:
-            err_msg = f"The key `{key}` is missing!"
-            raise KeyError(err_msg)
-        self.__dict__[key] = value
-
-    def to_dict(self) -> dict[str, Any]:
-        """Convert to the dictionary.
-
-        Examples:
-            >>> from xloft import NamedTuple
-            >>> nt = NamedTuple(x=10, y="Hello")
-            >>> d = nt.to_dict()
-            >>> d["x"]
-            10
-
-        Returns:
-            Dictionary with keys and values of the tuple.
-        """
-        attrs: dict[str, Any] = self.__dict__
-        keys: list[str] = self._jWjSaNy1RbtQinsN_keys
-        return {key: attrs[key] for key in keys}
-
-    def items(self) -> list[tuple[str, Any]]:
-        """Return a set-like object providing a view on the NamedTuple's items.
-
-        Examples:
-            >>> from xloft import NamedTuple
-            >>> nt = NamedTuple(x=10, y="Hello")
-            >>> for key, val in nt.items():
-            ...     print(f"Key: {key}, Value: {val}")
-            "Key: x, Value: 10"
-            "Key: y, Value: Hello"
-
-        Returns:
-            list[tuple[str, Any]]
-        """
-        attrs: dict[str, Any] = self.__dict__
-        keys: list[str] = self._jWjSaNy1RbtQinsN_keys
-        return [(key, attrs[key]) for key in keys]
-
-    def keys(self) -> list[str]:
-        """Get a list of keys.
-
-        Examples:
-            >>> from xloft import NamedTuple
-            >>> nt = NamedTuple(x=10, y="Hello")
-            >>> nt.keys()
-            ["x", "y"]
-
-        Returns:
-            List of keys.
-        """
-        return self._jWjSaNy1RbtQinsN_keys
-
-    def values(self) -> list[Any]:
-        """Get a list of values.
-
-        Examples:
-            >>> from xloft import NamedTuple
-            >>> nt = NamedTuple(x=10, y="Hello")
-            >>> nt.values()
-            [10, "Hello"]
-
-        Returns:
-            List of values.
-        """
-        attrs: dict[str, Any] = self.__dict__
-        keys: list[str] = self._jWjSaNy1RbtQinsN_keys
-        return [attrs[key] for key in keys]
-
-    def has_key(self, key: str) -> bool:
-        """Returns True if the key exists, otherwise False.
-
-        Args:
-            key: Key name.
-
-        Examples:
-            >>> from xloft import NamedTuple
-            >>> nt = NamedTuple(x=10, y="Hello")
-            >>> nt.has_key("x")
-            True
-
-        Returns:
-            True if the key exists, otherwise False.
-        """
-        keys: list[str] = self._jWjSaNy1RbtQinsN_keys
-        return key in keys
-
-    def has_value(self, value: Any) -> bool:
-        """Returns True if the value exists, otherwise False.
-
-        Args:
-            value: Value of key.
-
-        Examples:
-            >>> from xloft import NamedTuple
-            >>> nt = NamedTuple(x=10, y="Hello")
-            >>> nt.has_value(10)
-            True
-
-        Returns:
-            True if the value exists, otherwise False.
-        """
-        values = self.values()
-        return value in values
+"""This module contains the implementation of the `NamedTuple` class.
+
+`NamedTuple` class imitates the behavior of the *named tuple*.
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+from xloft.errors import (
+    AttributeCannotBeDeleteError,
+    AttributeDoesNotSetValueError,
+)
+
+
+class NamedTuple:
+    """This class imitates the behavior of the `named tuple`."""
+
+    def __init__(self, **kwargs: dict[str, Any]) -> None:  # noqa: D107
+        self.__dict__["_0D5rSmH9Sy2XUWb5_keys"] = []
+        for name, value in kwargs.items():
+            self.__dict__[name] = value
+            self._0D5rSmH9Sy2XUWb5_keys.append(name)
+
+    def __len__(self) -> int:
+        """Get the number of elements.
+
+        Examples:
+            >>> from xloft import NamedTuple
+            >>> nt = NamedTuple(x=10, y="Hello")
+            >>> len(nt)
+            2
+
+        Returns:
+            The number of elements in the tuple.
+        """
+        return len(self._0D5rSmH9Sy2XUWb5_keys)
+
+    def __getattr__(self, name: str) -> Any:
+        """Getter.
+
+        Examples:
+            >>> from xloft import NamedTuple
+            >>> nt = NamedTuple(x=10, y="Hello")
+            >>> nt.x
+            10
+
+        Args:
+            name: Key name.
+
+        Returns:
+            Value of key.
+        """
+        return self.__dict__[name]
+
+    def __setattr__(self, name: str, value: Any) -> None:
+        """Blocked Setter."""
+        raise AttributeDoesNotSetValueError(name)
+
+    def __delattr__(self, name: str) -> None:
+        """Blocked Deleter."""
+        raise AttributeCannotBeDeleteError(name)
+
+    def get(self, key: str) -> Any:
+        """Return the value for key if key is in the dictionary, else `None`.
+
+        Args:
+            key: Key name.
+
+        Examples:
+            >>> from xloft import NamedTuple
+            >>> nt = NamedTuple(x=10, y="Hello")
+            >>> nt.get("x")
+            10
+
+        Returns:
+            Value of key.
+        """
+        value = self.__dict__.get(key)
+        if value is not None:
+            return value
+        return None
+
+    def update(self, key: str, value: Any) -> None:
+        """Update a value of key.
+
+        Attention: This is an uncharacteristic action for the type `tuple`.
+
+        Args:
+            key: Key name.
+            value: Value of key.
+
+        Examples:
+            >>> from xloft import NamedTuple
+            >>> nt = NamedTuple(x=10, y="Hello")
+            >>> nt.update("x", 20)
+            >>> nt.x
+            20
+
+        Returns:
+            None
+        """
+        keys: list[str] = self._0D5rSmH9Sy2XUWb5_keys
+        if key not in keys:
+            err_msg = f"The key `{key}` is missing!"
+            raise KeyError(err_msg)
+        self.__dict__[key] = value
+
+    def to_dict(self) -> dict[str, Any]:
+        """Convert to the dictionary.
+
+        Examples:
+            >>> from xloft import NamedTuple
+            >>> nt = NamedTuple(x=10, y="Hello")
+            >>> d = nt.to_dict()
+            >>> d["x"]
+            10
+
+        Returns:
+            Dictionary with keys and values of the tuple.
+        """
+        attrs: dict[str, Any] = self.__dict__
+        keys: list[str] = self._0D5rSmH9Sy2XUWb5_keys
+        return {key: attrs[key] for key in keys}
+
+    def items(self) -> list[tuple[str, Any]]:
+        """Return a set-like object providing a view on the NamedTuple's items.
+
+        Examples:
+            >>> from xloft import NamedTuple
+            >>> nt = NamedTuple(x=10, y="Hello")
+            >>> for key, val in nt.items():
+            ...     print(f"Key: {key}, Value: {val}")
+            "Key: x, Value: 10"
+            "Key: y, Value: Hello"
+
+        Returns:
+            list[tuple[str, Any]]
+        """
+        attrs: dict[str, Any] = self.__dict__
+        keys: list[str] = self._0D5rSmH9Sy2XUWb5_keys
+        return [(key, attrs[key]) for key in keys]
+
+    def keys(self) -> list[str]:
+        """Get a list of keys.
+
+        Examples:
+            >>> from xloft import NamedTuple
+            >>> nt = NamedTuple(x=10, y="Hello")
+            >>> nt.keys()
+            ["x", "y"]
+
+        Returns:
+            List of keys.
+        """
+        return self._0D5rSmH9Sy2XUWb5_keys.copy()
+
+    def values(self) -> list[Any]:
+        """Get a list of values.
+
+        Examples:
+            >>> from xloft import NamedTuple
+            >>> nt = NamedTuple(x=10, y="Hello")
+            >>> nt.values()
+            [10, "Hello"]
+
+        Returns:
+            List of values.
+        """
+        attrs: dict[str, Any] = self.__dict__
+        keys: list[str] = self._0D5rSmH9Sy2XUWb5_keys
+        return [attrs[key] for key in keys]
+
+    def has_key(self, key: str) -> bool:
+        """Returns True if the key exists, otherwise False.
+
+        Args:
+            key: Key name.
+
+        Examples:
+            >>> from xloft import NamedTuple
+            >>> nt = NamedTuple(x=10, y="Hello")
+            >>> nt.has_key("x")
+            True
+
+        Returns:
+            True if the key exists, otherwise False.
+        """
+        return key in self._0D5rSmH9Sy2XUWb5_keys
+
+    def has_value(self, value: Any) -> bool:
+        """Returns True if the value exists, otherwise False.
+
+        Args:
+            value: Value of key.
+
+        Examples:
+            >>> from xloft import NamedTuple
+            >>> nt = NamedTuple(x=10, y="Hello")
+            >>> nt.has_value(10)
+            True
+
+        Returns:
+            True if the value exists, otherwise False.
+        """
+        return value in self.values()

{xloft-0.5.1.dist-info → xloft-0.9.6.dist-info}/METADATA

@@ -1,8 +1,8 @@
 Metadata-Version: 2.4
 Name: xloft
-Version: 0.5.1
+Version: 0.9.6
 Summary: (XLOFT) X-Library of tools
-Project-URL: Homepage, https://github.com/kebasyaty/xloft
+Project-URL: Homepage, https://kebasyaty.github.io/xloft/
 Project-URL: Repository, https://github.com/kebasyaty/xloft
 Project-URL: Source, https://github.com/kebasyaty/xloft
 Project-URL: Bug Tracker, https://github.com/kebasyaty/xloft/issues
@@ -17,10 +17,12 @@ Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: MacOS :: MacOS X
 Classifier: Operating System :: Microsoft :: Windows
 Classifier: Operating System :: POSIX
+Classifier: Operating System :: POSIX :: Linux
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Topic :: Software Development :: Libraries
 Classifier: Topic :: Utilities
@@ -47,21 +49,14 @@ Description-Content-Type: text/markdown
       <a href="https://pypi.python.org/pypi/xloft/" alt="PyPI status"><img src="https://img.shields.io/pypi/status/xloft.svg" alt="PyPI status"></a>
       <a href="https://pypi.python.org/pypi/xloft/" alt="PyPI version fury.io"><img src="https://badge.fury.io/py/xloft.svg" alt="PyPI version fury.io"></a>
       <br>
-      <a href="https://github.com/kebasyaty/xloft/issues"><img src="https://img.shields.io/github/issues/kebasyaty/xloft.svg" alt="GitHub issues"></a>
-      <a href="https://pepy.tech/projects/xloft"><img src="https://static.pepy.tech/badge/xloft" alt="PyPI Downloads"></a>
-      <a href="https://github.com/kebasyaty/xloft/blob/main/LICENSE" alt="GitHub license"><img src="https://img.shields.io/github/license/kebasyaty/xloft" alt="GitHub license"></a>
-      <a href="https://mypy-lang.org/" alt="Types: Mypy"><img src="https://img.shields.io/badge/types-Mypy-202235.svg?color=0c7ebf" alt="Types: Mypy"></a>
+      <a href="https://pyrefly.org/" alt="Types: Pyrefly"><img src="https://img.shields.io/badge/types-Pyrefly-FFB74D.svg" alt="Types: Pyrefly"></a>
       <a href="https://docs.astral.sh/ruff/" alt="Code style: Ruff"><img src="https://img.shields.io/badge/code%20style-Ruff-FDD835.svg" alt="Code style: Ruff"></a>
-      <a href="https://github.com/kebasyaty/xloft" alt="PyPI implementation"><img src="https://img.shields.io/pypi/implementation/xloft" alt="PyPI implementation"></a>
-      <br>
       <a href="https://pypi.org/project/xloft"><img src="https://img.shields.io/pypi/format/xloft" alt="Format"></a>
-      <a href="https://github.com/kebasyaty/xloft"><img src="https://img.shields.io/github/languages/top/kebasyaty/xloft" alt="Top"></a>
-      <a href="https://github.com/kebasyaty/xloft"><img src="https://img.shields.io/github/repo-size/kebasyaty/xloft" alt="Size"></a>
-      <a href="https://github.com/kebasyaty/xloft"><img src="https://img.shields.io/github/last-commit/kebasyaty/xloft/main" alt="Last commit"></a>
-      <a href="https://github.com/kebasyaty/xloft/releases/" alt="GitHub release"><img src="https://img.shields.io/github/release/kebasyaty/xloft" alt="GitHub release"></a>
+      <a href="https://pepy.tech/projects/xloft"><img src="https://static.pepy.tech/badge/xloft" alt="PyPI Downloads"></a>
+      <a href="https://github.com/kebasyaty/xloft/blob/main/LICENSE" alt="GitHub license"><img src="https://img.shields.io/github/license/kebasyaty/xloft" alt="GitHub license"></a>
     </p>
     <p align="center">
-      The collection is represented by three modules of `NamedTuple`, `Human`.
+      The collection is represented by three modules of `NamedTuple`, `Converters`, `ItIs`.
       <br>
       In the future, new tools can be added.
     </p>
@@ -70,13 +65,6 @@ Description-Content-Type: text/markdown
 
 ##
 
-<img src="https://raw.githubusercontent.com/kebasyaty/xloft/v0/assets/attention.svg" alt="Attention">
-<p>
-The `quantum` module was deleted.
-<br>
-<a href="https://pypi.python.org/pypi/quantum-loop/" alt="quantum-loop">He is now here</a>
-</p>
-
 <br>
 
 ## Documentation
@@ -98,6 +86,8 @@ uv add xloft
 - **NamedTuple**
 
 ```python
+"""This class imitates the behavior of the `named tuple`."""
+
 from xloft import NamedTuple
 
 
@@ -155,30 +145,68 @@ nt["y"] = "Hi"  # => TypeError
 nt["_id"] = "new_id"  # => TypeError
 nt["z"] = [1, 2, 3]  # => TypeError
 
-nt.x = 20  # => raise: AttributeDoesNotSetValue
-nt.y = "Hi"  # => raise: AttributeDoesNotSetValue
-nt._id = "new_id"  # => raise: AttributeDoesNotSetValue
-nt.z = [1, 2, 3]  # => raise: AttributeDoesNotSetValue
+nt.x = 20  # => raise: AttributeDoesNotSetValueError
+nt.y = "Hi"  # => raise: AttributeDoesNotSetValueError
+nt._id = "new_id"  # => raise: AttributeDoesNotSetValueError
+nt.z = [1, 2, 3]  # => raise: AttributeDoesNotSetValueError
 
-del nt.x  # => raise: AttributeCannotBeDelete
-del nt.y # => raise: AttributeCannotBeDelete
-del nt._id # => raise: AttributeCannotBeDelete
+del nt.x  # => raise: AttributeCannotBeDeleteError
+del nt.y # => raise: AttributeCannotBeDeleteError
+del nt._id # => raise: AttributeCannotBeDeleteError
 ```
 
-- **Human**
+- **Converters**
 
 ```python
-from xloft import to_human_size
+"""Convert the number of bytes into a human-readable format."""
 
+from xloft import to_human_size, int_to_roman, roman_to_int
+# from xloft.converters import to_human_size, int_to_roman, roman_to_int
 
-s = to_human_size(200)
-print(s)  # => 200 bytes
 
-s = to_human_size(1048576)
-print(s)  # => 1 MB
+to_human_size(200)  # => 200 bytes
+to_human_size(1048576)  # => 1 MB
+to_human_size(1048575)  # => 1023.999 KB
+#
+int_to_roman(1994)  # => MCMXCIV
+roman_to_int("MCMXCIV")  # => 1994
+```
 
-s = to_human_size(1048575)
-print(s)  # => 1023.999 KB
+- **ItIs**
+
+```python
+"""Check if a string is a number."""
+
+from xloft import is_number, is_palindrome
+# from xloft.itis import is_number, is_palindrome
+
+
+is_number("")  # => False
+is_number(" ")  # => False
+is_number("1230.")  # => False
+is_number("0x5")  # => False
+is_number("0o5")  # => False
+is_number("-5.0")  # => True
+is_number("+5.0")  # => True
+is_number("5.0")  # => True
+is_number(".5")  # => True
+is_number("5.")  # => True
+is_number("3.4E+38")  # => True
+is_number("3.4E-38")  # => True
+is_number("1.7E+308")  # => True
+is_number("1.7E-308")  # => True
+is_number("-1.7976931348623157e+308")  # => True
+is_number("1.7976931348623157e+308")  # => True
+is_number("72028601076372765770200707816364342373431783018070841859646251155447849538676")  # => True
+is_number("-72028601076372765770200707816364342373431783018070841859646251155447849538676")  # => True
+#
+is_palindrome("racecar")  # True
+is_palindrome("Go hang a salami, I'm a lasagna hog") # True
+is_palindrome("22022022")  # True
+is_palindrome("Gene")  # False
+is_palindrome("123")  # False
+is_palindrome(123)  # TypeError
+is_palindrome("")  # ValueError
 ```
 
 ## Changelog

xloft-0.9.6.dist-info/RECORD

@@ -0,0 +1,12 @@
+xloft/__init__.py,sha256=hHQbBnIet5HUmjwp8R-6BCkGkFFSJYnXYz3INWFLwoc,1157
+xloft/errors.py,sha256=FuI9IWgoD7J5Z34ijXhAGDBAEwBdbJOrHThEk1I33kI,988
+xloft/itis.py,sha256=iQiPh4tvsHVqO5UIk3ZAcFQLS0KBPDogT6A0cNttjFk,1321
+xloft/namedtuple.py,sha256=NFqgaArayECek36v7_rIfOhb8TgnXTY3XfSgwT_4yCY,5539
+xloft/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+xloft/converters/__init__.py,sha256=YxWzIqa9TgDTc2aSJnxniKWdaQF_GGOu--5k1yOR8mA,510
+xloft/converters/human_size.py,sha256=-nxGQIz5_KMTSbOigYWPbXk4u2IAugTHpUYC_o2AM6E,1110
+xloft/converters/roman.py,sha256=pqoM3xwaafzJtI6Fih--2GykM9JuOJ7sXaJbqZYlwmE,2293
+xloft-0.9.6.dist-info/METADATA,sha256=Y6km_9v-wuHeeDbcGcR0TTNz9mNY3rE2MRzCOVLyiXg,7445
+xloft-0.9.6.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+xloft-0.9.6.dist-info/licenses/LICENSE,sha256=mS0Wz0yGNB63gEcWEnuIb_lldDYV0sjRaO-o_GL6CWE,1074
+xloft-0.9.6.dist-info/RECORD,,

{xloft-0.5.1.dist-info → xloft-0.9.6.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: hatchling 1.27.0
+Generator: hatchling 1.28.0
 Root-Is-Purelib: true
 Tag: py3-none-any

{xloft-0.5.1.dist-info → xloft-0.9.6.dist-info}/licenses/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 Gennady Kostyunin
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2025 Gennady Kostyunin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

xloft/human.py

@@ -1,64 +0,0 @@
-"""A collection of instruments for converting data to format is convenient for humans.
-
-The module contains the following functions:
-
-- `to_human_size(size)` - Returns a humanized string: 200 bytes | 1 KB | 1.5 MB etc.
-"""
-
-from __future__ import annotations
-
-__all__ = (
-    "to_human_size",
-    "get_cache_human_size",
-)
-
-import math
-
-# To caching the results from to_human_size method.
-_cache_human_size: dict[int, str] = {}
-
-
-def get_cache_human_size() -> dict[int, str]:
-    """Get a copy of variable _cach_human_size.
-
-    Hint: To tests.
-    """
-    return _cache_human_size.copy()
-
-
-def clean_cache_human_size() -> None:
-    """Reset of variable _cach_human_size."""
-    global _cache_human_size  # noqa: PLW0603
-    _cache_human_size = {}
-
-
-def to_human_size(n_bytes: int) -> str:
-    """Convert number of bytes to readable format.
-
-    Examples:
-        >>> from xloft import to_human_size
-        >>> to_human_size(200)
-        200 bytes
-        >>> to_human_size(1048576)
-        1 MB
-        >>> to_human_size(1048575)
-        1023.999 KB
-
-    Args:
-        n_bytes: The number of bytes.
-
-    Returns:
-        Returns a humanized string: 200 bytes | 1 KB | 1.5 MB etc.
-    """
-    result: str | None = _cache_human_size.get(n_bytes)
-    if result is not None:
-        return result
-    idx: int = math.floor(math.log(n_bytes) / math.log(1024))
-    ndigits: int = [0, 3, 6, 9, 12][idx]
-    human_size: int | float = n_bytes if n_bytes < 1024 else abs(round(n_bytes / pow(1024, idx), ndigits))
-    order = ["bytes", "KB", "MB", "GB", "TB"][idx]
-    if math.modf(human_size)[0] == 0.0:
-        human_size = int(human_size)
-    result = f"{human_size} {order}"
-    _cache_human_size[n_bytes] = result
-    return result

xloft-0.5.1.dist-info/RECORD

@@ -1,9 +0,0 @@
-xloft/__init__.py,sha256=mf6z2-Tnl-CdYMa8mrI5MlTl48G0GQoYNNj2PMp8SsQ,419
-xloft/errors.py,sha256=hZcmF0QVVdvE5oM1jsXymRk_pPGgDSnUDM9wx9zJAYQ,895
-xloft/human.py,sha256=WQbVOKpOvzGot-c7f3xitbS05JUIQmj3dreGtRV6GA0,1792
-xloft/namedtuple.py,sha256=a_l3bZF-L2I7MGxuF2CXzAHgNai-Vyj6SY1ODwxs7TU,6856
-xloft/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-xloft-0.5.1.dist-info/METADATA,sha256=o24kZAXLE4z4CaUnpSlqLbl-JihkCc0eXsP4mLsZQ-M,7079
-xloft-0.5.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-xloft-0.5.1.dist-info/licenses/LICENSE,sha256=2zZINd6m_jNYlowdQImlEizyhSui5cBAJZRhWQURcEc,1095
-xloft-0.5.1.dist-info/RECORD,,