absfuyu 5.12.1__py3-none-any.whl → 5.13.0__py3-none-any.whl

absfuyu/__init__.py

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

absfuyu/__main__.py

@@ -3,7 +3,7 @@ ABSFUYU
 -------
 COMMAND LINE INTERFACE
 
-Version: 5.12.0
+Version: 5.13.0
 Date updated: 17/10/2025 (dd/mm/yyyy)
 """
 

absfuyu/cli/__init__.py

@@ -3,7 +3,7 @@ ABSFUYU
 -------
 COMMAND LINE INTERFACE
 
-Version: 5.12.0
+Version: 5.13.0
 Date updated: 17/10/2025 (dd/mm/yyyy)
 """
 

absfuyu/cli/color.py

@@ -3,7 +3,7 @@ ABSFUYU CLI
 -----------
 Color
 
-Version: 5.12.0
+Version: 5.13.0
 Date updated: 17/10/2025 (dd/mm/yyyy)
 """
 

absfuyu/cli/config_group.py

@@ -3,7 +3,7 @@ ABSFUYU CLI
 -----------
 Config
 
-Version: 5.12.0
+Version: 5.13.0
 Date updated: 17/10/2025 (dd/mm/yyyy)
 """
 

absfuyu/cli/do_group.py

@@ -3,7 +3,7 @@ ABSFUYU CLI
 -----------
 Do
 
-Version: 5.12.0
+Version: 5.13.0
 Date updated: 17/10/2025 (dd/mm/yyyy)
 """
 

absfuyu/cli/game_group.py

@@ -3,7 +3,7 @@ ABSFUYU CLI
 -----------
 Game
 
-Version: 5.12.0
+Version: 5.13.0
 Date updated: 17/10/2025 (dd/mm/yyyy)
 """
 

absfuyu/cli/tool_group.py

@@ -3,8 +3,8 @@ ABSFUYU CLI
 -----------
 Tool
 
-Version: 5.12.0
-Date updated: 17/10/2025 (dd/mm/yyyy)
+Version: 5.13.0
+Date updated: 02/11/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,18 @@ def file_checksum(
         click.echo(res == hash_to_compare)
 
 
+@click.command(name="cimg")
+@click.argument("file_path", type=str)
+@click.argument("to_format", type=str)
+def convert_img(file_path: str, to_format: str) -> None:
+    """Convert img in directory"""
+    from absfuyu.extra.picture import ImgConverter
+
+    engine = ImgConverter(Path(file_path).resolve())
+    engine.img_convert(to_format)
+    click.echo("Done")
+
+
 @click.command(name="t2c")
 @click.argument("text", type=str)
 def text2chem(text: str) -> None:
@@ -121,7 +134,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 +151,6 @@ def tool_group() -> None:
 
 
 tool_group.add_command(file_checksum)
+tool_group.add_command(convert_img)
 tool_group.add_command(base64_group)
 tool_group.add_command(text2chem)

absfuyu/config/__init__.py

@@ -3,7 +3,7 @@ Absfuyu: Configuration
 ----------------------
 Package configuration module
 
-Version: 5.12.0
+Version: 5.13.0
 Date updated: 17/10/2025 (dd/mm/yyyy)
 """
 

absfuyu/core/__init__.py

@@ -3,7 +3,7 @@ Absfuyu: Core
 -------------
 Bases for other features
 
-Version: 5.12.0
+Version: 5.13.0
 Date updated: 17/10/2025 (dd/mm/yyyy)
 """
 

absfuyu/core/baseclass.py

@@ -3,7 +3,7 @@ Absfuyu: Core
 -------------
 Bases for other features
 
-Version: 5.12.0
+Version: 5.13.0
 Date updated: 17/10/2025 (dd/mm/yyyy)
 """
 

absfuyu/core/baseclass2.py

@@ -3,7 +3,7 @@ Absfuyu: Core
 -------------
 Bases for other features (with library)
 
-Version: 5.12.0
+Version: 5.13.0
 Date updated: 17/10/2025 (dd/mm/yyyy)
 """
 

absfuyu/core/decorator.py

@@ -3,7 +3,7 @@ Absfuyu: Core
 -------------
 Decorator
 
-Version: 5.12.0
+Version: 5.13.0
 Date updated: 17/10/2025 (dd/mm/yyyy)
 """
 

absfuyu/core/docstring.py

@@ -3,7 +3,7 @@ Absfuyu: Core
 -------------
 Sphinx docstring decorator
 
-Version: 5.12.0
+Version: 5.13.0
 Date updated: 17/10/2025 (dd/mm/yyyy)
 """
 

absfuyu/core/dummy_cli.py

@@ -3,7 +3,7 @@ Absfuyu: Core
 -------------
 Dummy cli
 
-Version: 5.12.0
+Version: 5.13.0
 Date updated: 17/10/2025 (dd/mm/yyyy)
 """
 

absfuyu/core/dummy_func.py

@@ -3,7 +3,7 @@ Absfuyu: Core
 -------------
 Dummy functions when other libraries are unvailable
 
-Version: 5.12.0
+Version: 5.13.0
 Date updated: 17/10/2025 (dd/mm/yyyy)
 """
 

absfuyu/dxt/__init__.py

@@ -3,7 +3,7 @@ Absfuyu: Data Extension
 -----------------------
 Extension for data type such as ``list``, ``str``, ``dict``, ...
 
-Version: 5.12.0
+Version: 5.13.0
 Date updated: 17/10/2025 (dd/mm/yyyy)
 
 Features:

absfuyu/dxt/base_type.py

@@ -0,0 +1,93 @@
+"""
+Absfuyu: Data Extension
+-----------------------
+Base type expansion
+
+Version: 5.13.0
+Date updated: 28/10/2025 (dd/mm/yyyy)
+"""
+
+# from __future__ import annotations
+
+# Module Package
+# ---------------------------------------------------------------------------
+__all__ = []
+
+
+# Library
+# ---------------------------------------------------------------------------
+from abc import ABC
+from typing import Generic, Self, TypeVar
+
+# Class
+# ---------------------------------------------------------------------------
+T = TypeVar("T")
+
+
+class BaseType(Generic[T], ABC):
+    """
+    A universal base class for creating custom immutable type wrappers.
+
+    Features:
+    ----------
+    - Works with any immutable type (int, str, float, etc.)
+    - Provides validation hook via `_validate`
+    - Automatically infers the base type from generic argument
+
+
+    Example:
+    --------
+    >>> class NonNegativeInt(BaseType[int], int):
+    >>>     @classmethod
+    >>>     def _validate(cls, value: int) -> None:
+    >>>         if value < 0:
+    >>>             raise ValueError("Value must be non-negative")
+    """
+
+    # Automatically infer `_base_type` when subclassed
+    def __init_subclass__(cls, *args, **kwargs) -> None:
+        super().__init_subclass__(*args, **kwargs)
+
+        # print(getattr(cls, "__orig_bases__", []))
+        for base in getattr(cls, "__orig_bases__", []):
+            if hasattr(base, "__args__") and base.__args__:
+                cls._base_type: type[T] = base.__args__[0]
+                break
+        else:
+            raise TypeError(f"{cls.__name__} must specify a generic base type, e.g. BaseType[int]")
+
+    def __new__(cls, value: T) -> Self:
+        base_type = cls._base_type
+        if not isinstance(value, base_type):
+            raise TypeError(f"{cls.__name__} must be initialized with {base_type.__name__}, got {type(value).__name__}")
+        cls._validate(value)
+        return base_type.__new__(cls, value)  # type: ignore
+
+    @classmethod
+    def _validate(cls, value: T) -> None:
+        """Override this in subclasses to add custom validation."""
+        pass
+
+    def __repr__(self) -> str:
+        # base_name = self._base_type.__name__
+        # return f"{self.__class__.__name__}({base_name}={self._base_type(self)!r})"  # type: ignore
+        return f"{self.__class__.__name__}({self._base_type(self)!r})"  # type: ignore
+
+
+class IntBase(BaseType[int], int):
+    """
+    A base class for creating custom integer-like types.
+    Provides a hook for validation and extension.
+
+    Parameters
+    ----------
+    value : int
+        Int value
+
+
+    Usage:
+    ------
+    Use ``_validate(cls, value: int) -> None:`` classmethod to create custom validator
+    """
+
+    pass

absfuyu/dxt/dictext.py

@@ -3,10 +3,12 @@ Absfuyu: Data Extension
 -----------------------
 dict extension
 
-Version: 5.12.0
-Date updated: 17/10/2025 (dd/mm/yyyy)
+Version: 5.13.0
+Date updated: 02/11/2025 (dd/mm/yyyy)
 """
 
+from __future__ import annotations
+
 # Module Package
 # ---------------------------------------------------------------------------
 __all__ = ["DictExt", "DictAnalyzeResult"]
@@ -259,7 +261,7 @@ class DictExt(GetClassMembersMixin, dict[KT, VT]):
             raise ValueError(err_msg)  # noqa: B904
 
     # Swap
-    def swap_items(self) -> "DictExt[VT, KT]":
+    def swap_items(self) -> DictExt[VT, KT]:
         """
         Swap ``dict.keys()`` with ``dict.values()``
 
@@ -282,12 +284,12 @@ class DictExt(GetClassMembersMixin, dict[KT, VT]):
 
     # Apply
     @overload
-    def apply(self, func: Callable[[VT], R]) -> "DictExt[KT, R]": ...
+    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], R], apply_to_value: Literal[False] = ...) -> DictExt[R, VT]: ...
 
-    def apply(self, func: Callable[[KT | VT], R], apply_to_value: bool = True):  # type: ignore
+    def apply(self, func: Callable[[KT | VT], R], apply_to_value: bool = True) -> DictExt[KT | R, VT | R]:  # type: ignore
         """
         Apply function to ``DictExt.keys()`` or ``DictExt.values()``
 

absfuyu/dxt/dxt_support.py

@@ -3,7 +3,7 @@ Absfuyu: Data Extension
 -----------------------
 Support classes
 
-Version: 5.12.0
+Version: 5.13.0
 Date updated: 17/10/2025 (dd/mm/yyyy)
 """
 

absfuyu/dxt/intext.py

@@ -3,8 +3,8 @@ Absfuyu: Data Extension
 -----------------------
 int extension
 
-Version: 5.12.0
-Date updated: 17/10/2025 (dd/mm/yyyy)
+Version: 5.13.0
+Date updated: 28/10/2025 (dd/mm/yyyy)
 """
 
 # Module Package
@@ -15,9 +15,15 @@ __all__ = ["IntExt", "Pow"]
 # Library
 # ---------------------------------------------------------------------------
 import math
+from abc import ABC
 from collections import Counter
 from typing import Any, Literal, Self, overload
 
+try:
+    from typing import override  # type: ignore
+except ImportError:
+    from absfuyu.core.decorator import dummy_decorator as override
+
 from absfuyu.core.baseclass import GetClassMembersMixin
 from absfuyu.core.docstring import deprecated, versionadded, versionchanged
 from absfuyu.dxt.dxt_support import DictBoolTrue
@@ -493,7 +499,7 @@ class IntExt(GetClassMembersMixin, int):
         return divi_list
 
     @overload
-    def prime_factor(self) -> list[Pow]: ...
+    def prime_factor(self) -> list[Pow]: ...  # type: ignore
 
     @overload
     def prime_factor(self, short_form: Literal[False] = ...) -> list[int]: ...
@@ -633,3 +639,70 @@ class IntExt(GetClassMembersMixin, int):
 
         quotient, remainder = divmod(self, p)
         return [quotient + (i >= (p - remainder)) for i in range(p)]
+
+
+# Class
+# ---------------------------------------------------------------------------
+class IntBase(int, ABC):
+    """
+    A base class for creating custom integer-like types.
+    Provides a hook for validation and extension.
+
+    Usage:
+    ------
+    Use ``_validate(cls, value: int) -> None:`` classmethod to create custom validator
+    """
+
+    def __new__(cls, value: int = 0) -> Self:
+        # Ensure the value is an integer
+        if not isinstance(value, int):
+            raise TypeError(f"{cls.__name__} must be initialized with an int, got {type(value).__name__}")
+        # Optional validation hook
+        cls._validate(value)
+        return int.__new__(cls, value)
+
+    @classmethod
+    def _validate(cls, value: int) -> None:
+        """Override in subclasses to add custom validation."""
+        pass
+
+    def __repr__(self) -> str:
+        return f"{self.__class__.__name__}({int(self)})"
+
+
+class PositiveInt(IntBase):
+    """Only allows positive int"""
+
+    @classmethod
+    @override
+    def _validate(cls, value: int) -> None:
+        if value < 0:
+            raise ValueError(f"{cls.__name__} must be non-negative")
+
+
+class NegativeInt(IntBase):
+    """Only allows negative int"""
+
+    @classmethod
+    @override
+    def _validate(cls, value: int) -> None:
+        if value >= 0:
+            raise ValueError(f"{cls.__name__} must be non-positive")
+
+
+class IntWithNote(IntBase):
+    """Int with additional note"""
+
+    def __new__(cls, value: int = 0) -> Self:
+        ins = super().__new__(cls, value)
+        ins.note = ""
+        return ins
+
+    def __repr__(self) -> str:
+        if self.note == "":
+            return f"{int(self)}"
+            # return super().__repr__()
+        return f"{self.__class__.__name__}({int(self)}, note={repr(self.note)})"
+
+    def add_note(self, note: str) -> None:
+        self.note = note

absfuyu/dxt/listext.py

@@ -3,7 +3,7 @@ Absfuyu: Data Extension
 -----------------------
 list extension
 
-Version: 5.12.0
+Version: 5.13.0
 Date updated: 17/10/2025 (dd/mm/yyyy)
 """
 

absfuyu/dxt/strext.py

@@ -3,7 +3,7 @@ Absfuyu: Data Extension
 -----------------------
 str extension
 
-Version: 5.12.0
+Version: 5.13.0
 Date updated: 17/10/2025 (dd/mm/yyyy)
 """
 

absfuyu/extra/__init__.py

@@ -3,7 +3,7 @@ Absfuyu: Extra
 --------------
 Features that require additional libraries
 
-Version: 5.12.0
+Version: 5.13.0
 Date updated: 17/10/2025 (dd/mm/yyyy)
 """
 

absfuyu/extra/beautiful.py

@@ -3,7 +3,7 @@ Absfuyu: Beautiful
 ------------------
 A decorator that makes output more beautiful
 
-Version: 5.12.0
+Version: 5.13.0
 Date updated: 17/10/2025 (dd/mm/yyyy)
 """
 

absfuyu/extra/da/__init__.py

@@ -3,7 +3,7 @@ Absfuyu: Data Analysis
 ----------------------
 Data Analyst
 
-Version: 5.12.0
+Version: 5.13.0
 Date updated: 17/10/2025 (dd/mm/yyyy)
 """
 

absfuyu/extra/da/dadf.py

@@ -3,7 +3,7 @@ Absfuyu: Data Analysis
 ----------------------
 Data Analyst DataFrame
 
-Version: 5.12.0
+Version: 5.13.0
 Date updated: 17/10/2025 (dd/mm/yyyy)
 """
 

absfuyu/extra/da/dadf_base.py

@@ -3,7 +3,7 @@ Absfuyu: Data Analysis
 ----------------------
 Data Analyst DataFrame - Base/Core
 
-Version: 5.12.0
+Version: 5.13.0
 Date updated: 17/10/2025 (dd/mm/yyyy)
 """
 

absfuyu/extra/da/df_func.py

@@ -3,7 +3,7 @@ Absfuyu: Data Analysis
 ----------------------
 DF Function
 
-Version: 5.12.0
+Version: 5.13.0
 Date updated: 17/10/2025 (dd/mm/yyyy)
 """
 

absfuyu/extra/da/mplt.py

@@ -3,7 +3,7 @@ Absfuyu: Data Analysis
 ----------------------
 Matplotlib Helper
 
-Version: 5.12.0
+Version: 5.13.0
 Date updated: 17/10/2025 (dd/mm/yyyy)
 """
 

absfuyu/extra/data_analysis.py

@@ -4,7 +4,7 @@ Absfuyu: Data Analysis [W.I.P]
 Extension for ``pd.DataFrame``
 (deprecated)
 
-Version: 5.12.0
+Version: 5.13.0
 Date updated: 17/10/2025 (dd/mm/yyyy)
 """
 

absfuyu/extra/pdf.py

@@ -3,7 +3,7 @@ Absfuyu: PDF
 ------------
 PDF Tool [W.I.P]
 
-Version: 5.12.0
+Version: 5.13.0
 Date updated: 17/10/2025 (dd/mm/yyyy)
 """