absfuyu 5.3.0__py3-none-any.whl → 5.5.0__py3-none-any.whl

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.5.0
+Date updated: 23/04/2025 (dd/mm/yyyy)
 """
 
 # Module Package
@@ -71,7 +71,7 @@ class PerformanceTrackingMeta(type):
     Usage:
     ------
     >>> class Demo(metaclass=PerformanceTrackingMeta):
-    ...     def __init__(self):...
+    ...     def __init__(self): ...
     >>> Demo()
     --------------------------------------
     Class: Demo

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.5.0
+Date updated: 23/04/2025 (dd/mm/yyyy)
 """
 
 # Module Package

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.5.0
+Date updated: 23/04/2025 (dd/mm/yyyy)
 """
 
 # Module Package

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.5.0
+Date updated: 23/04/2025 (dd/mm/yyyy)
 """
 
 # Module Package

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.5.0
+Date updated: 23/04/2025 (dd/mm/yyyy)
 """
 
 # Module Package

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.5.0
+Date updated: 23/04/2025 (dd/mm/yyyy)
 
 Features:
 ---------

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.5.0
+Date updated: 23/04/2025 (dd/mm/yyyy)
 """
 
 # Module Package
@@ -16,9 +16,18 @@ __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.core import GetClassMembersMixin, 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(GetClassMembersMixin, dict[KT, VT]):
     """
     ``dict`` extension
 
@@ -56,13 +65,7 @@ class DictExt(ShowAllMethodsMixin, dict):
 
         Example:
         --------
-        >>> test = DictExt({
-        ...     "abc": 9,
-        ...     "def": 9,
-        ...     "ghi": 8,
-        ...     "jkl": 1,
-        ...     "mno": 1
-        ... })
+        >>> test = DictExt({"abc": 9, "def": 9, "ghi": 8, "jkl": 1, "mno": 1})
         >>> test.analyze()
         DictAnalyzeResult(max_value=9, min_value=1, max_list=[('abc', 9), ('def', 9)], min_list=[('jkl', 1), ('mno', 1)])
         """
@@ -106,7 +109,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 +144,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/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.5.0
+Date updated: 23/04/2025 (dd/mm/yyyy)
 """
 
 # Module Package

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.5.0
+Date updated: 23/04/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 GetClassMembersMixin
+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,13 +57,16 @@ 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)
 
 
-class IntExt(ShowAllMethodsMixin, int):
+class IntExt(GetClassMembersMixin, int):
     """
     ``int`` extension
 
@@ -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/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.5.0
+Date updated: 23/04/2025 (dd/mm/yyyy)
 """
 
 # Module Package
@@ -18,10 +18,11 @@ import operator
 import random
 from collections import Counter
 from collections.abc import Callable, Iterable
-from itertools import accumulate, chain, groupby, zip_longest
+from heapq import heapreplace
+from itertools import accumulate, chain, count, groupby, zip_longest
 from typing import Any, Literal, Self, cast, overload
 
-from absfuyu.core.baseclass import ShowAllMethodsMixin
+from absfuyu.core.baseclass import GetClassMembersMixin
 from absfuyu.core.docstring import deprecated, versionadded, versionchanged
 from absfuyu.typings import T as _T
 from absfuyu.util import set_min_max
@@ -29,7 +30,7 @@ from absfuyu.util import set_min_max
 
 # Class
 # ---------------------------------------------------------------------------
-class ListExt(ShowAllMethodsMixin, list):
+class ListExt(GetClassMembersMixin, list):
     """
     ``list`` extension
 
@@ -72,6 +73,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 +99,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))
@@ -167,7 +180,6 @@ class ListExt(ShowAllMethodsMixin, list):
         self,
         sort: bool = False,
         num_of_first_char: int | None = None,
-        appear_increment: Literal[False] = ...,
     ) -> dict: ...
 
     @overload
@@ -330,16 +342,32 @@ class ListExt(ShowAllMethodsMixin, list):
         except TypeError:
             return sep.join(self.apply(str))
 
-    def numbering(self, start: int = 0) -> Self:
+    @overload
+    def numbering(self) -> Self: ...
+
+    @overload
+    def numbering(self, start: int | float = 0) -> Self: ...
+
+    @overload
+    def numbering(self, *, step: int | float = 1) -> Self: ...
+
+    @overload
+    def numbering(self, start: int | float = 0, step: int | float = 1) -> Self: ...
+
+    @versionchanged("5.5.0", "Use itertools.count to wrap")
+    def numbering(self, start: int | float = 0, step: int | float = 1) -> Self:
         """
         Number the item in list
-        (``enumerate`` wrapper)
+        (``itertools.count`` wrapper)
 
         Parameters
         ----------
-        start : int
+        start : int | float, optional
             Start from which number, by default ``0``
 
+        step : int | float, optional
+            Step, by default ``1``
+
         Returns
         -------
         Self
@@ -352,8 +380,9 @@ class ListExt(ShowAllMethodsMixin, list):
         >>> test.numbering()
         [(0, 9), (1, 9), (2, 9)]
         """
-        start = max(start, 0)
-        return self.__class__(enumerate(self, start=start))
+        nums = count(start=start, step=step)
+        # return self.__class__(enumerate(self, start=start))
+        return self.__class__(zip(nums, self))
 
     @versionadded("5.3.0")  # no test case yet
     def transpose(self, fillvalue: _T | None = None, /) -> Self:
@@ -608,13 +637,51 @@ class ListExt(ShowAllMethodsMixin, list):
                         temp[x].append(item)
 
             # Flatten dict.values
-            for k, v in temp.items():
-                temp[k] = list(set(chain(*v)))
+            temp = {k: list(set(chain(*v))) for k, v in temp.items()}
 
             iter = list(temp.values())
 
         return list(x for x, _ in groupby(iter))
 
+    @versionadded("5.5.0")
+    def split_equal(self, n: int, sort: bool = True) -> Self:
+        """
+        Try to equally split a list of number into ``n`` equal sum parts.
+
+        **Note:** Element in list must be a number.
+
+        Parameters
+        ----------
+        n : int
+            Split into how many parts. Must be >= 1.
+
+        sort : bool, optional
+            Sort the instance before split, by default ``True``
+
+        Returns
+        -------
+        Self
+            Splitted (list[list])
+
+
+        Example:
+        --------
+        >>> ListExt(range(1, 11)).split_equal(2)
+        [[10, 7, 5, 4, 1], [9, 8, 6, 3, 2]]
+        """
+
+        # https://stackoverflow.com/a/61649667
+        bins: list[list[int]] = [[0] for _ in range(max(n, 1))]
+        if sort:
+            # self = self.sorts(reverse=True)
+            self = self.__class__(sorted(self, reverse=True))
+        for x in self:
+            least = bins[0]
+            least[0] += x
+            least.append(x)
+            heapreplace(bins, least)
+        return self.__class__(x[1:] for x in bins)
+
     # Slicing
     def slice_points(self, points: list[int]) -> Self:
         """
@@ -700,7 +767,7 @@ class ListExt(ShowAllMethodsMixin, list):
 
         Example:
         --------
-        >>> ins = ListExt(range(1,20))
+        >>> ins = ListExt(range(1, 20))
 
         >>> # Normal split chunk
         >>> ins.split_chunk(10)

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.5.0
+Date updated: 23/04/2025 (dd/mm/yyyy)
 """
 
 # Module Package
@@ -18,7 +18,7 @@ import random
 from string import ascii_letters as _ascii_letters
 from typing import NotRequired, Self, TypedDict
 
-from absfuyu.core import ShowAllMethodsMixin, deprecated, versionadded, versionchanged
+from absfuyu.core import GetClassMembersMixin, deprecated, versionadded, versionchanged
 from absfuyu.util import set_min_max
 
 
@@ -116,7 +116,7 @@ class TextAnalyzeDictFormat(TypedDict):
     is_palindrome: NotRequired[bool]
 
 
-class Text(ShowAllMethodsMixin, str):
+class Text(GetClassMembersMixin, str):
     """
     ``str`` extension
 

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.5.0
+Date updated: 23/04/2025 (dd/mm/yyyy)
 """
 
 

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.5.0
+Date updated: 23/04/2025 (dd/mm/yyyy)
 """
 
 # Module level

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.5.0
+Date updated: 23/04/2025 (dd/mm/yyyy)
 """
 
 # Module level