absfuyu 5.6.1__tar.gz → 5.7.0__tar.gz

{absfuyu-5.6.1 → absfuyu-5.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: absfuyu
-Version: 5.6.1
+Version: 5.7.0
 Summary: A small collection of code
 Project-URL: Homepage, https://github.com/AbsoluteWinter/absfuyu-public
 Project-URL: Documentation, https://absolutewinter.github.io/absfuyu-docs/
@@ -31,9 +31,6 @@ Requires-Dist: colorama
 Requires-Dist: requests
 Provides-Extra: beautiful
 Requires-Dist: rich; extra == 'beautiful'
-Provides-Extra: dev
-Requires-Dist: hatch; extra == 'dev'
-Requires-Dist: pytest; extra == 'dev'
 Provides-Extra: docs
 Requires-Dist: numpy; extra == 'docs'
 Requires-Dist: pandas; extra == 'docs'
@@ -44,6 +41,8 @@ Requires-Dist: numpy; extra == 'extra'
 Requires-Dist: openpyxl; extra == 'extra'
 Requires-Dist: pandas; extra == 'extra'
 Requires-Dist: spire-pdf; extra == 'extra'
+Requires-Dist: xlsxwriter; extra == 'extra'
+Requires-Dist: xmltodict; extra == 'extra'
 Provides-Extra: full
 Requires-Dist: numpy; extra == 'full'
 Requires-Dist: openpyxl; extra == 'full'
@@ -52,6 +51,8 @@ Requires-Dist: rich; extra == 'full'
 Requires-Dist: spire-pdf; extra == 'full'
 Requires-Dist: tqdm; extra == 'full'
 Requires-Dist: unidecode; extra == 'full'
+Requires-Dist: xlsxwriter; extra == 'full'
+Requires-Dist: xmltodict; extra == 'full'
 Description-Content-Type: text/markdown
 
 <div align="center">

{absfuyu-5.6.1 → absfuyu-5.7.0}/pyproject.toml

@@ -58,13 +58,21 @@ Issues = "https://github.com/AbsoluteWinter/absfuyu-public/issues"
 
 [project.optional-dependencies]
 full = [
-    "numpy", "pandas", "rich", "tqdm", "unidecode", "openpyxl", "spire-pdf",
+    "numpy",
+    "pandas",
+    "rich",
+    "tqdm",
+    "unidecode",
+    "openpyxl",
+    "xlsxwriter",
+    "spire-pdf",
+    "xmltodict",
     # "jinja2"
 ]
 docs = ["numpy", "pandas", "rich", "spire-pdf"]
 beautiful = ["rich"]
-extra = ["numpy", "pandas", "openpyxl", "spire-pdf"]
-dev = ["hatch", "pytest"]
+extra = ["numpy", "pandas", "openpyxl", "xlsxwriter", "spire-pdf", "xmltodict"]
+
 
 [project.scripts]
 absfuyu = "absfuyu.__main__:main"
@@ -98,7 +106,13 @@ cov = ["test-cov", "cov-report"]                                    # use this
 cov2 = "pytest --cov-report=term-missing --cov=absfuyu --cov=tests" # use this
 
 [tool.hatch.envs.all]
-dependencies = ["coverage[toml]", "pytest", "pytest-cov", "pytest-mock", "pytest-xdist"]
+dependencies = [
+    "coverage[toml]",
+    "pytest",
+    "pytest-cov",
+    "pytest-mock",
+    "pytest-xdist",
+]
 features = ["full"]
 description = """
 All python version to test:
@@ -157,7 +171,7 @@ clean = [
     """,
 ]
 build_only = [
-    "sphinx-build docs docs/build",           # Build
+    "sphinx-build docs docs/build", # Build
 ]
 build_private = [
     # -f --force
@@ -215,7 +229,7 @@ qa = [
 ]
 test = [
     "qa",
-    "hatch run all:test",    # Test
+    "hatch run all:test", # Test
 ]
 build = [
     # Update license year - Convert to hex due to unable to run multiple lines
@@ -244,8 +258,8 @@ build = [
     9617320663a662e77726974656c696e65732863290a7072696e7428224c6963656e7365\
     207965617220757064617465642229').decode('utf-8'))\"
     """,
-    "hatch clean",          # Clean dist/ folder
-    "hatch -v build",       # Build package
+    "hatch clean", # Clean dist/ folder
+    "hatch -v build", # Build package
     "hatch run docs:build", # Build docs
 ]
 patch = [
@@ -307,7 +321,7 @@ no_implicit_reexport = true
 
 # MARK: TOOL: ruff
 [tool.ruff]
-line-length = 88
+line-length = 120
 indent-width = 4
 target-version = "py311"
 include = ["pyproject.toml", "src/**", "tests/**"]
@@ -353,4 +367,13 @@ convention = "numpy"
 
 # MARK: TOOL: black
 [tool.black]
-line-length = 88
+line-length = 120
+
+# MARK: TOOL: uv
+[tool.uv]
+required-version = ">=0.5.0"
+cache-dir = "./.uv_cache"
+dev-dependencies = ["ruff", "mypy>=1.18.0", "pytest>=8.4.0", "hatch>=1.14.1"]
+
+[tool.uv.build-backend]
+source-include = ["tests/**"]

{absfuyu-5.6.1 → absfuyu-5.7.0}/src/absfuyu/__init__.py

@@ -22,7 +22,7 @@ Using in cmd:
 __title__ = "absfuyu"
 __author__ = "AbsoluteWinter"
 __license__ = "MIT License"
-__version__ = "5.6.1"
+__version__ = "5.7.0"
 __all__ = [
     "core",
     "config",

{absfuyu-5.6.1 → absfuyu-5.7.0}/src/absfuyu/__main__.py

@@ -3,7 +3,7 @@ ABSFUYU
 -------
 COMMAND LINE INTERFACE
 
-Version: 5.6.1
+Version: 5.7.0
 Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 

{absfuyu-5.6.1 → absfuyu-5.7.0}/src/absfuyu/cli/__init__.py

@@ -3,7 +3,7 @@ ABSFUYU
 -------
 COMMAND LINE INTERFACE
 
-Version: 5.6.1
+Version: 5.7.0
 Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 

{absfuyu-5.6.1 → absfuyu-5.7.0}/src/absfuyu/cli/color.py

@@ -3,7 +3,7 @@ ABSFUYU CLI
 -----------
 Color
 
-Version: 5.6.1
+Version: 5.7.0
 Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 

{absfuyu-5.6.1 → absfuyu-5.7.0}/src/absfuyu/cli/config_group.py

@@ -3,7 +3,7 @@ ABSFUYU CLI
 -----------
 Config
 
-Version: 5.6.1
+Version: 5.7.0
 Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 

{absfuyu-5.6.1 → absfuyu-5.7.0}/src/absfuyu/cli/do_group.py

@@ -3,7 +3,7 @@ ABSFUYU CLI
 -----------
 Do
 
-Version: 5.6.1
+Version: 5.7.0
 Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 

{absfuyu-5.6.1 → absfuyu-5.7.0}/src/absfuyu/cli/game_group.py

@@ -3,7 +3,7 @@ ABSFUYU CLI
 -----------
 Game
 
-Version: 5.6.1
+Version: 5.7.0
 Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 

{absfuyu-5.6.1 → absfuyu-5.7.0}/src/absfuyu/cli/tool_group.py

@@ -3,7 +3,7 @@ ABSFUYU CLI
 -----------
 Tool
 
-Version: 5.6.1
+Version: 5.7.0
 Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 

{absfuyu-5.6.1 → absfuyu-5.7.0}/src/absfuyu/config/__init__.py

@@ -3,7 +3,7 @@ Absfuyu: Configuration
 ----------------------
 Package configuration module
 
-Version: 5.6.1
+Version: 5.7.0
 Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 

{absfuyu-5.6.1 → absfuyu-5.7.0}/src/absfuyu/core/__init__.py

@@ -3,7 +3,7 @@ Absfuyu: Core
 -------------
 Bases for other features
 
-Version: 5.6.1
+Version: 5.7.0
 Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 

{absfuyu-5.6.1 → absfuyu-5.7.0}/src/absfuyu/core/baseclass.py

@@ -3,7 +3,7 @@ Absfuyu: Core
 -------------
 Bases for other features
 
-Version: 5.6.1
+Version: 5.7.0
 Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 

{absfuyu-5.6.1 → absfuyu-5.7.0}/src/absfuyu/core/baseclass2.py

@@ -3,7 +3,7 @@ Absfuyu: Core
 -------------
 Bases for other features (with library)
 
-Version: 5.6.1
+Version: 5.7.0
 Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 

{absfuyu-5.6.1 → absfuyu-5.7.0}/src/absfuyu/core/decorator.py

@@ -3,7 +3,7 @@ Absfuyu: Core
 -------------
 Decorator
 
-Version: 5.6.1
+Version: 5.7.0
 Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 

{absfuyu-5.6.1 → absfuyu-5.7.0}/src/absfuyu/core/docstring.py

@@ -3,7 +3,7 @@ Absfuyu: Core
 -------------
 Sphinx docstring decorator
 
-Version: 5.6.1
+Version: 5.7.0
 Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 

{absfuyu-5.6.1 → absfuyu-5.7.0}/src/absfuyu/core/dummy_cli.py

@@ -3,7 +3,7 @@ Absfuyu: Core
 -------------
 Dummy cli
 
-Version: 5.6.1
+Version: 5.7.0
 Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 

{absfuyu-5.6.1 → absfuyu-5.7.0}/src/absfuyu/core/dummy_func.py

@@ -3,7 +3,7 @@ Absfuyu: Core
 -------------
 Dummy functions when other libraries are unvailable
 
-Version: 5.6.1
+Version: 5.7.0
 Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 

{absfuyu-5.6.1 → absfuyu-5.7.0}/src/absfuyu/dxt/__init__.py

@@ -3,7 +3,7 @@ Absfuyu: Data Extension
 -----------------------
 Extension for data type such as ``list``, ``str``, ``dict``, ...
 
-Version: 5.6.1
+Version: 5.7.0
 Date updated: 12/09/2025 (dd/mm/yyyy)
 
 Features:

{absfuyu-5.6.1 → absfuyu-5.7.0}/src/absfuyu/dxt/dictext.py

@@ -3,7 +3,7 @@ Absfuyu: Data Extension
 -----------------------
 dict extension
 
-Version: 5.6.1
+Version: 5.7.0
 Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 

{absfuyu-5.6.1 → absfuyu-5.7.0}/src/absfuyu/dxt/dxt_support.py

@@ -3,7 +3,7 @@ Absfuyu: Data Extension
 -----------------------
 Support classes
 
-Version: 5.6.1
+Version: 5.7.0
 Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 

{absfuyu-5.6.1 → absfuyu-5.7.0}/src/absfuyu/dxt/intext.py

@@ -3,7 +3,7 @@ Absfuyu: Data Extension
 -----------------------
 int extension
 
-Version: 5.6.1
+Version: 5.7.0
 Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 

{absfuyu-5.6.1 → absfuyu-5.7.0}/src/absfuyu/dxt/listext.py

@@ -3,7 +3,7 @@ Absfuyu: Data Extension
 -----------------------
 list extension
 
-Version: 5.6.1
+Version: 5.7.0
 Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 

{absfuyu-5.6.1 → absfuyu-5.7.0}/src/absfuyu/dxt/strext.py

@@ -3,7 +3,7 @@ Absfuyu: Data Extension
 -----------------------
 str extension
 
-Version: 5.6.1
+Version: 5.7.0
 Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 

{absfuyu-5.6.1 → absfuyu-5.7.0}/src/absfuyu/extra/__init__.py

@@ -3,7 +3,7 @@ Absfuyu: Extra
 --------------
 Features that require additional libraries
 
-Version: 5.6.1
+Version: 5.7.0
 Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 

{absfuyu-5.6.1 → absfuyu-5.7.0}/src/absfuyu/extra/beautiful.py

@@ -3,7 +3,7 @@ Absfuyu: Beautiful
 ------------------
 A decorator that makes output more beautiful
 
-Version: 5.6.1
+Version: 5.7.0
 Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 

{absfuyu-5.6.1 → absfuyu-5.7.0}/src/absfuyu/extra/da/__init__.py

@@ -3,8 +3,8 @@ Absfuyu: Data Analysis
 ----------------------
 Data Analyst
 
-Version: 5.6.1
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 5.7.0
+Date updated: 16/09/2025 (dd/mm/yyyy)
 """
 
 # Module level
@@ -18,7 +18,9 @@ DA_MODE = False
 
 try:
     import numpy as np
+    import openpyxl
     import pandas as pd
+    import xlsxwriter
 except ImportError:
     from subprocess import run
 

{absfuyu-5.6.1 → absfuyu-5.7.0}/src/absfuyu/extra/da/dadf.py

@@ -3,8 +3,8 @@ Absfuyu: Data Analysis
 ----------------------
 Data Analyst DataFrame
 
-Version: 5.6.1
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 5.7.0
+Date updated: 16/09/2025 (dd/mm/yyyy)
 """
 
 # Module level
@@ -17,6 +17,7 @@ __all__ = [
     "DataAnalystDataFrameNAMixin",
     "DataAnalystDataFrameOtherMixin",
     "DataAnalystDataFrameDateMixin",
+    "DataAnalystDataFrameExportMixin",
     "DataAnalystDataFrameCityMixin",
 ]
 
@@ -31,6 +32,8 @@ from typing import Any, Literal, Self
 
 import numpy as np
 import pandas as pd
+from xlsxwriter import Workbook
+from xlsxwriter.worksheet import Worksheet
 
 try:
     from typing import override  # type: ignore
@@ -183,7 +186,9 @@ class DataAnalystDataFrameColumnMethodMixin(DFBase):
     @deprecated("5.1.0", reason="Use pd.DataFrame.assign(...) method instead")
     def add_blank_column(self, column_name: str, fill: Any = np.nan, /) -> Self:
         """
-        Add a blank column
+        [DEPRECATED] Add a blank column.
+
+        E.g: Use `pd.DataFrame.assign(new_col=lambda x: x['old_col'])` instead
 
         Parameters
         ----------
@@ -246,9 +251,7 @@ class DataAnalystDataFrameColumnMethodMixin(DFBase):
         """
         if n is None:
             pass
-        splited_data: pd.DataFrame = self[col].str.split(
-            pat=pattern, n=n, expand=True, regex=regex
-        )
+        splited_data: pd.DataFrame = self[col].str.split(pat=pattern, n=n, expand=True, regex=regex)  # type: ignore
         num_of_splitted_cols = splited_data.shape[1]
         new_col_names = [f"{col}_{x}" for x in range(num_of_splitted_cols)]
         self[new_col_names] = splited_data
@@ -262,6 +265,7 @@ class DataAnalystDataFrameRowMethodMixin(DFBase):
     Data Analyst ``pd.DataFrame`` - Row method
 
     - Get different rows
+    - Add blank row
     """
 
     @versionadded("4.0.0")
@@ -297,6 +301,26 @@ class DataAnalystDataFrameRowMethodMixin(DFBase):
         )
         return self.__class__(out)
 
+    @versionadded("5.7.0")
+    def add_blank_row(self, fill: Any = np.nan, /) -> Self:
+        """
+        Add a new row to the end of a DataFrame.
+
+        Parameters
+        ----------
+        fill : Any, default np.nan
+            Value to fill in the new row (e.g., np.nan, None, "", 0).
+
+        Returns
+        -------
+        Self
+            DataFrame with the new row appended.
+        """
+        # Create a dict with all columns filled with fill
+        new_row = {col: fill for col in self.columns}
+        self.loc[len(self)] = new_row  # type: ignore
+        return self
+
 
 # Info
 # ---------------------------------------------------------------------------
@@ -486,7 +510,7 @@ class DataAnalystDataFrameInfoMixin(DFBase):
         if top is not None:
             list_of_keep: list = (
                 col_df[destination_column]
-                .head(set_min_max(top - 1, min_value=1, max_value=col_df.shape[0]))
+                .head(set_min_max(top - 1, min_value=1, max_value=col_df.shape[0]))  # type: ignore
                 .to_list()
             )
             # logger.debug(list_of_keep)
@@ -561,7 +585,7 @@ class DataAnalystDataFrameNAMixin(DFBase):
         except KeyError:
             if getattr(self, "add_blank_column", None) is not None:
                 # Compatible with DataAnalystDataFrameColumnMethodMixin
-                self.add_blank_column(column_name, fill_when_not_exist)
+                self.add_blank_column(column_name, fill_when_not_exist)  # type: ignore
         return self
 
     def get_missing_values(
@@ -679,7 +703,7 @@ class DataAnalystDataFrameNAMixin(DFBase):
         3 -1.435079         400          400      REPLACED  ywahcasi 2024-05-20
         4  0.118993         861          800      REPLACED  saoupuby 2019-04-28
         """
-        self[col] = self[col].apply(lambda x: callable(x) if pd.notnull(x) else x)
+        self[col] = self[col].apply(lambda x: callable(x) if pd.notnull(x) else x)  # type: ignore
         return self
 
     @versionadded("5.1.0")  # type: ignore
@@ -750,7 +774,7 @@ class DataAnalystDataFrameNAMixin(DFBase):
 
         # Column name
         cname = "applied_row_null" if col_name is None else col_name
-        self[cname] = self.apply(apply_func, axis=1)
+        self[cname] = self.apply(apply_func, axis=1)  # type: ignore
 
         return self
 
@@ -825,7 +849,7 @@ class DataAnalystDataFrameOtherMixin(DFBase):
 
             if getattr(self, "drop_columns", None) is not None:
                 # Compatible with DataAnalystDataFrameColumnMethodMixin
-                self.drop_columns(cols)
+                self.drop_columns(cols)  # type: ignore
 
         out = self.merge(other, how="left", on=on)
         return self.__class__(out)
@@ -1018,6 +1042,79 @@ class DataAnalystDataFrameDateMixin(DFBase):
         return self
 
 
+# Export
+# ---------------------------------------------------------------------------
+class DataAnalystDataFrameExportMixin(DFBase):
+    """
+    Data Analyst ``pd.DataFrame`` - Export method
+
+    - da_export
+    """
+
+    def da_export(self, path: str, sheet_name: str = "Sheet1", cols_contain_number: list[str] | None = None) -> None:
+        """
+        Export DataFrame with `xlsxwriter` engine
+
+        Parameters
+        ----------
+        path : Path | str
+            Path to export
+
+        sheet_name : str
+            Sheet name
+
+        cols_contain_number : list[str]
+            Columns that contain number value (to format as number)
+        """
+        # Using xlsxwriter engine
+        with pd.ExcelWriter(path, engine="xlsxwriter") as writer:
+            self.to_excel(writer, sheet_name=sheet_name, index=False, float_format="%.2f", na_rep="")
+
+            # Format style
+            workbook: Workbook = writer.book  # type: ignore
+            header_fmt = workbook.add_format(
+                {
+                    "bold": True,
+                    "text_wrap": True,
+                    "border": 1,
+                    "align": "center",
+                    "valign": "vcenter",
+                    # "bg_color": "#A0BEFD",
+                }
+            )
+            number_fmt = workbook.add_format(
+                {
+                    "num_format": "#,##0",
+                    "align": "center",
+                    "valign": "vcenter",
+                }
+            )  # 1,000,000
+            text_fmt = workbook.add_format({"valign": "vcenter"})
+            text_center_fmt = workbook.add_format({"align": "center", "valign": "vcenter"})
+
+            # Format sheet
+            worksheet: Worksheet = writer.sheets[sheet_name]
+
+            # Format header - First row
+            for col_num, value in enumerate(self.columns.values):
+                worksheet.write(0, col_num, value, header_fmt)
+
+            # Auto width + col format
+            for i, col in enumerate(self.columns):
+                # Max str len of each column
+                max_len = max(self[col].astype(str).map(len).max(), len(col)) + 2
+                worksheet.set_column(i, i, max_len)  # Set width
+
+                # Format style
+                if cols_contain_number is None:
+                    continue
+
+                if col in cols_contain_number:
+                    worksheet.set_column(i, i, max_len, number_fmt)
+                else:
+                    worksheet.set_column(i, i, max_len, text_fmt)
+
+
 # City
 # ---------------------------------------------------------------------------
 class DataAnalystDataFrameCityMixin(DFBase):
@@ -1091,6 +1188,7 @@ class DataAnalystDataFrameCityMixin(DFBase):
 class DADF(
     GetClassMembersMixin,
     DataAnalystDataFrameCityMixin,
+    DataAnalystDataFrameExportMixin,
     DataAnalystDataFrameDateMixin,
     DataAnalystDataFrameOtherMixin,
     DataAnalystDataFrameNAMixin,

{absfuyu-5.6.1 → absfuyu-5.7.0}/src/absfuyu/extra/da/dadf_base.py

@@ -3,7 +3,7 @@ Absfuyu: Data Analysis
 ----------------------
 Data Analyst DataFrame - Base/Core
 
-Version: 5.6.1
+Version: 5.7.0
 Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 

{absfuyu-5.6.1 → absfuyu-5.7.0}/src/absfuyu/extra/da/df_func.py

@@ -3,7 +3,7 @@ Absfuyu: Data Analysis
 ----------------------
 DF Function
 
-Version: 5.6.1
+Version: 5.7.0
 Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 

{absfuyu-5.6.1 → absfuyu-5.7.0}/src/absfuyu/extra/da/mplt.py

@@ -3,7 +3,7 @@ Absfuyu: Data Analysis
 ----------------------
 Matplotlib Helper
 
-Version: 5.6.1
+Version: 5.7.0
 Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 

{absfuyu-5.6.1 → absfuyu-5.7.0}/src/absfuyu/extra/data_analysis.py

@@ -4,7 +4,7 @@ Absfuyu: Data Analysis [W.I.P]
 Extension for ``pd.DataFrame``
 (deprecated)
 
-Version: 5.6.1
+Version: 5.7.0
 Date updated: 12/09/2025 (dd/mm/yyyy)
 """
 

{absfuyu-5.6.1 → absfuyu-5.7.0}/src/absfuyu/extra/pdf.py

@@ -3,8 +3,8 @@ Absfuyu: PDF
 ------------
 PDF Tool [W.I.P]
 
-Version: 5.6.1
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 5.7.0
+Date updated: 16/09/2025 (dd/mm/yyyy)
 """
 
 # Module level
@@ -41,8 +41,6 @@ else:
 
 # Class
 # ---------------------------------------------------------------------------
-
-
 class PDFTool(BaseClass):
     def __init__(self) -> None:
         super().__init__()