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

absfuyu/fun/rubik.py

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

absfuyu/fun/tarot.py

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

absfuyu/game/game_stat.py

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

absfuyu/game/schulte.py

@@ -0,0 +1,78 @@
+"""
+Game: Schulte
+-------------
+
+Version: 6.1.1
+Date updated: 30/12/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.6.1
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 6.1.1
+Date updated: 30/12/2025 (dd/mm/yyyy)
 
 Credit:
 -------

absfuyu/game/tictactoe.py

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

absfuyu/game/wordle.py

@@ -2,8 +2,8 @@
 Game: Wordle Solver
 -------------------
 
-Version: 5.6.1
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 6.1.1
+Date updated: 30/12/2025 (dd/mm/yyyy)
 
 Usage:
 ------
@@ -27,8 +27,6 @@ import string
 from collections import Counter
 from itertools import chain
 
-import requests
-
 # Class
 # ---------------------------------------------------------------------------
 OFFLINE_WORDS = """\
@@ -123,6 +121,8 @@ class Wordle:
         Try to fetch words list from online source
         """
         try:
+            import requests
+
             dict_link = "https://raw.githubusercontent.com/dwyl/english-words/master/words_dictionary.json"
             res = requests.get(dict_link)
             word_list: list[str] = list(res.json().keys())
@@ -134,6 +134,8 @@ class Wordle:
                     and set(word) < self._ALLOWABLE_CHARACTERS
                 }
             )
+        except ImportError:
+            raise ImportError("Please install requests package")
         except Exception:
             pass
 

absfuyu/general/__init__.py

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

absfuyu/general/content.py

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

absfuyu/general/human.py

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

absfuyu/general/resrel.py

@@ -0,0 +1,213 @@
+"""
+Absfuyu: Relative resolution
+----------------------------
+Relative resolution
+
+Use with screen resolution getter like ``tkinter``, ``ctypes``, ``screeninfo`` is recommended
+
+Version: 6.1.1
+Date updated: 30/12/2025 (dd/mm/yyyy)
+"""
+
+# Module level
+# ---------------------------------------------------------------------------
+__all__ = ["RelativeResoluton", "RelativeResolutonTranslater"]
+
+
+# Library
+# ---------------------------------------------------------------------------
+from fractions import Fraction
+from typing import Self, overload
+
+from absfuyu.core.baseclass import BaseClass
+
+
+# Class
+# ---------------------------------------------------------------------------
+class RelativeResoluton(BaseClass):
+    def __init__(self, x: int, y: int) -> None:
+        """
+        Resolution
+
+        Parameters
+        ----------
+        x : int
+            Normally width
+
+        y : int
+            Normally height
+
+        Raises
+        ------
+        ValueError
+            When x or y < 1
+        """
+        if x < 1 or y < 1:
+            raise ValueError("Resolution must be >= 1")
+
+        self.x = x
+        self.y = y
+
+    @property
+    def ratio(self) -> Fraction:
+        """
+        Ratio of the resolution
+        """
+        return Fraction(self.x, self.y)
+
+    def scale_by(self, by: int | float | Fraction, /) -> Self:
+        """
+        Scale the resolution by an amount
+
+        Parameters
+        ----------
+        by : int | float | Fraction
+            Amount to scale
+
+        Returns
+        -------
+        Self
+            New scaled resolution
+        """
+        if isinstance(by, Fraction):
+            x = int(self.x * by.numerator / by.denominator)
+            y = int(self.y * by.numerator / by.denominator)
+        else:
+            x = int(self.x * by)
+            y = int(self.y * by)
+        return self.__class__(x, y)
+
+    @overload
+    def get_point_relative(self, x: int, y: int, /) -> tuple[Fraction, Fraction]: ...
+    @overload
+    def get_point_relative(self, x: int, y: int, /, *, strict: bool = True) -> tuple[Fraction, Fraction]: ...
+    def get_point_relative(self, x: int, y: int, /, *, strict: bool = True) -> tuple[Fraction, Fraction]:
+        """
+        Get relative point from fixed point.
+
+        Parameters
+        ----------
+        x : int
+            Normally width
+
+        y : int
+            Normally height
+
+        strict : bool, optional
+            Convert ``x`` and ``y`` into type int first, by default ``True``
+
+        Returns
+        -------
+        tuple[Fraction, Fraction]
+            Relative point
+        """
+        if strict:
+            x = int(x)
+            y = int(y)
+        x_rel = Fraction(x, self.x)
+        y_rel = Fraction(y, self.y)
+        return x_rel, y_rel
+
+    def get_fixed_point(self, x_rel: Fraction, y_rel: Fraction, /) -> tuple[int, int]:
+        """
+        Get fixed point from relative point.
+
+        Parameters
+        ----------
+        x_rel : Fraction
+            Normally width
+
+        y_rel : Fraction
+            Normally height
+
+        Returns
+        -------
+        tuple[int, int]
+            Fixed point
+        """
+        x = int(self.x * x_rel.numerator / x_rel.denominator)
+        y = int(self.y * y_rel.numerator / y_rel.denominator)
+        return x, y
+
+
+class RelativeResolutonTranslater(RelativeResoluton):
+    """
+    Relative resolution translater
+
+    It is recommended to use with screen resolution getter like
+    ``tkinter``, ``ctypes``, ``screeninfo``, ``pyautogui``
+
+
+    Example:
+    --------
+    >>> import tkinter as tk
+    >>> root = tk.Tk()
+    >>> width, height = root.winfo_screenwidth(), root.winfo_screenheight()
+    >>> rr = RelativeResolutonTranslater(width, height)
+    >>> rr.add_target_scale((1920, 1080))
+    >>> rr.t(1280, 720)
+
+    >>> import tkinter as tk
+    >>> root = tk.Tk()
+    >>> width, height = root.winfo_screenwidth(), root.winfo_screenheight()
+    >>> rr = RelativeResolutonTranslater(1920, 1080)
+    >>> rr.add_target_scale((width, height))
+    >>> rr.t(1280, 720)
+    """
+
+    def __init__(self, x: int, y: int) -> None:
+        super().__init__(x, y)
+        self._target_scale = Fraction(1, 1)
+
+    @overload
+    def add_target_scale(self, target: int | float, /) -> None: ...
+    @overload
+    def add_target_scale(self, target: Fraction, /) -> None: ...
+    @overload
+    def add_target_scale(self, target: tuple[int, int], /) -> None: ...
+    def add_target_scale(self, target: tuple[int, int] | Fraction | int | float, /) -> None:
+        """
+        Add target scale to scale resolution to
+
+        Parameters
+        ----------
+        target : tuple[int, int] | Fraction | int | float
+            Target scale (tuple[int, int] for desire resolution)
+
+        Raises
+        ------
+        NotImplementedError
+            When ratio of new and old resolution is not equal
+        """
+        if isinstance(target, tuple):  # Resolution
+            if self.ratio == Fraction(*target):  # Same ratio
+                self._target_scale = Fraction(target[0] / self.x)
+            else:
+                raise NotImplementedError("Resolution's ratio conversion not supported")
+        else:
+            self._target_scale = Fraction(target)
+
+    def translate_point(self, x: int, y: int, /) -> tuple[int, int]:
+        """
+        Translate point(x, y) to target_scale fixed point through relative point.
+
+        Parameters
+        ----------
+        x : int
+            Normally width
+
+        y : int
+            Normally height
+
+        Returns
+        -------
+        tuple[int, int]
+            Translated point
+        """
+        x_rel, y_rel = self.get_point_relative(x, y)
+        fixed_point = self.scale_by(self._target_scale).get_fixed_point(x_rel, y_rel)
+        return fixed_point
+
+    def t(self, x: int, y: int, /) -> tuple[int, int]:
+        """Wrapper for self.translate_point"""
+        return self.translate_point(x, y)

absfuyu/general/shape.py

@@ -3,8 +3,8 @@ Absfuyu: Shape
 --------------
 Shapes
 
-Version: 5.6.1
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 6.1.1
+Date updated: 30/12/2025 (dd/mm/yyyy)
 """
 
 # Module level
@@ -33,12 +33,7 @@ __all__ = [
 # ---------------------------------------------------------------------------
 import math
 from abc import ABC, abstractmethod
-from typing import ClassVar, Self
-
-try:
-    from typing import override  # type: ignore
-except ImportError:
-    from absfuyu.core.decorator import dummy_decorator as override
+from typing import ClassVar, Self, override
 
 from absfuyu.core import BaseClass