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

absfuyu/tools/inspector.py

@@ -3,21 +3,22 @@ Absfuyu: Inspector
 ------------------
 Inspector
 
-Version: 5.1.0
-Date updated: 10/03/2025 (dd/mm/yyyy)
+Version: 5.2.0
+Date updated: 16/03/2025 (dd/mm/yyyy)
 """
 
 # Module level
 # ---------------------------------------------------------------------------
-__all__ = ["Inspector"]
+__all__ = ["Inspector", "inspect_all"]
 
 # Library
 # ---------------------------------------------------------------------------
-import inspect
+import inspect as _inspect
 import os
+from functools import partial
 from textwrap import TextWrapper
 from textwrap import shorten as text_shorten
-from typing import Any
+from typing import Any, Literal, overload
 
 from absfuyu.core.baseclass import (
     AutoREPRMixin,
@@ -33,7 +34,8 @@ from absfuyu.util.text_table import OneColumnTableMaker
 # TODO: rewrite with each class for docs, method, property, attr, param, title
 class Inspector(AutoREPRMixin):
     """
-    Inspect an object
+    Inspect an object.
+    By default shows object's docstring and attribute (if any).
 
     Parameters
     ----------
@@ -42,7 +44,7 @@ class Inspector(AutoREPRMixin):
 
     line_length: int | None
         Number of cols in inspect output (Split line every line_length).
-        Set to ``None`` to use ``os.get_terminal_size()``, by default ``88``
+        Set to ``None`` to use ``os.get_terminal_size()``, by default ``None``
 
     include_docs : bool, optional
         Include docstring, by default ``True``
@@ -54,7 +56,7 @@ class Inspector(AutoREPRMixin):
         Include object's methods (if any), by default ``False``
 
     include_property : bool, optional
-        Include object's properties (if any), by default ``True``
+        Include object's properties (if any), by default ``False``
 
     include_attribute : bool, optional
         Include object's attributes (if any), by default ``True``
@@ -65,27 +67,57 @@ class Inspector(AutoREPRMixin):
     include_all : bool, optional
         Include all infomation availble, by default ``False``
 
+    max_textwrap_lines : int, optional
+        Maximum lines for the output's header (class, signature, repr).
+        Must be >= 1, by default ``8``
+
 
     Example:
     --------
     >>> print(Inspector(<object>, **kwargs))
     """
 
+    @overload
+    def __init__(self, obj: Any) -> None: ...
+
+    @overload
+    def __init__(self, obj: Any, *, include_all: Literal[True] = ...) -> None: ...
+
+    @overload
+    def __init__(
+        self,
+        obj: Any,
+        *,
+        line_length: int | None = None,
+        include_docs: bool = True,
+        include_mro: bool = False,
+        include_method: bool = False,
+        include_property: bool = False,
+        include_attribute: bool = True,
+        include_private: bool = False,
+        max_textwrap_lines: int = 8,
+    ) -> None: ...
+
     def __init__(
         self,
         obj: Any,
         *,
-        line_length: int | None = 88,
+        # Line length
+        line_length: int | None = None,
+        line_length_offset: int = 0,  # line_length += line_length_offset (when line_length=None)
+        max_textwrap_lines: int = 8,
+        # Include
         include_docs: bool = True,
         include_mro: bool = False,
         include_method: bool = False,
-        include_property: bool = True,
+        include_property: bool = False,
         include_attribute: bool = True,
         include_private: bool = False,
         include_all: bool = False,
     ) -> None:
         """
-        Inspect an object
+        Inspect an object.
+        By default shows object's docstring and attribute (if any).
 
         Parameters
         ----------
@@ -94,7 +126,7 @@ class Inspector(AutoREPRMixin):
 
         line_length: int | None
             Number of cols in inspect output (Split line every line_length).
-            Set to ``None`` to use ``os.get_terminal_size()``, by default ``88``
+            Set to ``None`` to use ``os.get_terminal_size()``, by default ``None``
 
         include_docs : bool, optional
             Include docstring, by default ``True``
@@ -106,7 +138,7 @@ class Inspector(AutoREPRMixin):
             Include object's methods (if any), by default ``False``
 
         include_property : bool, optional
-            Include object's properties (if any), by default ``True``
+            Include object's properties (if any), by default ``False``
 
         include_attribute : bool, optional
             Include object's attributes (if any), by default ``True``
@@ -117,6 +149,10 @@ class Inspector(AutoREPRMixin):
         include_all : bool, optional
             Include all infomation availble, by default ``False``
 
+        max_textwrap_lines : int, optional
+            Maximum lines for the output's header (class, signature, repr).
+            Must be >= 1, by default ``8``
+
 
         Example:
         --------
@@ -141,7 +177,7 @@ class Inspector(AutoREPRMixin):
         # Setup line length
         if line_length is None:
             try:
-                self._linelength = os.get_terminal_size().columns
+                self._linelength = os.get_terminal_size().columns + line_length_offset
             except OSError:
                 self._linelength = 88
         elif isinstance(line_length, (int, float)):
@@ -156,7 +192,7 @@ class Inspector(AutoREPRMixin):
             subsequent_indent="",
             tabsize=4,
             break_long_words=True,
-            max_lines=8,
+            max_lines=max(max_textwrap_lines, 1),
         )
 
         # Output
@@ -167,18 +203,8 @@ class Inspector(AutoREPRMixin):
 
     # Support
     def _long_list_terminal_size(self, long_list: list) -> list:
-        max_name_len = max([len(x) for x in long_list]) + 1
-        cols = 1
-
-        if max_name_len <= self._linelength - 4:
-            cols = (self._linelength - 4) // max_name_len
-        splitted_chunk: list[list[str]] = ListExt(long_list).split_chunk(cols)
-
-        mod_chunk = ListExt(
-            [[x.ljust(max_name_len, " ") for x in chunk] for chunk in splitted_chunk]
-        ).apply(lambda x: "".join(x))
-
-        return list(mod_chunk)
+        ll = ListExt(long_list).wrap_to_column(self._linelength, margin=4)
+        return list(ll)
 
     # Signature
     def _make_title(self) -> str:
@@ -189,9 +215,9 @@ class Inspector(AutoREPRMixin):
         title_str = (
             str(self.obj)
             if (
-                inspect.isclass(self.obj)
+                _inspect.isclass(self.obj)
                 or callable(self.obj)
-                or inspect.ismodule(self.obj)
+                or _inspect.ismodule(self.obj)
             )
             else str(type(self.obj))
         )
@@ -199,17 +225,17 @@ class Inspector(AutoREPRMixin):
 
     def _get_signature_prefix(self) -> str:
         # signature prefix
-        if inspect.isclass(self.obj):
+        if _inspect.isclass(self.obj):
             return "class"
-        elif inspect.iscoroutinefunction(self.obj):
+        elif _inspect.iscoroutinefunction(self.obj):
             return "async def"
-        elif inspect.isfunction(self.obj):
+        elif _inspect.isfunction(self.obj):
             return "def"
         return ""
 
     def get_parameters(self) -> list[str] | None:
         try:
-            sig = inspect.signature(self.obj)
+            sig = _inspect.signature(self.obj)
         except (ValueError, AttributeError, TypeError):
             return None
         return [str(x) for x in sig.parameters.values()]
@@ -221,7 +247,7 @@ class Inspector(AutoREPRMixin):
         """
         try:
             return self._text_wrapper.wrap(
-                f"{self._get_signature_prefix()} {self.obj.__name__}{inspect.signature(self.obj)}"
+                f"{self._get_signature_prefix()} {self.obj.__name__}{_inspect.signature(self.obj)}"
             )
         #    not class, func | not type   | is module
         except (ValueError, AttributeError, TypeError):
@@ -229,9 +255,8 @@ class Inspector(AutoREPRMixin):
 
     # Method and property
     def _get_method_property(self) -> MethodNPropertyResult:
-        # if inspect.isclass(self.obj) or inspect.ismodule(self.obj):
-        if inspect.isclass(self.obj):
-            # TODO: Support enum type
+        # if _inspect.isclass(self.obj) or inspect.ismodule(self.obj):
+        if _inspect.isclass(self.obj):
             tmpcls = type(
                 "tmpcls",
                 (
@@ -271,7 +296,7 @@ class Inspector(AutoREPRMixin):
         Inspector's workflow:
         03. Get docstring and strip
         """
-        docs: str | None = inspect.getdoc(self.obj)
+        docs: str | None = _inspect.getdoc(self.obj)
 
         if docs is None:
             return ""
@@ -431,3 +456,8 @@ class Inspector(AutoREPRMixin):
 
     def detail_str(self) -> str:
         return self._inspect_output.make_table()
+
+
+# Partial
+# ---------------------------------------------------------------------------
+inspect_all = partial(Inspector, line_length=None, include_all=True)

absfuyu/tools/keygen.py

@@ -5,7 +5,7 @@ Mod7 product key generator (90's)
 
 This is for educational and informative purposes only.
 
-Version: 5.1.0
+Version: 5.2.0
 Date updated: 10/03/2025 (dd/mm/yyyy)
 """
 

absfuyu/tools/obfuscator.py

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

absfuyu/tools/passwordlib.py

@@ -3,8 +3,8 @@ Absfuyu: Passwordlib
 --------------------
 Password library
 
-Version: 5.1.0
-Date updated: 10/03/2025 (dd/mm/yyyy)
+Version: 5.2.0
+Date updated: 15/03/2025 (dd/mm/yyyy)
 """
 
 # Module level
@@ -27,7 +27,6 @@ from absfuyu.dxt import DictExt, Text
 from absfuyu.logger import logger
 from absfuyu.pkg_data import DataList, DataLoader
 from absfuyu.tools.generator import Charset, Generator
-from absfuyu.util import set_min
 
 
 # Function
@@ -213,7 +212,7 @@ class PasswordGenerator(BaseClass):
         while True:
             pwd = Generator.generate_string(
                 charset=charset,
-                size=set_min(length, min_value=8),  # type: ignore
+                size=max(length, 8),  # type: ignore
                 times=1,
                 string_type_if_1=True,
             )

absfuyu/tools/shutdownizer.py

@@ -3,7 +3,7 @@ Absfuyu: Shutdownizer
 ---------------------
 This shutdowns
 
-Version: 5.1.0
+Version: 5.2.0
 Date updated: 10/03/2025 (dd/mm/yyyy)
 """
 

absfuyu/tools/web.py

@@ -3,7 +3,7 @@ Absfuyu: Web
 ------------
 Web, ``request``, ``BeautifulSoup`` stuff
 
-Version: 5.1.0
+Version: 5.2.0
 Date updated: 10/03/2025 (dd/mm/yyyy)
 """
 

absfuyu/typings.py

@@ -0,0 +1,136 @@
+"""
+Absfuyu: Core
+-------------
+Pre-defined typing
+
+Version: 5.2.0
+Date updated: 14/03/2025 (dd/mm/yyyy)
+"""
+
+# Module Package
+# ---------------------------------------------------------------------------
+__all__ = [
+    # Type
+    "T",
+    "T_co",
+    "T_contra",
+    "P",
+    "R",
+    "_CALLABLE",
+    "CT",
+    "N",
+    "_Number",
+    "override",
+    # Protocol
+    "SupportsShowMethods",
+]
+
+
+# Library
+# ---------------------------------------------------------------------------
+from collections.abc import Callable
+from typing import Any, ParamSpec, Protocol, TypeVar, overload
+
+try:
+    from typing import override  # type: ignore
+except ImportError:
+    from absfuyu.core.decorator import dummy_decorator as override
+
+
+# Type
+# ---------------------------------------------------------------------------
+# Types where neither is possible are invariant
+T = TypeVar("T")  # Type invariant
+# Type variables that are covariant can be substituted
+# with a more specific type without causing errors
+T_co = TypeVar("T_co", covariant=True)  # Type covariant
+# Type variables that are contravariant can be substituted
+# with a more general type without causing errors
+T_contra = TypeVar("T_contra", contravariant=True)  # Type contravariant
+
+# Callable
+P = ParamSpec("P")  # Parameter type
+R = TypeVar("R")  # Return type - Can be anything
+_CALLABLE = Callable[P, R]
+
+# Class type - Can be any subtype of `type`
+CT = TypeVar("CT", bound=type)
+
+# Number type
+N = TypeVar("N", int, float)  # Must be int or float
+_Number = int | float
+
+
+# Protocol
+# ---------------------------------------------------------------------------
+class SupportsShowMethods(Protocol):
+    """
+    Support class with ``show_all_methods()``
+    and ``show_all_properties()`` method
+    from ``absfuyu.core.basclass.ShowAllMethodsMixin``
+    """
+
+    @overload
+    @classmethod
+    def show_all_methods(cls) -> dict[str, list[str]]: ...
+
+    @overload
+    @classmethod
+    def show_all_methods(
+        cls,
+        print_result: bool = False,
+        include_classmethod: bool = True,
+        classmethod_indicator: str = "<classmethod>",
+        include_staticmethod: bool = True,
+        staticmethod_indicator: str = "<staticmethod>",
+        include_private_method: bool = False,
+    ) -> dict[str, list[str]]: ...
+
+    @classmethod
+    def show_all_methods(cls, *args, **kwargs) -> Any: ...
+
+    @overload
+    @classmethod
+    def show_all_properties(cls) -> dict[str, list[str]]: ...
+
+    @overload
+    @classmethod
+    def show_all_properties(
+        cls, print_result: bool = False
+    ) -> dict[str, list[str]]: ...
+
+    @classmethod
+    def show_all_properties(cls, *args, **kwargs) -> Any: ...
+
+
+# Note
+# ---------------------------------------------------------------------------
+# Iterable                               : __iter__
+# Iterator(Iterable)                     : __next__, __iter__
+# Reversible(Iterable)                   : __reversed__, __iter__
+# Sized                                  : __len__
+# Container                              : __contains__
+# Collection(Sized, Iterable, Container) : __len__, __iter__, __contains__
+# Set(Collection)                        : __contains__, __iter__, __len__
+# MutableSet(Set)                        : __contains__, __iter__, __len__
+# Mapping(Collection)                    : __getitem__, __iter__, and __len__
+# MutableMapping(Mapping)                : __getitem__, __setitem__, __delitem__,__iter__, __len__
+# Sequence(Reversible, Collection)       : __reversed__, __len__, __iter__, __contains__
+# MutableSequence(Sequence)              : __getitem__, __setitem__, __delitem__, __reversed__, __len__, __iter__, __contains__
+
+# Iterable                               : str, dict, list, tuple, set
+# Iterator(Iterable)                     : Generator
+# Reversible(Iterable)                   : str, dict, list, tuple
+# Sized                                  : str, dict, list, tuple, set
+# Container                              : str, dict, list, tuple, set
+# Collection(Sized, Iterable, Container) : str, dict, list, tuple, set
+# Set(Collection)                        : set
+# MutableSet(Set)                        : set
+# Mapping(Collection)                    : dict
+# MutableMapping(Mapping)                : dict
+# Sequence(Reversible, Collection)       : str, list, tuple
+# MutableSequence(Sequence)              : list
+
+# __iter__: for <...> in <...>
+# __len__: len(<...>)
+# __contains__: if <...> in <...>

absfuyu/util/__init__.py

@@ -3,10 +3,20 @@ Absufyu: Utilities
 ------------------
 Some random utilities
 
-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__ = [
+    "get_installed_package",
+    "set_min",
+    "set_max",
+    "set_min_max",
+    "stop_after_day",
+]
+
 # Library
 # ---------------------------------------------------------------------------
 import pkgutil
@@ -137,8 +147,12 @@ def set_min_max(
     >>> set_min_max(808)
     100
     """
-    current_value = set_min(current_value, min_value=min_value)
-    current_value = set_max(current_value, max_value=max_value)
+    # Set min
+    # current_value = set_min(current_value, min_value=min_value)
+    current_value = max(current_value, min_value)
+    # Set max
+    # current_value = set_max(current_value, max_value=max_value)
+    current_value = min(current_value, max_value)
     return current_value
 
 

absfuyu/util/api.py

@@ -3,8 +3,8 @@ Absufyu: API
 ------------
 Fetch data stuff
 
-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 level
@@ -25,7 +25,8 @@ from typing import NamedTuple
 
 import requests
 
-from absfuyu.core import versionadded, versionchanged
+from absfuyu.core.baseclass import BaseClass
+from absfuyu.core.docstring import versionadded, versionchanged
 from absfuyu.logger import logger
 
 
@@ -33,8 +34,15 @@ from absfuyu.logger import logger
 # ---------------------------------------------------------------------------
 class PingResult(NamedTuple):
     """
-    :param host: Host name/IP
-    :param result: Ping result in ms
+    Ping result
+
+    Parameters
+    ----------
+    host : str
+        Host name/IP
+
+    result : str
+        Ping result in ms
     """
 
     host: str
@@ -90,28 +98,40 @@ def ping_windows(host: list[str], ping_count: int = 3) -> list[PingResult]:
 
 # Class
 # ---------------------------------------------------------------------------
-class APIRequest:
-    """API data with cache feature"""
+class APIRequest(BaseClass):
+    """
+    API data with cache feature
+
+    Parameters
+    ----------
+    api_url : str
+        API link
+
+    encoding : str | None, optional
+        Data encoding, by default ``"utf-8"``
+    """
 
     def __init__(
         self,
         api_url: str,
-        *,  # Use "*" to force using keyword in function parameter | Example: APIRequest(url, encoding="utf-8")
+        *,
         encoding: str | None = "utf-8",
     ) -> None:
         """
-        :param api_url: api link
-        :param encoding: data encoding (Default: utf-8)
+        Create APIRequest instance
+
+        Parameters
+        ----------
+        api_url : str
+            API link
+
+        encoding : str | None, optional
+            Data encoding, by default ``"utf-8"``
         """
+
         self.url = api_url
         self.encoding = encoding
 
-    def __str__(self) -> str:
-        return f"{self.__class__.__name__}({self.url})"
-
-    def __repr__(self) -> str:
-        return self.__str__()
-
     def fetch_data(self, *, update: bool = False, json_cache: str | Path):
         """
         Fetch data from an API then cache it for later use

absfuyu/util/json_method.py

@@ -3,8 +3,8 @@ Absfuyu: Json Method
 --------------------
 ``.json`` file handling
 
-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 level
@@ -16,7 +16,6 @@ __all__ = ["JsonFile"]
 # ---------------------------------------------------------------------------
 import json
 from pathlib import Path
-from typing import Any
 
 from absfuyu.core import BaseClass
 
@@ -26,6 +25,20 @@ from absfuyu.core import BaseClass
 class JsonFile(BaseClass):
     """
     ``.json`` file handling
+
+    Parameters
+    ----------
+    json_file_location : str | Path
+        .json file location
+
+    encoding : str | None, optional
+        Data encoding, by default ``"utf-8"``
+
+    indent : int | str | None, optional
+        Indentation when export to json file, by default ``4``
+
+    sort_keys : bool, optional
+        Sort the keys before export to json file, by default ``True``
     """
 
     def __init__(
@@ -37,26 +50,40 @@ class JsonFile(BaseClass):
         sort_keys: bool = True,
     ) -> None:
         """
-        json_file_location: json file location
-        encoding: data encoding (Default: utf-8)
-        indent: indentation when export to json file
-        sort_keys: sort the keys before export to json file
+        ``.json`` file handling
+
+        Parameters
+        ----------
+        json_file_location : str | Path
+            .json file location
+
+        encoding : str | None, optional
+            Data encoding, by default ``"utf-8"``
+
+        indent : int | str | None, optional
+            Indentation when export to json file, by default ``4``
+
+        sort_keys : bool, optional
+            Sort the keys before export to json file, by default ``True``
         """
+
         self.json_file_location = Path(json_file_location)
         self.encoding = encoding
         self.indent = indent
         self.sort_keys = sort_keys
-        self.data: dict[Any, Any] = {}
+        self.data: dict = {}
 
     def __str__(self) -> str:
         return f"{self.__class__.__name__}({self.json_file_location.name})"
 
-    def load_json(self) -> dict[Any, Any]:
+    def load_json(self) -> dict:
         """
         Load ``.json`` file
 
-        :returns: ``.json`` data
-        :rtype: dict
+        Returns
+        -------
+        dict
+            ``.json`` data
         """
         with open(self.json_file_location, "r", encoding=self.encoding) as file:
             self.data = json.load(file)
@@ -68,11 +95,13 @@ class JsonFile(BaseClass):
         with open(self.json_file_location, "w", encoding=self.encoding) as file:
             file.writelines(json_data)
 
-    def update_data(self, data: dict[Any, Any]) -> None:
+    def update_data(self, data: dict) -> None:
         """
         Update ``.json`` data without save
 
-        :param data: ``.json`` data
-        :type data: dict
+        Parameters
+        ----------
+        data : dict
+            ``.json`` data
         """
         self.data = data