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

absfuyu/tools/checksum.py

@@ -3,8 +3,8 @@ Absufyu: Checksum
 -----------------
 Check MD5, SHA256, ...
 
-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 level

absfuyu/tools/converter.py

@@ -3,8 +3,8 @@ Absufyu: Converter
 ------------------
 Convert stuff
 
-Version: 5.2.0
-Date updated: 15/03/2025 (dd/mm/yyyy)
+Version: 5.4.0
+Date updated: 21/03/2025 (dd/mm/yyyy)
 
 Feature:
 --------

absfuyu/tools/generator.py

@@ -3,8 +3,8 @@ Absfuyu: Generator
 ------------------
 This generate stuff (Not python's ``generator``)
 
-Version: 5.2.0
-Date updated: 15/03/2025 (dd/mm/yyyy)
+Version: 5.4.0
+Date updated: 21/03/2025 (dd/mm/yyyy)
 
 Features:
 ---------

absfuyu/tools/inspector.py

@@ -3,22 +3,24 @@ Absfuyu: Inspector
 ------------------
 Inspector
 
-Version: 5.2.0
-Date updated: 16/03/2025 (dd/mm/yyyy)
+Version: 5.4.0
+Date updated: 21/03/2025 (dd/mm/yyyy)
 """
 
 # Module level
 # ---------------------------------------------------------------------------
 __all__ = ["Inspector", "inspect_all"]
 
+
 # Library
 # ---------------------------------------------------------------------------
 import inspect as _inspect
 import os
+from collections.abc import Callable
 from functools import partial
 from textwrap import TextWrapper
 from textwrap import shorten as text_shorten
-from typing import Any, Literal, overload
+from typing import Any, Literal, get_overloads, overload
 
 from absfuyu.core.baseclass import (
     AutoREPRMixin,
@@ -26,6 +28,7 @@ from absfuyu.core.baseclass import (
     ShowAllMethodsMixin,
 )
 from absfuyu.dxt.listext import ListExt
+from absfuyu.typings import P, R
 from absfuyu.util.text_table import OneColumnTableMaker
 
 
@@ -71,6 +74,9 @@ class Inspector(AutoREPRMixin):
         Maximum lines for the output's header (class, signature, repr).
         Must be >= 1, by default ``8``
 
+    style : Literal["normal", "bold", "dashed", "double", "rounded"], optional
+        Style for the table, by default ``"normal"``
+
 
     Example:
     --------
@@ -96,6 +102,7 @@ class Inspector(AutoREPRMixin):
         include_attribute: bool = True,
         include_private: bool = False,
         max_textwrap_lines: int = 8,
+        style: Literal["normal", "bold", "dashed", "double", "rounded"] = "normal",
     ) -> None: ...
 
     def __init__(
@@ -114,6 +121,8 @@ class Inspector(AutoREPRMixin):
         include_attribute: bool = True,
         include_private: bool = False,
         include_all: bool = False,
+        # Style
+        style: Literal["normal", "bold", "dashed", "double", "rounded"] = "normal",
     ) -> None:
         """
         Inspect an object.
@@ -153,6 +162,9 @@ class Inspector(AutoREPRMixin):
             Maximum lines for the output's header (class, signature, repr).
             Must be >= 1, by default ``8``
 
+        style : Literal["normal", "bold", "dashed", "double", "rounded"], optional
+            Style for the table, by default ``"normal"``
+
 
         Example:
         --------
@@ -165,6 +177,7 @@ class Inspector(AutoREPRMixin):
         self.include_property = include_property
         self.include_attribute = include_attribute
         self.include_private = include_private
+        self._style = style
 
         if include_all:
             self.include_docs = True
@@ -203,7 +216,9 @@ class Inspector(AutoREPRMixin):
 
     # Support
     def _long_list_terminal_size(self, long_list: list) -> list:
-        ll = ListExt(long_list).wrap_to_column(self._linelength, margin=4)
+        ll = ListExt(long_list).wrap_to_column(
+            self._linelength, margin=4, transpose=True
+        )
         return list(ll)
 
     # Signature
@@ -240,12 +255,30 @@ class Inspector(AutoREPRMixin):
             return None
         return [str(x) for x in sig.parameters.values()]
 
+    def _get_func_signature(self, func: Callable[P, R]) -> list[str]:
+        overloads = list(get_overloads(func))
+        if len(overloads) < 1:
+            return [
+                f"{self._get_signature_prefix()} {func.__name__}{_inspect.signature(func)}"
+            ]
+        return [
+            f"{self._get_signature_prefix()} {x.__name__}{_inspect.signature(x)}"
+            for x in overloads
+        ]
+
     def _make_signature(self) -> list[str]:
         """
         Inspector's workflow:
         02. Make signature
         """
         try:
+            # if isinstance(self.obj, Callable):
+            if _inspect.isfunction(self.obj):
+                funcs = [
+                    self._text_wrapper.wrap(x)
+                    for x in self._get_func_signature(self.obj)
+                ]
+                return ListExt(funcs).flatten()
             return self._text_wrapper.wrap(
                 f"{self._get_signature_prefix()} {self.obj.__name__}{_inspect.signature(self.obj)}"
             )
@@ -392,7 +425,7 @@ class Inspector(AutoREPRMixin):
 
     # Output
     def _make_output(self) -> OneColumnTableMaker:
-        table = OneColumnTableMaker(self._linelength)
+        table = OneColumnTableMaker(self._linelength, style=self._style)
         body: list[str] = []
 
         # Signature
@@ -419,7 +452,9 @@ class Inspector(AutoREPRMixin):
 
         # Method & Property
         try:
-            method_n_properties = self._get_method_property().flatten_value().pack()
+            method_n_properties = (
+                self._get_method_property().flatten_value().pack().sort()
+            )
             if self.include_method:
                 ml = [
                     text_shorten(f"- {x}", self._linelength - 4)

absfuyu/tools/keygen.py

@@ -5,8 +5,8 @@ Mod7 product key generator (90's)
 
 This is for educational and informative purposes only.
 
-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/tools/obfuscator.py

@@ -3,8 +3,8 @@ Absfuyu: Obfuscator
 -------------------
 Obfuscate code
 
-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 level

absfuyu/tools/passwordlib.py

@@ -3,8 +3,8 @@ Absfuyu: Passwordlib
 --------------------
 Password library
 
-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 level

absfuyu/tools/shutdownizer.py

@@ -3,8 +3,8 @@ Absfuyu: Shutdownizer
 ---------------------
 This shutdowns
 
-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/tools/web.py

@@ -3,8 +3,8 @@ Absfuyu: Web
 ------------
 Web, ``request``, ``BeautifulSoup`` stuff
 
-Version: 5.2.0
-Date updated: 10/03/2025 (dd/mm/yyyy)
+Version: 5.4.0
+Date updated: 21/03/2025 (dd/mm/yyyy)
 """
 
 # Library

absfuyu/typings.py

@@ -3,8 +3,8 @@ Absfuyu: Core
 -------------
 Pre-defined typing
 
-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
@@ -14,6 +14,8 @@ __all__ = [
     "T",
     "T_co",
     "T_contra",
+    "KT",
+    "VT",
     "P",
     "R",
     "_CALLABLE",
@@ -48,6 +50,9 @@ T_co = TypeVar("T_co", covariant=True)  # Type covariant
 # with a more general type without causing errors
 T_contra = TypeVar("T_contra", contravariant=True)  # Type contravariant
 
+KT = TypeVar("KT")
+VT = TypeVar("VT")
+
 # Callable
 P = ParamSpec("P")  # Parameter type
 R = TypeVar("R")  # Return type - Can be anything

absfuyu/util/__init__.py

@@ -3,26 +3,33 @@ Absufyu: Utilities
 ------------------
 Some random utilities
 
-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
 # ---------------------------------------------------------------------------
 __all__ = [
+    # util
     "get_installed_package",
     "set_min",
     "set_max",
     "set_min_max",
     "stop_after_day",
+    "convert_to_raw_unicode",
+    # shorten number
+    "Decimal",
 ]
 
+
 # Library
 # ---------------------------------------------------------------------------
 import pkgutil
 from datetime import datetime
+from string import printable
 
-from absfuyu.core import deprecated, versionadded, versionchanged
+from absfuyu.core.docstring import deprecated, versionadded, versionchanged
+from absfuyu.util.shorten_number import Decimal
 
 
 # Function
@@ -192,3 +199,50 @@ def stop_after_day(
     result = end_date - now
     if result.days < 0:
         raise SystemExit("End of time")
+
+
+@versionadded("5.4.0")
+def convert_to_raw_unicode(text: str, partial: bool = True) -> str:
+    r"""
+    Convert text to raw unicode variant.
+
+    Parameters
+    ----------
+    text : str
+        Text to convert
+
+    partial : bool, optional
+        Only convert characters that not in ``string.printable``,
+        by default ``True``
+
+    Returns
+    -------
+    str
+        Converted text.
+
+
+    Example:
+    --------
+    >>> convert_to_raw_unicode("résumé")
+    r\u00E9sum\u00E9
+
+    >>> convert_to_raw_unicode("résumé", partial=False)
+    \u0072\u00E9\u0073\u0075\u006D\u00E9
+    """
+
+    character_set = printable
+
+    def _convert(character: str) -> str:
+        """Get unicode value"""
+        # ord(c): Returns the Unicode code point for a one-character string c.
+        _ord = ord(character)
+        # f"\\u{_ord:04X}": Formats the Unicode code point as a four-digit
+        # hexadecimal number for code points less than 0x10000.
+        # f"\\U{_ord:08X}": Formats the Unicode code point as an eight-digit
+        # hexadecimal number for code points greater than or equal to 0x10000.
+        return f"\\u{_ord:04X}" if _ord < 0x10000 else f"\\U{_ord:08X}"
+
+    return "".join(
+        character if character in character_set and partial else _convert(character)
+        for character in text
+    )

absfuyu/util/api.py

@@ -3,8 +3,8 @@ Absufyu: API
 ------------
 Fetch data stuff
 
-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 level

absfuyu/util/json_method.py

@@ -3,8 +3,8 @@ Absfuyu: Json Method
 --------------------
 ``.json`` file handling
 
-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 level

absfuyu/util/lunar.py

@@ -4,8 +4,8 @@ Absfuyu: Lunar calendar
 -----------------------
 Convert to lunar calendar
 
-Version: 5.2.0
-Date updated: 10/03/2025 (dd/mm/yyyy)
+Version: 5.4.0
+Date updated: 21/03/2025 (dd/mm/yyyy)
 
 Source:
 -------

absfuyu/util/path.py

@@ -3,8 +3,8 @@ Absfuyu: Path
 -------------
 Path related
 
-Version: 5.2.0
-Date updated: 14/03/2025 (dd/mm/yyyy)
+Version: 5.4.0
+Date updated: 21/03/2025 (dd/mm/yyyy)
 
 Feature:
 --------
@@ -46,6 +46,128 @@ from absfuyu.core.decorator import add_subclass_methods_decorator
 from absfuyu.core.docstring import deprecated, versionadded, versionchanged
 from absfuyu.logger import logger
 
+# Template
+# ---------------------------------------------------------------------------
+ORGANIZE_TEMPLATE: dict[str, list[str]] = {
+    "Code": [".ps1", ".py", ".rs", ".js", ".c", ".h", ".cpp", ".r", ".cmd", ".bat"],
+    "Comic": [".cbz", ".cbr", ".cb7", ".cbt", ".cba"],
+    "Compressed": [
+        ".7z",
+        ".zip",
+        ".rar",
+        ".apk",
+        ".cab",
+        ".tar",
+        ".tgz",
+        ".txz",
+        ".bz2",
+        ".gz",
+        ".lz",
+        ".lz4",
+        ".lzma",
+        ".xz",
+        ".zipx",
+        ".zst",
+    ],
+    "Documents": [".docx", ".doc", ".xls", ".xlsx", ".ppt", ".pptx", ".pdf", ".txt"],
+    "Ebook": [
+        ".epub",
+        ".mobi",
+        ".prc",
+        ".lrf",
+        ".lrx",
+        ".pdb",
+        ".azw",
+        ".azw3",
+        ".kf8",
+        ".kfx",
+        ".opf",
+    ],
+    "Music": [".mp3", ".flac", ".wav", ".m4a", ".wma", ".aac", ".alac", ".aiff"],
+    "OS": [".iso", ".dmg", ".wim"],
+    "Pictures": [
+        ".jpg",
+        ".jpeg",
+        ".png",
+        ".apng",
+        ".avif",
+        ".bmp",
+        ".gif",
+        ".jfif",
+        ".pjpeg",
+        ".pjp",
+        ".svg",
+        ".ico",
+        ".cur",
+        ".tif",
+        ".tiff",
+        ".webp",
+    ],
+    "Programs": [".exe", ".msi"],
+    "Video": [
+        ".3g2",
+        ".3gp",
+        ".avi",
+        ".flv",
+        ".m2ts",
+        ".m4v",
+        ".mkv",
+        ".mov",
+        ".mp4",
+        ".mpeg",
+        ".mpv",
+        ".mts",
+        ".ts",
+        ".vob",
+        ".webm",
+    ],
+    "Raw pictures": [
+        ".3fr",
+        ".ari",
+        ".arw",
+        ".bay",
+        ".braw",
+        ".crw",
+        ".cr2",
+        ".cr3",
+        ".cap",
+        ".data",
+        ".dcs",
+        ".dcr",
+        ".dng",
+        ".drf",
+        ".eip",
+        ".erf",
+        ".fff",
+        ".gpr",
+        ".iiq",
+        ".k25",
+        ".kdc",
+        ".mdc",
+        ".mef",
+        ".mos",
+        ".mrw",
+        ".nef",
+        ".nrw",
+        ".obm",
+        ".orf",
+        ".pef",
+        ".ptx",
+        ".pxn",
+        ".r3d",
+        ".raf",
+        ".raw",
+        ".rwl",
+        ".rw2",
+        ".rwz",
+        ".sr2",
+        ".srf",
+        ".srw",
+        ".tif",
+        ".x3f",
+    ],
+}
+
 
 # Support Class
 # ---------------------------------------------------------------------------
@@ -444,10 +566,42 @@ class DirectoryArchiverMixin(DirectoryBase):
 
 class DirectoryOrganizerMixin(DirectoryBase):
     """
-    Directory - File organizer - SOON
+    Directory - File organizer
+
+    - Organize
     """
 
-    pass
+    @versionadded("5.3.0")
+    def organize(self, dirtemplate: dict[str, list[str]] | None = None) -> None:
+        """
+        Organize a directory.
+
+        Parameters
+        ----------
+        dirtemplate : dict[str, Collection[str]] | None, optional
+            | Template to move file to, by default ``None``.
+            | Example: {"Documents": [".txt", ".pdf", ...]}
+        """
+        if dirtemplate is None:
+            template = ORGANIZE_TEMPLATE
+        else:
+            template = dirtemplate
+
+        other_dir = self.source_path.joinpath("Others")
+        other_dir.mkdir(parents=True, exist_ok=True)
+
+        for path in self.source_path.iterdir():
+            if path.is_dir():
+                continue
+
+            for dir_name, suffixes in template.items():
+                if path.suffix.lower() in suffixes:
+                    move_path = self.source_path.joinpath(dir_name)
+                    move_path.mkdir(parents=True, exist_ok=True)
+                    path.rename(move_path.joinpath(path.name))
+                    break
+            else:
+                path.rename(other_dir.joinpath(path.name))
 
 
 class DirectoryTreeMixin(DirectoryBase):

absfuyu/util/performance.py

@@ -3,8 +3,8 @@ Absfuyu: Performance
 --------------------
 Performance Check
 
-Version: 5.2.0
-Date updated: 15/03/2025 (dd/mm/yyyy)
+Version: 5.4.0
+Date updated: 21/03/2025 (dd/mm/yyyy)
 
 Feature:
 --------

absfuyu/util/shorten_number.py

@@ -3,8 +3,8 @@ Absfuyu: Shorten number
 -----------------------
 Short number base on suffixes
 
-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