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

absfuyu/general/data_extension.py

@@ -3,8 +3,8 @@ Absfuyu: Data extension
 -----------------------
 Extension for data type such as ``list``, ``str``, ``dict``, ...
 
-Version: 1.15.0
-Date updated: 27/04/2024 (dd/mm/yyyy)
+Version: 1.15.2
+Date updated: 06/01/2025 (dd/mm/yyyy)
 
 Features:
 ---------
@@ -47,23 +47,7 @@ import operator
 import random
 from collections import Counter
 from itertools import accumulate, chain, groupby
-from sys import version_info as _python_version
-from typing import (
-    Any,
-    Callable,
-    Dict,
-    List,
-    NamedTuple,
-    Optional,
-    Tuple,
-    TypedDict,
-    Union,
-)
-
-if _python_version.minor >= 11:
-    from typing import NotRequired, Self
-else:
-    from typing_extensions import NotRequired, Self  # type: ignore
+from typing import Any, Callable, NamedTuple, NotRequired, Self, TypedDict, Union
 
 from deprecated.sphinx import versionadded, versionchanged
 
@@ -74,7 +58,7 @@ from absfuyu.util import set_min, set_min_max
 
 # Function
 ###########################################################################
-def _dict_bool(dict_object: dict, option: bool) -> Optional[dict]:
+def _dict_bool(dict_object: dict, option: bool) -> dict | None:
     """
     Support function DictBool class
     """
@@ -93,7 +77,7 @@ def _dict_bool(dict_object: dict, option: bool) -> Optional[dict]:
 class Pow:
     """Number power by a number"""
 
-    def __init__(self, number: Union[int, float], power_by: Union[int, float]) -> None:
+    def __init__(self, number: int | float, power_by: int | float) -> None:
         self.number = number
         self.power_by = power_by
 
@@ -107,7 +91,7 @@ class Pow:
     def __repr__(self) -> str:
         return self.__str__()
 
-    def to_list(self) -> List[Union[int, float]]:
+    def to_list(self) -> list[int | float]:
         """
         Convert into list
 
@@ -132,7 +116,7 @@ class ListREPR(list):
         return _compress_list_for_print(self, 9)
 
 
-class ListNoDunder(List[str]):
+class ListNoDunder(list[str]):
     """Use with ``object.__dir__()``"""
 
     def __repr__(self) -> str:
@@ -140,7 +124,7 @@ class ListNoDunder(List[str]):
         return out.__repr__()
 
 
-class DictBoolTrue(Dict[Any, bool]):
+class DictBoolTrue(dict[Any, bool]):
     """Only show items when ``values == True`` in ``__repr__()``"""
 
     def __repr__(self) -> str:
@@ -148,7 +132,7 @@ class DictBoolTrue(Dict[Any, bool]):
         return _dict_bool(temp, True).__repr__()
 
 
-class DictBoolFalse(Dict[Any, bool]):
+class DictBoolFalse(dict[Any, bool]):
     """Only show items when ``values == False`` in ``__repr__()``"""
 
     def __repr__(self) -> str:
@@ -206,8 +190,8 @@ class DictAnalyzeResult(NamedTuple):
     Result for ``DictExt.analyze()``
     """
 
-    max_value: Union[int, float]
-    min_value: Union[int, float]
+    max_value: int | float
+    min_value: int | float
     max_list: list
     min_list: list
 
@@ -220,7 +204,7 @@ class Text(str):
     ``str`` extension
     """
 
-    def divide(self, string_split_size: int = 60) -> List[str]:
+    def divide(self, string_split_size: int = 60) -> list[str]:
         """
         Divide long string into smaller size
 
@@ -255,8 +239,8 @@ class Text(str):
         self,
         split_size: int = 60,
         split_var_len: int = 12,
-        custom_var_name: Optional[str] = None,
-    ) -> List[str]:
+        custom_var_name: str | None = None,
+    ) -> list[str]:
         """
         Divide long string into smaller size,
         then assign a random variable to splited
@@ -546,7 +530,7 @@ class Text(str):
                 temp[i] = x.upper()
         return self.__class__("".join(temp))
 
-    def to_list(self) -> List[str]:
+    def to_list(self) -> list[str]:
         """
         Convert into list
 
@@ -625,7 +609,7 @@ class Text(str):
         return sum(out)
 
     @versionadded(version="3.3.0")
-    def hapax(self, strict: bool = False) -> List[str]:
+    def hapax(self, strict: bool = False) -> list[str]:
         """
         A hapax legomenon (often abbreviated to hapax)
         is a word which occurs only once in either
@@ -656,9 +640,9 @@ class Text(str):
         >>> test.hapax(strict=True)
         ['b']
         """
-        word_list: List[str] = self.lower().split()
+        word_list: list[str] = self.lower().split()
         if strict:
-            remove_characters: List[str] = list(r"\"'.,:;|()[]{}\/!@#$%^&*-_=+?<>`~")
+            remove_characters: list[str] = list(r"\"'.,:;|()[]{}\/!@#$%^&*-_=+?<>`~")
             temp = str(self)
             for x in remove_characters:
                 temp = temp.replace(x, "")
@@ -845,7 +829,7 @@ class IntNumber(int):
 
         else:
             # Faster way to check
-            perfect_number_index: List[int] = [
+            perfect_number_index: list[int] = [
                 61,
                 89,
                 107,
@@ -982,7 +966,7 @@ class IntNumber(int):
         return self.is_palindromic() and self.is_prime()
 
     # calculation stuff
-    @versionchanged(version="3.3.0", reason="Fix bug")
+    @versionchanged(version="4.0.0", reason="Update")
     def lcm(self, with_number: int) -> Self:
         """
         Least common multiple of ``self`` and ``with_number``
@@ -1004,10 +988,7 @@ class IntNumber(int):
         >>> test.lcm(5)
         510
         """
-        try:
-            return self.__class__(math.lcm(self, with_number))
-        except AttributeError:  # Python < 3.9
-            return self.__class__((self * with_number) // math.gcd(self, with_number))
+        return self.__class__(math.lcm(self, with_number))
 
     @versionchanged(version="3.3.0", reason="Fix bug")
     def gcd(self, with_number: int) -> Self:
@@ -1072,7 +1053,7 @@ class IntNumber(int):
             logger.debug(f"Sum after loop: {number}")
         return self.__class__(number)
 
-    def divisible_list(self, short_form: bool = True) -> List[int]:
+    def divisible_list(self, short_form: bool = True) -> list[int]:
         """
         A list of divisible number
 
@@ -1106,7 +1087,7 @@ class IntNumber(int):
             # return ListREPR(divi_list) ## FIX LATER
         return divi_list
 
-    def prime_factor(self, short_form: bool = True) -> Union[List[int], List[Pow]]:
+    def prime_factor(self, short_form: bool = True) -> Union[list[int], list[Pow]]:
         """
         Prime factor
 
@@ -1156,7 +1137,7 @@ class IntNumber(int):
         return factors
 
     # analyze
-    def analyze(self, short_form: bool = True) -> Dict[str, Dict[str, Any]]:
+    def analyze(self, short_form: bool = True) -> dict[str, dict[str, Any]]:
         """
         Analyze the number with almost all ``IntNumber`` method
 
@@ -1236,7 +1217,7 @@ class ListExt(list):
         >>> test.stringify()
         ['1', '1', '1', '2', '2', '3']
         """
-        return ListExt(map(str, self))
+        return self.__class__(map(str, self))
 
     def head(self, number_of_items: int = 5) -> list:
         """
@@ -1318,9 +1299,9 @@ class ListExt(list):
     def freq(
         self,
         sort: bool = False,
-        num_of_first_char: Optional[int] = None,
+        num_of_first_char: int | None = None,
         appear_increment: bool = False,
-    ) -> Union[dict, List[int]]:
+    ) -> Union[dict, list[int]]:
         """
         Find frequency of each item in list
 
@@ -1383,7 +1364,7 @@ class ListExt(list):
         logger.debug(times_appear)
 
         if appear_increment:
-            times_appear_increment: List[int] = list(
+            times_appear_increment: list[int] = list(
                 accumulate(times_appear.values(), operator.add)
             )
             logger.debug(times_appear_increment)
@@ -1391,7 +1372,7 @@ class ListExt(list):
         else:
             return times_appear
 
-    def slice_points(self, points: list) -> List[list]:
+    def slice_points(self, points: list) -> list[list]:
         """
         Slices a list at specific indices into constituent lists.
 
@@ -1474,7 +1455,7 @@ class ListExt(list):
         >>> test.len_items()
         [3, 3, 5]
         """
-        out = ListExt([len(str(x)) for x in self])
+        out = self.__class__([len(str(x)) for x in self])
         # out = ListExt(map(lambda x: len(str(x)), self))
         logger.debug(out)
         return out
@@ -1566,13 +1547,13 @@ class ListExt(list):
         return self.__class__([list(g) for _, g in temp])
 
     @staticmethod
-    def _group_by_unique(iterable: list) -> List[list]:
+    def _group_by_unique(iterable: list) -> list[list]:
         """
         Static method for ``group_by_unique``
         """
         return list([list(g) for _, g in groupby(iterable)])
 
-    def group_by_pair_value(self, max_loop: int = 3) -> List[list]:
+    def group_by_pair_value(self, max_loop: int = 3) -> list[list]:
         """
         Assume each ``list`` in ``list`` is a pair value,
         returns a ``list`` contain all paired value
@@ -1607,7 +1588,7 @@ class ListExt(list):
 
         # Init loop
         for _ in range(int(set_min(max_loop, min_value=3))):
-            temp: Dict[Any, list] = {}
+            temp: dict[Any, list] = {}
             # Make dict{key: all `item` that contains `key`}
             for item in iter:
                 for x in item:
@@ -1641,10 +1622,10 @@ class ListExt(list):
         ['test', 'test', 'test', 'test']
         """
         try:
-            return ListExt(chain(*self))
+            return self.__class__(chain(*self))
         except Exception:
             temp = list(map(lambda x: x if isinstance(x, list) else [x], self))
-            return ListExt(chain(*temp))
+            return self.__class__(chain(*temp))
 
     def numbering(self, start: int = 0) -> Self:
         """
@@ -1670,10 +1651,10 @@ class ListExt(list):
         [(0, 9), (1, 9), (2, 9)]
         """
         start = int(set_min(start, min_value=0))
-        return ListExt(enumerate(self, start=start))
+        return self.__class__(enumerate(self, start=start))
 
     @staticmethod
-    def _numbering(iterable: list, start: int = 0) -> List[Tuple[int, Any]]:
+    def _numbering(iterable: list, start: int = 0) -> list[tuple[int, Any]]:
         """
         Static method for ``numbering``
         """
@@ -1717,8 +1698,8 @@ class DictExt(dict):
         try:
             dct: dict = self.copy()
 
-            max_val: Union[int, float] = max(list(dct.values()))
-            min_val: Union[int, float] = min(list(dct.values()))
+            max_val: int | float = max(list(dct.values()))
+            min_val: int | float = min(list(dct.values()))
             max_list = []
             min_list = []
 
@@ -1798,8 +1779,8 @@ class DictExt(dict):
     @versionadded(version="3.4.0")
     def aggregate(
         self,
-        other_dict: Dict[Any, Union[int, float]],
-        default_value: Union[int, float] = 0,
+        other_dict: dict[Any, int | float],
+        default_value: int | float = 0,
     ) -> Self:
         """Dict with value type int or float"""
         out = {

absfuyu/pkg_data/__init__.py

@@ -3,8 +3,8 @@ Absfuyu: Package data
 ---------------------
 Load package data
 
-Version: 2.2.2
-Date updated: 30/11/2023 (dd/mm/yyyy)
+Version: 2.2.3
+Date updated: 14/11/2024 (dd/mm/yyyy)
 """
 
 # Module level
@@ -16,18 +16,8 @@ __all__ = ["PkgData"]
 ###########################################################################
 import zlib
 from ast import literal_eval
-from importlib.resources import read_binary
+from importlib.resources import files, read_binary
 from pathlib import Path
-from sys import version_info as _python_version
-from typing import List, Union
-
-if _python_version.minor >= 10:
-    from importlib.resources import files
-else:
-    try:
-        from importlib_resources import files  # type: ignore
-    except Exception:
-        raise ImportError("Please install importlib-resources")  # noqa: B904
 
 from absfuyu.core import DATA_PATH
 from absfuyu.logger import logger
@@ -61,7 +51,7 @@ class PkgData:
     def __repr__(self) -> str:
         return self.__str__()
 
-    def _make_dat(self, data: str, name: Union[str, Path]):
+    def _make_dat(self, data: str, name: str | Path):
         """
         data: string data
         name: name and location of the data
@@ -90,14 +80,14 @@ class PkgData:
 
         :param new_data: Data to be updated
         """
-        self._make_dat(data=new_data, name=DATA_PATH.joinpath(self.name))
+        self._make_dat(data=new_data, name=DATA_PATH.joinpath(self.name))  # type:ignore
         logger.debug("Data updated")
 
 
 class _ManagePkgData:
     """Manage this package data"""
 
-    def __init__(self, pkg_data_loc: Union[str, Path]) -> None:
+    def __init__(self, pkg_data_loc: str | Path) -> None:
         """
         pkg_data_loc: Package data location
         """
@@ -109,7 +99,7 @@ class _ManagePkgData:
     def __repr__(self) -> str:
         return self.__str__()
 
-    def get_data_list(self, *, pattern: str = "*") -> List[Path]:
+    def get_data_list(self, *, pattern: str = "*") -> list[Path]:
         """Get a list of data available"""
         excludes = [
             x for x in self.data_loc.glob("*.[pP][yY]")
@@ -119,7 +109,7 @@ class _ManagePkgData:
         ]
 
     @property
-    def data_list(self) -> List[str]:
+    def data_list(self) -> list[str]:
         """List of available data"""
         return [x.name for x in self.get_data_list()]
 
@@ -135,7 +125,10 @@ class _ManagePkgData:
             for data_name, data_link in _EXTERNAL_DATA.items():
                 logger.debug(f"Downloading {data_name}...")
                 data = APIRequest(data_link, encoding="utf-8")
-                data.fetch_data(update=True, json_cache=DATA_PATH.joinpath(data_name))
+                data.fetch_data(
+                    update=True,
+                    json_cache=DATA_PATH.joinpath(data_name),  # type:ignore
+                )
                 logger.debug(f"Downloading {data_name}...DONE")
             logger.debug("Downloading data...DONE")
         except Exception:
@@ -147,7 +140,7 @@ class _ManagePkgData:
             x.unlink()
 
 
-PACKAGE_DATA = _ManagePkgData(DATA_PATH)
+PACKAGE_DATA = _ManagePkgData(DATA_PATH)  # type:ignore
 
 
 # Run

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.2.3
+Date updated: 25/11/2024 (dd/mm/yyyy)
 
 Feature:
 --------
@@ -25,7 +25,6 @@ import math
 import re
 import string
 from itertools import chain, combinations
-from typing import Dict, List, Union
 
 from absfuyu.core import CLITextColor
 from absfuyu.logger import logger
@@ -74,7 +73,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 +87,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 +113,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 +135,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 +162,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 +218,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/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