absfuyu 5.1.0__py3-none-any.whl → 5.3.0__py3-none-any.whl

absfuyu/dxt/strext.py

@@ -3,8 +3,8 @@ Absfuyu: Data Extension
 -----------------------
 str extension
 
-Version: 5.1.0
-Date updated: 10/03/2025 (dd/mm/yyyy)
+Version: 5.2.0
+Date updated: 13/03/2025 (dd/mm/yyyy)
 """
 
 # Module Package
@@ -15,14 +15,72 @@ __all__ = ["Text", "TextAnalyzeDictFormat"]
 # Library
 # ---------------------------------------------------------------------------
 import random
+from string import ascii_letters as _ascii_letters
 from typing import NotRequired, Self, TypedDict
 
 from absfuyu.core import ShowAllMethodsMixin, deprecated, versionadded, versionchanged
-from absfuyu.logger import logger
-from absfuyu.tools.generator import Charset, Generator
 from absfuyu.util import set_min_max
 
 
+# Support function
+# ---------------------------------------------------------------------------
+def _generate_string(
+    charset: str | None = None,
+    size: int = 8,
+    times: int = 1,
+    unique: bool = True,
+) -> list[str]:
+    """
+    Generate a list of random string from character set
+    (Random string generator)
+
+    This is a lesser version of
+    ``absfuyu.tools.generator.Generator.generate_string()``
+
+    Parameters
+    ----------
+    charset : str, optional
+        Custom character set, by default ``None``
+        ([a-zA-Z] - string.ascii_letters)
+
+    size : int, optional
+            Length of each string in list, by default ``8``
+
+    times : int, optional
+        How many random string generated, by default ``1``
+
+    unique : bool, optional
+        Each generated text is unique, by default ``True``
+
+    Returns
+    -------
+    list[str]
+        List of random string generated
+    """
+
+    charset = _ascii_letters or charset
+
+    try:
+        char_lst = list(charset)  # type: ignore[arg-type]
+    except Exception:
+        char_lst = charset  # type: ignore[assignment]
+
+    unique_string = []
+    count = 0
+
+    while count < times:
+        gen_string = "".join(random.choice(char_lst) for _ in range(size))
+        if not unique:
+            unique_string.append(gen_string)
+            count += 1
+        else:
+            if gen_string not in unique_string:
+                unique_string.append(gen_string)
+                count += 1
+
+    return unique_string
+
+
 # Class
 # ---------------------------------------------------------------------------
 class TextAnalyzeDictFormat(TypedDict):
@@ -61,6 +119,9 @@ class TextAnalyzeDictFormat(TypedDict):
 class Text(ShowAllMethodsMixin, str):
     """
     ``str`` extension
+
+    >>> # For a list of new methods
+    >>> Text.show_all_methods()
     """
 
     def divide(self, string_split_size: int = 60) -> list[str]:
@@ -154,9 +215,7 @@ class Text(ShowAllMethodsMixin, str):
         splt_len = len(temp)
 
         if custom_var_name is None:
-            splt_name = Generator.generate_string(
-                charset=Charset.ALPHABET, size=split_var_len, times=splt_len + 1
-            )
+            splt_name = _generate_string(size=split_var_len, times=splt_len + 1)
             for i in range(splt_len):
                 output.append(f"{splt_name[i]}='{temp[i]}'")
         else:
@@ -361,14 +420,15 @@ class Text(ShowAllMethodsMixin, str):
         probability = int(set_min_max(probability))
         text = self.lower()
 
-        temp = []
-        for x in text:
-            if random.randint(1, 100) <= probability:
-                x = x.upper()
-            temp.append(x)
-        logger.debug(temp)
-        return self.__class__("".join(temp))
+        random_caps = (
+            x.upper() if random.randint(1, 100) <= probability else x for x in text
+        )
+        return self.__class__("".join(random_caps))
 
+    @deprecated(
+        "5.2.0",
+        reason="str already has swapcase() method, will be removed in version 5.3.0",
+    )
     @versionchanged("5.0.0", reason="Use ``str.swapcase()``")
     def reverse_capslock(self) -> Self:
         """
@@ -406,7 +466,7 @@ class Text(ShowAllMethodsMixin, str):
         """
         return list(self)
 
-    @deprecated("5.0.0", reason="Unused")
+    @deprecated("5.0.0", reason="Unused, will be removed in version 5.3.0")
     def to_listext(self) -> None:
         """Deprecated, will be removed soon"""
         raise NotImplementedError("Deprecated, will be removed soon")

absfuyu/extra/__init__.py

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

absfuyu/extra/beautiful.py

@@ -3,7 +3,7 @@ Absfuyu: Beautiful
 ------------------
 A decorator that makes output more beautiful
 
-Version: 5.1.0
+Version: 5.2.0
 Date updated: 10/03/2025 (dd/mm/yyyy)
 """
 

absfuyu/extra/da/__init__.py

@@ -3,7 +3,7 @@ Absfuyu: Data Analysis
 ----------------------
 Data Analyst
 
-Version: 5.1.0
+Version: 5.2.0
 Date updated: 10/03/2025 (dd/mm/yyyy)
 """
 

absfuyu/extra/da/dadf.py

@@ -3,8 +3,8 @@ Absfuyu: Data Analysis
 ----------------------
 Data Analyst DataFrame
 
-Version: 5.1.0
-Date updated: 10/03/2025 (dd/mm/yyyy)
+Version: 5.2.0
+Date updated: 15/03/2025 (dd/mm/yyyy)
 """
 
 # Module level
@@ -39,11 +39,12 @@ except ImportError:
 
 from absfuyu.core.baseclass import ShowAllMethodsMixin
 from absfuyu.core.docstring import deprecated, versionadded
-from absfuyu.core.typings import _R, _T
 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
 from absfuyu.logger import logger
+from absfuyu.typings import R as _R
+from absfuyu.typings import T as _T
 from absfuyu.util import set_min_max
 
 
@@ -1135,4 +1136,55 @@ class DADF_WIP(DADF):
     W.I.P - No test cases written
     """
 
-    pass
+    @versionadded("5.2.0")
+    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

absfuyu/extra/da/dadf_base.py

@@ -3,7 +3,7 @@ Absfuyu: Data Analysis
 ----------------------
 Data Analyst DataFrame - Base/Core
 
-Version: 5.1.0
+Version: 5.2.0
 Date updated: 10/03/2025 (dd/mm/yyyy)
 """
 

absfuyu/extra/da/df_func.py

@@ -3,7 +3,7 @@ Absfuyu: Data Analysis
 ----------------------
 DF Function
 
-Version: 5.1.0
+Version: 5.2.0
 Date updated: 10/03/2025 (dd/mm/yyyy)
 """
 

absfuyu/extra/da/mplt.py

@@ -3,7 +3,7 @@ Absfuyu: Data Analysis
 ----------------------
 Matplotlib Helper
 
-Version: 5.1.0
+Version: 5.2.0
 Date updated: 10/03/2025 (dd/mm/yyyy)
 """
 

absfuyu/extra/data_analysis.py

@@ -4,8 +4,8 @@ Absfuyu: Data Analysis [W.I.P]
 Extension for ``pd.DataFrame``
 (deprecated)
 
-Version: 5.1.0
-Date updated: 10/03/2025 (dd/mm/yyyy)
+Version: 5.2.0
+Date updated: 15/03/2025 (dd/mm/yyyy)
 """
 
 # Library
@@ -18,4 +18,4 @@ from absfuyu.extra.da.df_func import (  # noqa
 )
 
 # Class - DA
-# TODO: split column df[['A','B']]=df['AB'].str.split(' ',n=1,expand=True) | drop dups | Combine: row with data, row NaN
+# TODO: drop dups | Combine: row with data, row NaN

absfuyu/fun/__init__.py

@@ -3,7 +3,7 @@ Absfuyu: Fun
 ------------
 Some fun or weird stuff
 
-Version: 5.1.0
+Version: 5.2.0
 Date updated: 10/03/2025 (dd/mm/yyyy)
 """
 

absfuyu/fun/tarot.py

@@ -4,7 +4,7 @@ Absfuyu: Tarot
 Tarot stuff
 
 
-Version: 5.1.0
+Version: 5.2.0
 Date updated: 10/03/2025 (dd/mm/yyyy)
 
 Usage:

absfuyu/game/__init__.py

@@ -3,7 +3,7 @@ Absfuyu: Game
 -------------
 Contain some game that can be played on terminal
 
-Version: 5.1.0
+Version: 5.2.0
 Date updated: 10/03/2025 (dd/mm/yyyy)
 """
 

absfuyu/game/game_stat.py

@@ -1,7 +1,7 @@
 """
 Game: Game Stat
 
-Version: 5.1.0
+Version: 5.2.0
 Date updated: 10/03/2025 (dd/mm/yyyy)
 """
 

absfuyu/game/sudoku.py

@@ -3,7 +3,7 @@ Game: Sudoku
 ------------
 Sudoku 9x9 Solver
 
-Version: 5.1.0
+Version: 5.2.0
 Date updated: 10/03/2025 (dd/mm/yyyy)
 
 Credit:

absfuyu/game/tictactoe.py

@@ -2,11 +2,10 @@
 Game: Tic Tac Toe
 -----------------
 
-Version: 5.1.0
-Date updated: 10/03/2025 (dd/mm/yyyy)
+Version: 5.2.0
+Date updated: 15/03/2025 (dd/mm/yyyy)
 """
 
-
 # Module level
 # ---------------------------------------------------------------------------
 __all__ = ["TicTacToe", "GameMode"]

absfuyu/game/wordle.py

@@ -2,7 +2,7 @@
 Game: Wordle Solver
 -------------------
 
-Version: 5.1.0
+Version: 5.2.0
 Date updated: 10/03/2025 (dd/mm/yyyy)
 
 Usage:

absfuyu/general/__init__.py

@@ -3,7 +3,7 @@ Absfuyu: General
 ----------------
 Collection of useful classes
 
-Version: 5.1.0
+Version: 5.2.0
 Date updated: 10/03/2025 (dd/mm/yyyy)
 
 Features:

absfuyu/general/content.py

@@ -3,8 +3,8 @@ Absfuyu: Content
 ----------------
 Handle .txt file
 
-Version: 5.1.0
-Date updated: 10/03/2025 (dd/mm/yyyy)
+Version: 5.2.0
+Date updated: 15/03/2025 (dd/mm/yyyy)
 
 Usage:
 ------

absfuyu/general/human.py

@@ -3,7 +3,7 @@ Absfuyu: Human
 --------------
 Human related stuff
 
-Version: 5.1.0
+Version: 5.2.0
 Date updated: 10/03/2025 (dd/mm/yyyy)
 """
 

absfuyu/general/shape.py

@@ -3,7 +3,7 @@ Absfuyu: Shape
 --------------
 Shapes
 
-Version: 5.1.0
+Version: 5.2.0
 Date updated: 10/03/2025 (dd/mm/yyyy)
 """
 

absfuyu/logger.py

@@ -3,7 +3,7 @@ Absfuyu: Logger
 ---------------
 Custom Logger Module
 
-Version: 5.1.0
+Version: 5.2.0
 Date updated: 10/03/2025 (dd/mm/yyyy)
 
 Usage:

absfuyu/pkg_data/__init__.py

@@ -3,7 +3,7 @@ Absfuyu: Package data
 ---------------------
 Load package data
 
-Version: 5.1.0
+Version: 5.2.0
 Date updated: 10/03/2025 (dd/mm/yyyy)
 """
 

absfuyu/pkg_data/deprecated.py

@@ -3,7 +3,7 @@ Absfuyu: Package data
 ---------------------
 Deprecated (but might have some use)
 
-Version: 5.1.0
+Version: 5.2.0
 Date updated: 10/03/2025 (dd/mm/yyyy)
 """
 

absfuyu/sort.py

@@ -3,7 +3,7 @@ Absfuyu: Sort
 -------------
 Sort Module
 
-Version: 5.1.0
+Version: 5.2.0
 Date updated: 10/03/2025 (dd/mm/yyyy)
 """
 

absfuyu/tools/__init__.py

@@ -3,29 +3,32 @@ Absfuyu: Tools
 --------------
 Some useful tools
 
-Version: 5.1.0
-Date updated: 10/03/2025 (dd/mm/yyyy)
+Version: 5.2.0
+Date updated: 16/03/2025 (dd/mm/yyyy)
 """
 
 # Module Package
 # ---------------------------------------------------------------------------
 __all__ = [
-    # Main
+    #     # Main
     "Checksum",
-    "Base64EncodeDecode",
-    "Text2Chemistry",
-    "Charset",
-    "Generator",
+    "B64",
+    "T2C",
+    #     "Charset",
+    #     "Generator",
     "Inspector",
-    "Obfuscator",
-    "StrShifter",
+    "inspect_all",
+    #     "Obfuscator",
+    #     "StrShifter",
 ]
 
 
 # Library
 # ---------------------------------------------------------------------------
 from absfuyu.tools.checksum import Checksum
-from absfuyu.tools.converter import Base64EncodeDecode, Text2Chemistry
-from absfuyu.tools.generator import Charset, Generator
-from absfuyu.tools.inspector import Inspector
-from absfuyu.tools.obfuscator import Obfuscator, StrShifter
+from absfuyu.tools.converter import Base64EncodeDecode as B64
+from absfuyu.tools.converter import Text2Chemistry as T2C
+from absfuyu.tools.inspector import Inspector, inspect_all
+
+# from absfuyu.tools.generator import Charset, Generator  # circular import bug
+# from absfuyu.tools.obfuscator import Obfuscator, StrShifter  # circular import bug

absfuyu/tools/checksum.py

@@ -3,8 +3,8 @@ Absufyu: Checksum
 -----------------
 Check MD5, SHA256, ...
 
-Version: 5.1.0
-Date updated: 10/03/2025 (dd/mm/yyyy)
+Version: 5.2.0
+Date updated: 11/03/2025 (dd/mm/yyyy)
 """
 
 # Module level

absfuyu/tools/converter.py

@@ -3,8 +3,8 @@ Absufyu: Converter
 ------------------
 Convert stuff
 
-Version: 5.1.0
-Date updated: 10/03/2025 (dd/mm/yyyy)
+Version: 5.2.0
+Date updated: 15/03/2025 (dd/mm/yyyy)
 
 Feature:
 --------
@@ -19,6 +19,8 @@ __all__ = [
     "Base64EncodeDecode",
     "Text2Chemistry",
     "Str2Pixel",
+    # Support
+    "ChemistryElement",
 ]
 
 
@@ -36,7 +38,7 @@ from absfuyu.core.baseclass import BaseClass, CLITextColor
 from absfuyu.core.docstring import versionadded
 from absfuyu.logger import logger
 from absfuyu.pkg_data import DataList, DataLoader
-from absfuyu.util import set_min
+from absfuyu.util.text_table import OneColumnTableMaker
 
 
 # Class
@@ -167,6 +169,10 @@ class ChemistryElement(BaseClass):
 
 
 class Text2Chemistry(BaseClass):
+    """
+    Convert text into chemistry symbols.
+    """
+
     def __init__(self) -> None:
         self.data_location = DataList.CHEMISTRY
 
@@ -301,16 +307,31 @@ class Text2Chemistry(BaseClass):
         if len(result) == 0:
             res = "No possible combination"
         else:
-            msg = []
+            header = ["Text to Chemistry"]
+            body = []
+            max_table_len = len(header[0])
+
             for i, solution in enumerate(result, start=1):
+                msg = []
                 max_word_len = max([len(x.name) for x in solution])
                 msg.append(f"Option {i:02}: {', '.join([x.symbol for x in solution])}")
                 for x in solution:
                     msg.append(
-                        f"{x.symbol.ljust(2)} ({x.number:02}. {x.name.ljust(max_word_len)} - {round(x.atomic_mass, 2)})"
+                        f"{x.symbol.ljust(2)} "
+                        f"({x.number:02}. {x.name.ljust(max_word_len)}"
+                        f" - {round(x.atomic_mass, 2)})"
                     )
-                msg.append("---")
-            res = "\n".join(msg)
+                body.append(msg)
+
+            max_table_len = max(
+                max([max([len(x) for x in opt]) for opt in body]), max_table_len
+            )
+            table = OneColumnTableMaker(ncols=max_table_len + 4, style="normal")
+            table.add_paragraph(header)
+            for x in body:
+                table.add_paragraph(x)
+
+            res = table.make_table()
         return res
 
 
@@ -357,7 +378,7 @@ class Str2Pixel(BaseClass):
         """
         self.data = str_data
         if pixel_symbol_overwrite is None:
-            self.pixel = self.PIXEL * int(set_min(pixel_size, min_value=1))
+            self.pixel = self.PIXEL * int(max(pixel_size, 1))
         else:
             self.pixel = pixel_symbol_overwrite