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

absfuyu/dxt/listext.py

@@ -3,8 +3,8 @@ Absfuyu: Data Extension
 -----------------------
 list extension
 
-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
@@ -20,13 +20,16 @@ from collections import Counter
 from collections.abc import Callable, Iterable
 from heapq import heapreplace
 from itertools import accumulate, chain, count, groupby, zip_longest
-from typing import Any, Literal, Self, cast, overload
+from typing import Any, Literal, Self, TypeVar, cast, overload
 
 from absfuyu.core.baseclass import GetClassMembersMixin
 from absfuyu.core.docstring import deprecated, versionadded, versionchanged
-from absfuyu.typings import T as _T
 from absfuyu.util import set_min_max
 
+# Type
+# ---------------------------------------------------------------------------
+T = TypeVar("T")
+R = TypeVar("R")  # Return type - Can be anything
 
 # Class
 # ---------------------------------------------------------------------------
@@ -377,7 +380,7 @@ class ListExt(GetClassMembersMixin, list):
         return self.__class__(zip(nums, self))
 
     @versionadded("5.3.0")  # no test case yet
-    def transpose(self, fillvalue: _T | None = None, /) -> Self:
+    def transpose(self, fillvalue: Any | None = None, /) -> Self:
         """
         Transpose a list of iterable.
 
@@ -743,7 +746,7 @@ class ListExt(GetClassMembersMixin, list):
         return self.slice_points(slice_points)
 
     @versionadded("5.3.0")  # no test case yet
-    def to_column(self, ncols: int, fillvalue: _T | None = None) -> Self:
+    def to_column(self, ncols: int, fillvalue: Any | None = None) -> Self:
         """
         Smart convert 1 dimension list to 2 dimension list,
         in which, number of columns = ``ncols``.
@@ -753,7 +756,7 @@ class ListExt(GetClassMembersMixin, list):
         ncols : int
             Number of columns
 
-        fillvalue : T | None, optional
+        fillvalue : Any | None, optional
             Fill value, by default ``None``
 
         Returns
@@ -871,3 +874,313 @@ class ListExt(GetClassMembersMixin, list):
             mod_chunk = self.split_chunk(column_count).apply(mod_item)
 
         return mod_chunk
+
+
+class ListExt2(GetClassMembersMixin, list[T]):
+    """
+    ``list`` extension (with generic - W.I.P)
+
+    >>> # For a list of new methods
+    >>> ListExt2.show_all_methods()
+    """
+
+    # Info
+    def head(self, number_of_items: int = 5, /) -> list[T]:
+        """
+        Show first ``number_of_items`` items in ``ListExt``
+
+        Parameters
+        ----------
+        number_of_items : int
+            | Number of items to shows at once
+            | (Default: ``5``)
+
+        Returns
+        -------
+        list
+            Filtered list
+
+
+        Example:
+        --------
+        >>> ListExt(range(10)).head(2)
+        [0, 1]
+        """
+        number_of_items = int(set_min_max(number_of_items, min_value=0, max_value=len(self)))
+        return self[:number_of_items]
+
+    def tail(self, number_of_items: int = 5, /) -> list[T]:
+        """
+        Show last ``number_of_items`` items in ``ListExt``
+
+        Parameters
+        ----------
+        number_of_items : int
+            | Number of items to shows at once
+            | (Default: ``5``)
+
+        Returns
+        -------
+        list
+            Filtered list
+
+
+        Example:
+        --------
+        >>> ListExt(range(10)).tail(2)
+        [8, 9]
+        """
+        number_of_items = int(set_min_max(number_of_items, min_value=0, max_value=len(self)))
+        return self[::-1][:number_of_items][::-1]
+
+    # Misc
+    def apply(self, func: Callable[[T], R]) -> "ListExt2[R]":
+        """
+        Apply function to each entry
+
+        Parameters
+        ----------
+        func : Callable[[Any], Any]
+            Callable function
+
+        Returns
+        -------
+        Self
+            ListExt
+
+
+        Example:
+        --------
+        >>> test = ListExt([1, 2, 3])
+        >>> test.apply(str)
+        ['1', '2', '3']
+        """
+        # return self.__class__(map(func, self))
+        return self.__class__(func(x) for x in self)  # type: ignore
+
+    @versionchanged("5.2.0", reason="New ``recursive`` parameter")
+    def flatten(self, recursive: bool = False) -> "ListExt2":
+        """
+        Flatten the list
+
+        Parameters
+        ----------
+        recursive : bool
+            Recursively flatten the list, by default ``False``
+
+        Returns
+        -------
+        Self
+            Flattened list
+
+
+        Example:
+        --------
+        >>> test = ListExt([["test"], ["test", "test"], ["test"]])
+        >>> test.flatten()
+        ['test', 'test', 'test', 'test']
+        """
+
+        def instance_checking(item):
+            if isinstance(item, str):
+                return [item]
+            if isinstance(item, Iterable):
+                return item
+            return [item]
+
+        # Flatten
+        list_of_list = (instance_checking(x) for x in self)
+        flattened = self.__class__(chain(*list_of_list))
+
+        # Recursive
+        if recursive:
+
+            def _condition(item) -> bool:
+                if isinstance(item, str):
+                    return False
+                return isinstance(item, Iterable)
+
+            while any(flattened.apply(_condition)):
+                flattened = flattened.flatten()
+
+        # Return
+        return flattened
+
+    @versionadded("5.2.0")
+    def join(self, sep: str = " ", /) -> str:
+        """
+        Join every element in list to str (``str.join()`` wrapper).
+
+        Parameters
+        ----------
+        sep : str, optional
+            Separator between each element, by default ``" "``
+
+        Returns
+        -------
+        str
+            Joined list
+
+
+        Example:
+        --------
+        >>> ListExt(["a", "b", "c"]).join()
+        a b c
+
+        >>> # Also work with non-str type
+        >>> ListExt([1, 2, 3]).join()
+        1 2 3
+        """
+        try:
+            return sep.join(self)  # type: ignore
+        except TypeError:
+            return sep.join(self.apply(str))
+
+    # Random
+    def pick_one(self) -> T:
+        """
+        Pick one random items from ``list``
+
+        Returns
+        -------
+        Any
+            Random value
+
+
+        Example:
+        --------
+        >>> test = ListExt(["foo", "bar"])
+        >>> test.pick_one()
+        'bar'
+        """
+        if len(self) != 0:
+            out = random.choice(self)
+            # logger.debug(out)
+            return out
+        else:
+            # logger.debug("List empty!")
+            raise IndexError("List empty!")
+
+    def get_random(self, number_of_items: int = 5, /) -> list[T]:
+        """
+        Get ``number_of_items`` random items in ``ListExt``
+
+        Parameters
+        ----------
+        number_of_items : int
+            Number random of items, by default ``5``
+
+        Returns
+        -------
+        list
+            Filtered list
+        """
+        return [self.pick_one() for _ in range(number_of_items)]
+
+    @versionadded("5.10.0")
+    def shuffle(self) -> Self:
+        """
+        Shuffle the list itself
+
+        Returns
+        -------
+        Self
+            Shuffled list
+        """
+        random.shuffle(self)
+        return self
+
+    # Len
+    @versionchanged("5.2.0", reason="Handle more type")
+    def len_items(self) -> "ListExt2[int]":
+        """
+        ``len()`` for every item in ``self``
+
+        Returns
+        -------
+        Self
+            List of ``len()``'ed value
+
+
+        Example:
+        --------
+        >>> test = ListExt(["foo", "bar", "pizza"])
+        >>> test.len_items()
+        [3, 3, 5]
+        """
+
+        def _len(item: Any) -> int:
+            try:
+                return len(item)
+            except TypeError:
+                return len(str(item))
+
+        return self.__class__([_len(x) for x in self])  # type: ignore
+
+    @versionchanged("5.2.0", reason="New ``recursive`` parameter")
+    def mean_len(self, recursive: bool = False) -> float:
+        """
+        Average length of every item. Returns zero if failed (empty list, ZeroDivisionError).
+
+        Parameters
+        ----------
+        recursive : bool
+            Recursively find the average length of items in nested lists, by default ``False``
+
+        Returns
+        -------
+        float
+            Average length
+
+
+        Example:
+        --------
+        >>> test = ListExt(["foo", "bar", "pizza"])
+        >>> test.mean_len()
+        3.6666666666666665
+        """
+
+        if recursive:
+            dat = self.flatten(recursive=recursive)
+        else:
+            dat = self
+
+        try:
+            return sum(dat.len_items()) / len(dat)
+        except ZeroDivisionError:
+            return 0.0
+
+    @versionadded("5.2.0")
+    def max_item_len(self, recursive: bool = False) -> int:
+        """
+        Find the maximum length of items in the list.
+
+        Parameters
+        ----------
+        recursive : bool
+            Recursively find the maximum length of items in nested lists, by default ``False``
+
+        Returns
+        -------
+        int
+            Maximum length of items
+
+
+        Example:
+        --------
+        >>> test = ListExt(["test", "longer_test"])
+        >>> test.max_item_len()
+        11
+
+        >>> test = ListExt([["short"], ["longer_test"]])
+        >>> test.max_item_len(recursive=True)
+        11
+        """
+        if recursive:
+            return cast(int, max(self.flatten(recursive=True).len_items()))
+        return cast(int, max(self.len_items()))
+
+
+if __name__ == "__main__":
+    test = ListExt2([1, 2, 3, 4, 5])
+    a = test.pick_one()

absfuyu/dxt/strext.py

@@ -3,8 +3,8 @@ Absfuyu: Data Extension
 -----------------------
 str extension
 
-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/extra/__init__.py

@@ -3,8 +3,8 @@ Absfuyu: Extra
 --------------
 Features that require additional libraries
 
-Version: 5.11.0
-Date updated: 30/09/2025 (dd/mm/yyyy)
+Version: 5.12.0
+Date updated: 17/10/2025 (dd/mm/yyyy)
 """
 
 

absfuyu/extra/beautiful.py

@@ -3,8 +3,8 @@ Absfuyu: Beautiful
 ------------------
 A decorator that makes output more beautiful
 
-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/extra/da/__init__.py

@@ -3,8 +3,8 @@ Absfuyu: Data Analysis
 ----------------------
 Data Analyst
 
-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/extra/da/dadf.py

@@ -3,8 +3,8 @@ Absfuyu: Data Analysis
 ----------------------
 Data Analyst DataFrame
 
-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
@@ -28,7 +28,7 @@ import random
 import string
 from collections.abc import Callable, Sequence
 from datetime import datetime, timedelta
-from typing import Any, Literal, Self
+from typing import Any, Literal, Self, cast
 
 import numpy as np
 import pandas as pd
@@ -40,6 +40,11 @@ try:
 except ImportError:
     from absfuyu.core.decorator import dummy_decorator as override
 
+try:
+    from unidecode import unidecode  # type: ignore
+except ImportError:
+    from absfuyu.core.dummy_func import dummy_function as unidecode
+
 from absfuyu.core.baseclass import GetClassMembersMixin
 from absfuyu.core.docstring import deprecated, versionadded, versionchanged
 from absfuyu.extra.da.dadf_base import CityData
@@ -62,6 +67,8 @@ class DataAnalystDataFrameColumnMethodMixin(DFBase):
     - Drop rightmost column
     - Add blank column
     - Split str column
+    - Get column name unidecoded
+    - Get column unidecoded
     """
 
     def rearrange_rightmost_column(
@@ -257,6 +264,69 @@ class DataAnalystDataFrameColumnMethodMixin(DFBase):
         self[new_col_names] = splited_data
         return self
 
+    @versionadded("5.12.0")  # No test cases
+    def get_column_name_unidecoded(self, col_name: str, /, *, mode: Literal["start", "end", "in"] = "start") -> str:
+        """
+        Get column name from lowercase unidecode'd version name
+
+        Parameters
+        ----------
+        col_name : str
+            Column name to find
+
+        mode : Literal["start", "end", "in"], optional
+            Which mode to find, by default "start"
+            - "start": str.startswith()
+            - "end": str.endswith()
+            - "in": if x in y
+
+        Returns
+        -------
+        str
+            Column name
+
+        Raises
+        ------
+        ValueError
+            Column not found
+        """
+        for x in self.columns.to_list():
+            col_name_mod = cast(str, unidecode(x.strip().lower()))
+            if mode == "start":
+                if col_name_mod.startswith(col_name):
+                    return x
+            elif mode == "end":
+                if col_name_mod.endswith(col_name):
+                    return x
+            elif mode == "in":
+                if col_name_mod in col_name:
+                    return x
+
+        raise ValueError(f"Column not found: {col_name}")
+
+    @versionadded("5.12.0")  # No test cases
+    def get_column_unidecoded(self, col_name: str, /, *, mode: Literal["start", "end", "in"] = "start") -> pd.Series:
+        """
+        Get column from lowercase unidecode'd version column name
+
+        Parameters
+        ----------
+        col_name : str
+            Column name to find
+
+        mode : Literal["start", "end", "in"], optional
+            Which mode to find, by default "start"
+            - "start": str.startswith()
+            - "end": str.endswith()
+            - "in": if x in y
+
+        Returns
+        -------
+        Series
+            Column data
+        """
+        return self[self.get_column_name_unidecoded(col_name, mode=mode)]
+
 
 # Row method
 # ---------------------------------------------------------------------------

absfuyu/extra/da/dadf_base.py

@@ -3,8 +3,8 @@ Absfuyu: Data Analysis
 ----------------------
 Data Analyst DataFrame - Base/Core
 
-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/extra/da/df_func.py

@@ -3,8 +3,8 @@ Absfuyu: Data Analysis
 ----------------------
 DF Function
 
-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/extra/da/mplt.py

@@ -3,8 +3,8 @@ Absfuyu: Data Analysis
 ----------------------
 Matplotlib Helper
 
-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/extra/data_analysis.py

@@ -4,8 +4,8 @@ Absfuyu: Data Analysis [W.I.P]
 Extension for ``pd.DataFrame``
 (deprecated)
 
-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/extra/pdf.py

@@ -3,8 +3,8 @@ Absfuyu: PDF
 ------------
 PDF Tool [W.I.P]
 
-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/extra/rclone.py

@@ -3,8 +3,8 @@ Absfuyu: Rclone decrypt
 -----------------------
 Rclone decryptor
 
-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/extra/xml.py

@@ -3,8 +3,8 @@ Absfuyu: XML
 ------------
 XML Tool [W.I.P]
 
-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/fun/__init__.py

@@ -3,8 +3,8 @@ Absfuyu: Fun
 ------------
 Some fun or weird 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/fun/rubik.py

@@ -3,8 +3,8 @@ Absfuyu: Fun
 ------------
 Rubik
 
-Version: 5.11.0
-Date updated: 30/09/2025 (dd/mm/yyyy)
+Version: 5.12.0
+Date updated: 17/10/2025 (dd/mm/yyyy)
 
 
 Version added: 5.4.0

absfuyu/fun/tarot.py

@@ -4,8 +4,8 @@ Absfuyu: Tarot
 Tarot 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)
 
 Usage:
 ------

absfuyu/game/__init__.py

@@ -3,8 +3,8 @@ Absfuyu: Game
 -------------
 Contain some game that can be played on terminal
 
-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/game_stat.py

@@ -1,8 +1,8 @@
 """
 Game: Game Stat
 
-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/schulte.py

@@ -2,8 +2,8 @@
 Game: Schulte
 -------------
 
-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/sudoku.py

@@ -3,8 +3,8 @@ Game: Sudoku
 ------------
 Sudoku 9x9 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)
 
 Credit:
 -------