absfuyu 5.11.0__py3-none-any.whl → 5.12.0__py3-none-any.whl

absfuyu/__init__.py

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

absfuyu/__main__.py

@@ -3,8 +3,8 @@ ABSFUYU
 -------
 COMMAND LINE INTERFACE
 
-Version: 5.11.0
-Date updated: 30/09/2025 (dd/mm/yyyy)
+Version: 5.12.0
+Date updated: 17/10/2025 (dd/mm/yyyy)
 """
 
 # Library

absfuyu/cli/__init__.py

@@ -3,8 +3,8 @@ ABSFUYU
 -------
 COMMAND LINE INTERFACE
 
-Version: 5.11.0
-Date updated: 30/09/2025 (dd/mm/yyyy)
+Version: 5.12.0
+Date updated: 17/10/2025 (dd/mm/yyyy)
 """
 
 __all__ = ["cli"]

absfuyu/cli/color.py

@@ -3,8 +3,8 @@ ABSFUYU CLI
 -----------
 Color
 
-Version: 5.11.0
-Date updated: 30/09/2025 (dd/mm/yyyy)
+Version: 5.12.0
+Date updated: 17/10/2025 (dd/mm/yyyy)
 """
 
 # Module Package

absfuyu/cli/config_group.py

@@ -3,8 +3,8 @@ ABSFUYU CLI
 -----------
 Config
 
-Version: 5.11.0
-Date updated: 30/09/2025 (dd/mm/yyyy)
+Version: 5.12.0
+Date updated: 17/10/2025 (dd/mm/yyyy)
 """
 
 # Module Package

absfuyu/cli/do_group.py

@@ -3,8 +3,8 @@ ABSFUYU CLI
 -----------
 Do
 
-Version: 5.11.0
-Date updated: 30/09/2025 (dd/mm/yyyy)
+Version: 5.12.0
+Date updated: 17/10/2025 (dd/mm/yyyy)
 """
 
 # Module Package

absfuyu/cli/game_group.py

@@ -3,8 +3,8 @@ ABSFUYU CLI
 -----------
 Game
 
-Version: 5.11.0
-Date updated: 30/09/2025 (dd/mm/yyyy)
+Version: 5.12.0
+Date updated: 17/10/2025 (dd/mm/yyyy)
 """
 
 # Module Package

absfuyu/cli/tool_group.py

@@ -3,8 +3,8 @@ ABSFUYU CLI
 -----------
 Tool
 
-Version: 5.11.0
-Date updated: 30/09/2025 (dd/mm/yyyy)
+Version: 5.12.0
+Date updated: 17/10/2025 (dd/mm/yyyy)
 """
 
 # Module Package

absfuyu/config/__init__.py

@@ -3,8 +3,8 @@ Absfuyu: Configuration
 ----------------------
 Package configuration module
 
-Version: 5.11.0
-Date updated: 30/09/2025 (dd/mm/yyyy)
+Version: 5.12.0
+Date updated: 17/10/2025 (dd/mm/yyyy)
 """
 
 # Module level

absfuyu/core/__init__.py

@@ -3,8 +3,8 @@ Absfuyu: Core
 -------------
 Bases for other features
 
-Version: 5.11.0
-Date updated: 30/09/2025 (dd/mm/yyyy)
+Version: 5.12.0
+Date updated: 17/10/2025 (dd/mm/yyyy)
 """
 
 # Module Package

absfuyu/core/baseclass.py

@@ -3,8 +3,8 @@ Absfuyu: Core
 -------------
 Bases for other features
 
-Version: 5.11.0
-Date updated: 05/10/2025 (dd/mm/yyyy)
+Version: 5.12.0
+Date updated: 17/10/2025 (dd/mm/yyyy)
 """
 
 # Module Package

absfuyu/core/baseclass2.py

@@ -3,8 +3,8 @@ Absfuyu: Core
 -------------
 Bases for other features (with library)
 
-Version: 5.11.0
-Date updated: 30/09/2025 (dd/mm/yyyy)
+Version: 5.12.0
+Date updated: 17/10/2025 (dd/mm/yyyy)
 """
 
 # Module Package

absfuyu/core/decorator.py

@@ -3,8 +3,8 @@ Absfuyu: Core
 -------------
 Decorator
 
-Version: 5.11.0
-Date updated: 30/09/2025 (dd/mm/yyyy)
+Version: 5.12.0
+Date updated: 17/10/2025 (dd/mm/yyyy)
 """
 
 # Module Package

absfuyu/core/docstring.py

@@ -3,8 +3,8 @@ Absfuyu: Core
 -------------
 Sphinx docstring decorator
 
-Version: 5.11.0
-Date updated: 30/09/2025 (dd/mm/yyyy)
+Version: 5.12.0
+Date updated: 17/10/2025 (dd/mm/yyyy)
 """
 
 # Module Package

absfuyu/core/dummy_cli.py

@@ -3,8 +3,8 @@ Absfuyu: Core
 -------------
 Dummy cli
 
-Version: 5.11.0
-Date updated: 30/09/2025 (dd/mm/yyyy)
+Version: 5.12.0
+Date updated: 17/10/2025 (dd/mm/yyyy)
 """
 
 # Module Package
@@ -57,7 +57,7 @@ def get_parser(
 
 
 def cli() -> None:
-    desc = "This is a dummy cli, please install <click> and <colorama> package to use this feature"
+    desc = "This is a dummy cli, install <click> and <colorama> package to use this feature"
     arg_parser = get_parser(
         name=__title__,
         description=desc,

absfuyu/core/dummy_func.py

@@ -3,8 +3,8 @@ Absfuyu: Core
 -------------
 Dummy functions when other libraries are unvailable
 
-Version: 5.11.0
-Date updated: 30/09/2025 (dd/mm/yyyy)
+Version: 5.12.0
+Date updated: 17/10/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.11.0
-Date updated: 30/09/2025 (dd/mm/yyyy)
+Version: 5.12.0
+Date updated: 17/10/2025 (dd/mm/yyyy)
 
 Features:
 ---------

absfuyu/dxt/dictext.py

@@ -3,8 +3,8 @@ Absfuyu: Data Extension
 -----------------------
 dict extension
 
-Version: 5.11.0
-Date updated: 30/09/2025 (dd/mm/yyyy)
+Version: 5.12.0
+Date updated: 17/10/2025 (dd/mm/yyyy)
 """
 
 # Module Package
@@ -16,7 +16,7 @@ __all__ = ["DictExt", "DictAnalyzeResult"]
 # ---------------------------------------------------------------------------
 import operator
 from collections.abc import Callable
-from typing import Any, NamedTuple, Self, TypeVar
+from typing import Any, Literal, NamedTuple, Self, TypeVar, overload
 
 from absfuyu.core import GetClassMembersMixin, versionadded, versionchanged
 
@@ -28,6 +28,8 @@ from absfuyu.core import GetClassMembersMixin, versionadded, versionchanged
 # ---------------------------------------------------------------------------
 KT = TypeVar("KT")
 VT = TypeVar("VT")
+VT2 = TypeVar("VT2")
+R = TypeVar("R")  # Return type - Can be anything
 
 
 # Class
@@ -43,9 +45,9 @@ class DictAnalyzeResult(NamedTuple):
     min_list: list
 
 
-class DictExt(GetClassMembersMixin, dict[KT, VT]):
+class DictExtLegacy(GetClassMembersMixin, dict[KT, VT]):
     """
-    ``dict`` extension
+    ``dict`` extension (with no generic type-hints)
 
     >>> # For a list of new methods
     >>> DictExt.show_all_methods()
@@ -107,7 +109,7 @@ class DictExt(GetClassMembersMixin, dict[KT, VT]):
         {9: 'abc'}
         """
         # return self.__class__(zip(self.values(), self.keys()))
-        return self.__class__({v: k for k, v in self.items()})
+        return self.__class__({v: k for k, v in self.items()})  # type: ignore
 
     def apply(self, func: Callable[[Any], Any], apply_to_value: bool = True) -> Self:
         """
@@ -205,3 +207,181 @@ class DictExt(GetClassMembersMixin, dict[KT, VT]):
                 merged_output[k] = [value_self, value_other]
 
         return self.__class__(merged_output)
+
+
+# Type-hints are hard coded, no work around Self[KT, VT] yet
+class DictExt(GetClassMembersMixin, dict[KT, VT]):
+    """
+    ``dict`` extension
+
+    >>> # For a list of new methods
+    >>> DictExt.show_all_methods()
+    """
+
+    # Analyze
+    @versionchanged("3.3.0", reason="Updated return type")
+    def analyze(self) -> DictAnalyzeResult:
+        """
+        Analyze all the key values (``int``, ``float``)
+        in ``dict`` then return highest/lowest index
+
+        Returns
+        -------
+        dict
+            Analyzed data
+
+
+        Example:
+        --------
+        >>> 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)])
+        """
+        try:
+            dct: dict = self.copy()
+
+            max_val: int | float = max(list(dct.values()))
+            min_val: int | float = min(list(dct.values()))
+            max_list = []
+            min_list = []
+
+            for k, v in dct.items():
+                if v == max_val:
+                    max_list.append((k, v))
+                if v == min_val:
+                    min_list.append((k, v))
+
+            return DictAnalyzeResult(max_val, min_val, max_list, min_list)
+
+        except TypeError:
+            err_msg = "Value must be int or float"
+            # logger.error(err_msg)
+            raise ValueError(err_msg)  # noqa: B904
+
+    # Swap
+    def swap_items(self) -> "DictExt[VT, KT]":
+        """
+        Swap ``dict.keys()`` with ``dict.values()``
+
+        Returns
+        -------
+        DictExt
+            Swapped dict
+
+
+        Example:
+        --------
+        >>> test = DictExt({"abc": 9})
+        >>> test.swap_items()
+        {9: 'abc'}
+        """
+        # return self.__class__(zip(self.values(), self.keys()))
+        out: dict[VT, KT] = {v: k for k, v in self.items()}
+        # return self.__class__({v: k for k, v in self.items()})  # type: ignore
+        return self.__class__(out)  # type: ignore
+
+    # Apply
+    @overload
+    def apply(self, func: Callable[[VT], R]) -> "DictExt[KT, R]": ...
+
+    @overload
+    def apply(self, func: Callable[[KT], R], apply_to_value: Literal[False] = ...) -> "DictExt[R, VT]": ...
+
+    def apply(self, func: Callable[[KT | VT], R], apply_to_value: bool = True):  # type: ignore
+        """
+        Apply function to ``DictExt.keys()`` or ``DictExt.values()``
+
+        Parameters
+        ----------
+        func : Callable
+            Callable function
+
+        apply_to_value : bool
+            | ``True``: Apply ``func`` to ``DictExt.values()``
+            | ``False``: Apply ``func`` to ``DictExt.keys()``
+
+        Returns
+        -------
+        DictExt
+            DictExt
+
+
+        Example:
+        --------
+        >>> test = DictExt({"abc": 9})
+        >>> test.apply(str)
+        {'abc': '9'}
+        """
+        if apply_to_value:
+            new_dict_v: dict[KT, R] = {k: func(v) for k, v in self.items()}
+            return self.__class__(new_dict_v)  # type: ignore
+        else:
+            new_dict_k: dict[R, VT] = {func(k): v for k, v in self.items()}
+            return self.__class__(new_dict_k)  # type: ignore
+
+    # Aggregate
+    @versionchanged("5.0.0", reason="Updated to handle more types and operator")
+    @versionadded("3.4.0")
+    def aggregate(
+        self,
+        other_dict: dict[KT, VT | VT2],
+        default_value: Any = 0,
+        operator_func: Callable[[Any, Any], R] = operator.add,  # operator add
+    ):
+        """
+        Aggregates the values of the current dictionary with another dictionary.
+
+        For each unique key, this method applies the specified operator to the values
+        from both dictionaries. If a key exists in only one dictionary, its value is used.
+        If an error occurs during aggregation (e.g., incompatible types), the values
+        from both dictionaries are returned as a list.
+
+        Parameters
+        ----------
+        other_dict : dict
+            The dictionary to aggregate with.
+
+        default_value : Any, optional
+            The value to use for missing keys, by default ``0``
+
+
+        operator_func : Callable[[Any, Any], Any], optional
+            A function that takes two arguments and returns a single value,
+            by default ``operator.add``
+
+        Returns
+        -------
+        Self
+            A new instance of the aggregated dictionary.
+
+
+        Example:
+        --------
+        >>> test = DictExt({"test": 5, "test2": 9})
+        >>> agg = {"test1": 10, "test2": 1}
+        >>> print(test.aggregate(agg))
+        {'test1': 10, 'test': 5, 'test2': 10}
+
+        >>> test = DictExt({"test": 5, "test2": 9})
+        >>> agg = {"test1": 10, "test2": "1"}
+        >>> print(test.aggregate(agg))
+        {'test1': 10, 'test': 5, 'test2': [9, '1']}
+        """
+        merged_output: dict[KT, VT | R | list[VT | VT2]] = {}
+
+        # Create a set of all unique keys from both dictionaries
+        all_keys = set(self) | set(other_dict)
+
+        for k in all_keys:
+            # Retrieve values with default fallback
+            value_self = self.get(k, default_value)
+            value_other = other_dict.get(k, default_value)
+
+            try:
+                # Attempt to apply the operator for existing keys
+                merged_output[k] = operator_func(value_self, value_other)
+            except TypeError:
+                # If a TypeError occurs (e.g., if values are not compatible), store values as a list
+                merged_output[k] = [value_self, value_other]  # type: ignore
+
+        return self.__class__(merged_output)  # type: ignore

absfuyu/dxt/dxt_support.py

@@ -3,8 +3,8 @@ Absfuyu: Data Extension
 -----------------------
 Support classes
 
-Version: 5.11.0
-Date updated: 30/09/2025 (dd/mm/yyyy)
+Version: 5.12.0
+Date updated: 17/10/2025 (dd/mm/yyyy)
 """
 
 # Module Package

absfuyu/dxt/intext.py

@@ -3,8 +3,8 @@ Absfuyu: Data Extension
 -----------------------
 int extension
 
-Version: 5.11.0
-Date updated: 30/09/2025 (dd/mm/yyyy)
+Version: 5.12.0
+Date updated: 17/10/2025 (dd/mm/yyyy)
 """
 
 # Module Package