absfuyu 5.6.1__py3-none-any.whl → 6.1.2__py3-none-any.whl

absfuyu/__init__.py

@@ -22,19 +22,21 @@ Using in cmd:
 __title__ = "absfuyu"
 __author__ = "AbsoluteWinter"
 __license__ = "MIT License"
-__version__ = "5.6.1"
+__version__ = "6.1.2"
 __all__ = [
     "core",
     "config",
     "dxt",
     "extra",
-    "logger",
     "fun",
     "game",
     "general",
+    "numbers",
     "pkg_data",
-    "sort",
     "tools",
     "util",
+    "logger",
+    "sort",
+    "typings",
     "version",
 ]

absfuyu/__main__.py

@@ -3,8 +3,8 @@ ABSFUYU
 -------
 COMMAND LINE INTERFACE
 
-Version: 5.6.1
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 6.1.1
+Date updated: 30/12/2025 (dd/mm/yyyy)
 """
 
 # Library

absfuyu/cli/__init__.py

@@ -3,8 +3,8 @@ ABSFUYU
 -------
 COMMAND LINE INTERFACE
 
-Version: 5.6.1
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 6.1.1
+Date updated: 30/12/2025 (dd/mm/yyyy)
 """
 
 __all__ = ["cli"]
@@ -15,6 +15,7 @@ import click
 import colorama
 
 from absfuyu import __title__, __version__
+from absfuyu.cli.audio_group import audio_group
 from absfuyu.cli.color import COLOR
 from absfuyu.cli.config_group import config_group
 from absfuyu.cli.do_group import do_group
@@ -25,6 +26,15 @@ from absfuyu.cli.tool_group import tool_group
 colorama.init(autoreset=True)
 
 
+def quick_info() -> str:
+    return (
+        f"- os/type: {platform.system().lower()}\n"
+        f"- os/kernel: {platform.version()}\n"
+        f"- os/arch: {platform.machine().lower()}\n"
+        f"- python version: {platform.python_version()}\n"
+    )
+
+
 @click.command()
 def version() -> None:
     """Show current version"""
@@ -50,4 +60,5 @@ cli.add_command(config_group)
 cli.add_command(do_group)
 cli.add_command(game_group)
 cli.add_command(tool_group)
+cli.add_command(audio_group)
 cli.add_command(version)

absfuyu/cli/audio_group.py

@@ -0,0 +1,98 @@
+"""
+ABSFUYU CLI
+-----------
+Audio
+
+Version: 6.1.1
+Date updated: 30/12/2025 (dd/mm/yyyy)
+"""
+
+# Module Package
+# ---------------------------------------------------------------------------
+__all__ = ["audio_group"]
+
+
+# Library
+# ---------------------------------------------------------------------------
+from pathlib import Path
+
+import click
+
+from absfuyu.extra.audio.convert import DirectoryAudioConvertMixin
+from absfuyu.extra.audio.lossless import DirectoryAudioLosslessCheckMixin
+
+
+# CLI
+# ---------------------------------------------------------------------------
+@click.command(name="c3")
+@click.argument("dir_path", type=str)
+@click.option(
+    "--recursive",
+    "-r",
+    "recursive_mode",
+    type=bool,
+    default=False,
+    is_flag=True,
+    show_default=True,
+    help="Scan for every file in the folder (including child folder)",
+)
+@click.option(
+    "--format",
+    "-f",
+    "from_format",
+    type=str,
+    default=".flac",
+    show_default=True,
+    help="From which audio format",
+)
+def convert_to_mp3(dir_path: str, from_format: str, recursive_mode: bool) -> None:
+    """Convert to .mp3 file"""
+
+    engine = DirectoryAudioConvertMixin(Path(dir_path).resolve())
+
+    try:
+        engine.convert_to_mp3(from_format=from_format, recursive=recursive_mode)
+    except Exception:
+        engine.convert_to_mp3_single_thread(from_format=from_format, recursive=recursive_mode)
+    click.echo("Done")
+
+
+@click.command(name="lc")
+@click.argument("dir_path", type=str)
+@click.option(
+    "--recursive",
+    "-r",
+    "recursive_mode",
+    type=bool,
+    default=False,
+    is_flag=True,
+    show_default=True,
+    help="Scan for every file in the folder (including child folder)",
+)
+@click.option(
+    "--format",
+    "-f",
+    "format",
+    type=str,
+    default=".flac",
+    show_default=True,
+    help="Audio format",
+)
+def lossless_check(dir_path: str, format: str, recursive_mode: bool) -> None:
+    """Check for lossless audio file"""
+
+    engine = DirectoryAudioLosslessCheckMixin(Path(dir_path).resolve())
+    try:
+        engine.lossless_check(from_format=format, recursive=recursive_mode)
+    except Exception:
+        engine.lossless_check_single_thread(from_format=format, recursive=recursive_mode)
+    click.echo("Done")
+
+
+@click.group(name="audio")
+def audio_group() -> None:
+    """Audio related"""
+    pass
+
+audio_group.add_command(lossless_check)
+audio_group.add_command(convert_to_mp3)

absfuyu/cli/color.py

@@ -3,8 +3,8 @@ ABSFUYU CLI
 -----------
 Color
 
-Version: 5.6.1
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 6.1.1
+Date updated: 30/12/2025 (dd/mm/yyyy)
 """
 
 # Module Package

absfuyu/cli/config_group.py

@@ -3,8 +3,8 @@ ABSFUYU CLI
 -----------
 Config
 
-Version: 5.6.1
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 6.1.1
+Date updated: 30/12/2025 (dd/mm/yyyy)
 """
 
 # Module Package

absfuyu/cli/do_group.py

@@ -3,8 +3,8 @@ ABSFUYU CLI
 -----------
 Do
 
-Version: 5.6.1
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 6.1.1
+Date updated: 30/12/2025 (dd/mm/yyyy)
 """
 
 # Module Package

absfuyu/cli/game_group.py

@@ -3,8 +3,8 @@ ABSFUYU CLI
 -----------
 Game
 
-Version: 5.6.1
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 6.1.1
+Date updated: 30/12/2025 (dd/mm/yyyy)
 """
 
 # Module Package
@@ -17,6 +17,7 @@ __all__ = ["game_group"]
 import click
 
 from absfuyu.game import game_escapeLoop, game_RockPaperScissors
+from absfuyu.game.schulte import SchulteTable
 from absfuyu.game.sudoku import Sudoku
 from absfuyu.game.tictactoe import GameMode, TicTacToe
 from absfuyu.game.wordle import Wordle
@@ -103,6 +104,22 @@ def tictactoe(size: int, game_mode: str, bot_time: float) -> None:
     instance.play(game_mode, bot_time=bot_time)
 
 
+@click.command(name="schulte")
+@click.option(
+    "--size",
+    "-s",
+    "size",
+    type=int,
+    default=5,
+    show_default=True,
+    help="Size of the table",
+)
+def schulte_table(size: int) -> None:
+    """Schulte table"""
+    engine = SchulteTable(size=size)
+    engine.make_table()
+
+
 @click.group(name="game")
 def game_group() -> None:
     """Play game"""
@@ -114,3 +131,4 @@ game_group.add_command(escape_loop)
 game_group.add_command(wordle_solver)
 game_group.add_command(sudoku_solver)
 game_group.add_command(tictactoe)
+game_group.add_command(schulte_table)

absfuyu/cli/tool_group.py

@@ -3,8 +3,8 @@ ABSFUYU CLI
 -----------
 Tool
 
-Version: 5.6.1
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 6.1.1
+Date updated: 30/12/2025 (dd/mm/yyyy)
 """
 
 # Module Package
@@ -14,6 +14,7 @@ __all__ = ["tool_group"]
 
 # Library
 # ---------------------------------------------------------------------------
+from pathlib import Path
 from typing import Literal
 
 import click
@@ -24,7 +25,7 @@ from absfuyu.tools.converter import Base64EncodeDecode, Text2Chemistry
 
 # CLI
 # ---------------------------------------------------------------------------
-@click.command(name="checksum")
+@click.command(name="cs")
 @click.argument("file_path", type=str)
 @click.option(
     "--hashmode",
@@ -80,6 +81,67 @@ def file_checksum(
         click.echo(res == hash_to_compare)
 
 
+@click.command(name="cimg")
+@click.argument("dir_path", type=str)
+@click.argument("to_format", type=str)
+def convert_img(dir_path: str, to_format: str) -> None:
+    """Convert image in directory"""
+    from absfuyu.extra.img.converter import ImgConverter
+
+    engine = ImgConverter(Path(dir_path).resolve())
+    engine.img_convert(to_format)
+    click.echo("Done")
+
+
+@click.command(name="rdimg")
+@click.argument("dir_path", type=str)
+@click.option(
+    "--dryrun",
+    "-d",
+    "dry_run",
+    type=bool,
+    default=False,
+    is_flag=True,
+    show_default=True,
+    help="Simulate deleting only",
+)
+@click.option(
+    "--recursive",
+    "-r",
+    "recursive_mode",
+    type=bool,
+    default=False,
+    is_flag=True,
+    show_default=True,
+    help="Scan for every file in the folder (including child folder)",
+)
+@click.option(
+    "--threshold",
+    "-t",
+    "threshold",
+    type=int,
+    default=5,
+    show_default=True,
+    help="Threshold: 0 for exact image, 5 to 10 for light edit",
+)
+@click.option(
+    "--keepmode",
+    "-k",
+    "keep_mode",
+    type=click.Choice(["first", "last", "best"]),
+    default="best",
+    show_default=True,
+    help="Keep mode",
+)
+def remove_dup_img(dir_path: str, threshold: bool, recursive_mode: bool, keep_mode: str, dry_run: bool) -> None:
+    """Remove duplicate images in directory"""
+    from absfuyu.extra.img.dup_check import DirectoryRemoveDuplicateImageMixin as DRDI
+
+    engine = DRDI(Path(dir_path).resolve())
+    engine.remove_duplicate_images(threshold=threshold, recursive=recursive_mode, keep_mode=keep_mode, dry_run=dry_run)
+    click.echo("Done")
+
+
 @click.command(name="t2c")
 @click.argument("text", type=str)
 def text2chem(text: str) -> None:
@@ -121,7 +183,7 @@ def base64convert_img(img_path: str, data_tag: bool) -> None:
 
 
 @click.group(name="b64")
-def base64_group():
+def base64_group() -> None:
     """Base64 encode decode"""
     pass
 
@@ -138,5 +200,7 @@ def tool_group() -> None:
 
 
 tool_group.add_command(file_checksum)
+tool_group.add_command(convert_img)
+tool_group.add_command(remove_dup_img)
 tool_group.add_command(base64_group)
 tool_group.add_command(text2chem)

absfuyu/config/__init__.py

@@ -1,10 +1,10 @@
 """
 Absfuyu: Configuration
 ----------------------
-Package configuration module
+Package configuration module - internal use
 
-Version: 5.6.1
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 6.1.1
+Date updated: 30/12/2025 (dd/mm/yyyy)
 """
 
 # Module level

absfuyu/core/__init__.py

@@ -3,8 +3,8 @@ Absfuyu: Core
 -------------
 Bases for other features
 
-Version: 5.6.1
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 6.1.1
+Date updated: 30/12/2025 (dd/mm/yyyy)
 """
 
 # Module Package
@@ -27,11 +27,15 @@ __all__ = [
 ]
 
 __package_feature__ = [
-    "beautiful",  # BeautifulOutput
-    "docs",  # For (package) hatch's env use only
-    "extra",  # DataFrame
     "full",  # All package
-    "dev",
+    "docs",  # For (package) hatch's env use only
+    "extra",  # Extra features
+    "beautiful",  # BeautifulOutput
+    "dadf",  # DataFrame
+    "pdf",  # PDF
+    "pic",  # picture related
+    "xml",  # XML
+    "ggapi",  # Google
 ]
 
 

absfuyu/core/baseclass.py

@@ -3,8 +3,8 @@ Absfuyu: Core
 -------------
 Bases for other features
 
-Version: 5.6.1
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 6.1.1
+Date updated: 30/12/2025 (dd/mm/yyyy)
 """
 
 # Module Package
@@ -18,6 +18,7 @@ __all__ = [
     # Mixins
     "GetClassMembersMixin",
     "AutoREPRMixin",
+    "AddFormatMixin",
     # Class
     "BaseClass",
     "BaseDataclass",
@@ -27,6 +28,7 @@ __all__ = [
 
 # Library
 # ---------------------------------------------------------------------------
+from collections.abc import Callable
 from dataclasses import dataclass, field
 from typing import Any, ClassVar, Literal, Self
 
@@ -57,7 +59,8 @@ class BaseDataclass:
     Base dataclass.
 
     Contains util methods:
-    - Get fields
+    - _get_fields
+    - to_dict
     """
 
     @classmethod
@@ -73,6 +76,22 @@ class BaseDataclass:
         _fields = getattr(cls, "__dataclass_fields__", ())
         return tuple(_fields)
 
+    # @versionadded("5.11.0")
+    def to_dict(self):
+        """
+        Convert dataclass into dict
+
+        Returns
+        -------
+        dict
+            Dataclass converted into dict
+        """
+        fields = self._get_fields()
+        output = {}
+        for field in fields:
+            output.__setitem__(field, self.__getattribute__(field))
+        return output
+
 
 # Support
 # ---------------------------------------------------------------------------
@@ -844,20 +863,6 @@ class GetClassMembersMixin:
         mems[self.__class__.__name__].attributes = attrs
         return mems
 
-    # @remove("6.0.0")
-    # @deprecated("5.5.0")
-    # @versionadded("5.1.0")
-    @classmethod
-    def _get_methods_and_properties(
-        cls,
-        skip_private_attribute: bool = True,
-        include_private_method: bool = False,
-    ) -> ClassMembersResult:
-        """Wrapper of ``cls._get_members``, deprecated"""
-        return cls._get_members(
-            dunder=skip_private_attribute, private=include_private_method
-        )
-
     @classmethod
     def show_all_methods(
         cls,
@@ -950,13 +955,6 @@ class GetClassMembersMixin:
         return result.prioritize_value("properties")
 
 
-# Temp name for backward compability
-# Will be removed at version 6.0.0
-MethodNPropertyList = ClassMembers
-MethodNPropertyResult = ClassMembersResult
-ShowAllMethodsMixin = GetClassMembersMixin
-
-
 class AutoREPRMixin:
     """
     Generate ``repr()`` output as ``<class(param1=any, param2=any, ...)>``
@@ -1014,19 +1012,38 @@ class AutoREPRMixin:
         return f"{self.__class__.__name__}({sep.join(out)})"
 
 
-# Class
-# ---------------------------------------------------------------------------
-class BaseClass(GetClassMembersMixin, AutoREPRMixin):
-    """Base class"""
+class AddFormatMixin:
+    """
+    This mixin that allows classes to define and register custom format
+    specifications for use with Python's built-in :func:`format` function
+    and f-string formatting.
 
-    def __str__(self) -> str:
-        return repr(self)
+    This mixin extends the standard ``__format__`` mechanism by letting you
+    attach named formatting presets at runtime. Each format spec is simply a
+    callable that receives the object instance and returns a formatted string.
+
+    Attribute ``_format_specs`` is used and must not be overwritten in any
+    circumstances.
+    """
+
+    def __init__(self) -> None:
+        self._format_specs: dict[str, Callable[[Self], str]] = {}
 
     def __format__(self, format_spec: str) -> str:
         """
-        Formats the object according to the specified format.
-        If no format_spec is provided, returns the object's string representation.
-        (Currently a dummy function)
+        Format the object using a registered format specification.
+
+        Parameters
+        ----------
+        format_spec : str
+            The name of a previously registered format spec. If empty or not
+            found, the object's ``__str__`` representation is returned.
+
+        Returns
+        -------
+        str
+            The formatted string according to the given format spec.
+
 
         Usage
         -----
@@ -1035,7 +1052,60 @@ class BaseClass(GetClassMembersMixin, AutoREPRMixin):
         >>> print(format(<object>, <format_spec>))
         """
 
-        return self.__str__()
+        func = self._format_specs.get(format_spec, None)
+
+        if func is None:
+            return self.__str__()
+        else:
+            return func(self)
+
+    def add_format_spec(self, name: str, format_func: Callable[[Self], str]) -> None:
+        """
+        Register a custom format specification.
+
+        Parameters
+        ----------
+        name : str
+            The format specifier string to register.
+
+        format_func : Callable[[Self], str]
+            A function that receives the object instance and returns a formatted string.
+        """
+        if getattr(self, "_format_specs", None) is None:
+            self._format_specs: dict[str, Callable[[Self], str]] = {}
+        self._format_specs[name] = format_func
+
+    @property
+    def available_format_spec(self) -> list[str]:
+        """
+        List all registered format specification names.
+
+        Returns
+        -------
+        list[str]
+            A list containing the names of all format specs that have been
+            registered via :meth:`add_format_spec`. If no format specs exist,
+            an empty list is returned.
+
+
+        Notes
+        -----
+        - This is a convenience property to inspect which formatting presets
+        are currently available for the object.
+        - The list contains only the names (keys), not the formatting functions.
+        """
+        if getattr(self, "_format_specs", None) is None:
+            return []
+        return list(self._format_specs)
+
+
+# Class
+# ---------------------------------------------------------------------------
+class BaseClass(GetClassMembersMixin, AutoREPRMixin):
+    """Base class"""
+
+    def __str__(self) -> str:
+        return repr(self)
 
 
 # Metaclass

absfuyu/core/baseclass2.py

@@ -3,8 +3,8 @@ Absfuyu: Core
 -------------
 Bases for other features (with library)
 
-Version: 5.6.1
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 6.1.1
+Date updated: 30/12/2025 (dd/mm/yyyy)
 """
 
 # Module Package
@@ -62,6 +62,47 @@ class ShowAllMethodsMixinInspectVer:
         return result
 
 
+class UniversalConfigMixin:
+    """
+    Universal config Mixin
+
+    This use these attributes:
+    - _instance_config
+    - config
+
+    Example:
+    --------
+    >>> class Test(UniversalConfigMixin):
+    >>>     DEFAULT_CONFIG = {"test": True}
+    >>> test = Test(config={"new_key": True})
+    >>> print(test.config)
+    {'test': True, 'new_key': True}
+    """
+
+    DEFAULT_CONFIG = {}
+
+    def __init__(self, **kwargs) -> None:
+        try:
+            super().__init__(**kwargs)
+        except TypeError:
+            pass
+        # instance override
+        self._instance_config = kwargs.get("config", {})
+
+    @property
+    def config(self):
+        # Priority: instance > class > default
+        merged = dict(self.DEFAULT_CONFIG)
+
+        try:
+            # merged.update(getattr(self, "CLASS_CONFIG", {}))
+            merged.update(self._instance_config)
+        except Exception:
+            pass
+
+        return merged
+
+
 # Metaclass
 # ---------------------------------------------------------------------------
 class PerformanceTrackingMeta(type):

absfuyu/core/decorator.py

@@ -3,8 +3,8 @@ Absfuyu: Core
 -------------
 Decorator
 
-Version: 5.6.1
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 6.1.1
+Date updated: 30/12/2025 (dd/mm/yyyy)
 """
 
 # Module Package