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

absfuyu/game/tictactoe.py

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

absfuyu/game/wordle.py

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

absfuyu/general/__init__.py

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

absfuyu/general/content.py

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

absfuyu/general/human.py

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

absfuyu/general/shape.py

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

absfuyu/general/tax.py

@@ -3,8 +3,8 @@ Absfuyu: Tax calculator
 -----------------------
 Tax calculator
 
-Version: 5.11.0
-Date updated: 05/10/2025 (dd/mm/yyyy)
+Version: 5.12.0
+Date updated: 17/10/2025 (dd/mm/yyyy)
 """
 
 # Module level
@@ -186,6 +186,24 @@ class PersonalIncomeTaxCalculator(BaseClass):
 
     marginal_rate : float
         Tax rate applied to the last amount of money of taxable income.
+
+
+    Example:
+    --------
+    >>> tax_levels = [(100, 0.05), (None, 0.1)]
+    >>> cal = PersonalIncomeTaxCalculator(tax_levels)
+    >>> cal.calculate(500)
+    >>> cal.to_dict(raw=True)
+    {...}
+
+    >>> cal.interpret_result()
+    ===== Tax information =====
+    Taxable income: 500.00 (500.00 - 0.00)
+    - Level 1: 0.00 - 100.00 @ 5.0%: 100.00 -> tax 5.00
+    - Level 2: 100.00 - 500.00 @ 10.0%: 400.00 -> tax 40.00
+    Net tax: 45.00 (45.00 - 0.00)
+    Effective rate: 9.00%
+    Marginal rate: 10.0%
     """
 
     def __init__(self, tax_levels: TaxLevel | None = None, deductions: float = 0.0, tax_credits: float = 0.0) -> None:
@@ -264,8 +282,10 @@ class PersonalIncomeTaxCalculator(BaseClass):
 
     @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

absfuyu/logger.py

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

absfuyu/pkg_data/__init__.py

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

absfuyu/sort.py

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

absfuyu/tools/__init__.py

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

absfuyu/tools/checksum.py

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

absfuyu/tools/converter.py

@@ -3,8 +3,8 @@ Absufyu: Converter
 ------------------
 Convert stuff
 
-Version: 5.11.0
-Date updated: 30/09/2025 (dd/mm/yyyy)
+Version: 5.12.0
+Date updated: 17/10/2025 (dd/mm/yyyy)
 
 Feature:
 --------

absfuyu/tools/generator.py

@@ -3,8 +3,8 @@ Absfuyu: Generator
 ------------------
 This generate stuff (Not python's ``generator``)
 
-Version: 5.11.0
-Date updated: 30/09/2025 (dd/mm/yyyy)
+Version: 5.12.0
+Date updated: 17/10/2025 (dd/mm/yyyy)
 
 Features:
 ---------

absfuyu/tools/inspector.py

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

absfuyu/tools/obfuscator.py

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

absfuyu/tools/passwordlib.py

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

absfuyu/tools/shutdownizer.py

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

absfuyu/tools/sw.py

@@ -3,8 +3,8 @@ Absufyu: Software
 -----------------
 Software, pyinstaller related stuff
 
-Version: 5.11.0
-Date updated: 30/09/2025 (dd/mm/yyyy)
+Version: 5.12.0
+Date updated: 17/10/2025 (dd/mm/yyyy)
 """
 
 # Module level

absfuyu/tools/web.py

@@ -3,8 +3,8 @@ Absfuyu: Web
 ------------
 Web, ``request``, ``BeautifulSoup`` stuff
 
-Version: 5.11.0
-Date updated: 30/09/2025 (dd/mm/yyyy)
+Version: 5.12.0
+Date updated: 17/10/2025 (dd/mm/yyyy)
 """
 
 # Library

absfuyu/typings.py

@@ -3,8 +3,8 @@ Absfuyu: Core
 -------------
 Pre-defined typing
 
-Version: 5.11.0
-Date updated: 30/09/2025 (dd/mm/yyyy)
+Version: 5.12.0
+Date updated: 17/10/2025 (dd/mm/yyyy)
 """
 
 # Module Package
@@ -42,12 +42,15 @@ except ImportError:
 # Type
 # ---------------------------------------------------------------------------
 # Types where neither is possible are invariant
+# Type safety must be strict
 T = TypeVar("T")  # Type invariant
 # Type variables that are covariant can be substituted
 # with a more specific type without causing errors
+# Safe to treat a Box[int] as a Box[object]
 T_co = TypeVar("T_co", covariant=True)  # Type covariant
 # Type variables that are contravariant can be substituted
 # with a more general type without causing errors
+# Safe to use a Box[object] where a Box[int] is needed
 T_contra = TypeVar("T_contra", contravariant=True)  # Type contravariant
 
 KT = TypeVar("KT")

absfuyu/util/__init__.py

@@ -3,8 +3,8 @@ Absufyu: Utilities
 ------------------
 Some random utilities
 
-Version: 5.11.0
-Date updated: 30/09/2025 (dd/mm/yyyy)
+Version: 5.12.0
+Date updated: 17/10/2025 (dd/mm/yyyy)
 """
 
 # Module Package

absfuyu/util/api.py

@@ -3,8 +3,8 @@ Absufyu: API
 ------------
 Fetch data stuff
 
-Version: 5.11.0
-Date updated: 30/09/2025 (dd/mm/yyyy)
+Version: 5.12.0
+Date updated: 17/10/2025 (dd/mm/yyyy)
 """
 
 # Module level

absfuyu/util/cli.py

@@ -0,0 +1,118 @@
+"""
+Absfuyu: CLI
+------------
+Custom Argument Parser
+
+Version: 5.12.0
+Date updated: 17/10/2025 (dd/mm/yyyy)
+"""
+
+# Module level
+# ---------------------------------------------------------------------------
+__all__ = ["FuyuArgumentParser"]
+
+
+# Library
+# ---------------------------------------------------------------------------
+import logging
+import sys
+from argparse import ArgumentDefaultsHelpFormatter, ArgumentParser
+from typing import Any, Callable
+
+
+# Class
+# ---------------------------------------------------------------------------
+class FuyuArgumentParser(ArgumentParser):
+    """
+    Usage:
+    ------
+    >>> import sys
+    >>> args = FuyuArgumentParser()
+    >>> args.start()
+    """
+
+    def __init__(
+        self,
+        prog: str | None = None,
+        description: str | None = None,
+        epilog: str | None = None,
+        version: str = "0.0.1",
+        formatter_class: Any = ArgumentDefaultsHelpFormatter,
+        prefix_chars: str = "-",
+        argument_default: Any = None,
+        conflict_handler: str = "error",
+        add_help: bool = True,
+        allow_abbrev: bool = True,
+        exit_on_error: bool = True,
+    ) -> None:
+        # Desc
+        if description is None:
+            description = f"Absfuyu CLI {version}"
+
+        # Default
+        self._default_args = ["--help"]
+
+        # Super
+        super().__init__(
+            prog=prog,
+            description=description,
+            epilog=epilog,
+            formatter_class=formatter_class,
+            prefix_chars=prefix_chars,
+            argument_default=argument_default,
+            conflict_handler=conflict_handler,
+            add_help=add_help,
+            allow_abbrev=allow_abbrev,
+            exit_on_error=exit_on_error,
+        )
+
+        # Add version
+        self.add_argument("-v", "--version", action="version", version=f"%(prog)s {version}")
+
+        # Add log level
+        _ll_val = ["DEBUG", "INFO", "WARNING", "ERROR", "CRITICAL"]
+        self.add_argument(
+            "-ll",
+            "--log-level",
+            metavar="LOG_LEVEL",
+            dest="log_level",
+            choices=_ll_val,
+            default="ERROR",
+            help=f"Log level: {', '.join(_ll_val)}",
+        )
+
+    def _fuyu_set_log_level(self, log_level: str = "ERROR") -> None:
+        log_levels = {
+            "DEBUG": logging.DEBUG,
+            "INFO": logging.INFO,
+            "WARNING": logging.WARNING,
+            "ERROR": logging.ERROR,
+            "CRITICAL": logging.CRITICAL,
+        }
+        logging.basicConfig(
+            level=log_levels[log_level],
+            format="[%(asctime)s] [%(module)s] [%(name)s] [%(funcName)s] [%(levelname)-s] %(message)s",
+            datefmt="%Y-%m-%d %H:%M:%S",
+        )
+
+    def start(self, default: Callable[[], Any] | None = None):
+        """
+        Quick start for argument parser
+
+        Parameters
+        ----------
+        default : Callable[[], Any] | None, optional
+            | Default callable to run, by default ``None``
+            | Shows help on default behavior (default=None)
+
+        Returns
+        -------
+        Namespace
+            Namespace
+        """
+        if default is None:
+            args = self.parse_args(args=None if sys.argv[1:] else self._default_args)
+        else:
+            args = self.parse_args(args=None if sys.argv[1:] else default())
+        self._fuyu_set_log_level(getattr(args, "log_level", "ERROR"))
+        return args

absfuyu/util/gui.py

@@ -3,8 +3,8 @@ Absfuyu: GUI
 ------------
 Custom tkinter GUI
 
-Version: 5.11.0
-Date updated: 30/09/2025 (dd/mm/yyyy)
+Version: 5.12.0
+Date updated: 17/10/2025 (dd/mm/yyyy)
 """
 
 # Module level

absfuyu/util/json_method.py

@@ -3,8 +3,8 @@ Absfuyu: Json Method
 --------------------
 ``.json`` file handling
 
-Version: 5.11.0
-Date updated: 30/09/2025 (dd/mm/yyyy)
+Version: 5.12.0
+Date updated: 17/10/2025 (dd/mm/yyyy)
 """
 
 # Module level

absfuyu/util/lunar.py

@@ -4,8 +4,8 @@ Absfuyu: Lunar calendar
 -----------------------
 Convert to lunar calendar
 
-Version: 5.11.0
-Date updated: 30/09/2025 (dd/mm/yyyy)
+Version: 5.12.0
+Date updated: 17/10/2025 (dd/mm/yyyy)
 
 Source:
 -------

absfuyu/util/path.py

@@ -3,8 +3,8 @@ Absfuyu: Path
 -------------
 Path related
 
-Version: 5.11.0
-Date updated: 30/09/2025 (dd/mm/yyyy)
+Version: 5.12.0
+Date updated: 17/10/2025 (dd/mm/yyyy)
 
 Feature:
 --------

absfuyu/util/performance.py

@@ -3,8 +3,8 @@ Absfuyu: Performance
 --------------------
 Performance Check
 
-Version: 5.11.0
-Date updated: 30/09/2025 (dd/mm/yyyy)
+Version: 5.12.0
+Date updated: 17/10/2025 (dd/mm/yyyy)
 
 Feature:
 --------

absfuyu/util/shorten_number.py

@@ -3,8 +3,8 @@ Absfuyu: Shorten number
 -----------------------
 Short number base on suffixes
 
-Version: 5.11.0
-Date updated: 30/09/2025 (dd/mm/yyyy)
+Version: 5.12.0
+Date updated: 17/10/2025 (dd/mm/yyyy)
 """
 
 # Module level

absfuyu/util/text_table.py

@@ -3,8 +3,8 @@ Absufyu: Utilities
 ------------------
 Text table
 
-Version: 5.11.0
-Date updated: 30/09/2025 (dd/mm/yyyy)
+Version: 5.12.0
+Date updated: 17/10/2025 (dd/mm/yyyy)
 """
 
 # Module level

absfuyu/util/zipped.py

@@ -4,8 +4,8 @@ Absfuyu: Zipped
 Zipping stuff
 (deprecated, use absfuyu.util.path.Directory)
 
-Version: 5.11.0
-Date updated: 30/09/2025 (dd/mm/yyyy)
+Version: 5.12.0
+Date updated: 17/10/2025 (dd/mm/yyyy)
 """
 
 # Module level

absfuyu/version.py

@@ -3,8 +3,8 @@ Absfuyu: Version
 ----------------
 Package versioning module
 
-Version: 5.11.0
-Date updated: 30/09/2025 (dd/mm/yyyy)
+Version: 5.12.0
+Date updated: 17/10/2025 (dd/mm/yyyy)
 """
 
 # Module level

{absfuyu-5.11.0.dist-info → absfuyu-5.12.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: absfuyu
-Version: 5.11.0
+Version: 5.12.1
 Summary: A small collection of code
 Project-URL: Homepage, https://github.com/AbsoluteWinter/absfuyu-public
 Project-URL: Documentation, https://absolutewinter.github.io/absfuyu-docs/