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

absfuyu/extra/rclone.py

@@ -0,0 +1,253 @@
+"""
+Absfuyu: Rclone decrypt
+-----------------------
+Rclone decryptor
+
+Version: 5.10.0
+Date updated: 23/09/2025 (dd/mm/yyyy)
+"""
+
+# Module level
+# ---------------------------------------------------------------------------
+__all__ = ["RcloneEncryptDecrypt", "DirectoryRcloneDEMixin"]
+
+
+# Library
+# ---------------------------------------------------------------------------
+import os
+import shutil
+from pathlib import Path
+from typing import Literal, Self
+
+from rclone import Crypt
+
+from absfuyu.core.baseclass import AutoREPRMixin
+from absfuyu.logger import LogLevel, logger
+from absfuyu.util.path import DirectoryBase
+
+
+# Class
+# ---------------------------------------------------------------------------
+class RcloneEncryptDecrypt(AutoREPRMixin):
+    """
+    Rclone Decrypt/Encrypt Module
+    """
+
+    def __init__(self, crypt: Crypt) -> None:
+        """
+        This will encrypt/decrypt with rclone style
+
+        Parameters
+        ----------
+        crypt : Crypt
+            ``rclone.Crypt`` object | Encrypt/Decrypt engine
+        """
+        self._crypt = crypt
+
+    @classmethod
+    def from_passwd_salt(cls, passwd: str, salt: str | None = None) -> Self:
+        """
+        Create Rclone Decrypt/Encrypt object from password and salt
+
+        Parameters
+        ----------
+        passwd : str
+            Custom password
+
+        salt : str | None, optional
+            Custom salt, by default None
+
+        Returns
+        -------
+        Self
+            Rclone Decrypt/Encrypt object
+        """
+        if salt is None:
+            crypt: Crypt = Crypt(passwd=passwd)
+        else:
+            crypt: Crypt = Crypt(passwd=passwd, salt=salt)
+        return cls(crypt)
+
+    # Support
+    @staticmethod
+    def _directory_validator(path: Path) -> Path:
+        """Validate if directory exists, then return the path"""
+        path = Path(path)
+        if not path.exists():
+            raise ValueError("Path does not exist")
+        return path
+
+    def _modify_name(self, name_to_modify: str, mode: Literal["encrypt", "decrypt"]) -> str:
+        if mode == "decrypt":
+            return self._crypt.Name.standard_decrypt(name_to_modify)
+        if mode == "encrypt":
+            return self._crypt.Name.standard_encrypt(name_to_modify)
+
+    def _decrypt_encrypt_operation(
+        self,
+        mode: Literal["encrypt", "decrypt"],
+        root_dir: Path | str,  # type: ignore
+        delete_when_complete: bool = False,
+    ) -> None:
+        """
+        Base operation to decrypt, encrypt
+
+        Parameters
+        ----------
+        mode : Literal["encrypt", "decrypt"]
+            Encrypt or decrypt
+
+        root_dir : Path | str
+            Directory location
+
+        delete_when_complete : bool
+            Delete directory when completed, defaults to False
+        """
+
+        logger.info(f"Begin operation: {mode.title()}")
+        root_dir = Path(root_dir)
+        FILE_MODE = False
+
+        # Make Base folder
+        if root_dir.is_file():
+            # Get name of parent dir and make name
+            temp = self._modify_name(root_dir.parent.name, "encrypt" if mode == "decrypt" else "decrypt")
+            # Create sub dir
+            base_dir = root_dir.parent.joinpath(temp)
+            base_dir.mkdir(exist_ok=True, parents=True)
+            # Move file to that dir
+            new_path = root_dir.rename(base_dir.joinpath(root_dir.name))
+            root_dir = base_dir  # Make root dir
+            FILE_MODE = True
+        else:
+            root_dir: Path = self._directory_validator(root_dir)
+            base_name: str = self._modify_name(root_dir.name, mode=mode)
+            base_dir: Path = root_dir.parent.joinpath(base_name)
+            base_dir.mkdir(exist_ok=True, parents=True)
+
+        _ljust: int = 17  # Logger ljust value
+
+        # Decrypt / Encrypt
+        for path in root_dir.glob("**/*"):
+            rel_path: Path = path.relative_to(root_dir)
+            rel_path_splited: list[str] = str(rel_path).split(os.sep)
+            rel_path_modified: list[str] = [self._modify_name(x, mode=mode) for x in rel_path_splited]
+            new_path: Path = base_dir.joinpath(*rel_path_modified)
+
+            if path.is_dir():
+                logger.debug(f"{mode.title()}ing Dir:".ljust(_ljust) + f"{path}")
+                new_path.mkdir(exist_ok=True, parents=True)
+                logger.debug(f"{mode.title()}ed Dir:".ljust(_ljust) + f"{new_path}")
+            else:
+                logger.debug(f"{mode.title()}ing File:".ljust(_ljust) + f"{path}")
+                if mode == "decrypt":
+                    self._crypt.File.file_decrypt(path, new_path)  # type: ignore
+                if mode == "encrypt":
+                    self._crypt.File.file_encrypt(path, new_path)  # type: ignore
+                logger.debug(f"{mode.title()}ed File:".ljust(_ljust) + f"{new_path}")
+        logger.info(f"Operation: {mode.title()} COMPLETED")
+
+        # File mode
+        if FILE_MODE:
+            new_path.rename(root_dir.parent.joinpath(new_path.name))  # type: ignore
+            shutil.rmtree(root_dir)
+
+        # Delete when completed
+        if delete_when_complete:
+            logger.debug(f"Deleting {root_dir}")
+            shutil.rmtree(root_dir)
+            logger.debug(f"Deleting {root_dir}...DONE")
+
+    # Decrypt/Encrypt
+    def decrypt(self, root_dir: Path, delete_when_complete: bool = False) -> None:
+        """
+        Decrypt encrypted directory.
+
+        This will decrypt the directory itself and
+        create a decrypted directory next to the original
+
+        Parameters
+        ----------
+        root_dir : Path
+            Directory location
+
+        delete_when_complete : bool, optional
+            Delete directory when completed, by default False
+        """
+        self._decrypt_encrypt_operation(mode="decrypt", root_dir=root_dir, delete_when_complete=delete_when_complete)
+
+    def encrypt(self, root_dir: Path, delete_when_complete: bool = False) -> None:
+        """
+        Encrypt entire directory.
+
+        This will encrypt the directory itself and
+        create an encrypted directory next to the original
+
+        Parameters
+        ----------
+        root_dir : Path
+            Directory location
+
+        delete_when_complete : bool, optional
+            Delete directory when completed, by default False
+        """
+        self._decrypt_encrypt_operation(mode="encrypt", root_dir=root_dir, delete_when_complete=delete_when_complete)
+
+
+class DirectoryRcloneDEMixin(DirectoryBase):
+    """
+    Directory - Rclone encrypt/decrypt
+
+    Extension for ``absfuyu.util.path.Directory``
+
+    - Decrypt
+    - Encrypt
+    """
+
+    def rclone_encrypt(self, passwd: str, salt: str | None = None, delete_when_complete: bool = False) -> None:
+        """
+        Encrypt entire directory.
+
+        This will encrypt the directory itself and
+        create an encrypted directory next to the original
+
+        Parameters
+        ----------
+        passwd : str
+            Custom password
+
+        salt : str | None, optional
+            Custom salt, by default None
+
+        delete_when_complete : bool, optional
+            Delete directory when completed, by default False
+        """
+        engine = RcloneEncryptDecrypt.from_passwd_salt(passwd=passwd, salt=salt)
+        engine.encrypt(self.source_path, delete_when_complete=delete_when_complete)
+
+    def rclone_decrypt(self, passwd: str, salt: str | None = None, delete_when_complete: bool = False) -> None:
+        """
+        Decrypt encrypted directory.
+
+        This will decrypt the directory itself and
+        create a decrypted directory next to the original
+
+        Parameters
+        ----------
+        passwd : str
+            Custom password
+
+        salt : str | None, optional
+            Custom salt, by default None
+
+        delete_when_complete : bool, optional
+            Delete directory when completed, by default False
+        """
+        engine = RcloneEncryptDecrypt.from_passwd_salt(passwd=passwd, salt=salt)
+        engine.decrypt(self.source_path, delete_when_complete=delete_when_complete)
+
+
+# Run
+# -----------------------------------------------------------------------------------------------
+if __name__ == "__main__":
+    logger.setLevel(LogLevel.DEBUG)

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.10.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.10.0
+Date updated: 23/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.10.0
+Date updated: 23/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.10.0
+Date updated: 23/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.10.0
+Date updated: 23/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.10.0
+Date updated: 23/09/2025 (dd/mm/yyyy)
 """
 
 # Module level

absfuyu/game/schulte.py

@@ -0,0 +1,78 @@
+"""
+Game: Schulte
+-------------
+
+Version: 5.10.0
+Date updated: 25/09/2025 (dd/mm/yyyy)
+"""
+
+# Module level
+# ---------------------------------------------------------------------------
+__all__ = ["SchulteTable"]
+
+
+# Library
+# ---------------------------------------------------------------------------
+from absfuyu.core.baseclass import BaseClass
+from absfuyu.dxt import ListExt
+from absfuyu.util.text_table import BoxStyle, get_box_drawing_character
+
+
+# Function
+# ---------------------------------------------------------------------------
+def draw_grid(data: list[list[int]], style: BoxStyle = "normal"):
+    chars = get_box_drawing_character(style=style)
+    rows = len(data)
+    cols = len(data[0])
+
+    # find max width for padding
+    cell_width = max(len(str(x)) for row in data for x in row) + 2
+
+    def horizontal_border(left: str, middle: str, right: str) -> str:
+        return left + (chars.HORIZONTAL * cell_width + middle) * (cols - 1) + chars.HORIZONTAL * cell_width + right
+
+    # top border
+    print(horizontal_border(chars.UPPER_LEFT_CORNER, chars.HORIZONTAL_DOWN, chars.UPPER_RIGHT_CORNER))
+
+    for i, row in enumerate(data):
+        # content line
+        line = chars.VERTICAL + "".join(f"{str(val):^{cell_width}}" + chars.VERTICAL for val in row)
+        print(line)
+
+        # middle or bottom border
+        if i < rows - 1:
+            print(horizontal_border(chars.VERTICAL_RIGHT, chars.CROSS, chars.VERTICAL_LEFT))
+        else:
+            print(horizontal_border(chars.LOWER_LEFT_CORNER, chars.HORIZONTAL_UP, chars.LOWER_RIGHT_CORNER))
+
+
+# Class
+# ---------------------------------------------------------------------------
+class SchulteTable(BaseClass):
+    """
+    A Schulte Table is a cognitive training tool consisting of a grid filled
+    with randomly placed numbers. The task is to find and select all the numbers
+    in ascending order as quickly as possible. This exercise helps improve
+    visual attention, focus, processing speed, mental flexibility,
+    and peripheral vision.
+    """
+
+    def __init__(self, size: int = 5) -> None:
+        self.size = max(size, 1)
+
+    def make_table(self) -> None:
+        data = ListExt(range(1, self.size**2 + 1)).shuffle().split_chunk(self.size)
+        draw_grid(data)
+
+    # def play(self):
+    #     """GUI"""
+    #     from absfuyu.util.gui import CustomTkinterApp
+
+    #     class Schulte(CustomTkinterApp):
+    #         def __init__(self, title: str | None = None, size: tuple[int, int] | None = None) -> None:
+    #             super().__init__(title=title, size=size)
+
+
+if __name__ == "__main__":
+    t = SchulteTable(5)
+    print(t)

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.10.0
+Date updated: 23/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.10.0
+Date updated: 23/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.10.0
+Date updated: 23/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.10.0
+Date updated: 23/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.10.0
+Date updated: 23/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.10.0
+Date updated: 23/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.10.0
+Date updated: 23/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.10.0
+Date updated: 23/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.10.0
+Date updated: 23/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.10.0
+Date updated: 23/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.10.0
+Date updated: 23/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.10.0
+Date updated: 23/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.10.0
+Date updated: 23/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.10.0
+Date updated: 23/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.10.0
+Date updated: 23/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.10.0
+Date updated: 23/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.10.0
+Date updated: 23/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.10.0
+Date updated: 23/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.10.0
+Date updated: 23/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.10.0
+Date updated: 23/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.10.0
+Date updated: 23/09/2025 (dd/mm/yyyy)
 """
 
 # Module level