absfuyu 5.2.0__py3-none-any.whl → 5.4.0__py3-none-any.whl

absfuyu/dxt/listext.py

@@ -3,8 +3,8 @@ Absfuyu: Data Extension
 -----------------------
 list extension
 
-Version: 5.2.0
-Date updated: 15/03/2025 (dd/mm/yyyy)
+Version: 5.4.0
+Date updated: 21/03/2025 (dd/mm/yyyy)
 """
 
 # Module Package
@@ -18,11 +18,12 @@ import operator
 import random
 from collections import Counter
 from collections.abc import Callable, Iterable
-from itertools import accumulate, chain, groupby
+from itertools import accumulate, chain, groupby, zip_longest
 from typing import Any, Literal, Self, cast, overload
 
 from absfuyu.core.baseclass import ShowAllMethodsMixin
 from absfuyu.core.docstring import deprecated, versionadded, versionchanged
+from absfuyu.typings import T as _T
 from absfuyu.util import set_min_max
 
 
@@ -71,6 +72,12 @@ class ListExt(ShowAllMethodsMixin, list):
         -------
         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))
@@ -91,6 +98,12 @@ class ListExt(ShowAllMethodsMixin, list):
         -------
         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))
@@ -354,6 +367,40 @@ class ListExt(ShowAllMethodsMixin, list):
         start = max(start, 0)
         return self.__class__(enumerate(self, start=start))
 
+    @versionadded("5.3.0")  # no test case yet
+    def transpose(self, fillvalue: _T | None = None, /) -> Self:
+        """
+        Transpose a list of iterable.
+
+        Parameters
+        ----------
+        fillvalue : Any, optional
+            A fill value, by default ``None``
+
+        Returns
+        -------
+        Self | list[list[T]]
+            Transposed list.
+
+
+        Example:
+        --------
+        >>> ListExt([1, 1, 1, 1]).transpose()
+        [(1, 1, 1, 1)]
+
+        >>> ListExt([[1, 1, 1, 1], [1, 1, 1, 1]]).transpose()
+        [(1, 1), (1, 1), (1, 1), (1, 1)]
+
+        >>> ListExt([[1, 1, 1, 1], [1, 1, 1, 1], [1]]).transpose()
+        [(1, 1, 1), (1, 1, None), (1, 1, None), (1, 1, None)]
+        """
+        try:
+            return self.__class__(zip_longest(*self, fillvalue=fillvalue)).apply(list)
+        except TypeError:  # Dimension of 1
+            mod_dat = self.apply(lambda x: [x])
+            # return self.__class__(zip_longest(*mod_dat, fillvalue=fillvalue)).apply(list)
+            return mod_dat
+
     # Random
     def pick_one(self) -> Any:
         """
@@ -620,7 +667,7 @@ class ListExt(ShowAllMethodsMixin, list):
         return self.__class__(data[i1:i2] for i1, i2 in zip([0] + points[:-1], points))
 
     @versionadded("5.1.0")
-    def split_chunk(self, chunk_size: int) -> Self:
+    def split_chunk(self, chunk_size: int, /) -> Self:
         """
         Split list into smaller chunks
 
@@ -643,8 +690,75 @@ class ListExt(ShowAllMethodsMixin, list):
         slice_points = list(range(0, len(self), max(chunk_size, 1)))[1:]
         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:
+        """
+        Smart convert 1 dimension list to 2 dimension list,
+        in which, number of columns = ``ncols``.
+
+        Parameters
+        ----------
+        ncols : int
+            Number of columns
+
+        fillvalue : T | None, optional
+            Fill value, by default ``None``
+
+        Returns
+        -------
+        Self
+            Coulumned list.
+
+
+        Example:
+        --------
+        >>> ins = ListExt(range(1,20))
+
+        >>> # Normal split chunk
+        >>> ins.split_chunk(10)
+        [
+            [1, 2, 3, 4, 5, 6, 7, 8, 9, 10],
+            [11, 12, 13, 14, 15, 16, 17, 18, 19]
+        ]
+
+        >>> # Column split chunk
+        >>> ins.to_column(10)
+        [
+            [1, 3, 5, 7, 9, 11, 13, 15, 17, 19],
+            [2, 4, 6, 8, 10, 12, 14, 16, 18, None]
+        ]
+        """
+        num_of_col = max(ncols, 1)
+        len_cols = len(self.split_chunk(num_of_col))
+        return self.split_chunk(len_cols).transpose(fillvalue)
+
+    @overload
+    def wrap_to_column(self, width: int, /) -> Self: ...
+
+    @overload
+    def wrap_to_column(
+        self,
+        width: int,
+        /,
+        *,
+        margin: int = 4,
+        sep: str = "",
+        fill: str = " ",
+        transpose: bool = False,
+    ) -> Self: ...
+
+    @versionchanged("5.3.0", reason="New `sep`, `fill`, `transpose` parameters")
     @versionadded("5.2.0")  # no test case yet
-    def wrap_to_column(self, width: int, margin: int = 4) -> Self:
+    def wrap_to_column(
+        self,
+        width: int,
+        /,
+        *,
+        margin: int = 4,
+        sep: str = "",
+        fill: str = " ",
+        transpose: bool = False,
+    ) -> Self:
         """
         Arrange list[str] items into aligned text columns (for printing)
         with automatic column count calculation.
@@ -655,7 +769,16 @@ class ListExt(ShowAllMethodsMixin, list):
             Total available display width (must be >= ``margin``)
 
         margin : int, optional
-            Reserved space for borders/padding, by default ``4``
+            Reserved space for borders/padding, should be an even number, by default ``4``
+
+        sep : str, optional
+            Separator between each element, by default ``""``
+
+        fill : str, optional
+            Fill character for spacing, must have the length of 1, by default ``" "``
+
+        transpose : bool, optional
+            Smart transpose the columns, by default ``False``
 
         Returns
         -------
@@ -673,8 +796,10 @@ class ListExt(ShowAllMethodsMixin, list):
         ['apple  ', 'banana ', 'cherry ', 'date   ']
         """
 
-        max_item_length = self.max_item_len() + 1  # +1 for spacing
-        available_width = max(width, 4) - max(margin, 2)  # Set boundary
+        max_item_length = self.max_item_len() + max(len(sep), 1)
+        available_width = max(width, 4) - max(margin, 0)  # Set boundary
+        if len(fill) != 1:
+            fill = " "
 
         # Calculate how many columns of text
         column_count = (
@@ -688,8 +813,11 @@ class ListExt(ShowAllMethodsMixin, list):
 
         def mod_item(item: list[str]) -> str:
             # Set width for str item and join them together
-            return "".join(x.ljust(max_item_length, " ") for x in item)
+            return sep.join(x.ljust(max_item_length, fill) for x in item)
 
-        mod_chunk = self.split_chunk(column_count).apply(mod_item)
+        if transpose:
+            mod_chunk = self.to_column(column_count, fillvalue="").apply(mod_item)
+        else:
+            mod_chunk = self.split_chunk(column_count).apply(mod_item)
 
         return mod_chunk

absfuyu/dxt/strext.py

@@ -3,8 +3,8 @@ Absfuyu: Data Extension
 -----------------------
 str extension
 
-Version: 5.2.0
-Date updated: 13/03/2025 (dd/mm/yyyy)
+Version: 5.4.0
+Date updated: 21/03/2025 (dd/mm/yyyy)
 """
 
 # Module Package

absfuyu/extra/__init__.py

@@ -3,8 +3,8 @@ Absfuyu: Extra
 --------------
 Features that require additional libraries
 
-Version: 5.2.0
-Date updated: 10/03/2025 (dd/mm/yyyy)
+Version: 5.4.0
+Date updated: 21/03/2025 (dd/mm/yyyy)
 """
 
 

absfuyu/extra/beautiful.py

@@ -3,8 +3,8 @@ Absfuyu: Beautiful
 ------------------
 A decorator that makes output more beautiful
 
-Version: 5.2.0
-Date updated: 10/03/2025 (dd/mm/yyyy)
+Version: 5.4.0
+Date updated: 21/03/2025 (dd/mm/yyyy)
 """
 
 # Module level

absfuyu/extra/da/__init__.py

@@ -3,8 +3,8 @@ Absfuyu: Data Analysis
 ----------------------
 Data Analyst
 
-Version: 5.2.0
-Date updated: 10/03/2025 (dd/mm/yyyy)
+Version: 5.4.0
+Date updated: 21/03/2025 (dd/mm/yyyy)
 """
 
 # Module level

absfuyu/extra/da/dadf.py

@@ -3,8 +3,8 @@ Absfuyu: Data Analysis
 ----------------------
 Data Analyst DataFrame
 
-Version: 5.2.0
-Date updated: 15/03/2025 (dd/mm/yyyy)
+Version: 5.4.0
+Date updated: 21/03/2025 (dd/mm/yyyy)
 """
 
 # Module level
@@ -58,6 +58,7 @@ class DataAnalystDataFrameColumnMethodMixin(DFBase):
     - Drop columns
     - Drop rightmost column
     - Add blank column
+    - Split str column
     """
 
     def rearrange_rightmost_column(
@@ -200,6 +201,59 @@ class DataAnalystDataFrameColumnMethodMixin(DFBase):
         self[column_name] = [fill] * self.shape[0]
         return self
 
+    @versionadded("5.2.0")  # No test cases
+    def split_str_column(
+        self,
+        col: str,
+        pattern: str = " ",
+        *,
+        n: int | None = None,
+        regex: bool = False,
+    ) -> Self:
+        """
+        Split column with dtype[str] into other columns.
+
+        Parameters
+        ----------
+        col : str
+            Column name
+
+        pattern : str, optional
+            Split pattern, by default ``" "``
+
+        n : int | None, optional
+            Split by how many times, by default ``None``
+
+        regex : bool, optional
+            Regex mode, by default ``False``
+
+        Returns
+        -------
+        Self
+            DataFrame
+
+
+        Example:
+        --------
+        >>> df = DADF(DADF.sample_df(5)[["text"]])
+        >>> df.split_str_column("text", "s"))
+               text    text_0 text_1
+        0  uwfzbsgj     uwfzb     gj
+        1  lxlskayx       lxl   kayx
+        2  fzgpzjtp  fzgpzjtp   None
+        3  lxnytktz  lxnytktz   None
+        4  onryaxtt  onryaxtt   None
+        """
+        if n is None:
+            pass
+        splited_data: pd.DataFrame = self[col].str.split(
+            pat=pattern, n=n, expand=True, regex=regex
+        )
+        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
+        return self
+
 
 # Row method
 # ---------------------------------------------------------------------------
@@ -1136,42 +1190,4 @@ class DADF_WIP(DADF):
     W.I.P - No test cases written
     """
 
-    def split_str_column(
-        self,
-        col: str,
-        pattern: str = " ",
-        *,
-        n: int | None = None,
-        regex: bool = False,
-    ) -> Self:
-        """
-        Split column with dtype[str] into other columns.
-
-        Parameters
-        ----------
-        col : str
-            Column name
-
-        pattern : str, optional
-            Split pattern, by default ``" "``
-
-        n : int | None, optional
-            Split by how many times, by default ``None``
-
-        regex : bool, optional
-            Regex mode, by default ``False``
-
-        Returns
-        -------
-        Self
-            DataFrame
-        """
-        if n is None:
-            pass
-        splited_data: pd.DataFrame = self[col].str.split(
-            pat=pattern, n=n, expand=True, regex=regex
-        )
-        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
-        return self
+    pass

absfuyu/extra/da/dadf_base.py

@@ -3,8 +3,8 @@ Absfuyu: Data Analysis
 ----------------------
 Data Analyst DataFrame - Base/Core
 
-Version: 5.2.0
-Date updated: 10/03/2025 (dd/mm/yyyy)
+Version: 5.4.0
+Date updated: 21/03/2025 (dd/mm/yyyy)
 """
 
 # Module level

absfuyu/extra/da/df_func.py

@@ -3,8 +3,8 @@ Absfuyu: Data Analysis
 ----------------------
 DF Function
 
-Version: 5.2.0
-Date updated: 10/03/2025 (dd/mm/yyyy)
+Version: 5.4.0
+Date updated: 21/03/2025 (dd/mm/yyyy)
 """
 
 # Module level

absfuyu/extra/da/mplt.py

@@ -3,8 +3,8 @@ Absfuyu: Data Analysis
 ----------------------
 Matplotlib Helper
 
-Version: 5.2.0
-Date updated: 10/03/2025 (dd/mm/yyyy)
+Version: 5.4.0
+Date updated: 21/03/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.2.0
-Date updated: 15/03/2025 (dd/mm/yyyy)
+Version: 5.4.0
+Date updated: 21/03/2025 (dd/mm/yyyy)
 """
 
 # Library

absfuyu/fun/__init__.py

@@ -3,10 +3,15 @@ Absfuyu: Fun
 ------------
 Some fun or weird stuff
 
-Version: 5.2.0
-Date updated: 10/03/2025 (dd/mm/yyyy)
+Version: 5.4.0
+Date updated: 21/03/2025 (dd/mm/yyyy)
 """
 
+# Module level
+# ---------------------------------------------------------------------------
+__all__ = ["zodiac_sign", "happy_new_year", "human_year_to_dog_year"]
+
+
 # Library
 # ---------------------------------------------------------------------------
 from datetime import date