absfuyu 5.7.0__tar.gz → 5.8.0__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: absfuyu
-Version: 5.7.0
+Version: 5.8.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,6 +31,11 @@ Requires-Dist: colorama
 Requires-Dist: requests
 Provides-Extra: beautiful
 Requires-Dist: rich; extra == 'beautiful'
+Provides-Extra: dadf
+Requires-Dist: numpy; extra == 'dadf'
+Requires-Dist: openpyxl; extra == 'dadf'
+Requires-Dist: pandas; extra == 'dadf'
+Requires-Dist: xlsxwriter; extra == 'dadf'
 Provides-Extra: docs
 Requires-Dist: numpy; extra == 'docs'
 Requires-Dist: pandas; extra == 'docs'
@@ -53,6 +58,10 @@ Requires-Dist: tqdm; extra == 'full'
 Requires-Dist: unidecode; extra == 'full'
 Requires-Dist: xlsxwriter; extra == 'full'
 Requires-Dist: xmltodict; extra == 'full'
+Provides-Extra: pdf
+Requires-Dist: spire-pdf; extra == 'pdf'
+Provides-Extra: xml
+Requires-Dist: xmltodict; extra == 'xml'
 Description-Content-Type: text/markdown
 
 <div align="center">

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

@@ -72,6 +72,9 @@ full = [
 docs = ["numpy", "pandas", "rich", "spire-pdf"]
 beautiful = ["rich"]
 extra = ["numpy", "pandas", "openpyxl", "xlsxwriter", "spire-pdf", "xmltodict"]
+pdf = ["spire-pdf"]
+dadf = ["numpy", "pandas", "openpyxl", "xlsxwriter"]
+xml = ["xmltodict"]
 
 
 [project.scripts]
@@ -231,7 +234,7 @@ test = [
     "qa",
     "hatch run all:test", # Test
 ]
-build = [
+build_no_docs = [
     # Update license year - Convert to hex due to unable to run multiple lines
     # Source code:
     # import re;from datetime import datetime;from pathlib import Path
@@ -260,6 +263,9 @@ build = [
     """,
     "hatch clean", # Clean dist/ folder
     "hatch -v build", # Build package
+]
+build = [
+    "build_no_docs",
     "hatch run docs:build", # Build docs
 ]
 patch = [

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

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

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

@@ -3,8 +3,8 @@ ABSFUYU
 -------
 COMMAND LINE INTERFACE
 
-Version: 5.7.0
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 5.8.0
+Date updated: 16/09/2025 (dd/mm/yyyy)
 """
 
 # Library

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

@@ -3,8 +3,8 @@ ABSFUYU
 -------
 COMMAND LINE INTERFACE
 
-Version: 5.7.0
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 5.8.0
+Date updated: 16/09/2025 (dd/mm/yyyy)
 """
 
 __all__ = ["cli"]

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

@@ -3,8 +3,8 @@ ABSFUYU CLI
 -----------
 Color
 
-Version: 5.7.0
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 5.8.0
+Date updated: 16/09/2025 (dd/mm/yyyy)
 """
 
 # Module Package

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

@@ -3,8 +3,8 @@ ABSFUYU CLI
 -----------
 Config
 
-Version: 5.7.0
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 5.8.0
+Date updated: 16/09/2025 (dd/mm/yyyy)
 """
 
 # Module Package

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

@@ -3,8 +3,8 @@ ABSFUYU CLI
 -----------
 Do
 
-Version: 5.7.0
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 5.8.0
+Date updated: 16/09/2025 (dd/mm/yyyy)
 """
 
 # Module Package

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

@@ -3,8 +3,8 @@ ABSFUYU CLI
 -----------
 Game
 
-Version: 5.7.0
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 5.8.0
+Date updated: 16/09/2025 (dd/mm/yyyy)
 """
 
 # Module Package

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

@@ -3,8 +3,8 @@ ABSFUYU CLI
 -----------
 Tool
 
-Version: 5.7.0
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 5.8.0
+Date updated: 16/09/2025 (dd/mm/yyyy)
 """
 
 # Module Package

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

@@ -3,8 +3,8 @@ Absfuyu: Configuration
 ----------------------
 Package configuration module
 
-Version: 5.7.0
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 5.8.0
+Date updated: 16/09/2025 (dd/mm/yyyy)
 """
 
 # Module level

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

@@ -3,8 +3,8 @@ Absfuyu: Core
 -------------
 Bases for other features
 
-Version: 5.7.0
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 5.8.0
+Date updated: 16/09/2025 (dd/mm/yyyy)
 """
 
 # Module Package

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

@@ -3,8 +3,8 @@ Absfuyu: Core
 -------------
 Bases for other features
 
-Version: 5.7.0
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 5.8.0
+Date updated: 16/09/2025 (dd/mm/yyyy)
 """
 
 # Module Package

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

@@ -3,8 +3,8 @@ Absfuyu: Core
 -------------
 Bases for other features (with library)
 
-Version: 5.7.0
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 5.8.0
+Date updated: 16/09/2025 (dd/mm/yyyy)
 """
 
 # Module Package

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

@@ -3,8 +3,8 @@ Absfuyu: Core
 -------------
 Decorator
 
-Version: 5.7.0
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 5.8.0
+Date updated: 16/09/2025 (dd/mm/yyyy)
 """
 
 # Module Package

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

@@ -3,8 +3,8 @@ Absfuyu: Core
 -------------
 Sphinx docstring decorator
 
-Version: 5.7.0
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 5.8.0
+Date updated: 16/09/2025 (dd/mm/yyyy)
 """
 
 # Module Package

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

@@ -3,8 +3,8 @@ Absfuyu: Core
 -------------
 Dummy cli
 
-Version: 5.7.0
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 5.8.0
+Date updated: 16/09/2025 (dd/mm/yyyy)
 """
 
 # Module Package

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

@@ -3,8 +3,8 @@ Absfuyu: Core
 -------------
 Dummy functions when other libraries are unvailable
 
-Version: 5.7.0
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 5.8.0
+Date updated: 16/09/2025 (dd/mm/yyyy)
 """
 
 # Module Package

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

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

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

@@ -3,8 +3,8 @@ Absfuyu: Data Extension
 -----------------------
 dict extension
 
-Version: 5.7.0
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 5.8.0
+Date updated: 16/09/2025 (dd/mm/yyyy)
 """
 
 # Module Package

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

@@ -3,8 +3,8 @@ Absfuyu: Data Extension
 -----------------------
 Support classes
 
-Version: 5.7.0
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 5.8.0
+Date updated: 16/09/2025 (dd/mm/yyyy)
 """
 
 # Module Package

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

@@ -3,8 +3,8 @@ Absfuyu: Data Extension
 -----------------------
 int extension
 
-Version: 5.7.0
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 5.8.0
+Date updated: 16/09/2025 (dd/mm/yyyy)
 """
 
 # Module Package

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

@@ -3,8 +3,8 @@ Absfuyu: Data Extension
 -----------------------
 list extension
 
-Version: 5.7.0
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 5.8.0
+Date updated: 16/09/2025 (dd/mm/yyyy)
 """
 
 # Module Package

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

@@ -3,8 +3,8 @@ Absfuyu: Data Extension
 -----------------------
 str extension
 
-Version: 5.7.0
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 5.8.0
+Date updated: 16/09/2025 (dd/mm/yyyy)
 """
 
 # Module Package

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

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

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

@@ -3,8 +3,8 @@ Absfuyu: Beautiful
 ------------------
 A decorator that makes output more beautiful
 
-Version: 5.7.0
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 5.8.0
+Date updated: 16/09/2025 (dd/mm/yyyy)
 """
 
 # Module level

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

@@ -3,7 +3,7 @@ Absfuyu: Data Analysis
 ----------------------
 Data Analyst
 
-Version: 5.7.0
+Version: 5.8.0
 Date updated: 16/09/2025 (dd/mm/yyyy)
 """
 

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

@@ -3,8 +3,8 @@ Absfuyu: Data Analysis
 ----------------------
 Data Analyst DataFrame
 
-Version: 5.7.0
-Date updated: 16/09/2025 (dd/mm/yyyy)
+Version: 5.8.0
+Date updated: 17/09/2025 (dd/mm/yyyy)
 """
 
 # Module level
@@ -41,7 +41,7 @@ except ImportError:
     from absfuyu.core.decorator import dummy_decorator as override
 
 from absfuyu.core.baseclass import GetClassMembersMixin
-from absfuyu.core.docstring import deprecated, versionadded
+from absfuyu.core.docstring import deprecated, versionadded, versionchanged
 from absfuyu.extra.da.dadf_base import CityData
 from absfuyu.extra.da.dadf_base import DataAnalystDataFrameBase as DFBase
 from absfuyu.extra.da.dadf_base import SplittedDF
@@ -366,7 +366,7 @@ class DataAnalystDataFrameInfoMixin(DFBase):
         return info
 
     @override
-    def describe(self, percentiles=None, include=None, exclude=None) -> Self:
+    def describe(self, percentiles=None, include=None, exclude=None) -> Self:  # type: ignore
         """pd.DataFrame.describe() override"""
         return self.__class__(super().describe(percentiles, include, exclude))  # type: ignore [no-any-return]
 
@@ -1051,7 +1051,17 @@ class DataAnalystDataFrameExportMixin(DFBase):
     - da_export
     """
 
-    def da_export(self, path: str, sheet_name: str = "Sheet1", cols_contain_number: list[str] | None = None) -> None:
+    @versionchanged("5.8.0", "New parameter")
+    def da_export(
+        self,
+        path: str,
+        sheet_name: str = "Sheet1",
+        *,
+        auto_width: bool = True,
+        cols_contain_centered_text: list[str] | None = None,
+        cols_contain_number: list[str] | None = None,
+        cols_contain_percentage: list[str] | None = None,
+    ) -> None:
         """
         Export DataFrame with `xlsxwriter` engine
 
@@ -1060,12 +1070,22 @@ class DataAnalystDataFrameExportMixin(DFBase):
         path : Path | str
             Path to export
 
-        sheet_name : str
-            Sheet name
+        sheet_name : str, optional
+            Sheet name, by default "Sheet1"
+
+        auto_width : bool, optional
+            Auto resize column width, by default ``True``
+
+        cols_contain_centered_text : list[str] | None, optional
+            Columns that contain centered text (Align center), by default None
 
-        cols_contain_number : list[str]
-            Columns that contain number value (to format as number)
+        cols_contain_number : list[str] | None, optional
+            Columns that contain number value (to format as number - int), by default None
+
+        cols_contain_percentage : list[str] | None, optional
+            Columns that contain percentage value (to format as percentage), by default None
         """
+
         # 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="")
@@ -1083,12 +1103,9 @@ class DataAnalystDataFrameExportMixin(DFBase):
                 }
             )
             number_fmt = workbook.add_format(
-                {
-                    "num_format": "#,##0",
-                    "align": "center",
-                    "valign": "vcenter",
-                }
+                {"num_format": "#,##0", "align": "center", "valign": "vcenter"}
             )  # 1,000,000
+            percent_fmt = workbook.add_format({"num_format": "0.00%", "align": "center", "valign": "vcenter"})  # 1.00%
             text_fmt = workbook.add_format({"valign": "vcenter"})
             text_center_fmt = workbook.add_format({"align": "center", "valign": "vcenter"})
 
@@ -1099,20 +1116,29 @@ class DataAnalystDataFrameExportMixin(DFBase):
             for col_num, value in enumerate(self.columns.values):
                 worksheet.write(0, col_num, value, header_fmt)
 
+            rules = [
+                (cols_contain_number, number_fmt),
+                (cols_contain_percentage, percent_fmt),
+                (cols_contain_centered_text, text_center_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
+                max_len = None if auto_width is None else 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
+                fmt = text_fmt  # default
+                for cols, f in rules:
+                    if cols is not None and col in cols:
+                        fmt = f
+                        break
+                worksheet.set_column(i, i, max_len, fmt)
 
-                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)
+            # if cols_contain_number is not None:
+            #     for x in cols_contain_number:
+            #         self[x] = pd.to_numeric(self[x], errors="coerce")
 
 
 # City
@@ -1289,3 +1315,14 @@ class DADF_WIP(DADF):
     """
 
     pass
+
+if __name__ == "__main__":
+    from pathlib import Path
+
+    t = DADF.sample_df().show_distribution("number_range", show_percentage=False)
+    t.da_export(
+        Path(__file__).parent.joinpath("a.xlsx").resolve().__str__(),
+        cols_contain_number=["number_range"],
+        cols_contain_percentage=["percentage"],
+    )
+    print(t)

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

@@ -3,8 +3,8 @@ Absfuyu: Data Analysis
 ----------------------
 Data Analyst DataFrame - Base/Core
 
-Version: 5.7.0
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 5.8.0
+Date updated: 16/09/2025 (dd/mm/yyyy)
 """
 
 # Module level

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

@@ -3,8 +3,8 @@ Absfuyu: Data Analysis
 ----------------------
 DF Function
 
-Version: 5.7.0
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 5.8.0
+Date updated: 16/09/2025 (dd/mm/yyyy)
 """
 
 # Module level

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

@@ -3,8 +3,8 @@ Absfuyu: Data Analysis
 ----------------------
 Matplotlib Helper
 
-Version: 5.7.0
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 5.8.0
+Date updated: 16/09/2025 (dd/mm/yyyy)
 """
 
 # Module level

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

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

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

@@ -3,7 +3,7 @@ Absfuyu: PDF
 ------------
 PDF Tool [W.I.P]
 
-Version: 5.7.0
+Version: 5.8.0
 Date updated: 16/09/2025 (dd/mm/yyyy)
 """
 

{absfuyu-5.7.0 → absfuyu-5.8.0}/src/absfuyu/extra/xml.py

@@ -3,7 +3,7 @@ Absfuyu: XML
 ------------
 XML Tool [W.I.P]
 
-Version: 5.7.0
+Version: 5.8.0
 Date updated: 16/09/2025 (dd/mm/yyyy)
 """
 

{absfuyu-5.7.0 → absfuyu-5.8.0}/src/absfuyu/fun/__init__.py

@@ -3,8 +3,8 @@ Absfuyu: Fun
 ------------
 Some fun or weird stuff
 
-Version: 5.7.0
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 5.8.0
+Date updated: 16/09/2025 (dd/mm/yyyy)
 """
 
 # Module level

{absfuyu-5.7.0 → absfuyu-5.8.0}/src/absfuyu/fun/rubik.py

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

{absfuyu-5.7.0 → absfuyu-5.8.0}/src/absfuyu/fun/tarot.py

@@ -4,8 +4,8 @@ Absfuyu: Tarot
 Tarot stuff
 
 
-Version: 5.7.0
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 5.8.0
+Date updated: 16/09/2025 (dd/mm/yyyy)
 
 Usage:
 ------

{absfuyu-5.7.0 → absfuyu-5.8.0}/src/absfuyu/game/__init__.py

@@ -3,8 +3,8 @@ Absfuyu: Game
 -------------
 Contain some game that can be played on terminal
 
-Version: 5.7.0
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 5.8.0
+Date updated: 16/09/2025 (dd/mm/yyyy)
 """
 
 # Module level

{absfuyu-5.7.0 → absfuyu-5.8.0}/src/absfuyu/game/game_stat.py

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

{absfuyu-5.7.0 → absfuyu-5.8.0}/src/absfuyu/game/sudoku.py

@@ -3,8 +3,8 @@ Game: Sudoku
 ------------
 Sudoku 9x9 Solver
 
-Version: 5.7.0
-Date updated: 12/09/2025 (dd/mm/yyyy)
+Version: 5.8.0
+Date updated: 16/09/2025 (dd/mm/yyyy)
 
 Credit:
 -------

{absfuyu-5.7.0 → absfuyu-5.8.0}/src/absfuyu/game/tictactoe.py

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