absfuyu 4.0.0__tar.gz → 4.1.1__tar.gz

{absfuyu-4.0.0 → absfuyu-4.1.1}/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2022-2024 AbsoluteWinter
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2022-2025 AbsoluteWinter
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

{absfuyu-4.0.0 → absfuyu-4.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: absfuyu
-Version: 4.0.0
+Version: 4.1.1
 Summary: A small collection of code
 Project-URL: Homepage, https://github.com/AbsoluteWinter/absfuyu-public
 Project-URL: Documentation, https://absolutewinter.github.io/absfuyu-docs/
@@ -46,6 +46,7 @@ Requires-Dist: absfuyu-res; extra == 'full'
 Requires-Dist: numpy; extra == 'full'
 Requires-Dist: pandas; extra == 'full'
 Requires-Dist: rich; extra == 'full'
+Requires-Dist: tqdm; extra == 'full'
 Provides-Extra: res
 Requires-Dist: absfuyu-res; extra == 'res'
 Description-Content-Type: text/markdown

{absfuyu-4.0.0 → absfuyu-4.1.1}/pyproject.toml

@@ -5,7 +5,7 @@
 # 4. Build package (hatch build)
 # 5. Generating docs (hatch run docs:build)
 # 6. Publish packge (hatch publish)
-## Run entire workflow: hatch run workflow:perform
+## Run entire workflow: hatch run workflow:<major | minor | patch>
 ## `hatch env show` for more information
 
 # MARK: BUILD ====================
@@ -60,7 +60,7 @@ Issues = "https://github.com/AbsoluteWinter/absfuyu-public/issues"
 
 [project.optional-dependencies]
 res = ["absfuyu-res"]
-full = ["absfuyu-res", "numpy", "pandas", "rich"]
+full = ["absfuyu-res", "numpy", "pandas", "rich", "tqdm"]
 beautiful = ["rich"]
 extra = ["numpy", "pandas"]
 dev = ["hatch", "pytest"]
@@ -171,12 +171,12 @@ detached = true
 skip-install = true
 description = """
 Package workflow:
-hatch run workflow:perform
+hatch run workflow:<option>
 
-Note:
-- perform: bump version patch
-- perform2: bump version minor
-- perform3: bump version major
+Options:
+- patch: release version patch
+- minor: release version minor
+- major: release version major
 """
 
 [tool.hatch.envs.workflow.scripts]
@@ -186,25 +186,54 @@ test = [
     "hatch run all:test",    # Test
 ]
 build = [
+    # Update license year - Convert to hex due to unable to run multiple lines
+    # Source code:
+    # import re;from datetime import datetime;from pathlib import Path
+    # print("Updating license year...");p=r"([12]\d{3})(-[12]\d{3})?"
+    # n=str(datetime.now().year);l=list(Path.cwd().glob("*license*"))[0]
+    # with open(l)as f:c=f.readlines()
+    # for i,x in enumerate(c):
+    #     s=re.search(p,x);y=s.groups()[0]if s else n
+    #     if y!=n:c[i]=re.sub(p,f"{y}-{n}",x)
+    # with open(l,"w",encoding="utf-8")as f:f.writelines(c)
+    # print("License year updated")
+    """
+    python -c \"exec(bytes.fromhex('696d706f72742072653b66726f6d20646174657\
+    4696d6520696d706f7274206461746574696d653b66726f6d20706174686c696220696d\
+    706f727420506174680a7072696e7428225570646174696e67206c6963656e736520796\
+    561722e2e2e22293b703d7222285b31325d5c647b337d29282d5b31325d5c647b337d29\
+    3f220a6e3d737472286461746574696d652e6e6f7728292e79656172293b6c3d6c69737\
+    428506174682e63776428292e676c6f6228222a6c6963656e73652a2229295b305d0a77\
+    697468206f70656e286c29617320663a633d662e726561646c696e657328290a666f722\
+    0692c7820696e20656e756d65726174652863293a0a20202020733d72652e7365617263\
+    6828702c78293b793d732e67726f75707328295b305d6966207320656c7365206e0a202\
+    0202069662079213d6e3a635b695d3d72652e73756228702c66227b797d2d7b6e7d222c\
+    78290a77697468206f70656e286c2c2277222c656e636f64696e673d227574662d38222\
+    9617320663a662e77726974656c696e65732863290a7072696e7428224c6963656e7365\
+    207965617220757064617465642229').decode('utf-8'))\"
+    """,
+    # "python support_scripts/update_license_year.py", # Update license year
     "hatch clean",          # Clean dist/ folder
     "hatch -v build",       # Build package
     "hatch run docs:build", # Build docs
-    "hatch publish",        # Publish
 ]
-perform = [
+patch = [
     "test",
     "hatch version patch", # Bump version patch
     "build",
+    "hatch publish",       # Publish
 ]
-perform2 = [
+minor = [
     "test",
     "hatch version minor", # Bump version minor
     "build",
+    "hatch publish",       # Publish
 ]
-perform3 = [
+major = [
     "test",
     "hatch version major", # Bump version major
     "build",
+    "hatch publish",       # Publish
 ]
 
 # MARK: TOOL: pytest
@@ -223,7 +252,7 @@ markers = [ # pytest -m <marker> -v
 
 # MARK: TOOL: mypy
 [tool.mypy]
-# python_version = "3.8"
+python_version = "3.11"
 mypy_path = "src"
 check_untyped_defs = true
 # disallow_any_generics = true
@@ -279,6 +308,7 @@ ignore = [
 "tests/*" = [
     "F401", # imported but unused
 ]
+"shorten_number.py" = ["B007"] # Loop control variable not used within loop body
 
 # MARK: TOOL: black
 [tool.black]

{absfuyu-4.0.0 → absfuyu-4.1.1}/src/absfuyu/__init__.py

@@ -22,7 +22,7 @@ Using in cmd (`absfuyu[cli]` required):
 __title__ = "absfuyu"
 __author__ = "AbsoluteWinter"
 __license__ = "MIT License"
-__version__ = "4.0.0"
+__version__ = "4.1.1"
 __all__ = [
     "core",
     "config",

{absfuyu-4.0.0 → absfuyu-4.1.1}/src/absfuyu/cli/do_group.py

@@ -3,13 +3,14 @@ ABSFUYU CLI
 -----------
 Do
 
-Version: 1.2.0
-Date updated: 07/01/2025 (dd/mm/yyyy)
+Version: 1.3.1
+Date updated: 01/02/2025 (dd/mm/yyyy)
 """
 
 __all__ = ["do_group"]
 
 import subprocess
+from typing import Literal
 
 import click
 
@@ -17,6 +18,7 @@ from absfuyu import __title__
 from absfuyu.cli.color import COLOR
 from absfuyu.core import __package_feature__
 from absfuyu.general.human import Human2
+from absfuyu.tools.checksum import Checksum
 from absfuyu.util.zipped import Zipper
 from absfuyu.version import PkgVersion
 
@@ -96,6 +98,63 @@ def unzip_files_in_dir(dir: str) -> None:
     print("Done")
 
 
+@click.command(name="checksum")
+@click.argument("file_path", type=str)
+@click.option(
+    "--hashmode",
+    "-m",
+    "hash_mode",
+    type=click.Choice(["md5", "sha1", "sha256", "sha512"]),
+    default="sha256",
+    show_default=True,
+    help="Hash mode",
+)
+@click.option(
+    "--save-result",
+    "-s",
+    "save_result",
+    type=bool,
+    default=False,
+    is_flag=True,
+    show_default=True,
+    help="Save checksum result to file",
+)
+@click.option(
+    "--recursive",
+    "-r",
+    "recursive_mode",
+    type=bool,
+    default=False,
+    is_flag=True,
+    show_default=True,
+    help="Do checksum for every file in the folder (including child folder)",
+)
+@click.option(
+    "--compare",
+    "-c",
+    "hash_to_compare",
+    type=str,
+    default=None,
+    show_default=True,
+    help="Hash to compare",
+)
+def file_checksum(
+    file_path: str,
+    hash_mode: str | Literal["md5", "sha1", "sha256", "sha512"],
+    save_result: bool,
+    recursive_mode: bool,
+    hash_to_compare: str,
+) -> None:
+    """Checksum for file"""
+    # print(hash_mode, save_result, recursive_mode)
+    instance = Checksum(file_path, hash_mode=hash_mode, save_result_to_file=save_result)
+    res = instance.checksum(recursive=recursive_mode)
+    if hash_to_compare:
+        print(res == hash_to_compare)
+    else:
+        print(res)
+
+
 @click.group(name="do")
 def do_group() -> None:
     """Perform functionalities"""
@@ -108,3 +167,4 @@ do_group.add_command(advice)
 do_group.add_command(fs)
 do_group.add_command(info)
 do_group.add_command(unzip_files_in_dir)
+do_group.add_command(file_checksum)

{absfuyu-4.0.0 → absfuyu-4.1.1}/src/absfuyu/core.py

@@ -3,8 +3,8 @@ Absfuyu: Core
 -------------
 Contain type hints and other stuffs
 
-Version: 2.2.1
-Date updated: 14/11/2024 (dd/mm/yyyy)
+Version: 2.3.1
+Date updated: 01/02/2025 (dd/mm/yyyy)
 """
 
 # Module Package
@@ -21,6 +21,9 @@ __all__ = [
 __package_feature__ = ["beautiful", "extra", "res", "full", "dev"]
 
 
+# Library
+###########################################################################
+from importlib import import_module
 from importlib.resources import files
 
 
@@ -43,3 +46,12 @@ class CLITextColor:
 CORE_PATH = files("absfuyu")
 CONFIG_PATH = CORE_PATH.joinpath("config", "config.json")
 DATA_PATH = CORE_PATH.joinpath("pkg_data")
+
+
+# tqdm wrapper
+try:
+    tqdm = import_module("tqdm").tqdm
+except ModuleNotFoundError:
+
+    def tqdm(iterable, **kwargs):
+        return iterable

{absfuyu-4.0.0 → absfuyu-4.1.1}/src/absfuyu/game/__init__.py

@@ -82,7 +82,7 @@ def game_escapeLoop() -> None:
                 print(x)
             stop_time = time.time()
             break
-    print(f"= Escaped in {stop_time-start_time:,.2f}s =")
+    print(f"= Escaped in {stop_time - start_time:,.2f}s =")
 
 
 # Rock Paper Scissors

{absfuyu-4.0.0 → absfuyu-4.1.1}/src/absfuyu/game/game_stat.py

@@ -26,7 +26,7 @@ class GameStats:
     def _update_win_rate(self) -> None:
         try:
             self._win_rate = self.win / (self.win + self.draw + self.lose)
-            self.win_rate = f"{self._win_rate*100:,.2f}%"
+            self.win_rate = f"{self._win_rate * 100:,.2f}%"
         except ZeroDivisionError:
             self._win_rate = 0
             self.win_rate = "N/A"

{absfuyu-4.0.0 → absfuyu-4.1.1}/src/absfuyu/general/content.py

@@ -427,12 +427,12 @@ class ContentLoader:
             self.tag_dictionary = tag_dictionary
 
         # symbol stuff
-        assert (
-            comment_symbol != split_symbol
-        ), "comment_symbol and split_symbol should have different values"
-        assert (
-            tag_separate_symbol != split_symbol
-        ), "tag_separate_symbol and split_symbol should have different values"
+        assert comment_symbol != split_symbol, (
+            "comment_symbol and split_symbol should have different values"
+        )
+        assert tag_separate_symbol != split_symbol, (
+            "tag_separate_symbol and split_symbol should have different values"
+        )
         self.comment_symbol: str = comment_symbol
         self.split_symbol: str = split_symbol
         self.tag_separate_symbol: str = tag_separate_symbol
@@ -485,7 +485,7 @@ class ContentLoader:
                 if x.startswith(self.comment_symbol) or len(x) == 0:
                     continue  # skip comment and empty lines
                 logger.debug(
-                    f"### Loop {i+1} #####################################################################"
+                    f"### Loop {i + 1} #####################################################################"
                 )
 
                 temp = x.split(self.split_symbol)

{absfuyu-4.0.0 → absfuyu-4.1.1}/src/absfuyu/general/data_extension.py

@@ -302,7 +302,7 @@ class Text(str):
                 output.append(f"{splt_name[i]}='{temp[i]}'")
         else:
             for i in range(splt_len):
-                output.append(f"{custom_var_name}{i+1}='{temp[i]}'")
+                output.append(f"{custom_var_name}{i + 1}='{temp[i]}'")
 
         # joined variable
         temp = []
@@ -319,9 +319,9 @@ class Text(str):
                 if i == 0:
                     temp.append(f"{custom_var_name}=")
                 if i == splt_len - 1:
-                    temp.append(f"{custom_var_name}{i+1}")
+                    temp.append(f"{custom_var_name}{i + 1}")
                 else:
-                    temp.append(f"{custom_var_name}{i+1}+")
+                    temp.append(f"{custom_var_name}{i + 1}+")
 
         output.append("".join(temp))
         if custom_var_name is None:

{absfuyu-4.0.0 → absfuyu-4.1.1}/src/absfuyu/general/generator.py

@@ -156,7 +156,9 @@ class Generator:
 
         while count < times:
             s = "".join(choice(char_lst) for _ in range(size))
-            logger.debug(f"Time generated: {count+1}. Remaining: {times-count-1}. {s}")
+            logger.debug(
+                f"Time generated: {count + 1}. Remaining: {times - count - 1}. {s}"
+            )
             if not unique:
                 unique_string.append(s)
                 count += 1
@@ -274,7 +276,7 @@ class Generator:
                 if num[i] >= 10:  # type: ignore
                     num[i] -= 9  # type: ignore
             sum += num[i]  # type: ignore
-            logger.debug(f"Loop {i+1}: {num[i]}, {sum}")
+            logger.debug(f"Loop {i + 1}: {num[i]}, {sum}")
 
         out = (10 - (sum % 10)) % 10
         logger.debug(f"Output: {out}")

{absfuyu-4.0.0 → absfuyu-4.1.1}/src/absfuyu/logger.py

@@ -100,7 +100,7 @@ def _compress_list_for_print(iterable: list, max_visible: Optional[int] = 5) ->
         # temp = [iterable[:cut_idx_1], ["..."], iterable[len(iterable)-cut_idx_2:]]
         # out = list(chain.from_iterable(temp))
         # out = [*iterable[:cut_idx_1], "...", *iterable[len(iterable)-cut_idx_2:]] # Version 2
-        out = f"{str(iterable[:cut_idx_1])[:-1]}, ...,{str(iterable[len(iterable)-cut_idx_2:])[1:]}"  # Version 3
+        out = f"{str(iterable[:cut_idx_1])[:-1]}, ...,{str(iterable[len(iterable) - cut_idx_2 :])[1:]}"  # Version 3
         # logger.debug(out)
         return f"{out} [Len: {len(iterable)}]"
 
@@ -123,7 +123,7 @@ def _compress_string_for_print(text: str, max_visible: Optional[int] = 120) -> s
         return str(text)
     else:
         cut_idx = math.floor((max_visible - 3) / 2)
-        temp = f"{text[:cut_idx]}...{text[len(text)-cut_idx:]}"
+        temp = f"{text[:cut_idx]}...{text[len(text) - cut_idx :]}"
         return f"{temp} [Len: {len(text)}]"
 
 

absfuyu-4.1.1/src/absfuyu/tools/checksum.py

@@ -0,0 +1,143 @@
+"""
+Absufyu: Checksum
+-----------------
+Check MD5, SHA256, ...
+
+Version: 1.1.0
+Date updated: 01/02/2025 (dd/mm/yyyy)
+"""
+
+# Module level
+###########################################################################
+__all__ = ["Checksum", "checksum_operation"]
+
+
+# Library
+###########################################################################
+import hashlib
+from pathlib import Path
+from typing import Literal
+
+from absfuyu.core import tqdm
+
+# Function
+###########################################################################
+
+
+# Deprecated
+def checksum_operation(
+    file: Path | str,
+    hash_mode: str | Literal["md5", "sha1", "sha256", "sha512"] = "sha256",
+) -> str:
+    """This performs checksum"""
+    if hash_mode.lower() == "md5":
+        hash_engine = hashlib.md5()
+    elif hash_mode.lower() == "sha1":
+        hash_engine = hashlib.sha1()
+    elif hash_mode.lower() == "sha256":
+        hash_engine = hashlib.sha256()
+    elif hash_mode.lower() == "sha512":
+        hash_engine = hashlib.sha512()
+    else:
+        hash_engine = hashlib.md5()
+
+    with open(Path(file), "rb") as f:
+        while True:
+            data = f.read(4096)
+            if len(data) == 0:
+                break
+            else:
+                hash_engine.update(data)
+    return hash_engine.hexdigest()
+
+
+class Checksum:
+    def __init__(
+        self,
+        path: str | Path,
+        hash_mode: str | Literal["md5", "sha1", "sha256", "sha512"] = "sha256",
+        save_result_to_file: bool = False,
+    ) -> None:
+        self.path = Path(path)
+        self.hash_mode = hash_mode
+        self.save_result_to_file = save_result_to_file
+        self.checksum_result_file_name = "checksum_results.txt"
+
+    def _get_hash_engine(self):
+        hash_mode = self.hash_mode
+        if hash_mode.lower() == "md5":
+            hash_engine = hashlib.md5()
+        elif hash_mode.lower() == "sha1":
+            hash_engine = hashlib.sha1()
+        elif hash_mode.lower() == "sha256":
+            hash_engine = hashlib.sha256()
+        elif hash_mode.lower() == "sha512":
+            hash_engine = hashlib.sha512()
+        else:
+            hash_engine = hashlib.md5()
+        return hash_engine
+
+    def _checksum_operation(
+        self,
+        file: Path | str,
+    ) -> str:
+        """This performs checksum"""
+
+        hash_engine = self._get_hash_engine().copy()
+        with open(Path(file), "rb") as f:
+            # Read and hash the file in 4K chunks. Reading the whole
+            # file at once might consume a lot of memory if it is
+            # large.
+            while True:
+                data = f.read(4096)
+                if len(data) == 0:
+                    break
+                else:
+                    hash_engine.update(data)
+        return hash_engine.hexdigest()  # type: ignore
+
+    def checksum(self, recursive: bool = True) -> str:
+        """Perform checksum
+
+        Parameters
+        ----------
+        recursive : bool, optional
+            Do checksum for every file in the folder (including child folder), by default True
+
+        Returns
+        -------
+        str
+            Checksum hash
+        """
+        if self.path.absolute().is_dir():
+            new_path = self.path.joinpath(self.checksum_result_file_name)
+            # List of files
+            if recursive:
+                file_list: list[Path] = [
+                    x for x in self.path.glob("**/*") if x.is_file()
+                ]
+            else:
+                file_list = [x for x in self.path.glob("*") if x.is_file()]
+
+            # Checksum
+            res = []
+            for x in tqdm(file_list, desc="Calculating hash", unit_scale=True):
+                name = x.relative_to(self.path)
+                res.append(f"{self._checksum_operation(x)} | {name}")
+            output = "\n".join(res)
+        else:
+            new_path = self.path.with_name(self.checksum_result_file_name)
+            output = self._checksum_operation(self.path)
+
+        # Save result
+        if self.save_result_to_file:
+            with open(new_path, "w", encoding="utf-8") as f:
+                f.write(output)
+
+        return output
+
+
+# Run
+###########################################################################
+if __name__ == "__main__":
+    pass

{absfuyu-4.0.0 → absfuyu-4.1.1}/src/absfuyu/tools/converter.py

@@ -3,8 +3,8 @@ Absufyu: Converter
 ------------------
 Convert stuff
 
-Version: 1.2.3
-Date updated: 25/11/2024 (dd/mm/yyyy)
+Version: 1.3.0
+Date updated: 01/02/2025 (dd/mm/yyyy)
 
 Feature:
 --------
@@ -25,6 +25,7 @@ import math
 import re
 import string
 from itertools import chain, combinations
+from pathlib import Path
 
 from absfuyu.core import CLITextColor
 from absfuyu.logger import logger
@@ -48,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"""

{absfuyu-4.0.0 → absfuyu-4.1.1}/src/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))