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

absfuyu/__init__.py

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

absfuyu/__main__.py

@@ -3,8 +3,8 @@ ABSFUYU
 -------
 COMMAND LINE INTERFACE
 
-Version: 5.5.0
-Date updated: 23/04/2025 (dd/mm/yyyy)
+Version: 5.6.1
+Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 
 # Library

absfuyu/cli/__init__.py

@@ -3,8 +3,8 @@ ABSFUYU
 -------
 COMMAND LINE INTERFACE
 
-Version: 5.5.0
-Date updated: 23/04/2025 (dd/mm/yyyy)
+Version: 5.6.1
+Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 
 __all__ = ["cli"]

absfuyu/cli/color.py

@@ -3,8 +3,8 @@ ABSFUYU CLI
 -----------
 Color
 
-Version: 5.5.0
-Date updated: 23/04/2025 (dd/mm/yyyy)
+Version: 5.6.1
+Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 
 # Module Package

absfuyu/cli/config_group.py

@@ -3,8 +3,8 @@ ABSFUYU CLI
 -----------
 Config
 
-Version: 5.5.0
-Date updated: 23/04/2025 (dd/mm/yyyy)
+Version: 5.6.1
+Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 
 # Module Package

absfuyu/cli/do_group.py

@@ -3,8 +3,8 @@ ABSFUYU CLI
 -----------
 Do
 
-Version: 5.5.0
-Date updated: 23/04/2025 (dd/mm/yyyy)
+Version: 5.6.1
+Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 
 # Module Package

absfuyu/cli/game_group.py

@@ -3,8 +3,8 @@ ABSFUYU CLI
 -----------
 Game
 
-Version: 5.5.0
-Date updated: 23/04/2025 (dd/mm/yyyy)
+Version: 5.6.1
+Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 
 # Module Package

absfuyu/cli/tool_group.py

@@ -3,8 +3,8 @@ ABSFUYU CLI
 -----------
 Tool
 
-Version: 5.5.0
-Date updated: 23/04/2025 (dd/mm/yyyy)
+Version: 5.6.1
+Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 
 # Module Package

absfuyu/config/__init__.py

@@ -3,8 +3,8 @@ Absfuyu: Configuration
 ----------------------
 Package configuration module
 
-Version: 5.5.0
-Date updated: 23/04/2025 (dd/mm/yyyy)
+Version: 5.6.1
+Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 
 # Module level

absfuyu/core/__init__.py

@@ -3,8 +3,8 @@ Absfuyu: Core
 -------------
 Bases for other features
 
-Version: 5.5.0
-Date updated: 23/04/2025 (dd/mm/yyyy)
+Version: 5.6.1
+Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 
 # Module Package

absfuyu/core/baseclass.py

@@ -3,8 +3,8 @@ Absfuyu: Core
 -------------
 Bases for other features
 
-Version: 5.5.0
-Date updated: 23/04/2025 (dd/mm/yyyy)
+Version: 5.6.1
+Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 
 # Module Package
@@ -1041,7 +1041,13 @@ class BaseClass(GetClassMembersMixin, AutoREPRMixin):
 # Metaclass
 # ---------------------------------------------------------------------------
 class PositiveInitArgsMeta(type):
-    """Make sure that every args in a class __init__ is positive"""
+    """
+    Make sure that every args in a class __init__ is positive
+
+    Usage
+    -----
+    >>> class Test(metaclass=PositiveInitArgsMeta): pass
+    """
 
     def __call__(cls, *args, **kwargs):
         # Check if all positional and keyword arguments are positive

absfuyu/core/baseclass2.py

@@ -3,8 +3,8 @@ Absfuyu: Core
 -------------
 Bases for other features (with library)
 
-Version: 5.5.0
-Date updated: 23/04/2025 (dd/mm/yyyy)
+Version: 5.6.1
+Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 
 # Module Package

absfuyu/core/decorator.py

@@ -3,8 +3,8 @@ Absfuyu: Core
 -------------
 Decorator
 
-Version: 5.5.0
-Date updated: 23/04/2025 (dd/mm/yyyy)
+Version: 5.6.1
+Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 
 # Module Package

absfuyu/core/docstring.py

@@ -3,8 +3,8 @@ Absfuyu: Core
 -------------
 Sphinx docstring decorator
 
-Version: 5.5.0
-Date updated: 23/04/2025 (dd/mm/yyyy)
+Version: 5.6.1
+Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 
 # Module Package

absfuyu/core/dummy_cli.py

@@ -3,8 +3,8 @@ Absfuyu: Core
 -------------
 Dummy cli
 
-Version: 5.5.0
-Date updated: 23/04/2025 (dd/mm/yyyy)
+Version: 5.6.1
+Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 
 # Module Package

absfuyu/core/dummy_func.py

@@ -3,8 +3,8 @@ Absfuyu: Core
 -------------
 Dummy functions when other libraries are unvailable
 
-Version: 5.5.0
-Date updated: 23/04/2025 (dd/mm/yyyy)
+Version: 5.6.1
+Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 
 # Module Package

absfuyu/dxt/__init__.py

@@ -3,8 +3,8 @@ Absfuyu: Data Extension
 -----------------------
 Extension for data type such as ``list``, ``str``, ``dict``, ...
 
-Version: 5.5.0
-Date updated: 23/04/2025 (dd/mm/yyyy)
+Version: 5.6.1
+Date updated: 12/09/2025 (dd/mm/yyyy)
 
 Features:
 ---------

absfuyu/dxt/dictext.py

@@ -3,8 +3,8 @@ Absfuyu: Data Extension
 -----------------------
 dict extension
 
-Version: 5.5.0
-Date updated: 23/04/2025 (dd/mm/yyyy)
+Version: 5.6.1
+Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 
 # Module Package

absfuyu/dxt/dxt_support.py

@@ -3,8 +3,8 @@ Absfuyu: Data Extension
 -----------------------
 Support classes
 
-Version: 5.5.0
-Date updated: 23/04/2025 (dd/mm/yyyy)
+Version: 5.6.1
+Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 
 # Module Package

absfuyu/dxt/intext.py

@@ -3,8 +3,8 @@ Absfuyu: Data Extension
 -----------------------
 int extension
 
-Version: 5.5.0
-Date updated: 23/04/2025 (dd/mm/yyyy)
+Version: 5.6.1
+Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 
 # Module Package

absfuyu/dxt/listext.py

@@ -3,8 +3,8 @@ Absfuyu: Data Extension
 -----------------------
 list extension
 
-Version: 5.5.0
-Date updated: 23/04/2025 (dd/mm/yyyy)
+Version: 5.6.1
+Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 
 # Module Package

absfuyu/dxt/strext.py

@@ -3,8 +3,8 @@ Absfuyu: Data Extension
 -----------------------
 str extension
 
-Version: 5.5.0
-Date updated: 23/04/2025 (dd/mm/yyyy)
+Version: 5.6.1
+Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 
 # Module Package
@@ -69,7 +69,7 @@ def _generate_string(
     count = 0
 
     while count < times:
-        gen_string = "".join(random.choice(char_lst) for _ in range(size))
+        gen_string = "".join(random.choice(char_lst) for _ in range(size))  # type: ignore
         if not unique:
             unique_string.append(gen_string)
             count += 1

absfuyu/extra/__init__.py

@@ -3,8 +3,8 @@ Absfuyu: Extra
 --------------
 Features that require additional libraries
 
-Version: 5.5.0
-Date updated: 23/04/2025 (dd/mm/yyyy)
+Version: 5.6.1
+Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 
 

absfuyu/extra/beautiful.py

@@ -3,8 +3,8 @@ Absfuyu: Beautiful
 ------------------
 A decorator that makes output more beautiful
 
-Version: 5.5.0
-Date updated: 23/04/2025 (dd/mm/yyyy)
+Version: 5.6.1
+Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 
 # Module level

absfuyu/extra/da/__init__.py

@@ -3,8 +3,8 @@ Absfuyu: Data Analysis
 ----------------------
 Data Analyst
 
-Version: 5.5.0
-Date updated: 23/04/2025 (dd/mm/yyyy)
+Version: 5.6.1
+Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 
 # Module level
@@ -24,7 +24,7 @@ except ImportError:
 
     from absfuyu.config import ABSFUYU_CONFIG
 
-    if ABSFUYU_CONFIG._get_setting("auto-install-extra").value:
+    if ABSFUYU_CONFIG._get_setting("auto-install-extra").value:  # type: ignore
         cmd = "python -m pip install -U absfuyu[full]".split()
         run(cmd)
     else:

absfuyu/extra/da/dadf.py

@@ -3,8 +3,8 @@ Absfuyu: Data Analysis
 ----------------------
 Data Analyst DataFrame
 
-Version: 5.5.0
-Date updated: 23/04/2025 (dd/mm/yyyy)
+Version: 5.6.1
+Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 
 # Module level

absfuyu/extra/da/dadf_base.py

@@ -3,8 +3,8 @@ Absfuyu: Data Analysis
 ----------------------
 Data Analyst DataFrame - Base/Core
 
-Version: 5.5.0
-Date updated: 23/04/2025 (dd/mm/yyyy)
+Version: 5.6.1
+Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 
 # Module level

absfuyu/extra/da/df_func.py

@@ -3,8 +3,8 @@ Absfuyu: Data Analysis
 ----------------------
 DF Function
 
-Version: 5.5.0
-Date updated: 23/04/2025 (dd/mm/yyyy)
+Version: 5.6.1
+Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 
 # Module level

absfuyu/extra/da/mplt.py

@@ -3,8 +3,8 @@ Absfuyu: Data Analysis
 ----------------------
 Matplotlib Helper
 
-Version: 5.5.0
-Date updated: 23/04/2025 (dd/mm/yyyy)
+Version: 5.6.1
+Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 
 # Module level

absfuyu/extra/data_analysis.py

@@ -4,8 +4,8 @@ Absfuyu: Data Analysis [W.I.P]
 Extension for ``pd.DataFrame``
 (deprecated)
 
-Version: 5.5.0
-Date updated: 23/04/2025 (dd/mm/yyyy)
+Version: 5.6.1
+Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 
 # Library

absfuyu/extra/pdf.py

@@ -0,0 +1,89 @@
+"""
+Absfuyu: PDF
+------------
+PDF Tool [W.I.P]
+
+Version: 5.6.1
+Date updated: 12/09/2025 (dd/mm/yyyy)
+"""
+
+# Module level
+# ---------------------------------------------------------------------------
+__all__ = ["PDFTool"]
+
+
+# Library
+# ---------------------------------------------------------------------------
+from collections.abc import Sequence
+from pathlib import Path
+from typing import overload
+
+from absfuyu.core import BaseClass
+from absfuyu.core.dummy_func import tqdm
+
+PDF_MODE = False
+
+try:
+    from spire.pdf import PdfDocument, PdfTextExtractOptions, PdfTextExtractor
+except ImportError:
+    from subprocess import run
+
+    from absfuyu.config import ABSFUYU_CONFIG
+
+    if ABSFUYU_CONFIG._get_setting("auto-install-extra").value:  # type: ignore
+        cmd = "python -m pip install -U absfuyu[full]".split()
+        run(cmd)
+    else:
+        raise SystemExit("This feature is in absfuyu[full] package")  # noqa: B904
+else:
+    PDF_MODE = True
+
+
+# Class
+# ---------------------------------------------------------------------------
+
+
+class PDFTool(BaseClass):
+    def __init__(self) -> None:
+        super().__init__()
+        self.engine = PdfDocument()  # type: ignore
+
+        self.files: list[Path] = []
+
+    @overload
+    def add_file(self, file: Path | str) -> None: ...
+
+    @overload
+    def add_file(self, file: Sequence[Path | str]) -> None: ...
+
+    def add_file(self, file: Path | Sequence[Path | str] | str) -> None:
+        if isinstance(file, Sequence) and not isinstance(file, str):
+            self.files.extend([Path(x) for x in file])
+        else:
+            self.files.append(Path(file))
+
+    def load_file(self) -> list[str]:
+        """
+        Extract text from all file
+
+        Returns
+        -------
+        list[str]
+            Extracted text
+        """
+        engine = PdfDocument()  # type: ignore
+
+        extracted: list[str] = []
+        for x in tqdm(self.files, desc="Extracting", unit_scale=True):
+            engine.LoadFromFile(x.absolute().__str__())
+
+            # Get pages
+            for page in engine.Pages:
+                # Create a PdfTextExtractor for the page
+                extractor = PdfTextExtractor(page)  # type: ignore
+
+                # Extract all text from the page
+                text = extractor.ExtractText(PdfTextExtractOptions())  # type: ignore
+                extracted.append(text)
+
+        return extracted

absfuyu/fun/__init__.py

@@ -3,8 +3,8 @@ Absfuyu: Fun
 ------------
 Some fun or weird stuff
 
-Version: 5.5.0
-Date updated: 23/04/2025 (dd/mm/yyyy)
+Version: 5.6.1
+Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 
 # Module level

absfuyu/fun/rubik.py

@@ -3,8 +3,8 @@ Absfuyu: Fun
 ------------
 Rubik
 
-Version: 5.5.0
-Date updated: 23/04/2025 (dd/mm/yyyy)
+Version: 5.6.1
+Date updated: 12/09/2025 (dd/mm/yyyy)
 
 
 Version added: 5.4.0

absfuyu/fun/tarot.py

@@ -4,8 +4,8 @@ Absfuyu: Tarot
 Tarot stuff
 
 
-Version: 5.5.0
-Date updated: 23/04/2025 (dd/mm/yyyy)
+Version: 5.6.1
+Date updated: 12/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.5.0
-Date updated: 23/04/2025 (dd/mm/yyyy)
+Version: 5.6.1
+Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 
 # Module level

absfuyu/game/game_stat.py

@@ -1,8 +1,8 @@
 """
 Game: Game Stat
 
-Version: 5.5.0
-Date updated: 23/04/2025 (dd/mm/yyyy)
+Version: 5.6.1
+Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 
 # Module level

absfuyu/game/sudoku.py

@@ -3,8 +3,8 @@ Game: Sudoku
 ------------
 Sudoku 9x9 Solver
 
-Version: 5.5.0
-Date updated: 23/04/2025 (dd/mm/yyyy)
+Version: 5.6.1
+Date updated: 12/09/2025 (dd/mm/yyyy)
 
 Credit:
 -------

absfuyu/game/tictactoe.py

@@ -2,8 +2,8 @@
 Game: Tic Tac Toe
 -----------------
 
-Version: 5.5.0
-Date updated: 23/04/2025 (dd/mm/yyyy)
+Version: 5.6.1
+Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 
 # Module level

absfuyu/game/wordle.py

@@ -2,8 +2,8 @@
 Game: Wordle Solver
 -------------------
 
-Version: 5.5.0
-Date updated: 23/04/2025 (dd/mm/yyyy)
+Version: 5.6.1
+Date updated: 12/09/2025 (dd/mm/yyyy)
 
 Usage:
 ------

absfuyu/general/__init__.py

@@ -3,8 +3,8 @@ Absfuyu: General
 ----------------
 Collection of useful classes
 
-Version: 5.5.0
-Date updated: 23/04/2025 (dd/mm/yyyy)
+Version: 5.6.1
+Date updated: 12/09/2025 (dd/mm/yyyy)
 
 Features:
 ---------

absfuyu/general/content.py

@@ -3,8 +3,8 @@ Absfuyu: Content
 ----------------
 Handle .txt file
 
-Version: 5.5.0
-Date updated: 23/04/2025 (dd/mm/yyyy)
+Version: 5.6.1
+Date updated: 12/09/2025 (dd/mm/yyyy)
 
 Usage:
 ------

absfuyu/general/human.py

@@ -3,8 +3,8 @@ Absfuyu: Human
 --------------
 Human related stuff
 
-Version: 5.5.0
-Date updated: 23/04/2025 (dd/mm/yyyy)
+Version: 5.6.1
+Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 
 # Module level

absfuyu/general/shape.py

@@ -3,8 +3,8 @@ Absfuyu: Shape
 --------------
 Shapes
 
-Version: 5.5.0
-Date updated: 23/04/2025 (dd/mm/yyyy)
+Version: 5.6.1
+Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 
 # Module level

absfuyu/logger.py

@@ -3,8 +3,8 @@ Absfuyu: Logger
 ---------------
 Custom Logger Module
 
-Version: 5.5.0
-Date updated: 23/04/2025 (dd/mm/yyyy)
+Version: 5.6.1
+Date updated: 12/09/2025 (dd/mm/yyyy)
 
 Usage:
 ------

absfuyu/pkg_data/__init__.py

@@ -3,8 +3,8 @@ Absfuyu: Package data
 ---------------------
 Load package data
 
-Version: 5.5.0
-Date updated: 23/04/2025 (dd/mm/yyyy)
+Version: 5.6.1
+Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 
 # Module level