absfuyu 5.2.0__py3-none-any.whl → 5.4.0__py3-none-any.whl

absfuyu/__init__.py

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

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/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/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/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/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
@@ -83,6 +83,15 @@ def os_shutdown() -> None:
     engine.shutdown()
 
 
+@click.command(name="organize")
+@click.argument("dir", type=str)
+def organize_directory(dir: str) -> None:
+    """Organize a directory"""
+    engine = Directory(dir)
+    engine.organize()
+    click.echo(f"{COLOR['green']}Done!")
+
+
 @click.group(name="do")
 def do_group() -> None:
     """Perform functionalities"""
@@ -93,3 +102,4 @@ do_group.add_command(update)
 do_group.add_command(install)
 do_group.add_command(unzip_files_in_dir)
 do_group.add_command(os_shutdown)
+do_group.add_command(organize_directory)

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/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/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/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/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
@@ -162,6 +162,36 @@ class MethodNPropertyList(NamedTuple):
 
         return self.__class__(new_methods_list, [], [], self.properties)
 
+    def sort(self, reverse: bool = False) -> Self:
+        """
+        Sorts every element in each method list.
+
+        Parameters
+        ----------
+        reverse : bool, optional
+            Descending order, by default ``False``
+
+        Returns
+        -------
+        Self
+            Sorted.
+
+
+        Example:
+        --------
+        >>> test = MethodNPropertyList(["b", "a"], ["d", "c"], ["f", "e"], ["h", "g"])
+        >>> test.sort()
+        MethodNPropertyList(methods=['a', 'b'], classmethods=['c', 'd'], staticmethods=['e', 'f'], properties=['g', 'h'])
+
+        >>> test.pack().sort()
+        MethodNPropertyList(methods=['a', 'b', 'c <classmethod>', 'd <classmethod>', 'e <staticmethod>', 'f <staticmethod>'], properties=['g', 'h'])
+        """
+        sorted_vals = [
+            sorted(getattr(self, field), reverse=reverse) for field in self._fields
+        ]
+        # return self._make(sorted_vals)
+        return self.__class__(*sorted_vals)
+
 
 # @versionadded("5.1.0")
 class MethodNPropertyResult(dict[str, MethodNPropertyList]):

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/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/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/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/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/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/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/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/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": {