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

absfuyu/tools/keygen.py

@@ -5,8 +5,8 @@ Mod7 product key generator (90's)
 
 This is for educational and informative purposes only.
 
-Version: 5.0.0
-Date updated: 25/02/2025 (dd/mm/yyyy)
+Version: 6.1.1
+Date updated: 30/12/2025 (dd/mm/yyyy)
 """
 
 # Module level

absfuyu/tools/obfuscator.py

@@ -3,8 +3,8 @@ Absfuyu: Obfuscator
 -------------------
 Obfuscate code
 
-Version: 5.0.0
-Date updated: 23/02/2025 (dd/mm/yyyy)
+Version: 6.1.1
+Date updated: 30/12/2025 (dd/mm/yyyy)
 """
 
 # Module level
@@ -22,17 +22,28 @@ from collections import deque
 from string import Template
 from typing import ClassVar
 
-from absfuyu.core import BaseClass, ShowAllMethodsMixin, versionadded
+from absfuyu.core.baseclass import BaseClass, GetClassMembersMixin
+from absfuyu.core.docstring import versionadded
 from absfuyu.dxt import Text
-from absfuyu.general.generator import Charset, Generator
 from absfuyu.logger import logger
+from absfuyu.tools.generator import Charset, Generator
 
 
 # Class
 # ---------------------------------------------------------------------------
 @versionadded("5.0.0")
 class StrShifter(BaseClass):
-    """Shift characters in a string by a specified number of positions."""
+    """
+    Shift characters in a string by a specified number of positions.
+
+    Parameters
+    ----------
+    str_to_shift : str
+        The string whose characters will be shifted.
+
+    shift_by : int, optional
+        The number of positions to shift the characters, by default ``5``.
+    """
 
     __slots__ = ("_str_to_shift", "shift_by")
 
@@ -99,8 +110,30 @@ class StrShifter(BaseClass):
         return self._use_convert_table(self._make_convert_table())
 
 
-class Obfuscator(ShowAllMethodsMixin):
-    """Obfuscate code"""
+class Obfuscator(GetClassMembersMixin):
+    """
+    Obfuscate code
+
+    Parameters
+    ----------
+    code : str
+        Code text
+
+    base64_only : bool, optional
+        - ``True``: encode in base64 form only
+        - ``False``: base64, compress, rot13 (default)
+
+    split_every : int, optional
+        Split the long line of code every ``x`` character.
+        Minimum is ``1``, by default ``60``
+
+    variable_length : int, optional
+        Length of variable name (when data string split).
+        Minimum is ``7``, by default ``12``
+
+    fake_data : bool, optional
+        Generate additional meaningless data, by default ``False``
+    """
 
     # Var
     LIB_BASE64_ONLY: ClassVar[list[str]] = ["base64"]
@@ -219,8 +252,13 @@ class Obfuscator(ShowAllMethodsMixin):
         """
         Convert text into base64 and then return a code that decode that base64 code
 
-        text: Code that need to convert
-        raw: Return hex form only
+        Parameters
+        ----------
+        text : str
+            Code that need to convert
+
+        raw : bool
+            Return hex form only, by default ``False``
         """
         b64_encode_codec = base64.b64encode(text.encode()).decode()
         b64_decode_codec = f"base64.b64decode('{b64_encode_codec}'.encode()).decode()"

absfuyu/tools/passwordlib.py

@@ -3,13 +3,13 @@ Absfuyu: Passwordlib
 --------------------
 Password library
 
-Version: 5.0.0
-Date updated: 19/02/2025 (dd/mm/yyyy)
+Version: 6.1.1
+Date updated: 30/12/2025 (dd/mm/yyyy)
 """
 
 # Module level
 # ---------------------------------------------------------------------------
-__all__ = ["PasswordGenerator", "TOTP"]
+__all__ = ["PasswordGenerator", "PasswordHash", "TOTP"]
 
 
 # Library
@@ -21,12 +21,12 @@ import re
 from typing import ClassVar, Literal, NamedTuple
 from urllib.parse import quote, urlencode
 
-from absfuyu.core import BaseClass, deprecated, versionadded
+from absfuyu.core.baseclass import BaseClass
+from absfuyu.core.docstring import deprecated, versionadded
 from absfuyu.dxt import DictExt, Text
-from absfuyu.general.generator import Charset, Generator
 from absfuyu.logger import logger
 from absfuyu.pkg_data import DataList, DataLoader
-from absfuyu.util import set_min
+from absfuyu.tools.generator import Charset, Generator
 
 
 # Function
@@ -88,6 +88,18 @@ def _password_check(password: str) -> bool:
 # Class
 # ---------------------------------------------------------------------------
 class PasswordHash(NamedTuple):
+    """
+    Password hash
+
+    Parameters
+    ----------
+    salt : bytes
+        Salt
+
+    key : bytes
+        Key
+    """
+
     salt: bytes
     key: bytes
 
@@ -102,7 +114,17 @@ class PasswordGenerator(BaseClass):
     @staticmethod
     def password_hash(password: str) -> PasswordHash:
         """
-        Generate hash for password
+        Generate hash for password.
+
+        Parameters
+        ----------
+        password : str
+            Password string
+
+        Returns
+        -------
+        PasswordHash
+            Password hash contains salt and key
         """
         salt = os.urandom(32)
         key = hashlib.pbkdf2_hmac(
@@ -116,7 +138,19 @@ class PasswordGenerator(BaseClass):
 
     @staticmethod
     def password_check(password: str) -> dict:
-        """Check password's characteristic"""
+        """
+        Check password's characteristic.
+
+        Parameters
+        ----------
+        password : str
+            Password string
+
+        Returns
+        -------
+        dict
+            Password's characteristic.
+        """
         data = Text(password).analyze()
         data = DictExt(data).apply(lambda x: True if x > 0 else False)  # type: ignore
         data.__setitem__("length", len(password))
@@ -131,7 +165,7 @@ class PasswordGenerator(BaseClass):
         include_special: bool = True,
     ) -> str:
         r"""
-        Generate a random password
+        Generate a random password.
 
         Parameters
         ----------
@@ -141,13 +175,13 @@ class PasswordGenerator(BaseClass):
             | (Default: ``8``)
 
         include_uppercase : bool
-            Include uppercase character in the password (Default: ``True``)
+            Include uppercase character in the password, by default ``True``
 
         include_number : bool
-            Include digit character in the password (Default: ``True``)
+            Include digit character in the password, by default ``True``
 
         include_special : bool
-            Include special character in the password (Default: ``True``)
+            Include special character in the password, by default ``True``
 
         Returns
         -------
@@ -178,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,
             )
@@ -205,16 +239,16 @@ class PasswordGenerator(BaseClass):
         Parameters
         ----------
         num_of_blocks : int
-            Number of word used (Default: ``5``)
+            Number of word used, by default ``5``
 
         block_divider : str
-            Character symbol that between each word (Default: ``"-"``)
+            Character symbol that between each word, by default ``"-"``
 
         first_letter_cap : bool
-            Capitalize first character of each word (Default: ``True``)
+            Capitalize first character of each word, by default ``True``
 
         include_number : bool
-            Add number to the end of each word (Default: ``True``)
+            Add number to the end of each word, by default ``True``
 
         custom_word_list : list[str] | None
             Custom word list for passphrase generation, by default uses a list of 360K+ words
@@ -255,6 +289,33 @@ class PasswordGenerator(BaseClass):
 class TOTP(BaseClass):
     """
     A class to represent a Time-based One-Time Password (TOTP) generator.
+
+    Parameters
+    ----------
+    secret : str
+        The shared secret key used to generate the TOTP.
+
+    name : str, optional
+        | The name associated with the TOTP.
+        | If not provided, by default ``"None"``.
+
+    issuer : str, optional
+        The issuer of the TOTP.
+
+    algorithm : Literal["SHA1", "SHA256", "SHA512"], optional
+        | The hashing algorithm used to generate the TOTP.
+        | Must be one of ``"SHA1"``, ``"SHA256"``, or ``"SHA512"``.
+        | By default ``"SHA1"``.
+
+    digit : int, optional
+        | The number of digits in the generated TOTP.
+        | Must be greater than 0.
+        | By default ``6``.
+
+    period : int, optional
+        | The time step in seconds for TOTP generation.
+        | Must be greater than 0.
+        | by default ``30``.
     """
 
     URL_SCHEME: ClassVar[str] = "otpauth://totp/"
@@ -277,23 +338,26 @@ class TOTP(BaseClass):
             The shared secret key used to generate the TOTP.
 
         name : str, optional
-            The name associated with the TOTP. If not provided, defaults to ``"None"``.
+            | The name associated with the TOTP.
+            | If not provided, by default ``"None"``.
 
         issuer : str, optional
             The issuer of the TOTP.
 
         algorithm : Literal["SHA1", "SHA256", "SHA512"], optional
-            The hashing algorithm used to generate the TOTP.
-            Must be one of ``"SHA1"``, ``"SHA256"``, or ``"SHA512"``.
-            Defaults to ``"SHA1"``.
+            | The hashing algorithm used to generate the TOTP.
+            | Must be one of ``"SHA1"``, ``"SHA256"``, or ``"SHA512"``.
+            | By default ``"SHA1"``.
 
         digit : int, optional
-            The number of digits in the generated TOTP. Must be greater than 0.
-            Defaults to ``6``.
+            | The number of digits in the generated TOTP.
+            | Must be greater than 0.
+            | By default ``6``.
 
         period : int, optional
-            The time step in seconds for TOTP generation. Must be greater than 0.
-            Defaults to ``30``.
+            | The time step in seconds for TOTP generation.
+            | Must be greater than 0.
+            | by default ``30``.
         """
         self.secret = secret.upper()
         self.name = name if name else "None"

absfuyu/tools/shutdownizer.py

@@ -3,8 +3,8 @@ Absfuyu: Shutdownizer
 ---------------------
 This shutdowns
 
-Version: 5.0.0
-Date updated: 23/02/2025 (dd/mm/yyyy)
+Version: 6.1.1
+Date updated: 30/12/2025 (dd/mm/yyyy)
 """
 
 # Module level
@@ -20,12 +20,7 @@ import sys
 from abc import ABC, abstractmethod
 from datetime import datetime, time, timedelta
 from pathlib import Path
-from typing import Annotated
-
-try:
-    from typing import override  # type: ignore
-except ImportError:
-    from absfuyu.core.decorator import dummy_decorator as override
+from typing import Annotated, override
 
 from absfuyu.core import BaseClass, versionadded, versionchanged
 from absfuyu.logger import logger