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

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

absfuyu/tools/sw.py

@@ -3,8 +3,8 @@ Absufyu: Software
 -----------------
 Software, pyinstaller related stuff
 
-Version: 5.10.0
-Date updated: 23/09/2025 (dd/mm/yyyy)
+Version: 5.11.0
+Date updated: 30/09/2025 (dd/mm/yyyy)
 """
 
 # Module level
@@ -14,12 +14,14 @@ __all__ = [
     "get_system_info",
     "get_pyinstaller_exe_dir",
     "get_pyinstaller_resource_path",
+    "PyinstallerHelper",
     "HWIDgen",
     "LicenseKeySystem",
     "BasicSoftwareProtection",
     # Support
     "SystemInfo",
     "LicenseKey",
+    "PyinstallerHiddenImportPreset",
 ]
 
 
@@ -46,7 +48,7 @@ from absfuyu.tools.converter import Base64EncodeDecode
 from absfuyu.util import stop_after_day
 
 
-# System Info
+# MARK: System Info
 # ---------------------------------------------------------------------------
 class SystemInfo(NamedTuple):
     """System info"""
@@ -93,7 +95,7 @@ def get_system_info() -> SystemInfo:
     )
 
 
-# Pyinstaller
+# MARK: Pyinstaller
 # ---------------------------------------------------------------------------
 @versionchanged("5.6.1", "Fixed behavior")
 def get_pyinstaller_exe_dir() -> Path:
@@ -123,7 +125,7 @@ def get_pyinstaller_resource_path(relative_path: str) -> Path:
     environments and PyInstaller-packaged executables.
 
     When running from a PyInstaller bundle, this function resolves the path relative
-    to the temporary `_MEIPASS` folder. During normal execution, it resolves the path
+    to the temporary ``_MEIPASS`` folder. During normal execution, it resolves the path
     relative to the current script's directory.
 
     Parameters
@@ -151,7 +153,136 @@ def get_pyinstaller_resource_path(relative_path: str) -> Path:
     return base_path / relative_path
 
 
-# Key System
+class PyinstallerHiddenImportPreset:
+    """
+    pyinstaller hidden import preset (library preset)
+
+    Example:
+    --------
+    >>> PyinstallerHelper(...).add_hidden_import(*PyinstallerHiddenImportPreset.ABSFUYU)
+    """
+
+    ABSFUYU = ["absfuyu"]
+    DF = ["pandas", "numpy", "openpyxl", "xlsxwriter"]  # DataFrame
+    VISUAL = ["rich", "tqdm"]
+
+
+@versionadded("5.11.0")
+class PyinstallerHelper(BaseClass):
+    """pyinstaller helper"""
+
+    def __init__(
+        self,
+        path_to_file: str | Path,
+        relative_to_cwd: bool = True,
+        console: bool = True,
+        onefile: bool = False,
+        noconfirm: bool = False,
+    ) -> None:
+        """
+        pyinstaller cmd helper
+
+        Parameters
+        ----------
+        path_to_file : str | Path
+            Path to .py file to make .exe
+
+        relative_to_cwd : bool, optional
+            Is the file relative to cwd, by default True
+
+        console : bool, optional
+            Include console, by default True
+
+        onefile : bool, optional
+            Convert into one file, by default False
+
+        noconfirm : bool, optional
+            No confirmation, by default False
+        """
+        self.source_path = Path(path_to_file)
+        self.relative_to_cwd = relative_to_cwd
+        self.console = console
+        self.onefile = onefile
+        self.noconfirm = noconfirm
+
+        if self.relative_to_cwd:
+            # rel = self.source_path.relative_to(Path.cwd())
+            # self._base_cmd = ["pyinstaller", f"'.\\{Path('.').joinpath(rel)}'"]
+            self._base_cmd = ["pyinstaller", f"'.\\{self.source_path.relative_to(Path.cwd())}'"]
+        else:
+            self._base_cmd = ["pyinstaller", f"'{self.source_path.resolve()}'"]
+
+        self._hidden_import = []
+        self._icon = ""
+
+    def add_hidden_import(self, *library: str) -> None:
+        """
+        Add hidden import (library)
+        """
+        if len(self._hidden_import) < 1:
+            self._hidden_import = list(library)
+        else:
+            self._hidden_import.extend(list(library))
+
+    def add_icon(self, path_to_icon: str | Path, *, relative_to_cwd: bool | None = None) -> None:
+        """
+        Add icon to .exe
+
+        Parameters
+        ----------
+        path_to_icon : str | Path
+            Path to icon file
+
+        relative_to_cwd : bool | None, optional
+            Use boolean value to overwrite relative_to_cwd option of the main engine, by default None
+        """
+        p = Path(path_to_icon)
+        use_relative = self.relative_to_cwd if relative_to_cwd is None else relative_to_cwd
+
+        if use_relative:
+            rel = p.relative_to(Path.cwd())
+            # ensure it always shows with ./ prefix
+            # self._icon = f"'{Path('.').joinpath(rel)}'"
+            self._icon = f"'.\\{rel}'"
+        else:
+            self._icon = f"'{p.resolve()}'"
+
+    def export_cmd(self) -> str:
+        """
+        Export pyinstaller cmd
+
+        Returns
+        -------
+        str
+            pyinstaller command
+        """
+        cmd = self._base_cmd
+
+        # Hidden import
+        if len(self._hidden_import) > 0:
+            dat = (f"--hidden-import={x}" for x in list(set(self._hidden_import)))
+            cmd.append(" ".join(dat))
+
+        # Console
+        if not self.console:
+            cmd.append("--noconsole")
+
+        # One file
+        if self.onefile:
+            cmd.append("--onefile")
+
+        # No confirm
+        if self.noconfirm:
+            cmd.append("--noconfirm")
+
+        # Icon
+        if len(self._icon) > 0:
+            cmd.append(self._icon)
+
+        return " ".join(cmd)
+
+
+# MARK: Key System
 # ---------------------------------------------------------------------------
 class HWIDgen(BaseClass):
     """
@@ -385,7 +516,7 @@ class LicenseKeySystem(BaseClass):
             return False
 
 
-# Software
+# MARK: Software
 # ---------------------------------------------------------------------------
 class BasicSoftwareProtection(BaseClass):
     """