absfuyu 3.4.0__py3-none-any.whl → 4.1.0__py3-none-any.whl

absfuyu/tools/converter.py

@@ -3,8 +3,8 @@ Absufyu: Converter
 ------------------
 Convert stuff
 
-Version: 1.2.2
-Date updated: 05/04/2024 (dd/mm/yyyy)
+Version: 1.3.0
+Date updated: 01/02/2025 (dd/mm/yyyy)
 
 Feature:
 --------
@@ -25,7 +25,7 @@ import math
 import re
 import string
 from itertools import chain, combinations
-from typing import Dict, List, Union
+from pathlib import Path
 
 from absfuyu.core import CLITextColor
 from absfuyu.logger import logger
@@ -49,6 +49,29 @@ class Base64EncodeDecode:
     def decode(data: str) -> str:
         return base64.b64decode(data).decode()
 
+    @staticmethod
+    def encode_image(img_path: Path | str, data_tag: bool = False) -> str:
+        """Encode image file into base64 string
+
+        Parameters
+        ----------
+        img_path : Path | str
+            Path to image
+        data_tag : bool, optional
+            Add data tag before base64 string, by default False
+
+        Returns
+        -------
+        str
+            Encoded image
+        """
+        img = Path(img_path)
+        with open(img, "rb") as img_file:
+            b64_data = base64.b64encode(img_file.read()).decode("utf-8")
+        if data_tag:
+            return f"data:image/{img.suffix[1:]};charset=utf-8;base64,{b64_data}"
+        return b64_data
+
 
 class ChemistryElement:
     """Chemistry Element"""
@@ -74,7 +97,7 @@ class ChemistryElement:
         # return self.symbol
         return f"{self.__class__.__name__}({self.symbol})"
 
-    def to_dict(self) -> Dict[str, Union[str, int, float]]:
+    def to_dict(self) -> dict[str, str | int | float]:
         """
         Output content to dict
 
@@ -88,7 +111,7 @@ class ChemistryElement:
         }
 
     @classmethod
-    def from_dict(cls, data: Dict[str, Union[str, int, float]]) -> "ChemistryElement":
+    def from_dict(cls, data: dict[str, str | int | float]) -> "ChemistryElement":
         """
         Convert from ``dict`` data
 
@@ -114,11 +137,11 @@ class Text2Chemistry:
     def __repr__(self) -> str:
         return self.__str__()
 
-    def _load_chemistry_data(self) -> List[ChemistryElement]:
+    def _load_chemistry_data(self) -> list[ChemistryElement]:
         """
         Load chemistry pickle data
         """
-        data: List[dict] = Pickler.load(self.data_location)  # type: ignore
+        data: list[dict] = Pickler.load(self.data_location)  # type: ignore
         return [ChemistryElement.from_dict(x) for x in data]
 
     @property
@@ -136,7 +159,7 @@ class Text2Chemistry:
         # logger.debug(available)
         return base.difference(available)
 
-    def convert(self, text: str) -> List[List[ChemistryElement]]:
+    def convert(self, text: str) -> list[list[ChemistryElement]]:
         """
         Convert text to chemistry symbol
 
@@ -163,7 +186,7 @@ class Text2Chemistry:
         data = self._load_chemistry_data()
 
         # List possible elements
-        possible_elements: List[ChemistryElement] = []
+        possible_elements: list[ChemistryElement] = []
         for i, letter in enumerate(text_lower):
             for element in data:
                 if element.symbol.lower().startswith(
@@ -219,7 +242,7 @@ class Str2Pixel:
         str_data: str,
         *,
         pixel_size: int = 2,
-        pixel_symbol_overwrite: Union[str, None] = None,
+        pixel_symbol_overwrite: str | None = None,
     ) -> None:
         """
         str_data: Pixel string data (Format: <number_of_pixel><color_code>)

absfuyu/tools/obfuscator.py

@@ -217,7 +217,7 @@ class Obfuscator:
             )
             for x in bait_lst:
                 output.append(
-                    f"{x}='{gen.generate_string(charset=Charset.DEFAULT,size=self.split_every_length,times=1,string_type_if_1=True)}'"
+                    f"{x}='{gen.generate_string(charset=Charset.DEFAULT, size=self.split_every_length, times=1, string_type_if_1=True)}'"
                 )
 
             random_eval_text = str(random.randint(1, 100))

absfuyu/util/__init__.py

@@ -3,15 +3,14 @@ Absufyu: Utilities
 ------------------
 Some random utilities
 
-Version: 1.5.1
-Date updated: 05/04/2024 (dd/mm/yyyy)
+Version: 1.5.2
+Date updated: 25/11/2024 (dd/mm/yyyy)
 """
 
 # Library
 ###########################################################################
 import pkgutil
 from datetime import datetime
-from typing import Optional, Union
 
 from absfuyu.logger import logger
 
@@ -34,10 +33,10 @@ def get_installed_package():
 
 
 def set_min(
-    current_value: Union[int, float],
+    current_value: int | float,
     *,
-    min_value: Union[int, float] = 0,
-) -> Union[int, float]:
+    min_value: int | float = 0,
+) -> int | float:
     """
     Return ``min_value`` when ``current_value`` < ``min_value``
 
@@ -67,10 +66,10 @@ def set_min(
 
 
 def set_max(
-    current_value: Union[int, float],
+    current_value: int | float,
     *,
-    max_value: Union[int, float] = 100,
-) -> Union[int, float]:
+    max_value: int | float = 100,
+) -> int | float:
     """
     Return ``max_value`` when ``current_value`` > ``max_value``
 
@@ -100,11 +99,11 @@ def set_max(
 
 
 def set_min_max(
-    current_value: Union[int, float],
+    current_value: int | float,
     *,
-    min_value: Union[int, float] = 0,
-    max_value: Union[int, float] = 100,
-) -> Union[int, float]:
+    min_value: int | float = 0,
+    max_value: int | float = 100,
+) -> int | float:
     """
     Return ``min_value`` | ``max_value`` when ``current_value``
     is outside ``[min_value, max_value]``
@@ -139,7 +138,7 @@ def set_min_max(
 
 
 def stop_after_day(
-    year: Optional[int] = None, month: Optional[int] = None, day: Optional[int] = None
+    year: int | None = None, month: int | None = None, day: int | None = None
 ) -> None:
     """
     Stop working after specified day.

absfuyu/util/api.py

@@ -3,8 +3,8 @@ Absufyu: API
 ------------
 Fetch data stuff
 
-Version: 1.2.0
-Date updated: 05/04/2024 (dd/mm/yyyy)
+Version: 1.2.1
+Date updated: 15/11/2024 (dd/mm/yyyy)
 """
 
 # Module level
@@ -21,7 +21,7 @@ import json
 import re
 import subprocess
 from pathlib import Path
-from typing import List, NamedTuple, Optional, Union
+from typing import NamedTuple
 
 import requests
 from deprecated.sphinx import versionchanged
@@ -42,7 +42,7 @@ class PingResult(NamedTuple):
 
 
 @versionchanged(version="3.4.0", reason="Change function's return")
-def ping_windows(host: List[str], ping_count: int = 3) -> List[PingResult]:
+def ping_windows(host: list[str], ping_count: int = 3) -> list[PingResult]:
     """
     Ping web
 
@@ -66,7 +66,7 @@ def ping_windows(host: List[str], ping_count: int = 3) -> List[PingResult]:
     >>> ping_windows(["1.1.1.1", "google.com"])
     ['1.1.1.1 : xxms', 'google.com : xxms']
     """
-    out: List[PingResult] = []
+    out: list[PingResult] = []
 
     for ip in host:
         output = subprocess.run(
@@ -96,7 +96,7 @@ class APIRequest:
         self,
         api_url: str,
         *,  # Use "*" to force using keyword in function parameter | Example: APIRequest(url, encoding="utf-8")
-        encoding: Optional[str] = "utf-8",
+        encoding: str | None = "utf-8",
     ) -> None:
         """
         :param api_url: api link
@@ -111,7 +111,7 @@ class APIRequest:
     def __repr__(self) -> str:
         return self.__str__()
 
-    def fetch_data(self, *, update: bool = False, json_cache: Union[str, Path]):
+    def fetch_data(self, *, update: bool = False, json_cache: str | Path):
         """
         Fetch data from an API then cache it for later use
 

absfuyu/util/json_method.py

@@ -3,8 +3,8 @@ Absfuyu: Json Method
 --------------------
 ``.json`` file handling
 
-Version: 1.1.3
-Date updated: 05/04/2024 (dd/mm/yyyy)
+Version: 1.1.4
+Date updated: 15/11/2024 (dd/mm/yyyy)
 """
 
 # Module level
@@ -16,7 +16,7 @@ __all__ = ["JsonFile"]
 ###########################################################################
 import json
 from pathlib import Path
-from typing import Any, Dict, Optional, Union
+from typing import Any
 
 
 # Function
@@ -38,10 +38,10 @@ class JsonFile:
 
     def __init__(
         self,
-        json_file_location: Union[str, Path],
+        json_file_location: str | Path,
         *,
-        encoding: Optional[str] = "utf-8",
-        indent: Union[int, str, None] = 4,
+        encoding: str | None = "utf-8",
+        indent: int | str | None = 4,
         sort_keys: bool = True,
     ) -> None:
         """
@@ -54,7 +54,7 @@ class JsonFile:
         self.encoding = encoding
         self.indent = indent
         self.sort_keys = sort_keys
-        self.data: Dict[Any, Any] = {}
+        self.data: dict[Any, Any] = {}
 
     def __str__(self) -> str:
         return f"{self.__class__.__name__}({self.json_file_location.name})"
@@ -62,7 +62,7 @@ class JsonFile:
     def __repr__(self) -> str:
         return self.__str__()
 
-    def load_json(self) -> Dict[Any, Any]:
+    def load_json(self) -> dict[Any, Any]:
         """
         Load ``.json`` file
 
@@ -79,7 +79,7 @@ class JsonFile:
         with open(self.json_file_location, "w", encoding=self.encoding) as file:
             file.writelines(json_data)
 
-    def update_data(self, data: Dict[Any, Any]) -> None:
+    def update_data(self, data: dict[Any, Any]) -> None:
         """
         Update ``.json`` data without save
 

absfuyu/util/lunar.py

@@ -4,8 +4,8 @@ Absfuyu: Lunar calendar
 -----------------------
 Convert to lunar calendar
 
-Version: 1.0.2
-Date updated: 05/04/2024 (dd/mm/yyyy)
+Version: 1.0.3
+Date updated: 15/11/2024 (dd/mm/yyyy)
 
 Source:
 -------
@@ -22,7 +22,6 @@ __all__ = ["LunarCalendar"]
 ###########################################################################
 import math
 from datetime import date, datetime
-from typing import Optional, Union
 
 
 # Class
@@ -56,9 +55,9 @@ class LunarCalendar:
     def _julian_day_from_date(
         self,
         *,
-        overwrite_year: Optional[int] = None,
-        overwrite_month: Optional[int] = None,
-        overwrite_day: Optional[int] = None,
+        overwrite_year: int | None = None,
+        overwrite_month: int | None = None,
+        overwrite_day: int | None = None,
     ) -> int:
         """
         Compute the (integral) Julian day number of `self.date`
@@ -211,7 +210,7 @@ class LunarCalendar:
         """
         return int(self._new_moon(k) + 0.5 + self.time_zone / 24.0)
 
-    def _get_lunar_month_11(self, *, overwrite_year: Optional[int] = None) -> int:
+    def _get_lunar_month_11(self, *, overwrite_year: int | None = None) -> int:
         """
         Find the day that starts the luner month 11
         of the given year for the given time zone.
@@ -373,7 +372,7 @@ class LunarCalendar:
         return cls(year, month, day, lunar_leap=lunar_leap).to_lunar()
 
     @classmethod
-    def from_datetime(cls, datetime_object: Union[date, datetime]):
+    def from_datetime(cls, datetime_object: date | datetime):
         """
         Convert from ``datetime.datetime`` object
 

absfuyu/util/path.py

@@ -3,8 +3,8 @@ Absfuyu: Path
 -------------
 Path related
 
-Version: 1.6.5
-Date updated: 10/04/2024 (dd/mm/yyyy)
+Version: 1.6.7
+Date updated: 06/01/2025 (dd/mm/yyyy)
 
 Feature:
 --------
@@ -32,7 +32,7 @@ import shutil
 from datetime import datetime
 from functools import partial
 from pathlib import Path
-from typing import Any, List, Literal, NamedTuple, Optional, Union
+from typing import Any, Literal, NamedTuple
 
 from deprecated.sphinx import versionadded
 
@@ -69,7 +69,7 @@ class DirectoryInfo(NamedTuple):
 class DirectoryBase:
     def __init__(
         self,
-        source_path: Union[str, Path],
+        source_path: str | Path,
         create_if_not_exist: bool = False,
     ) -> None:
         """
@@ -114,21 +114,21 @@ class DirectoryBase:
     # Everything
     @property
     @versionadded(version="3.3.0")
-    def everything(self) -> List[Path]:
+    def everything(self) -> list[Path]:
         """
         Every folders and files in this Directory
         """
         return list(x for x in self.source_path.glob("**/*"))
 
     @versionadded(version="3.3.0")
-    def _every_folder(self) -> List[Path]:
+    def _every_folder(self) -> list[Path]:
         """
         Every folders in this Directory
         """
         return list(x for x in self.source_path.glob("**/*") if x.is_dir())
 
     @versionadded(version="3.3.0")
-    def _every_file(self) -> List[Path]:
+    def _every_file(self) -> list[Path]:
         """
         Every folders in this Directory
         """
@@ -224,7 +224,7 @@ class DirectoryBasicOperation(DirectoryBase):
             logger.debug("Overwriting file...DONE")
 
     # Delete folder
-    def _mtime_folder(self) -> List[FileOrFolderWithModificationTime]:
+    def _mtime_folder(self) -> list[FileOrFolderWithModificationTime]:
         """
         Get modification time of file/folder (first level only)
         """
@@ -236,7 +236,7 @@ class DirectoryBasicOperation(DirectoryBase):
         ]
 
     @staticmethod
-    def _delete_files(list_of_files: List[Path]) -> None:
+    def _delete_files(list_of_files: list[Path]) -> None:
         """
         Delete files/folders
         """
@@ -316,7 +316,9 @@ class DirectoryBasicOperation(DirectoryBase):
             logger.error(f"Removing {self.source_path}...FAILED\n{e}")
 
     # Zip
-    def compress(self, *, format: str = "zip") -> Union[Path, None]:
+    def compress(
+        self, *, format: Literal["zip", "tar", "gztar", "bztar", "xztar"] = "zip"
+    ) -> Path | None:
         """
         Compress the directory (Default: Create ``.zip`` file)
 
@@ -366,7 +368,7 @@ class Directory(DirectoryBasicOperation, DirectoryTree):
     """
 
     # Directory structure
-    def _list_dir(self, *ignore: str) -> List[Path]:
+    def _list_dir(self, *ignore: str) -> list[Path]:
         """
         List all directories and files
 
@@ -395,7 +397,7 @@ class Directory(DirectoryBasicOperation, DirectoryTree):
 
     @staticmethod
     @versionadded(version="3.3.0")
-    def _split_dir(list_of_path: List[Path]) -> List[List[str]]:
+    def _split_dir(list_of_path: list[Path]) -> list[list[str]]:
         """
         Split pathname by ``os.sep``
 
@@ -421,11 +423,11 @@ class Directory(DirectoryBasicOperation, DirectoryTree):
 
     def _separate_dir_and_files(
         self,
-        list_of_path: List[Path],
+        list_of_path: list[Path],
         *,
-        tab_symbol: Optional[str] = None,
-        sub_dir_symbol: Optional[str] = None,
-    ) -> List[str]:
+        tab_symbol: str | None = None,
+        sub_dir_symbol: str | None = None,
+    ) -> list[str]:
         """
         Separate dir and file and transform into folder structure
 
@@ -453,7 +455,7 @@ class Directory(DirectoryBasicOperation, DirectoryTree):
         if not sub_dir_symbol:
             sub_dir_symbol = "|-- "
 
-        temp: List[List[str]] = self._split_dir(list_of_path)
+        temp: list[list[str]] = self._split_dir(list_of_path)
 
         return [  # Returns n-tab space with sub-dir-symbol for the last item in x
             f"{tab_symbol * (len(x) - 1)}{sub_dir_symbol}{x[-1]}" for x in temp
@@ -485,8 +487,8 @@ class Directory(DirectoryBasicOperation, DirectoryTree):
             )
         ...
         """
-        temp: List[Path] = self._list_dir(*ignore)
-        out: List[str] = self._separate_dir_and_files(temp)
+        temp: list[Path] = self._list_dir(*ignore)
+        out: list[str] = self._separate_dir_and_files(temp)
         return "\n".join(out)  # Join the list
 
     def list_structure_pkg(self) -> str:
@@ -506,7 +508,7 @@ class Directory(DirectoryBasicOperation, DirectoryTree):
 class SaveFileAs:
     """File as multiple file type"""
 
-    def __init__(self, data: Any, *, encoding: Union[str, None] = "utf-8") -> None:
+    def __init__(self, data: Any, *, encoding: str | None = "utf-8") -> None:
         """
         :param encoding: Default: utf-8
         """
@@ -519,7 +521,7 @@ class SaveFileAs:
     def __repr__(self) -> str:
         return self.__str__()
 
-    def to_txt(self, path: Union[str, Path]) -> None:
+    def to_txt(self, path: str | Path) -> None:
         """
         Save as ``.txt`` file
 

absfuyu/util/performance.py

@@ -3,8 +3,8 @@ Absfuyu: Performance
 --------------------
 Performance Check
 
-Version: 1.2.3
-Date updated: 05/04/2024 (dd/mm/yyyy)
+Version: 1.2.4
+Date updated: 15/11/2024 (dd/mm/yyyy)
 
 Feature:
 --------
@@ -33,7 +33,7 @@ import time
 import tracemalloc
 from functools import wraps
 from inspect import getsource
-from typing import Any, Callable, Dict, List, Union
+from typing import Any, Callable
 
 from deprecated.sphinx import versionadded, versionchanged
 
@@ -271,7 +271,7 @@ class Checker:
         return f"{self.__class__.__name__}({self.item_to_check})"
 
     @property
-    def name(self) -> Union[Any, None]:
+    def name(self) -> Any | None:
         """``__name__`` of variable (if any)"""
         try:
             return self.item_to_check.__name__
@@ -284,7 +284,7 @@ class Checker:
         return self.item_to_check
 
     @property
-    def docstring(self) -> Union[str, None]:
+    def docstring(self) -> str | None:
         """``__doc__`` of variable (if any)"""
         return self.item_to_check.__doc__  # type: ignore
 
@@ -299,20 +299,20 @@ class Checker:
         return id(self.item_to_check)
 
     @property
-    def dir_(self) -> List[str]:
+    def dir_(self) -> list[str]:
         """``dir()`` of variable"""
         # return self.item_to_check.__dir__()
         return ListNoDunder(self.item_to_check.__dir__())
 
     @property
-    def source(self) -> Union[str, None]:
+    def source(self) -> str | None:
         """Source code of variable (if available)"""
         try:
             return getsource(self.item_to_check)
         except Exception:
             return None
 
-    def check(self, full: bool = False) -> Dict[str, Any]:
+    def check(self, full: bool = False) -> dict[str, Any]:
         """
         Check the variable