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

absfuyu/game/schulte.py

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

absfuyu/game/tictactoe.py

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

absfuyu/game/wordle.py

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

absfuyu/general/__init__.py

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

absfuyu/general/content.py

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

absfuyu/general/human.py

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

absfuyu/general/shape.py

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

absfuyu/general/tax.py

@@ -0,0 +1,324 @@
+"""
+Absfuyu: Tax calculator
+-----------------------
+Tax calculator
+
+Version: 5.11.0
+Date updated: 05/10/2025 (dd/mm/yyyy)
+"""
+
+# Module level
+# ---------------------------------------------------------------------------
+__all__ = ["PersonalIncomeTaxCalculator"]
+
+
+# Library
+# ---------------------------------------------------------------------------
+from dataclasses import dataclass
+from typing import Literal, TypedDict, overload
+
+from absfuyu.core.baseclass import BaseClass, BaseDataclass
+
+# Class
+# ---------------------------------------------------------------------------
+TaxLevel = list[tuple[float | int | None, float]]
+
+
+@dataclass
+class TaxLevelResult(BaseDataclass):
+    """
+    Result for a single tax level.
+
+    Parameters
+    ----------
+    lower : float
+        Lower bound
+
+    upper : float | None
+        Upper bound. ``None`` means +infinite
+
+    rate : float
+        Tax percentage in decimal (0.1 for 10%)
+
+    amount_taxed : float
+        Amount to calculate in current tax level
+
+    tax : float
+        Tax amount in current tax level
+    """
+
+    lower: float
+    upper: float | None
+    rate: float
+    amount_taxed: float
+    tax: float
+
+
+class TaxCalculationResult(TypedDict):
+    """
+    Tax calculation result.
+
+    Parameters
+    ----------
+    gross_income : float
+        The input gross income for the calculation.
+
+    deductions : float, optional
+        Amount to subtract from gross income before tax.
+
+    taxable_income : float
+        Gross income minus deductions.
+
+    per_tax_level : list[TaxLevelResult]
+        Detailed breakdown of income taxed at each tax level.
+
+    gross_tax : float
+        Total tax before credits.
+
+    tax_credits : float, optional
+        Amount subtracted from the computed tax after calculation.
+
+    net_tax : float
+        Total tax after applying credits.
+
+    effective_rate : float
+        Ratio of net tax to gross income (net_tax / gross_income).
+
+    marginal_rate : float
+        Tax rate applied to the last amount of money of taxable income.
+    """
+
+    gross_income: float
+    deductions: float
+    taxable_income: float
+    per_tax_level: list[TaxLevelResult]
+    gross_tax: float
+    tax_credits: float
+    net_tax: float
+    effective_rate: float
+    marginal_rate: float
+
+
+class TaxCalculationResultRaw(TypedDict):
+    """
+    Tax calculation result.
+
+    Parameters
+    ----------
+    gross_income : float
+        The input gross income for the calculation.
+
+    deductions : float, optional
+        Amount to subtract from gross income before tax.
+
+    taxable_income : float
+        Gross income minus deductions.
+
+    per_tax_level : list[TaxLevelResult]
+        Detailed breakdown of income taxed at each tax level.
+
+    gross_tax : float
+        Total tax before credits.
+
+    tax_credits : float, optional
+        Amount subtracted from the computed tax after calculation.
+
+    net_tax : float
+        Total tax after applying credits.
+
+    effective_rate : float
+        Ratio of net tax to gross income (net_tax / gross_income).
+
+    marginal_rate : float
+        Tax rate applied to the last amount of money of taxable income.
+    """
+
+    gross_income: float
+    deductions: float
+    taxable_income: float
+    per_tax_level: list[dict[str, float | None]]
+    gross_tax: float
+    tax_credits: float
+    net_tax: float
+    effective_rate: float
+    marginal_rate: float
+
+
+class PersonalIncomeTaxCalculator(BaseClass):
+    """
+    Progressive personal income tax calculator.
+
+    Parameters
+    ----------
+    tax_levels : list[tuple[float | int | None, float]], optional
+        Ordered list of tax levels.
+        Each tax level is represented as a tuple of (upper_bound, rate),
+        where ``upper_bound`` is the cumulative upper limit of the tax level.
+        Use ``None`` for the last tax level (no upper limit).
+        Example: ``[(10000, 0.10), (50000, 0.2), (None, 0.3)]``.
+        Set to ``None`` to have 0% tax rate, by default ``None``
+
+    deductions : float, optional
+        Amount to subtract from gross income before tax, by default 0.0
+
+    tax_credits : float, optional
+        Amount subtracted from the computed tax after calculation, by default 0.0
+
+    Attributes
+    ----------
+    gross_income : float
+        The input gross income for the calculation.
+
+    taxable_income : float
+        Gross income minus deductions.
+
+    per_tax_level : list[TaxLevelResult]
+        Detailed breakdown of income taxed at each tax level.
+
+    gross_tax : float
+        Total tax before credits.
+
+    net_tax : float
+        Total tax after applying credits.
+
+    effective_rate : float
+        Ratio of net tax to gross income.
+
+    marginal_rate : float
+        Tax rate applied to the last amount of money of taxable income.
+    """
+
+    def __init__(self, tax_levels: TaxLevel | None = None, deductions: float = 0.0, tax_credits: float = 0.0) -> None:
+        """
+        Progressive personal income tax calculator.
+
+        Parameters
+        ----------
+        tax_levels : list[tuple[float | int | None, float]], optional
+            Ordered list of tax levels.
+            Each tax level is represented as a tuple of (upper_bound, rate),
+            where ``upper_bound`` is the cumulative upper limit of the tax level.
+            Use ``None`` for the last tax level (no upper limit).
+            Example: ``[(10000, 0.10), (50000, 0.2), (None, 0.3)]``.
+            Set to ``None`` to have 0% tax rate, by default ``None``
+
+        deductions : float, optional
+            Amount to subtract from gross income before tax, by default 0.0
+
+        tax_credits : float, optional
+            Amount subtracted from the computed tax after calculation, by default 0.0
+        """
+        self.tax_levels = [] if tax_levels is None else tax_levels
+        self.deductions = deductions
+        self.tax_credits = tax_credits
+
+        # Results populated after calculation
+        self.gross_income: float = 0.0
+        self.taxable_income: float = 0.0
+        self.per_tax_level: list[TaxLevelResult] = []
+        self.gross_tax: float = 0.0
+        self.net_tax: float = 0.0
+        self.effective_rate: float = 0.0
+        self.marginal_rate: float = 0.0
+
+    def calculate(self, gross_income: float) -> None:
+        """
+        Compute tax for a given gross income.
+
+        Parameters
+        ----------
+        gross_income : float
+            Total gross income (unless tax levels are defined otherwise).
+        """
+        if gross_income < 0:
+            raise ValueError("gross_income must be non-negative")
+
+        self.gross_income = gross_income
+        self.taxable_income = max(0.0, gross_income - max(0.0, self.deductions))
+
+        self.per_tax_level = []
+        prev_upper = 0.0
+        remaining = self.taxable_income
+        self.gross_tax = 0.0
+        self.marginal_rate = 0.0
+
+        for upper, rate in self.tax_levels:
+            lower = prev_upper
+            if upper is None:
+                amount_taxed = remaining
+            else:
+                band = upper - prev_upper
+                amount_taxed = min(band, max(0.0, remaining))
+            tax = max(0.0, amount_taxed) * rate
+            self.per_tax_level.append(TaxLevelResult(lower, upper, rate, amount_taxed, tax))
+            self.gross_tax += tax
+            remaining -= amount_taxed
+            prev_upper = upper if upper is not None else prev_upper
+            if remaining <= 1e-9:
+                self.marginal_rate = rate
+                break
+            self.marginal_rate = rate
+
+        self.net_tax = max(0.0, self.gross_tax - max(0.0, self.tax_credits))
+        self.effective_rate = self.net_tax / gross_income if gross_income > 0 else 0.0
+
+    @overload
+    def to_dict(self) -> TaxCalculationResult: ...  # type: ignore
+    @overload
+    def to_dict(self, *, raw: Literal[True] = ...) -> TaxCalculationResultRaw: ...
+    def to_dict(self, *, raw: bool = False) -> TaxCalculationResult | TaxCalculationResultRaw:
+        """
+        Returns calculation result in dict format
+
+        Parameters
+        ----------
+        raw : bool, optional
+            Convert every value to dict, by default ``False``
+
+        Returns
+        -------
+        TaxCalculationResult
+            Tax calculation result
+        """
+        result: TaxCalculationResult = {
+            "gross_income": self.gross_income,
+            "deductions": self.deductions,
+            "taxable_income": self.taxable_income,
+            "per_tax_level": self.per_tax_level,
+            "gross_tax": self.gross_tax,
+            "tax_credits": self.tax_credits,
+            "net_tax": self.net_tax,
+            "effective_rate": self.effective_rate,
+            "marginal_rate": self.marginal_rate,
+        }
+        if raw:
+            result_raw: TaxCalculationResultRaw = result  # type: ignore
+            result_raw["per_tax_level"] = [x.to_dict() for x in result["per_tax_level"]]
+            return result
+        return result
+
+    def interpret_result(self) -> str:
+        result = self.to_dict()
+        text = ["===== Tax information ====="]
+
+        # text.append(f"Gross income: {result['gross_income']:,}")
+        # text.append(f"Deduction: {result['deductions']:,}")
+        # text.append(f"Taxable income: {result['taxable_income']:,}")
+        text.append(
+            f"Taxable income: {result['taxable_income']:,.2f} ({result['gross_income']:,.2f} - {result['deductions']:,.2f})"
+        )
+
+        for idx, tax_level in enumerate(result["per_tax_level"], start=1):
+            upper = f"{tax_level.upper:,.2f}" if tax_level.upper is not None else f"{self.gross_income:,.2f}"
+            text.append(
+                f"- Level {idx}: {tax_level.lower:,.2f} - {upper} @ {tax_level.rate*100:.1f}%: {tax_level.amount_taxed:,.2f} -> tax {tax_level.tax:,.2f}"
+            )
+
+        # text.append(f"Gross tax: {result['gross_tax']:,}")
+        # text.append(f"Tax credits: {result['tax_credits']:,}")
+        # text.append(f"Net tax: {result['net_tax']:,}")
+        text.append(f"Net tax: {result['net_tax']:,.2f} ({result['gross_tax']:,.2f} - {result['tax_credits']:,.2f})")
+
+        text.append(f"Effective rate: {result['effective_rate']*100:.2f}%")
+        text.append(f"Marginal rate: {result['marginal_rate']*100:.1f}%")
+        return "\n".join(text)

absfuyu/logger.py

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

absfuyu/pkg_data/__init__.py

@@ -3,8 +3,8 @@ Absfuyu: Package data
 ---------------------
 Load package data
 
-Version: 5.9.0
-Date updated: 19/09/2025 (dd/mm/yyyy)
+Version: 5.11.0
+Date updated: 30/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.9.0
-Date updated: 19/09/2025 (dd/mm/yyyy)
+Version: 5.11.0
+Date updated: 30/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.9.0
-Date updated: 19/09/2025 (dd/mm/yyyy)
+Version: 5.11.0
+Date updated: 30/09/2025 (dd/mm/yyyy)
 """
 
 from enum import StrEnum

absfuyu/sort.py

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

absfuyu/tools/__init__.py

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

absfuyu/tools/checksum.py

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

absfuyu/tools/converter.py

@@ -3,8 +3,8 @@ Absufyu: Converter
 ------------------
 Convert stuff
 
-Version: 5.9.0
-Date updated: 19/09/2025 (dd/mm/yyyy)
+Version: 5.11.0
+Date updated: 30/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.9.0
-Date updated: 19/09/2025 (dd/mm/yyyy)
+Version: 5.11.0
+Date updated: 30/09/2025 (dd/mm/yyyy)
 
 Features:
 ---------

absfuyu/tools/inspector.py

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

absfuyu/tools/obfuscator.py

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

absfuyu/tools/passwordlib.py

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

absfuyu/tools/shutdownizer.py

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