absfuyu 4.2.0__py3-none-any.whl → 5.0.1__py3-none-any.whl

absfuyu/general/__init__.py

@@ -3,94 +3,21 @@ Absfuyu: General
 ----------------
 Collection of useful classes
 
-Version: 1.1.4
-Date updated: 15/03/2024 (dd/mm/yyyy)
+Version: 5.0.0
+Date updated: 22/02/2025 (dd/mm/yyyy)
 
 Features:
 ---------
 - content
-- data_extension
 - generator
 - human
 """
 
-# Libary
-###########################################################################
-from typing import Any, Dict, Optional
-
-from absfuyu.general import content, data_extension, generator, human
-
-
-# Class
-###########################################################################
-class Dummy:
-    """
-    Dummy class that has nothing
-
-    Update attribute through dict
-    """
-
-    def __init__(self, data: Optional[Dict[Any, Any]] = None) -> None:
-        try:
-            self.__dict__.update(data)  # type: ignore
-        except Exception:
-            pass
-
-    def __str__(self) -> str:
-        class_name = self.__class__.__name__
-        return f"{class_name}({self.__dict__})"
-
-    def __repr__(self) -> str:
-        return self.__str__()
-
-    def dir_(self):
-        """List ``property``"""
-        return [x for x in self.__dir__() if not x.startswith("_")]
-
-    def update(self, data: Dict[Any, Any]) -> None:
-        """
-        Update with dict data
+# Module level
+# ---------------------------------------------------------------------------
+__all__ = ["content", "shape", "human"]
 
-        :param data: Dict data
-        :type data: dict
-        """
-        self.__dict__.update(data)
 
-
-class ClassBase:
-    """Class base for other class"""
-
-    def __init__(self) -> None:
-        pass
-
-    def __str__(self) -> str:
-        return f"{self.__class__.__name__}({self._get_key_and_val_for_print()})"
-
-    def __repr__(self) -> str:
-        return self.__str__()
-
-    def _get_key_and_val_for_print(self, sep: str = ", ") -> str:
-        """
-        returns `self.__dict__` without `{}` symbol
-
-        Example:
-        Convert `"a": "b"` to `a=b`
-        """
-        keys = self.__dict__.keys()
-        temp = filter(lambda x: not x.startswith("_"), keys)
-        # out = [f"{x}={self.__dict__[x]}" for x in temp]
-        out = [f"{x}={self.__dict__.get(x)}" for x in temp]
-        return sep.join(out)
-
-    # def _get_new_available_method(self) -> List[str]:
-    #     """
-    #     Return all new available methods in this particular class
-    #     """
-    #     available = set(dir(self.__class__)).difference(set(dir(self.__class__.__base__)))
-    #     return sorted(list(available))
-
-
-# Run
-###########################################################################
-if __name__ == "__main__":
-    pass
+# Libary
+# ---------------------------------------------------------------------------
+from absfuyu.general import content, human, shape

absfuyu/general/content.py

@@ -3,37 +3,38 @@ Absfuyu: Content
 ----------------
 Handle .txt file
 
-Version: 1.2.6
-Date updated: 05/04/2024 (dd/mm/yyyy)
+Version: 5.0.0
+Date updated: 25/02/2025 (dd/mm/yyyy)
 
 Usage:
 ------
 >>> from absfuyu.general.content import ContentLoader
 """
 
+# TODO: rewrite this
+
 # Module level
-###########################################################################
+# ---------------------------------------------------------------------------
 __all__ = ["ContentLoader", "Content", "LoadedContent"]
 
 
 # Library
-###########################################################################
+# ---------------------------------------------------------------------------
 import json
 import random
 import re
 from collections import Counter
 from itertools import chain
 from pathlib import Path
-from typing import List, Optional
-
-from unidecode import unidecode
+from typing import Self
 
+from absfuyu.core import BaseClass, ShowAllMethodsMixin, unidecode
 from absfuyu.logger import logger
 
 
 # Class
-###########################################################################
-class Content:
+# ---------------------------------------------------------------------------
+class Content(BaseClass):
     """
     Contain data
 
@@ -50,10 +51,7 @@ class Content:
         # return f"{self.data} | {self.tag}"
         return str(self.data)
 
-    def __repr__(self) -> str:
-        return self.__str__()
-
-    def unidecoded(self) -> "Content":
+    def unidecoded(self) -> Self:
         """
         Convert data through ``unidecode`` package
 
@@ -97,7 +95,7 @@ class Content:
 
     def handle_address(
         self, address_separator: str = ",", *, first_item_not_address: bool = True
-    ) -> "Content":
+    ) -> Self:
         """
         Handle ``self.data`` as address and then update the address into ``self.tag``
 
@@ -142,7 +140,7 @@ class Content:
         return self.__class__([self.data, self.tag])
 
 
-class LoadedContent(List[Content]):
+class LoadedContent(list[Content], ShowAllMethodsMixin):
     """
     Contain list of ``Content``
     """
@@ -154,7 +152,7 @@ class LoadedContent(List[Content]):
     def __repr__(self) -> str:
         return self.__str__()
 
-    def apply(self, func) -> "LoadedContent":
+    def apply(self, func) -> Self:
         """
         Apply function to each entry
 
@@ -165,7 +163,7 @@ class LoadedContent(List[Content]):
         return self.__class__(func(x.data) for x in self)
 
     @classmethod
-    def load_from_json(cls, file: Path) -> "LoadedContent":
+    def load_from_json(cls, file: Path) -> Self:
         """
         Use this method to load data from ``.json`` file from ``to_json()`` method
 
@@ -202,7 +200,7 @@ class LoadedContent(List[Content]):
         logger.debug(temp)
         return Counter(temp)
 
-    def filter(self, tag: str) -> "LoadedContent":
+    def filter(self, tag: str) -> Self:
         """
         Filter out entry with ``tag``
 
@@ -223,7 +221,7 @@ class LoadedContent(List[Content]):
             )
         return self.__class__([x for x in self if tag in x.tag])
 
-    def find(self, keyword: str) -> "LoadedContent":
+    def find(self, keyword: str) -> Self:
         """
         Return all entries that include ``keyword``
 
@@ -240,7 +238,7 @@ class LoadedContent(List[Content]):
             logger.debug("No result")
         return temp
 
-    def short_form(self, separator: str = ",") -> List[str]:
+    def short_form(self, separator: str = ",") -> list[str]:
         """
         Shows only first item when separated by ``separator`` of ``Content.data``
 
@@ -256,7 +254,7 @@ class LoadedContent(List[Content]):
         """
         return [x.short_form(separator) for x in self]
 
-    def pick_one(self, tag: Optional[str] = None) -> Content:
+    def pick_one(self, tag: str | None = None) -> Content:
         """
         Pick a random entry
 
@@ -279,7 +277,7 @@ class LoadedContent(List[Content]):
 
     def handle_address(
         self, address_separator: str = ",", *, first_item_not_address: bool = True
-    ) -> "LoadedContent":
+    ) -> Self:
         """
         Execute ``Content.handle_address()`` on every ``self.data`` of ``Content``
 
@@ -362,7 +360,7 @@ class LoadedContent(List[Content]):
         return "\n".join(out)
 
 
-class ContentLoader:
+class ContentLoader(BaseClass):
     """
     This load data from ``.txt`` file
 
@@ -372,9 +370,9 @@ class ContentLoader:
 
     def __init__(
         self,
-        file_path: Path,
+        file_path: Path | str,
         characteristic_detect: bool = True,
-        tag_dictionary: Optional[dict] = None,
+        tag_dictionary: dict | None = None,
         *,
         comment_symbol: str = "#",
         split_symbol: str = "|",
@@ -437,12 +435,6 @@ class ContentLoader:
         self.split_symbol: str = split_symbol
         self.tag_separate_symbol: str = tag_separate_symbol
 
-    def __str__(self) -> str:
-        return f"{self.__class__.__name__}({self.__dict__})"
-
-    def __repr__(self) -> str:
-        return self.__str__()
-
     def content_format(self) -> str:
         """
         Shows current content format
@@ -462,7 +454,7 @@ class ContentLoader:
         out = (
             f"{self.comment_symbol} This line will be ignored\n"
             f"<content> {self.split_symbol} "
-            f"<tag1>{self.tag_separate_symbol} <tag2>"
+            f"<tag1>{self.tag_separate_symbol} <tag2>, ..., <tag n>"
         )
         return out
 
@@ -557,9 +549,3 @@ class ContentLoader:
             Loaded content
         """
         return LoadedContent(map(Content, self.load()))
-
-
-# Run
-###########################################################################
-if __name__ == "__main__":
-    logger.setLevel(10)