absfuyu 5.8.0__py3-none-any.whl → 5.9.0__py3-none-any.whl

absfuyu/extra/xml.py

@@ -3,8 +3,8 @@ Absfuyu: XML
 ------------
 XML Tool [W.I.P]
 
-Version: 5.8.0
-Date updated: 16/09/2025 (dd/mm/yyyy)
+Version: 5.9.0
+Date updated: 23/09/2025 (dd/mm/yyyy)
 """
 
 # Module level

absfuyu/fun/__init__.py

@@ -3,8 +3,8 @@ Absfuyu: Fun
 ------------
 Some fun or weird stuff
 
-Version: 5.8.0
-Date updated: 16/09/2025 (dd/mm/yyyy)
+Version: 5.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 """
 
 # Module level

absfuyu/fun/rubik.py

@@ -3,8 +3,8 @@ Absfuyu: Fun
 ------------
 Rubik
 
-Version: 5.8.0
-Date updated: 16/09/2025 (dd/mm/yyyy)
+Version: 5.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 
 
 Version added: 5.4.0

absfuyu/fun/tarot.py

@@ -4,8 +4,8 @@ Absfuyu: Tarot
 Tarot stuff
 
 
-Version: 5.8.0
-Date updated: 16/09/2025 (dd/mm/yyyy)
+Version: 5.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 
 Usage:
 ------

absfuyu/game/__init__.py

@@ -3,8 +3,8 @@ Absfuyu: Game
 -------------
 Contain some game that can be played on terminal
 
-Version: 5.8.0
-Date updated: 16/09/2025 (dd/mm/yyyy)
+Version: 5.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 """
 
 # Module level

absfuyu/game/game_stat.py

@@ -1,8 +1,8 @@
 """
 Game: Game Stat
 
-Version: 5.8.0
-Date updated: 16/09/2025 (dd/mm/yyyy)
+Version: 5.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 """
 
 # Module level

absfuyu/game/sudoku.py

@@ -3,8 +3,8 @@ Game: Sudoku
 ------------
 Sudoku 9x9 Solver
 
-Version: 5.8.0
-Date updated: 16/09/2025 (dd/mm/yyyy)
+Version: 5.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 
 Credit:
 -------

absfuyu/game/tictactoe.py

@@ -2,8 +2,8 @@
 Game: Tic Tac Toe
 -----------------
 
-Version: 5.8.0
-Date updated: 16/09/2025 (dd/mm/yyyy)
+Version: 5.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 """
 
 # Module level

absfuyu/game/wordle.py

@@ -2,8 +2,8 @@
 Game: Wordle Solver
 -------------------
 
-Version: 5.8.0
-Date updated: 16/09/2025 (dd/mm/yyyy)
+Version: 5.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 
 Usage:
 ------

absfuyu/general/__init__.py

@@ -3,8 +3,8 @@ Absfuyu: General
 ----------------
 Collection of useful classes
 
-Version: 5.8.0
-Date updated: 16/09/2025 (dd/mm/yyyy)
+Version: 5.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 
 Features:
 ---------

absfuyu/general/content.py

@@ -3,8 +3,8 @@ Absfuyu: Content
 ----------------
 Handle .txt file
 
-Version: 5.8.0
-Date updated: 16/09/2025 (dd/mm/yyyy)
+Version: 5.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 
 Usage:
 ------

absfuyu/general/human.py

@@ -3,8 +3,8 @@ Absfuyu: Human
 --------------
 Human related stuff
 
-Version: 5.8.0
-Date updated: 16/09/2025 (dd/mm/yyyy)
+Version: 5.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 """
 
 # Module level

absfuyu/general/shape.py

@@ -3,8 +3,8 @@ Absfuyu: Shape
 --------------
 Shapes
 
-Version: 5.8.0
-Date updated: 16/09/2025 (dd/mm/yyyy)
+Version: 5.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 """
 
 # Module level

absfuyu/logger.py

@@ -3,8 +3,8 @@ Absfuyu: Logger
 ---------------
 Custom Logger Module
 
-Version: 5.8.0
-Date updated: 16/09/2025 (dd/mm/yyyy)
+Version: 5.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 
 Usage:
 ------

absfuyu/pkg_data/__init__.py

@@ -3,8 +3,8 @@ Absfuyu: Package data
 ---------------------
 Load package data
 
-Version: 5.8.0
-Date updated: 16/09/2025 (dd/mm/yyyy)
+Version: 5.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 """
 
 # Module level

absfuyu/pkg_data/deprecated.py

@@ -3,8 +3,8 @@ Absfuyu: Package data
 ---------------------
 Deprecated (but might have some use)
 
-Version: 5.8.0
-Date updated: 16/09/2025 (dd/mm/yyyy)
+Version: 5.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 """
 
 # Library

absfuyu/pkg_data/logo.py

@@ -3,8 +3,8 @@ Absfuyu: Logo
 -------------
 Absfuyu logo in base64 string for easy access
 
-Version: 5.8.0
-Date updated: 17/09/2025 (dd/mm/yyyy)
+Version: 5.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 """
 
 from enum import StrEnum

absfuyu/sort.py

@@ -3,8 +3,8 @@ Absfuyu: Sort
 -------------
 Sort Module
 
-Version: 5.8.0
-Date updated: 16/09/2025 (dd/mm/yyyy)
+Version: 5.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 """
 
 # Module level

absfuyu/tools/__init__.py

@@ -3,8 +3,8 @@ Absfuyu: Tools
 --------------
 Some useful tools
 
-Version: 5.8.0
-Date updated: 16/09/2025 (dd/mm/yyyy)
+Version: 5.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 """
 
 # Module Package

absfuyu/tools/checksum.py

@@ -3,8 +3,8 @@ Absufyu: Checksum
 -----------------
 Check MD5, SHA256, ...
 
-Version: 5.8.0
-Date updated: 16/09/2025 (dd/mm/yyyy)
+Version: 5.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 """
 
 # Module level

absfuyu/tools/converter.py

@@ -3,8 +3,8 @@ Absufyu: Converter
 ------------------
 Convert stuff
 
-Version: 5.8.0
-Date updated: 16/09/2025 (dd/mm/yyyy)
+Version: 5.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 
 Feature:
 --------

absfuyu/tools/generator.py

@@ -3,8 +3,8 @@ Absfuyu: Generator
 ------------------
 This generate stuff (Not python's ``generator``)
 
-Version: 5.8.0
-Date updated: 16/09/2025 (dd/mm/yyyy)
+Version: 5.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 
 Features:
 ---------

absfuyu/tools/inspector.py

@@ -3,8 +3,8 @@ Absfuyu: Inspector
 ------------------
 Inspector
 
-Version: 5.8.0
-Date updated: 16/09/2025 (dd/mm/yyyy)
+Version: 5.9.0
+Date updated: 19/09/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.8.0
-Date updated: 16/09/2025 (dd/mm/yyyy)
+Version: 5.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 """
 
 # Module level

absfuyu/tools/obfuscator.py

@@ -3,8 +3,8 @@ Absfuyu: Obfuscator
 -------------------
 Obfuscate code
 
-Version: 5.8.0
-Date updated: 16/09/2025 (dd/mm/yyyy)
+Version: 5.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 """
 
 # Module level

absfuyu/tools/passwordlib.py

@@ -3,8 +3,8 @@ Absfuyu: Passwordlib
 --------------------
 Password library
 
-Version: 5.8.0
-Date updated: 16/09/2025 (dd/mm/yyyy)
+Version: 5.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 """
 
 # Module level

absfuyu/tools/shutdownizer.py

@@ -3,8 +3,8 @@ Absfuyu: Shutdownizer
 ---------------------
 This shutdowns
 
-Version: 5.8.0
-Date updated: 16/09/2025 (dd/mm/yyyy)
+Version: 5.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 """
 
 # Module level

absfuyu/tools/sw.py

@@ -3,8 +3,8 @@ Absufyu: Software
 -----------------
 Software, pyinstaller related stuff
 
-Version: 5.8.0
-Date updated: 16/09/2025 (dd/mm/yyyy)
+Version: 5.9.0
+Date updated: 23/09/2025 (dd/mm/yyyy)
 """
 
 # Module level
@@ -40,7 +40,7 @@ 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
@@ -474,6 +474,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 +523,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,8 +3,8 @@ Absfuyu: Web
 ------------
 Web, ``request``, ``BeautifulSoup`` stuff
 
-Version: 5.8.0
-Date updated: 16/09/2025 (dd/mm/yyyy)
+Version: 5.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 """
 
 # Library

absfuyu/typings.py

@@ -3,8 +3,8 @@ Absfuyu: Core
 -------------
 Pre-defined typing
 
-Version: 5.8.0
-Date updated: 16/09/2025 (dd/mm/yyyy)
+Version: 5.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 """
 
 # Module Package

absfuyu/util/__init__.py

@@ -3,8 +3,8 @@ Absufyu: Utilities
 ------------------
 Some random utilities
 
-Version: 5.8.0
-Date updated: 16/09/2025 (dd/mm/yyyy)
+Version: 5.9.0
+Date updated: 23/09/2025 (dd/mm/yyyy)
 """
 
 # Module Package
@@ -25,6 +25,7 @@ __all__ = [
 # Library
 # ---------------------------------------------------------------------------
 import pkgutil
+import subprocess
 from datetime import datetime
 from string import printable
 
@@ -257,3 +258,31 @@ def convert_to_raw_unicode(text: str, partial: bool = True) -> str:
         character if character in character_set and partial else _convert(character)
         for character in text
     )
+
+
+@versionadded("5.9.0")
+def is_command_available(cmd: list[str] | str, err_msg: str = "") -> None:
+    """
+    Checks if the desired command available
+
+    Parameters
+    ----------
+    cmd : list[str] | str
+        Command to check
+
+    err_msg : str, optional
+        Custom error message, by default ""
+
+    Raises
+    ------
+    ValueError
+        When command is unvailable
+    """
+    try:
+        subprocess.run(
+            cmd,
+            stdout=subprocess.DEVNULL,
+            stderr=subprocess.DEVNULL,
+        )
+    except Exception:
+        raise ValueError(err_msg)

absfuyu/util/api.py

@@ -3,8 +3,8 @@ Absufyu: API
 ------------
 Fetch data stuff
 
-Version: 5.8.0
-Date updated: 16/09/2025 (dd/mm/yyyy)
+Version: 5.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 """
 
 # Module level

absfuyu/util/gui.py

@@ -0,0 +1,32 @@
+"""
+Absfuyu: GUI
+------------
+Custom tkinter GUI
+
+Version: 5.9.0
+Date updated: 23/09/2025 (dd/mm/yyyy)
+"""
+
+# Module level
+# ---------------------------------------------------------------------------
+__all__ = ["CustomTkinterApp"]
+
+
+# Library
+# ---------------------------------------------------------------------------
+import tkinter as tk
+
+from absfuyu.pkg_data.logo import AbsfuyuLogo
+
+
+# Class
+# ---------------------------------------------------------------------------
+class CustomTkinterApp(tk.Tk):
+    def __init__(self, title: str | None = None) -> None:
+        super().__init__()
+
+        # Set custom icon
+        self.iconphoto(True, tk.PhotoImage(data=AbsfuyuLogo.SHORT))
+
+        # Title
+        self.title(title)

absfuyu/util/json_method.py

@@ -3,8 +3,8 @@ Absfuyu: Json Method
 --------------------
 ``.json`` file handling
 
-Version: 5.8.0
-Date updated: 16/09/2025 (dd/mm/yyyy)
+Version: 5.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 """
 
 # Module level

absfuyu/util/lunar.py

@@ -4,8 +4,8 @@ Absfuyu: Lunar calendar
 -----------------------
 Convert to lunar calendar
 
-Version: 5.8.0
-Date updated: 16/09/2025 (dd/mm/yyyy)
+Version: 5.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 
 Source:
 -------

absfuyu/util/path.py

@@ -3,8 +3,8 @@ Absfuyu: Path
 -------------
 Path related
 
-Version: 5.8.0
-Date updated: 16/09/2025 (dd/mm/yyyy)
+Version: 5.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 
 Feature:
 --------

absfuyu/util/performance.py

@@ -3,8 +3,8 @@ Absfuyu: Performance
 --------------------
 Performance Check
 
-Version: 5.8.0
-Date updated: 16/09/2025 (dd/mm/yyyy)
+Version: 5.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 
 Feature:
 --------

absfuyu/util/shorten_number.py

@@ -3,8 +3,8 @@ Absfuyu: Shorten number
 -----------------------
 Short number base on suffixes
 
-Version: 5.8.0
-Date updated: 16/09/2025 (dd/mm/yyyy)
+Version: 5.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 """
 
 # Module level

absfuyu/util/text_table.py

@@ -3,8 +3,8 @@ Absufyu: Utilities
 ------------------
 Text table
 
-Version: 5.8.0
-Date updated: 16/09/2025 (dd/mm/yyyy)
+Version: 5.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 """
 
 # Module level

absfuyu/util/zipped.py

@@ -4,8 +4,8 @@ Absfuyu: Zipped
 Zipping stuff
 (deprecated, use absfuyu.util.path.Directory)
 
-Version: 5.8.0
-Date updated: 16/09/2025 (dd/mm/yyyy)
+Version: 5.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 """
 
 # Module level

absfuyu/version.py

@@ -3,8 +3,8 @@ Absfuyu: Version
 ----------------
 Package versioning module
 
-Version: 5.8.0
-Date updated: 16/09/2025 (dd/mm/yyyy)
+Version: 5.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 """
 
 # Module level