absfuyu 5.3.0__tar.gz → 5.4.0__tar.gz

{absfuyu-5.3.0 → absfuyu-5.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: absfuyu
-Version: 5.3.0
+Version: 5.4.0
 Summary: A small collection of code
 Project-URL: Homepage, https://github.com/AbsoluteWinter/absfuyu-public
 Project-URL: Documentation, https://absolutewinter.github.io/absfuyu-docs/

{absfuyu-5.3.0 → absfuyu-5.4.0}/src/absfuyu/__init__.py

@@ -22,7 +22,7 @@ Using in cmd:
 __title__ = "absfuyu"
 __author__ = "AbsoluteWinter"
 __license__ = "MIT License"
-__version__ = "5.3.0"
+__version__ = "5.4.0"
 __all__ = [
     "core",
     "config",

{absfuyu-5.3.0 → absfuyu-5.4.0}/src/absfuyu/__main__.py

@@ -3,8 +3,8 @@ ABSFUYU
 -------
 COMMAND LINE INTERFACE
 
-Version: 5.2.0
-Date updated: 13/03/2025 (dd/mm/yyyy)
+Version: 5.4.0
+Date updated: 21/03/2025 (dd/mm/yyyy)
 """
 
 # Library

{absfuyu-5.3.0 → absfuyu-5.4.0}/src/absfuyu/cli/__init__.py

@@ -3,8 +3,8 @@ ABSFUYU
 -------
 COMMAND LINE INTERFACE
 
-Version: 5.2.0
-Date updated: 10/03/2025 (dd/mm/yyyy)
+Version: 5.4.0
+Date updated: 21/03/2025 (dd/mm/yyyy)
 """
 
 __all__ = ["cli"]

{absfuyu-5.3.0 → absfuyu-5.4.0}/src/absfuyu/cli/color.py

@@ -3,8 +3,8 @@ ABSFUYU CLI
 -----------
 Color
 
-Version: 5.2.0
-Date updated: 13/03/2025 (dd/mm/yyyy)
+Version: 5.4.0
+Date updated: 21/03/2025 (dd/mm/yyyy)
 """
 
 # Module Package

{absfuyu-5.3.0 → absfuyu-5.4.0}/src/absfuyu/cli/config_group.py

@@ -3,8 +3,8 @@ ABSFUYU CLI
 -----------
 Config
 
-Version: 5.2.0
-Date updated: 12/03/2025 (dd/mm/yyyy)
+Version: 5.4.0
+Date updated: 21/03/2025 (dd/mm/yyyy)
 """
 
 # Module Package

{absfuyu-5.3.0 → absfuyu-5.4.0}/src/absfuyu/cli/do_group.py

@@ -3,8 +3,8 @@ ABSFUYU CLI
 -----------
 Do
 
-Version: 5.2.0
-Date updated: 12/03/2025 (dd/mm/yyyy)
+Version: 5.4.0
+Date updated: 21/03/2025 (dd/mm/yyyy)
 """
 
 # Module Package

{absfuyu-5.3.0 → absfuyu-5.4.0}/src/absfuyu/cli/game_group.py

@@ -3,8 +3,8 @@ ABSFUYU CLI
 -----------
 Game
 
-Version: 5.2.0
-Date updated: 12/03/2025 (dd/mm/yyyy)
+Version: 5.4.0
+Date updated: 21/03/2025 (dd/mm/yyyy)
 """
 
 # Module Package

{absfuyu-5.3.0 → absfuyu-5.4.0}/src/absfuyu/cli/tool_group.py

@@ -3,8 +3,8 @@ ABSFUYU CLI
 -----------
 Tool
 
-Version: 5.2.0
-Date updated: 12/03/2025 (dd/mm/yyyy)
+Version: 5.4.0
+Date updated: 21/03/2025 (dd/mm/yyyy)
 """
 
 # Module Package

{absfuyu-5.3.0 → absfuyu-5.4.0}/src/absfuyu/config/__init__.py

@@ -3,8 +3,8 @@ Absfuyu: Configuration
 ----------------------
 Package configuration module
 
-Version: 5.2.0
-Date updated: 10/03/2025 (dd/mm/yyyy)
+Version: 5.4.0
+Date updated: 21/03/2025 (dd/mm/yyyy)
 """
 
 # Module level

{absfuyu-5.3.0 → absfuyu-5.4.0}/src/absfuyu/core/__init__.py

@@ -3,8 +3,8 @@ Absfuyu: Core
 -------------
 Bases for other features
 
-Version: 5.2.0
-Date updated: 10/03/2025 (dd/mm/yyyy)
+Version: 5.4.0
+Date updated: 21/03/2025 (dd/mm/yyyy)
 """
 
 # Module Package

{absfuyu-5.3.0 → absfuyu-5.4.0}/src/absfuyu/core/baseclass.py

@@ -3,8 +3,8 @@ Absfuyu: Core
 -------------
 Bases for other features
 
-Version: 5.2.0
-Date updated: 11/03/2025 (dd/mm/yyyy)
+Version: 5.4.0
+Date updated: 21/03/2025 (dd/mm/yyyy)
 """
 
 # Module Package

{absfuyu-5.3.0 → absfuyu-5.4.0}/src/absfuyu/core/baseclass2.py

@@ -3,8 +3,8 @@ Absfuyu: Core
 -------------
 Bases for other features (with library)
 
-Version: 5.2.0
-Date updated: 10/03/2025 (dd/mm/yyyy)
+Version: 5.4.0
+Date updated: 21/03/2025 (dd/mm/yyyy)
 """
 
 # Module Package

{absfuyu-5.3.0 → absfuyu-5.4.0}/src/absfuyu/core/decorator.py

@@ -3,8 +3,8 @@ Absfuyu: Core
 -------------
 Decorator
 
-Version: 5.2.0
-Date updated: 14/03/2025 (dd/mm/yyyy)
+Version: 5.4.0
+Date updated: 21/03/2025 (dd/mm/yyyy)
 """
 
 # Module Package

{absfuyu-5.3.0 → absfuyu-5.4.0}/src/absfuyu/core/docstring.py

@@ -3,8 +3,8 @@ Absfuyu: Core
 -------------
 Sphinx docstring decorator
 
-Version: 5.2.0
-Date updated: 14/03/2025 (dd/mm/yyyy)
+Version: 5.4.0
+Date updated: 21/03/2025 (dd/mm/yyyy)
 """
 
 # Module Package

{absfuyu-5.3.0 → absfuyu-5.4.0}/src/absfuyu/core/dummy_cli.py

@@ -3,8 +3,8 @@ Absfuyu: Core
 -------------
 Dummy cli
 
-Version: 5.2.0
-Date updated: 10/03/2025 (dd/mm/yyyy)
+Version: 5.4.0
+Date updated: 21/03/2025 (dd/mm/yyyy)
 """
 
 # Module Package

{absfuyu-5.3.0 → absfuyu-5.4.0}/src/absfuyu/core/dummy_func.py

@@ -3,8 +3,8 @@ Absfuyu: Core
 -------------
 Dummy functions when other libraries are unvailable
 
-Version: 5.2.0
-Date updated: 13/03/2025 (dd/mm/yyyy)
+Version: 5.4.0
+Date updated: 21/03/2025 (dd/mm/yyyy)
 """
 
 # Module Package

{absfuyu-5.3.0 → absfuyu-5.4.0}/src/absfuyu/dxt/__init__.py

@@ -3,8 +3,8 @@ Absfuyu: Data Extension
 -----------------------
 Extension for data type such as ``list``, ``str``, ``dict``, ...
 
-Version: 5.2.0
-Date updated: 10/03/2025 (dd/mm/yyyy)
+Version: 5.4.0
+Date updated: 21/03/2025 (dd/mm/yyyy)
 
 Features:
 ---------

{absfuyu-5.3.0 → absfuyu-5.4.0}/src/absfuyu/dxt/dictext.py

@@ -3,8 +3,8 @@ Absfuyu: Data Extension
 -----------------------
 dict extension
 
-Version: 5.2.0
-Date updated: 12/03/2025 (dd/mm/yyyy)
+Version: 5.4.0
+Date updated: 21/03/2025 (dd/mm/yyyy)
 """
 
 # Module Package
@@ -16,10 +16,19 @@ __all__ = ["DictExt", "DictAnalyzeResult"]
 # ---------------------------------------------------------------------------
 import operator
 from collections.abc import Callable
-from typing import Any, NamedTuple, Self
+from typing import Any, NamedTuple, Self, TypeVar
 
 from absfuyu.core import ShowAllMethodsMixin, versionadded, versionchanged
 
+# from absfuyu.typings import KT as _KT
+# from absfuyu.typings import VT as _VT
+
+
+# Type
+# ---------------------------------------------------------------------------
+KT = TypeVar("KT")
+VT = TypeVar("VT")
+
 
 # Class
 # ---------------------------------------------------------------------------
@@ -34,7 +43,7 @@ class DictAnalyzeResult(NamedTuple):
     min_list: list
 
 
-class DictExt(ShowAllMethodsMixin, dict):
+class DictExt(ShowAllMethodsMixin, dict[KT, VT]):
     """
     ``dict`` extension
 
@@ -106,7 +115,7 @@ class DictExt(ShowAllMethodsMixin, dict):
         # return self.__class__(zip(self.values(), self.keys()))
         return self.__class__({v: k for k, v in self.items()})
 
-    def apply(self, func: Callable, apply_to_value: bool = True) -> Self:
+    def apply(self, func: Callable[[Any], Any], apply_to_value: bool = True) -> Self:
         """
         Apply function to ``DictExt.keys()`` or ``DictExt.values()``
 
@@ -141,7 +150,7 @@ class DictExt(ShowAllMethodsMixin, dict):
     @versionadded("3.4.0")
     def aggregate(
         self,
-        other_dict: dict,
+        other_dict: dict[KT, VT],
         default_value: Any = 0,
         operator_func: Callable[[Any, Any], Any] = operator.add,  # operator add
     ) -> Self:

{absfuyu-5.3.0 → absfuyu-5.4.0}/src/absfuyu/dxt/dxt_support.py

@@ -3,8 +3,8 @@ Absfuyu: Data Extension
 -----------------------
 Support classes
 
-Version: 5.2.0
-Date updated: 10/03/2025 (dd/mm/yyyy)
+Version: 5.4.0
+Date updated: 21/03/2025 (dd/mm/yyyy)
 """
 
 # Module Package

{absfuyu-5.3.0 → absfuyu-5.4.0}/src/absfuyu/dxt/intext.py

@@ -3,8 +3,8 @@ Absfuyu: Data Extension
 -----------------------
 int extension
 
-Version: 5.2.0
-Date updated: 12/03/2025 (dd/mm/yyyy)
+Version: 5.4.0
+Date updated: 21/03/2025 (dd/mm/yyyy)
 """
 
 # Module Package
@@ -16,9 +16,10 @@ __all__ = ["IntExt", "Pow"]
 # ---------------------------------------------------------------------------
 import math
 from collections import Counter
-from typing import Any, Self
+from typing import Any, Literal, Self, overload
 
-from absfuyu.core import ShowAllMethodsMixin, versionadded, versionchanged
+from absfuyu.core.baseclass import ShowAllMethodsMixin
+from absfuyu.core.docstring import deprecated, versionadded, versionchanged
 from absfuyu.dxt.dxt_support import DictBoolTrue
 
 
@@ -32,20 +33,23 @@ class Pow:
         self.power_by = power_by
 
     def __str__(self) -> str:
+        return self.__repr__()
+
+    def __repr__(self) -> str:
         if self.power_by == 1:
             return str(self.number)
         else:
             return f"{self.number}^{self.power_by}"
         # return f"{self.__class__.__name__}({self.number}, {self.power_by})"
 
-    def __repr__(self) -> str:
-        return self.__str__()
-
     def to_list(self) -> list[int]:
         """
         Convert into list
 
-        :rtype: list[int | float]
+        Returns
+        -------
+        list[int | float]
+            list
         """
         return [self.number] * self.power_by  # type: ignore
 
@@ -53,7 +57,10 @@ class Pow:
         """
         Calculate the ``self.number`` to the power of ``self.power_by``
 
-        :rtype: float
+        Returns
+        -------
+        float
+            Result
         """
         # return self.number**self.power_by
         return math.pow(self.number, self.power_by)
@@ -67,7 +74,8 @@ class IntExt(ShowAllMethodsMixin, int):
     >>> IntExt.show_all_methods()
     """
 
-    # convert stuff
+    # convert
+    @deprecated("5.4.0", reason="Use format(...) instead")
     def to_binary(self) -> str:
         """
         Convert to binary number
@@ -80,7 +88,7 @@ class IntExt(ShowAllMethodsMixin, int):
 
         Example:
         --------
-        >>> test = IntNumber(10)
+        >>> test = IntExt(10)
         >>> test.to_binary()
         '1010'
         """
@@ -98,7 +106,7 @@ class IntExt(ShowAllMethodsMixin, int):
 
         Example:
         --------
-        >>> test = IntNumber(10)
+        >>> test = IntExt(10)
         >>> test.to_celcius_degree()
         -12.222222222222221
         """
@@ -117,7 +125,7 @@ class IntExt(ShowAllMethodsMixin, int):
 
         Example:
         --------
-        >>> test = IntNumber(10)
+        >>> test = IntExt(10)
         >>> test.to_fahrenheit_degree()
         50.0
         """
@@ -130,13 +138,13 @@ class IntExt(ShowAllMethodsMixin, int):
 
         Returns
         -------
-        IntNumber
-            Reversed number
+        Self
+            Reversed number.
 
 
         Example:
         --------
-        >>> test = IntNumber(102)
+        >>> test = IntExt(102)
         >>> test.reverse()
         201
         """
@@ -384,13 +392,13 @@ class IntExt(ShowAllMethodsMixin, int):
 
         Returns
         -------
-        IntNumber
-            Least common multiple
+        Self
+            Least common multiple.
 
 
         Example:
         --------
-        >>> test = IntNumber(102)
+        >>> test = IntExt(102)
         >>> test.lcm(5)
         510
         """
@@ -408,13 +416,13 @@ class IntExt(ShowAllMethodsMixin, int):
 
         Returns
         -------
-        IntNumber
-            Greatest common divisor
+        Self
+            Greatest common divisor.
 
 
         Example:
         --------
-        >>> test = IntNumber(1024)
+        >>> test = IntExt(1024)
         >>> test.gcd(8)
         8
         """
@@ -433,28 +441,31 @@ class IntExt(ShowAllMethodsMixin, int):
 
         Returns
         -------
-        IntNumber
-            IntNumber
+        Self
+            IntExt
 
 
         Example:
         --------
-        >>> test = IntNumber(119)
+        >>> test = IntExt(119)
         >>> test.add_to_one_digit()
         2
 
-        >>> test = IntNumber(119)
+        >>> test = IntExt(119)
         >>> test.add_to_one_digit(master_number=True)
         11
         """
+
         number = int(self)
-        if number < 0:
+        if number < 0:  # Convert positive
             number *= -1
+
         while len(str(number)) != 1:
             number = sum(map(int, str(number)))
             if master_number:
                 if number == 22 or number == 11:
                     break  # Master number
+
         return self.__class__(number)
 
     @versionchanged("5.0.0", reason="Removed ``short_form`` parameter")
@@ -470,7 +481,7 @@ class IntExt(ShowAllMethodsMixin, int):
 
         Example:
         --------
-        >>> test = IntNumber(1024)
+        >>> test = IntExt(1024)
         >>> test.divisible_list()
         [1, 2, 4, 8, 16, 32, 64, 128, 256, 512, 1024]
         """
@@ -481,6 +492,12 @@ class IntExt(ShowAllMethodsMixin, int):
 
         return divi_list
 
+    @overload
+    def prime_factor(self) -> list[Pow]: ...
+
+    @overload
+    def prime_factor(self, short_form: Literal[False] = ...) -> list[int]: ...
+
     def prime_factor(self, short_form: bool = True) -> list[int] | list[Pow]:
         """
         Prime factor
@@ -503,14 +520,15 @@ class IntExt(ShowAllMethodsMixin, int):
 
         Example:
         --------
-        >>> test = IntNumber(1024)
+        >>> test = IntExt(1024)
         >>> test.prime_factor()
         [2^10]
 
-        >>> test = IntNumber(1024)
+        >>> test = IntExt(1024)
         >>> test.prime_factor(short_form=False)
         [2, 2, 2, 2, 2, 2, 2, 2, 2, 2]
         """
+
         # Generate list
         factors = []
         divisor = 2
@@ -533,7 +551,7 @@ class IntExt(ShowAllMethodsMixin, int):
     # analyze
     def analyze(self, short_form: bool = True) -> dict[str, dict[str, Any]]:
         """
-        Analyze the number with almost all ``IntNumber`` method
+        Analyze the number with almost all ``IntExt`` method
 
         Parameters
         ----------
@@ -549,7 +567,7 @@ class IntExt(ShowAllMethodsMixin, int):
 
         Example:
         --------
-        >>> test = IntNumber(1024)
+        >>> test = IntExt(1024)
         >>> test.analyze()
         {
             'summary': {'number': 1024, 'length': 4, 'even': True, 'prime factor': [2^10], 'divisible': [1, 2, 4, 8, 16, 32, 64, 128, 256, 512, 1024]},
@@ -562,7 +580,7 @@ class IntExt(ShowAllMethodsMixin, int):
                 "number": self,
                 "length": len(str(self)),
                 "even": self.is_even(),
-                "prime factor": self.prime_factor(short_form=short_form),
+                "prime factor": self.prime_factor(short_form=short_form),  # type: ignore[call-overload]
                 "divisible": self.divisible_list(),
             },
             "convert": {

{absfuyu-5.3.0 → absfuyu-5.4.0}/src/absfuyu/dxt/listext.py

@@ -3,8 +3,8 @@ Absfuyu: Data Extension
 -----------------------
 list extension
 
-Version: 5.2.0
-Date updated: 15/03/2025 (dd/mm/yyyy)
+Version: 5.4.0
+Date updated: 21/03/2025 (dd/mm/yyyy)
 """
 
 # Module Package
@@ -72,6 +72,12 @@ class ListExt(ShowAllMethodsMixin, list):
         -------
         list
             Filtered list
+
+
+        Example:
+        --------
+        >>> ListExt(range(10)).head(2)
+        [0, 1]
         """
         number_of_items = int(
             set_min_max(number_of_items, min_value=0, max_value=len(self))
@@ -92,6 +98,12 @@ class ListExt(ShowAllMethodsMixin, list):
         -------
         list
             Filtered list
+
+
+        Example:
+        --------
+        >>> ListExt(range(10)).tail(2)
+        [8, 9]
         """
         number_of_items = int(
             set_min_max(number_of_items, min_value=0, max_value=len(self))

{absfuyu-5.3.0 → absfuyu-5.4.0}/src/absfuyu/dxt/strext.py

@@ -3,8 +3,8 @@ Absfuyu: Data Extension
 -----------------------
 str extension
 
-Version: 5.2.0
-Date updated: 13/03/2025 (dd/mm/yyyy)
+Version: 5.4.0
+Date updated: 21/03/2025 (dd/mm/yyyy)
 """
 
 # Module Package

{absfuyu-5.3.0 → absfuyu-5.4.0}/src/absfuyu/extra/__init__.py

@@ -3,8 +3,8 @@ Absfuyu: Extra
 --------------
 Features that require additional libraries
 
-Version: 5.2.0
-Date updated: 10/03/2025 (dd/mm/yyyy)
+Version: 5.4.0
+Date updated: 21/03/2025 (dd/mm/yyyy)
 """
 
 

{absfuyu-5.3.0 → absfuyu-5.4.0}/src/absfuyu/extra/beautiful.py

@@ -3,8 +3,8 @@ Absfuyu: Beautiful
 ------------------
 A decorator that makes output more beautiful
 
-Version: 5.2.0
-Date updated: 10/03/2025 (dd/mm/yyyy)
+Version: 5.4.0
+Date updated: 21/03/2025 (dd/mm/yyyy)
 """
 
 # Module level

{absfuyu-5.3.0 → absfuyu-5.4.0}/src/absfuyu/extra/da/__init__.py

@@ -3,8 +3,8 @@ Absfuyu: Data Analysis
 ----------------------
 Data Analyst
 
-Version: 5.2.0
-Date updated: 10/03/2025 (dd/mm/yyyy)
+Version: 5.4.0
+Date updated: 21/03/2025 (dd/mm/yyyy)
 """
 
 # Module level