absfuyu 5.1.0__tar.gz → 5.2.0__tar.gz

{absfuyu-5.1.0 → absfuyu-5.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: absfuyu
-Version: 5.1.0
+Version: 5.2.0
 Summary: A small collection of code
 Project-URL: Homepage, https://github.com/AbsoluteWinter/absfuyu-public
 Project-URL: Documentation, https://absolutewinter.github.io/absfuyu-docs/

{absfuyu-5.1.0 → absfuyu-5.2.0}/src/absfuyu/__init__.py

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

{absfuyu-5.1.0 → absfuyu-5.2.0}/src/absfuyu/__main__.py

@@ -3,15 +3,15 @@ ABSFUYU
 -------
 COMMAND LINE INTERFACE
 
-Version: 5.1.0
-Date updated: 10/03/2025 (dd/mm/yyyy)
+Version: 5.2.0
+Date updated: 13/03/2025 (dd/mm/yyyy)
 """
 
 # Library
 # ---------------------------------------------------------------------------
 try:
     from absfuyu.cli import cli
-except ModuleNotFoundError:  # Check for `click`, `colorama`
+except ImportError:  # Check for `click`, `colorama`
     from absfuyu.core.dummy_cli import cli
 
 

{absfuyu-5.1.0 → absfuyu-5.2.0}/src/absfuyu/cli/__init__.py

@@ -3,7 +3,7 @@ ABSFUYU
 -------
 COMMAND LINE INTERFACE
 
-Version: 5.1.0
+Version: 5.2.0
 Date updated: 10/03/2025 (dd/mm/yyyy)
 """
 

{absfuyu-5.1.0 → absfuyu-5.2.0}/src/absfuyu/cli/color.py

@@ -3,8 +3,8 @@ ABSFUYU CLI
 -----------
 Color
 
-Version: 5.1.0
-Date updated: 10/03/2025 (dd/mm/yyyy)
+Version: 5.2.0
+Date updated: 13/03/2025 (dd/mm/yyyy)
 """
 
 # Module Package
@@ -16,7 +16,7 @@ __all__ = ["COLOR"]
 # ---------------------------------------------------------------------------
 try:
     import colorama
-except ModuleNotFoundError:  # Check for `colorama`
+except ImportError:  # Check for `colorama`
     colorama = None
 
 # Color

{absfuyu-5.1.0 → absfuyu-5.2.0}/src/absfuyu/cli/config_group.py

@@ -3,8 +3,8 @@ ABSFUYU CLI
 -----------
 Config
 
-Version: 5.1.0
-Date updated: 10/03/2025 (dd/mm/yyyy)
+Version: 5.2.0
+Date updated: 12/03/2025 (dd/mm/yyyy)
 """
 
 # Module Package

{absfuyu-5.1.0 → absfuyu-5.2.0}/src/absfuyu/cli/do_group.py

@@ -3,8 +3,8 @@ ABSFUYU CLI
 -----------
 Do
 
-Version: 5.1.0
-Date updated: 10/03/2025 (dd/mm/yyyy)
+Version: 5.2.0
+Date updated: 12/03/2025 (dd/mm/yyyy)
 """
 
 # Module Package

{absfuyu-5.1.0 → absfuyu-5.2.0}/src/absfuyu/cli/game_group.py

@@ -3,8 +3,8 @@ ABSFUYU CLI
 -----------
 Game
 
-Version: 5.1.0
-Date updated: 10/03/2025 (dd/mm/yyyy)
+Version: 5.2.0
+Date updated: 12/03/2025 (dd/mm/yyyy)
 """
 
 # Module Package

{absfuyu-5.1.0 → absfuyu-5.2.0}/src/absfuyu/cli/tool_group.py

@@ -3,11 +3,10 @@ ABSFUYU CLI
 -----------
 Tool
 
-Version: 5.1.0
-Date updated: 10/03/2025 (dd/mm/yyyy)
+Version: 5.2.0
+Date updated: 12/03/2025 (dd/mm/yyyy)
 """
 
-
 # Module Package
 # ---------------------------------------------------------------------------
 __all__ = ["tool_group"]

{absfuyu-5.1.0 → absfuyu-5.2.0}/src/absfuyu/config/__init__.py

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

{absfuyu-5.1.0 → absfuyu-5.2.0}/src/absfuyu/core/__init__.py

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

{absfuyu-5.1.0 → absfuyu-5.2.0}/src/absfuyu/core/baseclass.py

@@ -3,8 +3,8 @@ Absfuyu: Core
 -------------
 Bases for other features
 
-Version: 5.1.0
-Date updated: 10/03/2025 (dd/mm/yyyy)
+Version: 5.2.0
+Date updated: 11/03/2025 (dd/mm/yyyy)
 """
 
 # Module Package

{absfuyu-5.1.0 → absfuyu-5.2.0}/src/absfuyu/core/baseclass2.py

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

{absfuyu-5.1.0 → absfuyu-5.2.0}/src/absfuyu/core/decorator.py

@@ -3,8 +3,8 @@ Absfuyu: Core
 -------------
 Decorator
 
-Version: 5.1.0
-Date updated: 10/03/2025 (dd/mm/yyyy)
+Version: 5.2.0
+Date updated: 14/03/2025 (dd/mm/yyyy)
 """
 
 # Module Package
@@ -20,7 +20,7 @@ __all__ = [
 # ---------------------------------------------------------------------------
 from collections.abc import Callable
 from functools import wraps
-from typing import ParamSpec, TypeVar, overload
+from typing import ParamSpec, TypeVar, cast, overload
 
 # Type
 # ---------------------------------------------------------------------------
@@ -130,4 +130,4 @@ def add_subclass_methods_decorator(cls: T) -> T:
                     name = f"{cls.__module__}.{cls.__name__}"
                     cls.SUBCLASS_METHODS.update({name: sorted(methods_list)})
 
-    return type("AutoSubclass", (AutoSubclassMixin, cls), {})  # type: ignore[return-value]
+    return cast(T, type("AutoSubclass", (AutoSubclassMixin, cls), {}))

{absfuyu-5.1.0 → absfuyu-5.2.0}/src/absfuyu/core/docstring.py

@@ -3,8 +3,8 @@ Absfuyu: Core
 -------------
 Sphinx docstring decorator
 
-Version: 5.1.0
-Date updated: 10/03/2025 (dd/mm/yyyy)
+Version: 5.2.0
+Date updated: 14/03/2025 (dd/mm/yyyy)
 """
 
 # Module Package
@@ -53,6 +53,24 @@ class SphinxDocstring:
     A class-based decorator to add a 'Version added',
     'Version changed', or 'Deprecated' note to a function's docstring,
     formatted for Sphinx documentation.
+
+    Parameters
+    ----------
+    version : str
+        The version in which the function was added, changed, or deprecated.
+
+    reason : str | None, optional
+        An optional reason or description for the change
+        or deprecation, by default ``None``
+
+    mode : SphinxDocstringMode, optional
+        Specifies whether the function was 'added', 'changed', or 'deprecated',
+        by default SphinxDocstringMode.ADDED
+
+
+    Usage
+    -----
+    Use this as a decorator (``@SphinxDocstring(<parameters>)``)
     """
 
     _LINEBREAK: ClassVar[str] = "\n\n"  # Use ClassVar for constant
@@ -75,7 +93,7 @@ class SphinxDocstring:
             An optional reason or description for the change
             or deprecation, by default ``None``
 
-        mode : SphinxDocstringMode | int, optional
+        mode : SphinxDocstringMode, optional
             Specifies whether the function was 'added', 'changed', or 'deprecated',
             by default SphinxDocstringMode.ADDED
 
@@ -87,38 +105,27 @@ class SphinxDocstring:
         self.reason = reason
         self.mode = mode
 
-    @overload
-    def __call__(self, obj: _T) -> _T: ...  # Class overload
+    @overload  # Class overload
+    def __call__(self, obj: _T) -> _T: ...
+
+    @overload  # Function overload
+    def __call__(self, obj: Callable[_P, _R]) -> Callable[_P, _R]: ...
 
-    @overload
-    def __call__(
-        self, obj: Callable[_P, _R]
-    ) -> Callable[_P, _R]: ...  # Function overload
     def __call__(self, obj: _T | Callable[_P, _R]) -> _T | Callable[_P, _R]:
+        """
+        Decorator for class and callable
+        """
+
         # Class wrapper
         if isinstance(obj, type):  # if inspect.isclass(obj):
-            obj.__doc__ = (obj.__doc__ or "") + self._generate_version_note(
-                num_of_white_spaces=self._calculate_white_space(obj.__doc__)
-            )
-            return obj
+            return self._update_doc(obj)
 
         # Function wrapper
         @wraps(obj)
         def wrapper(*args: _P.args, **kwargs: _P.kwargs) -> _R:
             return obj(*args, **kwargs)
 
-        # Add docstring
-        # version_note = self._generate_version_note()
-        # if wrapper.__doc__ is None:
-        #     wrapper.__doc__ = version_note
-        # else:
-        #     wrapper.__doc__ += version_note
-
-        wrapper.__doc__ = (wrapper.__doc__ or "") + self._generate_version_note(
-            num_of_white_spaces=self._calculate_white_space(wrapper.__doc__)
-        )
-
-        return wrapper
+        return self._update_doc(wrapper)
 
     def _calculate_white_space(self, docs: str | None) -> int:
         """
@@ -158,6 +165,17 @@ class SphinxDocstring:
             reason=reason_str,
         )
 
+    @overload
+    def _update_doc(self, obj: _T) -> _T: ...
+    @overload
+    def _update_doc(self, obj: Callable[_P, _R]) -> Callable[_P, _R]: ...
+    def _update_doc(self, obj: _T | Callable[_P, _R]) -> _T | Callable[_P, _R]:
+        """Update docstring for an object"""
+        obj.__doc__ = (obj.__doc__ or "") + self._generate_version_note(
+            num_of_white_spaces=self._calculate_white_space(obj.__doc__)
+        )
+        return obj
+
 
 # Partial
 # ---------------------------------------------------------------------------

{absfuyu-5.1.0 → absfuyu-5.2.0}/src/absfuyu/core/dummy_cli.py

@@ -3,7 +3,7 @@ Absfuyu: Core
 -------------
 Dummy cli
 
-Version: 5.1.0
+Version: 5.2.0
 Date updated: 10/03/2025 (dd/mm/yyyy)
 """
 

{absfuyu-5.1.0 → absfuyu-5.2.0}/src/absfuyu/core/dummy_func.py

@@ -3,8 +3,8 @@ Absfuyu: Core
 -------------
 Dummy functions when other libraries are unvailable
 
-Version: 5.1.0
-Date updated: 10/03/2025 (dd/mm/yyyy)
+Version: 5.2.0
+Date updated: 13/03/2025 (dd/mm/yyyy)
 """
 
 # Module Package
@@ -26,7 +26,7 @@ from importlib import import_module
 try:
     _tqdm = import_module("tqdm")
     tqdm = getattr(_tqdm, "tqdm")  # noqa
-except (ModuleNotFoundError, AttributeError):
+except (ImportError, AttributeError):
 
     def tqdm(iterable, *args, **kwargs):
         """
@@ -40,7 +40,7 @@ except (ModuleNotFoundError, AttributeError):
 try:
     _unidecode = import_module("unidecode")
     unidecode = getattr(_unidecode, "unidecode")  # noqa
-except (ModuleNotFoundError, AttributeError):
+except (ImportError, AttributeError):
 
     def unidecode(*args, **kwargs):
         """

{absfuyu-5.1.0 → absfuyu-5.2.0}/src/absfuyu/dxt/__init__.py

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

{absfuyu-5.1.0 → absfuyu-5.2.0}/src/absfuyu/dxt/dictext.py

@@ -3,8 +3,8 @@ Absfuyu: Data Extension
 -----------------------
 dict extension
 
-Version: 5.1.0
-Date updated: 10/03/2025 (dd/mm/yyyy)
+Version: 5.2.0
+Date updated: 12/03/2025 (dd/mm/yyyy)
 """
 
 # Module Package
@@ -37,6 +37,9 @@ class DictAnalyzeResult(NamedTuple):
 class DictExt(ShowAllMethodsMixin, dict):
     """
     ``dict`` extension
+
+    >>> # For a list of new methods
+    >>> DictExt.show_all_methods()
     """
 
     @versionchanged("3.3.0", reason="Updated return type")

{absfuyu-5.1.0 → absfuyu-5.2.0}/src/absfuyu/dxt/dxt_support.py

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

{absfuyu-5.1.0 → absfuyu-5.2.0}/src/absfuyu/dxt/intext.py

@@ -3,8 +3,8 @@ Absfuyu: Data Extension
 -----------------------
 int extension
 
-Version: 5.1.0
-Date updated: 10/03/2025 (dd/mm/yyyy)
+Version: 5.2.0
+Date updated: 12/03/2025 (dd/mm/yyyy)
 """
 
 # Module Package
@@ -62,6 +62,9 @@ class Pow:
 class IntExt(ShowAllMethodsMixin, int):
     """
     ``int`` extension
+
+    >>> # For a list of new methods
+    >>> IntExt.show_all_methods()
     """
 
     # convert stuff