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

absfuyu/sort.py

@@ -3,8 +3,8 @@ Absfuyu: Sort
 -------------
 Sort Module
 
-Version: 5.6.1
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 6.1.2
+Date updated: 30/12/2025 (dd/mm/yyyy)
 """
 
 # Module level
@@ -26,7 +26,7 @@ from typing import Any
 
 # Functions
 # ---------------------------------------------------------------------------
-def selection_sort(iterable: list, reverse: bool = False) -> list:
+def selection_sort[T](iterable: list[T], reverse: bool = False) -> list[T]:
     """
     Sort the list with selection sort (bubble sort) algorithm
 
@@ -61,7 +61,7 @@ def selection_sort(iterable: list, reverse: bool = False) -> list:
         return iterable
 
 
-def insertion_sort(iterable: list) -> list:
+def insertion_sort[T](iterable: list[T]) -> list[T]:
     """
     Sort the list with insertion sort algorithm
 

absfuyu/tools/__init__.py

@@ -3,8 +3,8 @@ Absfuyu: Tools
 --------------
 Some useful tools
 
-Version: 5.6.1
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 6.1.2
+Date updated: 30/12/2025 (dd/mm/yyyy)
 """
 
 # Module Package

absfuyu/tools/checksum.py

@@ -3,13 +3,19 @@ Absufyu: Checksum
 -----------------
 Check MD5, SHA256, ...
 
-Version: 5.6.1
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 6.1.2
+Date updated: 30/12/2025 (dd/mm/yyyy)
 """
 
 # Module level
 # ---------------------------------------------------------------------------
-__all__ = ["Checksum", "ChecksumMode"]
+__all__ = [
+    # Checksum
+    "Checksum",
+    "ChecksumMode",
+    # Mixin
+    "DirectoryRemoveDuplicateMixin",
+]
 
 
 # Library
@@ -22,6 +28,8 @@ from typing import Literal
 from absfuyu.core.baseclass import BaseClass
 from absfuyu.core.docstring import deprecated, versionadded, versionchanged
 from absfuyu.core.dummy_func import tqdm
+from absfuyu.dxt import DictExt, ListExt
+from absfuyu.util.path import DirectoryBase
 
 
 # Function
@@ -64,6 +72,52 @@ class ChecksumMode(StrEnum):
     SHA512 = "sha512"
 
 
+class DuplicateSummary(DictExt[str, list[Path]]):
+    """
+    Duplicate file summary
+    """
+
+    def summary(self) -> int:
+        """
+        Show how many duplicates (include the original)
+
+        Returns
+        -------
+        int
+            How many duplicates
+        """
+        temp = self.__class__(self.copy())
+        try:
+            return sum(temp.apply(lambda x: len(x)).values())
+        except Exception as err:
+            print(f"Something wrong - {err}")
+
+    def remove_duplicates(self, dry_run: bool = True, keep_first: bool = True, debug: bool = False) -> None:
+        """
+        Remove duplicates
+
+        Parameters
+        ----------
+        dry_run : bool, optional
+            Simulate only (no files deleted), by default ``True``
+
+        keep_first : bool, optional
+            Keep the first duplicate file, will keep the last duplicate file when ``False``, by default ``True``
+        """
+        temp = self.__class__(self.copy())
+        removable_files = ListExt([x[1:] if keep_first else x[:-1] for x in temp.values()]).flatten()
+
+        for x in removable_files:
+            x: Path = x
+
+            if debug or dry_run:
+                print(f"Deleting {x}")
+            if dry_run:
+                continue
+
+            x.unlink(missing_ok=True)
+
+
 @versionchanged("4.1.1", reason="Checksum for entire folder is possible")
 @versionadded("4.1.0")
 class Checksum(BaseClass):
@@ -130,7 +184,8 @@ class Checksum(BaseClass):
         """This performs checksum"""
 
         hash_engine = self._get_hash_engine().copy()
-        with open(Path(file), "rb") as f:
+        # with open(Path(file), "rb") as f:
+        with file.open("rb") as f:
             # Read and hash the file in 4K chunks. Reading the whole
             # file at once might consume a lot of memory if it is
             # large.
@@ -183,3 +238,63 @@ class Checksum(BaseClass):
                 f.write(output)
 
         return output
+
+
+# Mixin
+class DirectoryRemoveDuplicateMixin(DirectoryBase):
+    """
+    Directory - Remove duplicate by SHA256
+
+    - remove_duplicate
+    """
+
+    def __init__(self, source_path, create_if_not_exist=False) -> None:
+        super().__init__(source_path, create_if_not_exist)
+
+        self._duplicate_cache: DuplicateSummary | None = None
+
+    def _gather_duplicate_cache(self, recursive: bool = True) -> None:
+        engine = Checksum(self.source_path, hash_mode=ChecksumMode.SHA256, save_result_to_file=False)
+        valid = [x for x in engine.path.glob("**/*" if recursive else "*") if x.is_file()]
+        checksum_cache = {}
+
+        # Checksum
+        for x in tqdm(valid, unit_scale=True, desc="Checking..."):
+            try:
+                cs_res = engine._checksum_operation(x)
+
+                if checksum_cache.get(cs_res) is None:
+                    checksum_cache[cs_res] = [x]
+                else:
+                    checksum_cache[cs_res] += [x]
+            except Exception as err:
+                print(f"ERROR: {x} - {err}")
+                continue
+
+        # Save to cache
+        self._duplicate_cache = DuplicateSummary({k: v for k, v in checksum_cache.items() if len(v) > 1})
+
+    def remove_duplicate(self, dry_run: bool = True, recursive: bool = True, debug: bool = True) -> None:
+        """
+        Remove duplicate files by SHA256 checksum
+
+        Parameters
+        ----------
+        dry_run : bool, optional
+            Simulate only (no files deleted), by default ``True``
+
+        recursive : bool, optional
+            Scan every file in the folder (including child folder), by default ``True``
+
+        debug : bool, optional
+            Print delete messages, by default ``True``
+        """
+        self._gather_duplicate_cache(recursive=recursive)
+
+        # Remove
+        try:
+            summary = self._duplicate_cache
+            print(f"Duplicate files: {summary.summary()}")
+            summary.remove_duplicates(dry_run=dry_run, keep_first=False, debug=debug)
+        except Exception as err:
+            pass

absfuyu/tools/converter.py

@@ -3,8 +3,8 @@ Absufyu: Converter
 ------------------
 Convert stuff
 
-Version: 5.6.1
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 6.1.2
+Date updated: 30/12/2025 (dd/mm/yyyy)
 
 Feature:
 --------

absfuyu/tools/generator.py

@@ -3,8 +3,8 @@ Absfuyu: Generator
 ------------------
 This generate stuff (Not python's ``generator``)
 
-Version: 5.6.1
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 6.1.2
+Date updated: 30/12/2025 (dd/mm/yyyy)
 
 Features:
 ---------
@@ -25,7 +25,7 @@ import string
 from collections.abc import Collection, Sequence
 from itertools import chain, combinations
 from random import choice
-from typing import TypeVar, cast, overload
+from typing import Literal, TypeVar, cast, overload
 
 from absfuyu.core.baseclass import GetClassMembersMixin
 from absfuyu.core.docstring import deprecated
@@ -78,6 +78,25 @@ class Generator(GetClassMembersMixin):
     """
 
     # Generate string
+    @overload
+    @staticmethod
+    def generate_string(  # type: ignore
+        charset: str = Charset.DEFAULT,
+        size: int = 8,
+        times: int = 1,
+        unique: bool = False,
+    ) -> list[str]: ...
+
+    @overload
+    @staticmethod
+    def generate_string(
+        charset: str = Charset.DEFAULT,
+        size: int = 8,
+        times: int = 1,
+        unique: bool = False,
+        string_type_if_1: Literal[True] = ...,
+    ) -> str: ...
+
     @staticmethod
     @deprecated("5.2.0", reason="Use generate_string2() instead.")
     def generate_string(
@@ -86,7 +105,7 @@ class Generator(GetClassMembersMixin):
         times: int = 1,
         unique: bool = False,
         string_type_if_1: bool = False,
-    ):
+    ) -> str | list[str]:
         """
         Generate a list of random string from character set (Random string generator).
         Deprecated
@@ -394,9 +413,7 @@ class Generator(GetClassMembersMixin):
 
     @overload
     @staticmethod
-    def combinations_range(
-        collection: Collection[T], *, min_len: int = 1, max_len: int = 0
-    ) -> list[tuple[T, ...]]: ...
+    def combinations_range(collection: Collection[T], *, min_len: int = 1, max_len: int = 0) -> list[tuple[T, ...]]: ...
 
     @staticmethod
     def combinations_range(

absfuyu/tools/inspector.py

@@ -3,8 +3,8 @@ Absfuyu: Inspector
 ------------------
 Inspector
 
-Version: 5.6.1
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 6.1.2
+Date updated: 30/12/2025 (dd/mm/yyyy)
 """
 
 # Module level

absfuyu/tools/keygen.py

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

absfuyu/tools/obfuscator.py

@@ -3,8 +3,8 @@ Absfuyu: Obfuscator
 -------------------
 Obfuscate code
 
-Version: 5.6.1
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 6.1.2
+Date updated: 30/12/2025 (dd/mm/yyyy)
 """
 
 # Module level

absfuyu/tools/passwordlib.py

@@ -3,8 +3,8 @@ Absfuyu: Passwordlib
 --------------------
 Password library
 
-Version: 5.6.1
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 6.1.2
+Date updated: 30/12/2025 (dd/mm/yyyy)
 """
 
 # Module level

absfuyu/tools/shutdownizer.py

@@ -3,8 +3,8 @@ Absfuyu: Shutdownizer
 ---------------------
 This shutdowns
 
-Version: 5.6.1
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 6.1.2
+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

absfuyu/tools/sw.py

@@ -3,8 +3,8 @@ Absufyu: Software
 -----------------
 Software, pyinstaller related stuff
 
-Version: 5.6.1
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 6.1.2
+Date updated: 30/12/2025 (dd/mm/yyyy)
 """
 
 # Module level
@@ -14,12 +14,14 @@ __all__ = [
     "get_system_info",
     "get_pyinstaller_exe_dir",
     "get_pyinstaller_resource_path",
+    "PyinstallerHelper",
     "HWIDgen",
     "LicenseKeySystem",
     "BasicSoftwareProtection",
     # Support
     "SystemInfo",
     "LicenseKey",
+    "PyinstallerHiddenImportPreset",
 ]
 
 
@@ -40,13 +42,13 @@ from pathlib import Path
 from typing import Literal, NamedTuple, TypedDict
 
 from absfuyu.core.baseclass import BaseClass
-from absfuyu.core.docstring import versionchanged
+from absfuyu.core.docstring import versionadded, versionchanged
 from absfuyu.dxt import Text
 from absfuyu.tools.converter import Base64EncodeDecode
 from absfuyu.util import stop_after_day
 
 
-# System Info
+# MARK: System Info
 # ---------------------------------------------------------------------------
 class SystemInfo(NamedTuple):
     """System info"""
@@ -93,7 +95,7 @@ def get_system_info() -> SystemInfo:
     )
 
 
-# Pyinstaller
+# MARK: Pyinstaller
 # ---------------------------------------------------------------------------
 @versionchanged("5.6.1", "Fixed behavior")
 def get_pyinstaller_exe_dir() -> Path:
@@ -123,7 +125,7 @@ def get_pyinstaller_resource_path(relative_path: str) -> Path:
     environments and PyInstaller-packaged executables.
 
     When running from a PyInstaller bundle, this function resolves the path relative
-    to the temporary `_MEIPASS` folder. During normal execution, it resolves the path
+    to the temporary ``_MEIPASS`` folder. During normal execution, it resolves the path
     relative to the current script's directory.
 
     Parameters
@@ -151,7 +153,137 @@ def get_pyinstaller_resource_path(relative_path: str) -> Path:
     return base_path / relative_path
 
 
-# Key System
+class PyinstallerHiddenImportPreset:
+    """
+    pyinstaller hidden import preset (library preset)
+
+    Example:
+    --------
+    >>> PyinstallerHelper(...).add_hidden_import(*PyinstallerHiddenImportPreset.ABSFUYU)
+    """
+
+    ABSFUYU = ["absfuyu"]
+    DF = ["pandas", "numpy", "openpyxl", "xlsxwriter"]  # DataFrame
+    VISUAL = ["rich", "tqdm"]
+
+
+@versionadded("5.11.0")
+class PyinstallerHelper(BaseClass):
+    """pyinstaller helper"""
+
+    def __init__(
+        self,
+        path_to_file: str | Path,
+        relative_to_cwd: bool = True,
+        console: bool = True,
+        onefile: bool = False,
+        noconfirm: bool = False,
+    ) -> None:
+        """
+        pyinstaller cmd helper
+
+        Parameters
+        ----------
+        path_to_file : str | Path
+            Path to .py file to make .exe
+
+        relative_to_cwd : bool, optional
+            Is the file relative to cwd, by default True
+
+        console : bool, optional
+            Include console, by default True
+
+        onefile : bool, optional
+            Convert into one file, by default False
+
+        noconfirm : bool, optional
+            No confirmation, by default False
+        """
+        self.source_path = Path(path_to_file)
+        self.relative_to_cwd = relative_to_cwd
+        self.console = console
+        self.onefile = onefile
+        self.noconfirm = noconfirm
+
+        if self.relative_to_cwd:
+            # rel = self.source_path.relative_to(Path.cwd())
+            # self._base_cmd = ["pyinstaller", f"'.\\{Path('.').joinpath(rel)}'"]
+            self._base_cmd = ["pyinstaller", f"'.\\{self.source_path.relative_to(Path.cwd())}'"]
+        else:
+            self._base_cmd = ["pyinstaller", f"'{self.source_path.resolve()}'"]
+
+        self._hidden_import = []
+        self._icon = ""
+
+    def add_hidden_import(self, *library: str) -> None:
+        """
+        Add hidden import (library)
+        """
+        if len(self._hidden_import) < 1:
+            self._hidden_import = list(library)
+        else:
+            self._hidden_import.extend(list(library))
+
+    def add_icon(self, path_to_icon: str | Path, *, relative_to_cwd: bool | None = None) -> None:
+        """
+        Add icon to .exe
+
+        Parameters
+        ----------
+        path_to_icon : str | Path
+            Path to icon file
+
+        relative_to_cwd : bool | None, optional
+            Use boolean value to overwrite relative_to_cwd option of the main engine, by default None
+        """
+        p = Path(path_to_icon)
+        use_relative = self.relative_to_cwd if relative_to_cwd is None else relative_to_cwd
+
+        # --icon=favicon.ico
+        if use_relative:
+            rel = p.relative_to(Path.cwd())
+            # ensure it always shows with ./ prefix
+            # self._icon = f"'{Path('.').joinpath(rel)}'"
+            self._icon = f"--icon='.\\{rel}'"
+        else:
+            self._icon = f"--icon='{p.resolve()}'"
+
+    def export_cmd(self) -> str:
+        """
+        Export pyinstaller cmd
+
+        Returns
+        -------
+        str
+            pyinstaller command
+        """
+        cmd = self._base_cmd
+
+        # Hidden import
+        if len(self._hidden_import) > 0:
+            dat = (f"--hidden-import={x}" for x in list(set(self._hidden_import)))
+            cmd.append(" ".join(dat))
+
+        # Console
+        if not self.console:
+            cmd.append("--noconsole")
+
+        # One file
+        if self.onefile:
+            cmd.append("--onefile")
+
+        # No confirm
+        if self.noconfirm:
+            cmd.append("--noconfirm")
+
+        # Icon
+        if len(self._icon) > 0:
+            cmd.append(self._icon)
+
+        return " ".join(cmd)
+
+
+# MARK: Key System
 # ---------------------------------------------------------------------------
 class HWIDgen(BaseClass):
     """
@@ -385,7 +517,7 @@ class LicenseKeySystem(BaseClass):
             return False
 
 
-# Software
+# MARK: Software
 # ---------------------------------------------------------------------------
 class BasicSoftwareProtection(BaseClass):
     """
@@ -474,6 +606,28 @@ class BasicSoftwareProtection(BaseClass):
         self._secret = secret
 
     def check_valid_license(self, generate_helper: bool = True) -> None:
+        """
+        Check for valid license
+        (``.zlic`` file in the same directory as the script that runs this code)
+
+        Parameters
+        ----------
+        generate_helper : bool, optional
+            Generate a helper file (``license.helper``),
+            which can be used to make license key,
+            by default ``True``
+
+        Raises
+        ------
+        SystemExit
+            License file not found!
+
+        SystemExit
+            Invalid license key format!
+
+        SystemExit
+            Invalid license!
+        """
         try:
             # Get license file
             license_file = list(self._cwd.glob("*.zlic"))[0]
@@ -501,14 +655,63 @@ class BasicSoftwareProtection(BaseClass):
             else:  # Invalid license
                 raise SystemExit("Invalid license!")
 
+    @versionadded("5.9.0")
+    def check_valid_license_gui(
+        self, title: str = "WARNING", message: str = "INVALID LICENSE!", generate_helper: bool = True
+    ) -> None:
+        """
+        Check for valid license
+        (``.zlic`` file in the same directory as the script that runs this code)
+        but will pop up a GUI when invalid license.
+
+        Parameters
+        ----------
+        title : str, optional
+            Title of the GUI, by default "WARNING"
+
+        message : str, optional
+            Message in the GUI, by default "INVALID LICENSE!"
+
+        generate_helper : bool, optional
+            Generate a helper file (``license.helper``),
+            which can be used to make license key,
+            by default ``True``
+
+        Raises
+        ------
+        SystemExit
+            Invalid license
+        """
+        try:
+            self.check_valid_license(generate_helper=generate_helper)
+        except SystemExit:
+            from tkinter import messagebox
+
+            messagebox.showwarning(title, message, icon="error")
+            raise SystemExit("Invalid license")
+
     # Make key
-    def _make_key(self, name: str, expiry: str, secret: str):
+    def _make_key(self, name: str, expiry: str, secret: str) -> None:
+        """
+        Generate license key in the same directory as the script that runs this code.
+
+        Parameters
+        ----------
+        name : str
+            Name of license's holder
+
+        expiry : str
+            Expiry date in format "yyyy-mm-dd"
+
+        secret : str
+            Secret string
+        """
         path = self._cwd.joinpath("license.zlic")
         engine = LicenseKeySystem(name, expiry, secret)
         with path.open("w", encoding="utf-8") as f:
             f.write(engine.make_key())
 
-    def generate_license_helper(self):
+    def generate_license_helper(self) -> None:
         """Gather HWID and make it into a file"""
         path = self._cwd.joinpath("license.helper")
         with path.open("w", encoding="utf-8") as f:

absfuyu/tools/web.py

@@ -3,21 +3,14 @@ Absfuyu: Web
 ------------
 Web, ``request``, ``BeautifulSoup`` stuff
 
-Version: 5.6.1
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 6.1.2
+Date updated: 30/12/2025 (dd/mm/yyyy)
 """
 
-# Library
-# ---------------------------------------------------------------------------
-import requests
-from bs4 import BeautifulSoup
-
-from absfuyu.logger import logger
-
 
 # Function
 # ---------------------------------------------------------------------------
-def soup_link(link: str) -> BeautifulSoup:
+def soup_link(link: str):
     """
     ``BeautifulSoup`` the link
 
@@ -32,12 +25,17 @@ def soup_link(link: str) -> BeautifulSoup:
         ``BeautifulSoup`` instance
     """
     try:
+        import requests
+        from bs4 import BeautifulSoup
+
         page = requests.get(link)
         soup = BeautifulSoup(page.content, "html.parser")
-        logger.debug("Soup completed!")
         return soup
+
+    except ImportError:
+        raise ImportError("Please install bs4, requests package")
+
     except Exception:
-        logger.error("Can't soup")
         raise SystemExit("Something wrong")  # noqa: B904
 
 
@@ -51,5 +49,4 @@ def gen_random_commit_msg() -> str:
         Random commit message
     """
     out = soup_link("https://whatthecommit.com/").get_text()[34:-20]
-    logger.debug(out)
     return out  # type: ignore