absfuyu 5.2.0__tar.gz → 5.3.0__tar.gz

{absfuyu-5.2.0 → absfuyu-5.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: absfuyu
-Version: 5.2.0
+Version: 5.3.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/

{absfuyu-5.2.0 → absfuyu-5.3.0}/src/absfuyu/__init__.py

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

{absfuyu-5.2.0 → absfuyu-5.3.0}/src/absfuyu/cli/do_group.py

@@ -83,6 +83,15 @@ def os_shutdown() -> None:
     engine.shutdown()
 
 
+@click.command(name="organize")
+@click.argument("dir", type=str)
+def organize_directory(dir: str) -> None:
+    """Organize a directory"""
+    engine = Directory(dir)
+    engine.organize()
+    click.echo(f"{COLOR['green']}Done!")
+
+
 @click.group(name="do")
 def do_group() -> None:
     """Perform functionalities"""
@@ -93,3 +102,4 @@ do_group.add_command(update)
 do_group.add_command(install)
 do_group.add_command(unzip_files_in_dir)
 do_group.add_command(os_shutdown)
+do_group.add_command(organize_directory)

{absfuyu-5.2.0 → absfuyu-5.3.0}/src/absfuyu/core/baseclass.py

@@ -162,6 +162,36 @@ class MethodNPropertyList(NamedTuple):
 
         return self.__class__(new_methods_list, [], [], self.properties)
 
+    def sort(self, reverse: bool = False) -> Self:
+        """
+        Sorts every element in each method list.
+
+        Parameters
+        ----------
+        reverse : bool, optional
+            Descending order, by default ``False``
+
+        Returns
+        -------
+        Self
+            Sorted.
+
+
+        Example:
+        --------
+        >>> test = MethodNPropertyList(["b", "a"], ["d", "c"], ["f", "e"], ["h", "g"])
+        >>> test.sort()
+        MethodNPropertyList(methods=['a', 'b'], classmethods=['c', 'd'], staticmethods=['e', 'f'], properties=['g', 'h'])
+
+        >>> test.pack().sort()
+        MethodNPropertyList(methods=['a', 'b', 'c <classmethod>', 'd <classmethod>', 'e <staticmethod>', 'f <staticmethod>'], properties=['g', 'h'])
+        """
+        sorted_vals = [
+            sorted(getattr(self, field), reverse=reverse) for field in self._fields
+        ]
+        # return self._make(sorted_vals)
+        return self.__class__(*sorted_vals)
+
 
 # @versionadded("5.1.0")
 class MethodNPropertyResult(dict[str, MethodNPropertyList]):

{absfuyu-5.2.0 → absfuyu-5.3.0}/src/absfuyu/dxt/listext.py

@@ -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
 
 
@@ -354,6 +355,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 +655,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 +678,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 +757,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 +784,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 +801,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-5.2.0 → absfuyu-5.3.0}/src/absfuyu/extra/da/dadf.py

@@ -1136,6 +1136,7 @@ class DADF_WIP(DADF):
     W.I.P - No test cases written
     """
 
+    @versionadded("5.2.0")
     def split_str_column(
         self,
         col: str,
@@ -1165,6 +1166,18 @@ class DADF_WIP(DADF):
         -------
         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

{absfuyu-5.2.0 → absfuyu-5.3.0}/src/absfuyu/tools/__init__.py

@@ -12,7 +12,7 @@ Date updated: 16/03/2025 (dd/mm/yyyy)
 __all__ = [
     #     # Main
     "Checksum",
-    "Base64ED",
+    "B64",
     "T2C",
     #     "Charset",
     #     "Generator",
@@ -26,7 +26,7 @@ __all__ = [
 # Library
 # ---------------------------------------------------------------------------
 from absfuyu.tools.checksum import Checksum
-from absfuyu.tools.converter import Base64EncodeDecode as Base64ED
+from absfuyu.tools.converter import Base64EncodeDecode as B64
 from absfuyu.tools.converter import Text2Chemistry as T2C
 from absfuyu.tools.inspector import Inspector, inspect_all
 

{absfuyu-5.2.0 → absfuyu-5.3.0}/src/absfuyu/tools/inspector.py

@@ -71,6 +71,9 @@ class Inspector(AutoREPRMixin):
         Maximum lines for the output's header (class, signature, repr).
         Must be >= 1, by default ``8``
 
+    style : Literal["normal", "bold", "dashed", "double", "rounded"], optional
+        Style for the table, by default ``"normal"``
+
 
     Example:
     --------
@@ -96,6 +99,7 @@ class Inspector(AutoREPRMixin):
         include_attribute: bool = True,
         include_private: bool = False,
         max_textwrap_lines: int = 8,
+        style: Literal["normal", "bold", "dashed", "double", "rounded"] = "normal",
     ) -> None: ...
 
     def __init__(
@@ -114,6 +118,8 @@ class Inspector(AutoREPRMixin):
         include_attribute: bool = True,
         include_private: bool = False,
         include_all: bool = False,
+        # Style
+        style: Literal["normal", "bold", "dashed", "double", "rounded"] = "normal",
     ) -> None:
         """
         Inspect an object.
@@ -153,6 +159,9 @@ class Inspector(AutoREPRMixin):
             Maximum lines for the output's header (class, signature, repr).
             Must be >= 1, by default ``8``
 
+        style : Literal["normal", "bold", "dashed", "double", "rounded"], optional
+            Style for the table, by default ``"normal"``
+
 
         Example:
         --------
@@ -165,6 +174,7 @@ class Inspector(AutoREPRMixin):
         self.include_property = include_property
         self.include_attribute = include_attribute
         self.include_private = include_private
+        self._style = style
 
         if include_all:
             self.include_docs = True
@@ -203,7 +213,9 @@ class Inspector(AutoREPRMixin):
 
     # Support
     def _long_list_terminal_size(self, long_list: list) -> list:
-        ll = ListExt(long_list).wrap_to_column(self._linelength, margin=4)
+        ll = ListExt(long_list).wrap_to_column(
+            self._linelength, margin=4, transpose=True
+        )
         return list(ll)
 
     # Signature
@@ -392,7 +404,7 @@ class Inspector(AutoREPRMixin):
 
     # Output
     def _make_output(self) -> OneColumnTableMaker:
-        table = OneColumnTableMaker(self._linelength)
+        table = OneColumnTableMaker(self._linelength, style=self._style)
         body: list[str] = []
 
         # Signature
@@ -419,7 +431,9 @@ class Inspector(AutoREPRMixin):
 
         # Method & Property
         try:
-            method_n_properties = self._get_method_property().flatten_value().pack()
+            method_n_properties = (
+                self._get_method_property().flatten_value().pack().sort()
+            )
             if self.include_method:
                 ml = [
                     text_shorten(f"- {x}", self._linelength - 4)

{absfuyu-5.2.0 → absfuyu-5.3.0}/src/absfuyu/util/path.py

@@ -46,6 +46,128 @@ from absfuyu.core.decorator import add_subclass_methods_decorator
 from absfuyu.core.docstring import deprecated, versionadded, versionchanged
 from absfuyu.logger import logger
 
+# Template
+# ---------------------------------------------------------------------------
+ORGANIZE_TEMPLATE: dict[str, list[str]] = {
+    "Code": [".ps1", ".py", ".rs", ".js", ".c", ".h", ".cpp", ".r", ".cmd", ".bat"],
+    "Comic": [".cbz", ".cbr", ".cb7", ".cbt", ".cba"],
+    "Compressed": [
+        ".7z",
+        ".zip",
+        ".rar",
+        ".apk",
+        ".cab",
+        ".tar",
+        ".tgz",
+        ".txz",
+        ".bz2",
+        ".gz",
+        ".lz",
+        ".lz4",
+        ".lzma",
+        ".xz",
+        ".zipx",
+        ".zst",
+    ],
+    "Documents": [".docx", ".doc", ".xls", ".xlsx", ".ppt", ".pptx", ".pdf", ".txt"],
+    "Ebook": [
+        ".epub",
+        ".mobi",
+        ".prc",
+        ".lrf",
+        ".lrx",
+        ".pdb",
+        ".azw",
+        ".azw3",
+        ".kf8",
+        ".kfx",
+        ".opf",
+    ],
+    "Music": [".mp3", ".flac", ".wav", ".m4a", ".wma", ".aac", ".alac", ".aiff"],
+    "OS": [".iso", ".dmg", ".wim"],
+    "Pictures": [
+        ".jpg",
+        ".jpeg",
+        ".png",
+        ".apng",
+        ".avif",
+        ".bmp",
+        ".gif",
+        ".jfif",
+        ".pjpeg",
+        ".pjp",
+        ".svg",
+        ".ico",
+        ".cur",
+        ".tif",
+        ".tiff",
+        ".webp",
+    ],
+    "Programs": [".exe", ".msi"],
+    "Video": [
+        ".3g2",
+        ".3gp",
+        ".avi",
+        ".flv",
+        ".m2ts",
+        ".m4v",
+        ".mkv",
+        ".mov",
+        ".mp4",
+        ".mpeg",
+        ".mpv",
+        ".mts",
+        ".ts",
+        ".vob",
+        ".webm",
+    ],
+    "Raw pictures": [
+        ".3fr",
+        ".ari",
+        ".arw",
+        ".bay",
+        ".braw",
+        ".crw",
+        ".cr2",
+        ".cr3",
+        ".cap",
+        ".data",
+        ".dcs",
+        ".dcr",
+        ".dng",
+        ".drf",
+        ".eip",
+        ".erf",
+        ".fff",
+        ".gpr",
+        ".iiq",
+        ".k25",
+        ".kdc",
+        ".mdc",
+        ".mef",
+        ".mos",
+        ".mrw",
+        ".nef",
+        ".nrw",
+        ".obm",
+        ".orf",
+        ".pef",
+        ".ptx",
+        ".pxn",
+        ".r3d",
+        ".raf",
+        ".raw",
+        ".rwl",
+        ".rw2",
+        ".rwz",
+        ".sr2",
+        ".srf",
+        ".srw",
+        ".tif",
+        ".x3f",
+    ],
+}
+
 
 # Support Class
 # ---------------------------------------------------------------------------
@@ -444,10 +566,42 @@ class DirectoryArchiverMixin(DirectoryBase):
 
 class DirectoryOrganizerMixin(DirectoryBase):
     """
-    Directory - File organizer - SOON
+    Directory - File organizer
+
+    - Organize
     """
 
-    pass
+    @versionadded("5.3.0")
+    def organize(self, dirtemplate: dict[str, list[str]] | None = None) -> None:
+        """
+        Organize a directory.
+
+        Parameters
+        ----------
+        dirtemplate : dict[str, Collection[str]] | None, optional
+            | Template to move file to, by default ``None``.
+            | Example: {"Documents": [".txt", ".pdf", ...]}
+        """
+        if dirtemplate is None:
+            template = ORGANIZE_TEMPLATE
+        else:
+            template = dirtemplate
+
+        other_dir = self.source_path.joinpath("Others")
+        other_dir.mkdir(parents=True, exist_ok=True)
+
+        for path in self.source_path.iterdir():
+            if path.is_dir():
+                continue
+
+            for dir_name, suffixes in template.items():
+                if path.suffix.lower() in suffixes:
+                    move_path = self.source_path.joinpath(dir_name)
+                    move_path.mkdir(parents=True, exist_ok=True)
+                    path.rename(move_path.joinpath(path.name))
+                    break
+            else:
+                path.rename(other_dir.joinpath(path.name))
 
 
 class DirectoryTreeMixin(DirectoryBase):