absfuyu 5.7.0__tar.gz → 5.9.0__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: absfuyu
-Version: 5.7.0
+Version: 5.9.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'
@@ -47,12 +52,19 @@ Provides-Extra: full
 Requires-Dist: numpy; extra == 'full'
 Requires-Dist: openpyxl; extra == 'full'
 Requires-Dist: pandas; extra == 'full'
+Requires-Dist: rclone-crypt; extra == 'full'
 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'
+Provides-Extra: pdf
+Requires-Dist: spire-pdf; extra == 'pdf'
+Provides-Extra: rclone
+Requires-Dist: rclone-crypt; extra == 'rclone'
+Provides-Extra: xml
+Requires-Dist: xmltodict; extra == 'xml'
 Description-Content-Type: text/markdown
 
 <div align="center">

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

@@ -67,11 +67,16 @@ full = [
     "xlsxwriter",
     "spire-pdf",
     "xmltodict",
+    "rclone-crypt",
     # "jinja2"
 ]
 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"]
+rclone = ["rclone-crypt"]
 
 
 [project.scripts]
@@ -231,7 +236,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 +265,9 @@ build = [
     """,
     "hatch clean", # Clean dist/ folder
     "hatch -v build", # Build package
+]
+build = [
+    "build_no_docs",
     "hatch run docs:build", # Build docs
 ]
 patch = [
@@ -373,7 +381,13 @@ line-length = 120
 [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"]
+dev-dependencies = [
+    "ruff",
+    "mypy>=1.18.0",
+    "pytest>=8.4.0",
+    "hatch>=1.14.1",
+    "python-dotenv",
+]
 
 [tool.uv.build-backend]
 source-include = ["tests/**"]

{absfuyu-5.7.0 → absfuyu-5.9.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.9.0"
 __all__ = [
     "core",
     "config",

{absfuyu-5.7.0 → absfuyu-5.9.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.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 """
 
 # Library

{absfuyu-5.7.0 → absfuyu-5.9.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.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 """
 
 __all__ = ["cli"]

{absfuyu-5.7.0 → absfuyu-5.9.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.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 """
 
 # Module Package

{absfuyu-5.7.0 → absfuyu-5.9.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.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 """
 
 # Module Package

{absfuyu-5.7.0 → absfuyu-5.9.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.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 """
 
 # Module Package

{absfuyu-5.7.0 → absfuyu-5.9.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.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 """
 
 # Module Package

{absfuyu-5.7.0 → absfuyu-5.9.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.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 """
 
 # Module Package

{absfuyu-5.7.0 → absfuyu-5.9.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.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 """
 
 # Module level

{absfuyu-5.7.0 → absfuyu-5.9.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.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 """
 
 # Module Package

{absfuyu-5.7.0 → absfuyu-5.9.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.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 """
 
 # Module Package

{absfuyu-5.7.0 → absfuyu-5.9.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.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 """
 
 # Module Package

{absfuyu-5.7.0 → absfuyu-5.9.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.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 """
 
 # Module Package

{absfuyu-5.7.0 → absfuyu-5.9.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.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 """
 
 # Module Package

{absfuyu-5.7.0 → absfuyu-5.9.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.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 """
 
 # Module Package

{absfuyu-5.7.0 → absfuyu-5.9.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.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 """
 
 # Module Package

{absfuyu-5.7.0 → absfuyu-5.9.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.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 
 Features:
 ---------

{absfuyu-5.7.0 → absfuyu-5.9.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.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 """
 
 # Module Package

{absfuyu-5.7.0 → absfuyu-5.9.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.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 """
 
 # Module Package

{absfuyu-5.7.0 → absfuyu-5.9.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.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 """
 
 # Module Package

{absfuyu-5.7.0 → absfuyu-5.9.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.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 """
 
 # Module Package

{absfuyu-5.7.0 → absfuyu-5.9.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.9.0
+Date updated: 19/09/2025 (dd/mm/yyyy)
 """
 
 # Module Package

{absfuyu-5.7.0 → absfuyu-5.9.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.9.0
+Date updated: 23/09/2025 (dd/mm/yyyy)
 """
 
 

{absfuyu-5.7.0 → absfuyu-5.9.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.9.0
+Date updated: 23/09/2025 (dd/mm/yyyy)
 """
 
 # Module level

absfuyu-5.9.0/src/absfuyu/extra/da/__init__.py

@@ -0,0 +1,72 @@
+"""
+Absfuyu: Data Analysis
+----------------------
+Data Analyst
+
+Version: 5.9.0
+Date updated: 23/09/2025 (dd/mm/yyyy)
+"""
+
+# Module level
+# ---------------------------------------------------------------------------
+__all__ = [
+    "MatplotlibFormatString",
+    "DADF",
+    # Function
+    "custom_pandas_settings",
+    "reset_custom_pandas_settings",
+]
+
+
+# Library
+# ---------------------------------------------------------------------------
+DA_MODE = False
+
+try:
+    import numpy as np
+    import openpyxl
+    import pandas as pd
+    import xlsxwriter
+except ImportError:
+    from subprocess import run
+
+    from absfuyu.config import ABSFUYU_CONFIG
+
+    if ABSFUYU_CONFIG._get_setting("auto-install-extra").value:  # type: ignore
+        cmd = "python -m pip install -U absfuyu[full]".split()
+        run(cmd)
+    else:
+        raise SystemExit("This feature is in absfuyu[full] package")  # noqa: B904
+else:
+    DA_MODE = True
+
+from absfuyu.extra.da.dadf import DADF
+from absfuyu.extra.da.mplt import MatplotlibFormatString
+
+
+# Function
+# ---------------------------------------------------------------------------
+def custom_pandas_settings(*, show_all_rows: bool = False) -> None:
+    """
+    Custom pandas settings. Currently only show all cols/rows
+
+    Parameters
+    ----------
+    show_all_rows : bool, optional
+        Show all rows, by default False
+    """
+    # Shows all columns
+    pd.set_option("display.max_columns", None)  # type: ignore
+
+    if show_all_rows:
+        # (optional) also show all rows if needed
+        pd.set_option("display.max_rows", None)  # type: ignore
+
+
+def reset_custom_pandas_settings() -> None:
+    """
+    Reset custom pandas settings
+    """
+    settings = ["display.max_columns", "display.max_rows"]
+    for x in settings:
+        pd.reset_option(x)  # type: ignore

{absfuyu-5.7.0 → absfuyu-5.9.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.9.0
+Date updated: 23/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.9.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.9.0
+Date updated: 23/09/2025 (dd/mm/yyyy)
 """
 
 # Module level

{absfuyu-5.7.0 → absfuyu-5.9.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.9.0
+Date updated: 23/09/2025 (dd/mm/yyyy)
 """
 
 # Module level

{absfuyu-5.7.0 → absfuyu-5.9.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.9.0
+Date updated: 23/09/2025 (dd/mm/yyyy)
 """
 
 # Module level

{absfuyu-5.7.0 → absfuyu-5.9.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.9.0
+Date updated: 23/09/2025 (dd/mm/yyyy)
 """
 
 # Library

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

@@ -3,8 +3,8 @@ Absfuyu: PDF
 ------------
 PDF Tool [W.I.P]
 
-Version: 5.7.0
-Date updated: 16/09/2025 (dd/mm/yyyy)
+Version: 5.9.0
+Date updated: 23/09/2025 (dd/mm/yyyy)
 """
 
 # Module level