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

absfuyu/__init__.py

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

absfuyu/cli/__init__.py

@@ -3,8 +3,8 @@ ABSFUYU
 -------
 COMMAND LINE INTERFACE
 
-Version: 1.0.0
-Date updated: 14/04/2024 (dd/mm/yyyy)
+Version: 1.1.0
+Date updated: 09/02/2025 (dd/mm/yyyy)
 """
 
 __all__ = ["cli"]
@@ -19,6 +19,7 @@ from absfuyu.cli.color import COLOR
 from absfuyu.cli.config_group import config_group
 from absfuyu.cli.do_group import do_group
 from absfuyu.cli.game_group import game_group
+from absfuyu.cli.tool_group import tool_group
 
 # Color stuff
 colorama.init(autoreset=True)
@@ -48,4 +49,5 @@ def cli() -> None:
 cli.add_command(config_group)
 cli.add_command(do_group)
 cli.add_command(game_group)
+cli.add_command(tool_group)
 cli.add_command(version)

absfuyu/cli/do_group.py

@@ -3,14 +3,13 @@ ABSFUYU CLI
 -----------
 Do
 
-Version: 1.3.0
-Date updated: 01/02/2025 (dd/mm/yyyy)
+Version: 1.4.0
+Date updated: 07/02/2025 (dd/mm/yyyy)
 """
 
 __all__ = ["do_group"]
 
 import subprocess
-from typing import Literal
 
 import click
 
@@ -18,7 +17,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_operation
+from absfuyu.tools.shutdownizer import ShutDownizer
 from absfuyu.util.zipped import Zipper
 from absfuyu.version import PkgVersion
 
@@ -82,7 +81,11 @@ def fs(date: str, number_string: str) -> None:
 @click.command(name="info")
 @click.argument("date", type=str)
 def info(date: str) -> None:
-    """Day info"""
+    """
+    Day info, format: yyyymmdd
+
+    Remake this
+    """
 
     instance = Human2(date)
     print(instance.info())
@@ -98,38 +101,11 @@ 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(
-    "--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"],
-    hash_to_compare: str,
-) -> None:
-    """Checksum for file"""
-
-    res = checksum_operation(file_path, hash_mode=hash_mode)
-    if hash_to_compare:
-        print(res == hash_to_compare)
-    else:
-        print(res)
+@click.command(name="shutdown")
+def os_shutdown() -> None:
+    """Shutdown"""
+    engine = ShutDownizer()
+    engine.shutdown()
 
 
 @click.group(name="do")
@@ -144,4 +120,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)
+do_group.add_command(os_shutdown)

absfuyu/cli/tool_group.py

@@ -0,0 +1,136 @@
+"""
+ABSFUYU CLI
+-----------
+Tool
+
+Version: 1.0.0
+Date updated: 10/02/2025 (dd/mm/yyyy)
+"""
+
+__all__ = ["tool_group"]
+
+from typing import Literal
+
+import click
+
+from absfuyu.tools.checksum import Checksum
+from absfuyu.tools.converter import Base64EncodeDecode, Text2Chemistry
+
+
+@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/directory"""
+    # 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.command(name="t2c")
+@click.argument("text", type=str)
+def text2chem(text: str) -> None:
+    """Convert text into chemistry symbol"""
+    engine = Text2Chemistry()
+    out = engine.convert(text)
+    print(Text2Chemistry.beautify_result(out))
+
+
+@click.command(name="e")
+@click.argument("text", type=str)
+def base64encode(text: str) -> None:
+    """Convert text to base64"""
+    print(Base64EncodeDecode.encode(text))
+
+
+@click.command(name="d")
+@click.argument("text", type=str)
+def base64decode(text: str) -> None:
+    """Convert base64 to text"""
+    print(Base64EncodeDecode.decode(text))
+
+
+@click.command(name="img")
+@click.option(
+    "--data-tag",
+    "-d",
+    "data_tag",
+    type=bool,
+    default=False,
+    is_flag=True,
+    show_default=True,
+    help="Add data tag before base64 string",
+)
+@click.argument("img_path", type=str)
+def base64convert_img(img_path: str, data_tag: bool) -> None:
+    """Convert img to base64"""
+    print(Base64EncodeDecode.encode_image(img_path, data_tag=data_tag))
+
+
+@click.group(name="b64")
+def base64_group():
+    """Base64 encode decode"""
+    pass
+
+
+base64_group.add_command(base64encode)
+base64_group.add_command(base64decode)
+base64_group.add_command(base64convert_img)
+
+
+@click.group(name="tool")
+def tool_group() -> None:
+    """Tools"""
+    pass
+
+
+tool_group.add_command(file_checksum)
+tool_group.add_command(base64_group)
+tool_group.add_command(text2chem)

absfuyu/core.py

@@ -3,8 +3,8 @@ Absfuyu: Core
 -------------
 Contain type hints and other stuffs
 
-Version: 2.3.0
-Date updated: 01/02/2025 (dd/mm/yyyy)
+Version: 2.3.2
+Date updated: 11/02/2025 (dd/mm/yyyy)
 """
 
 # Module Package
@@ -18,14 +18,13 @@ __all__ = [
     "DATA_PATH",
 ]
 
-__package_feature__ = ["beautiful", "extra", "res", "full", "dev"]
+__package_feature__ = ["beautiful", "extra", "full", "dev"]
 
 
 # Library
 ###########################################################################
 from importlib import import_module
 from importlib.resources import files
-from typing import Iterable
 
 
 class CLITextColor:
@@ -54,5 +53,5 @@ try:
     tqdm = import_module("tqdm").tqdm
 except ModuleNotFoundError:
 
-    def tqdm(iterable: Iterable, **kwargs):
+    def tqdm(iterable, **kwargs):
         return iterable

absfuyu/extensions/__init__.py

@@ -1,6 +1,7 @@
 """
 Absfuyu: Extension
 ------------------
+Features that require additional libraries
 
 Version: 1.0.1
 Date updated: 24/11/2023 (dd/mm/yyyy)

absfuyu/pkg_data/__init__.py

@@ -26,9 +26,9 @@ from absfuyu.logger import logger
 ###########################################################################
 _EXTERNAL_DATA = {
     "chemistry.json": "https://raw.githubusercontent.com/Bowserinator/Periodic-Table-JSON/master/PeriodicTableJSON.json",
-    "countries.json": "https://github.com/dr5hn/countries-states-cities-database/blob/master/countries.json",
     "tarot.json": "https://raw.githubusercontent.com/dariusk/corpora/master/data/divination/tarot_interpretations.json",
     "word_list.json": "https://raw.githubusercontent.com/dwyl/english-words/master/words_dictionary.json",
+    # "countries.json": "https://raw.githubusercontent.com/dr5hn/countries-states-cities-database/refs/heads/master/json/countries.json",
 }
 
 
@@ -37,6 +37,7 @@ _EXTERNAL_DATA = {
 class DataList:
     CHEMISTRY = files("absfuyu.pkg_data").joinpath("chemistry.pkl")
     TAROT = files("absfuyu.pkg_data").joinpath("tarot.pkl")
+    PASSWORDLIB = files("absfuyu.pkg_data").joinpath("passwordlib_lzma.pkl")
 
 
 class PkgData:

absfuyu/tools/checksum.py

@@ -3,13 +3,13 @@ Absufyu: Checksum
 -----------------
 Check MD5, SHA256, ...
 
-Version: 1.0.0
-Date updated: 01/02/2025 (dd/mm/yyyy)
+Version: 1.1.1
+Date updated: 05/02/2025 (dd/mm/yyyy)
 """
 
 # Module level
 ###########################################################################
-__all__ = ["checksum_operation"]
+__all__ = ["Checksum", "checksum_operation"]
 
 
 # Library
@@ -18,9 +18,13 @@ 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",
@@ -38,9 +42,6 @@ def checksum_operation(
         hash_engine = hashlib.md5()
 
     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:
@@ -50,6 +51,103 @@ def checksum_operation(
     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:
+        """Checksum engine
+
+        Parameters
+        ----------
+        path : str | Path
+            Path to file/directory to perform checksum
+        hash_mode : str | Literal["md5", "sha1", "sha256", "sha512"], optional
+            Hash mode, by default "sha256"
+        save_result_to_file : bool, optional
+            Save checksum result(s) to file, by default False
+        """
+        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():  # 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:  # File
+            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__":

absfuyu/tools/converter.py

@@ -3,8 +3,8 @@ Absufyu: Converter
 ------------------
 Convert stuff
 
-Version: 1.3.0
-Date updated: 01/02/2025 (dd/mm/yyyy)
+Version: 1.4.0
+Date updated: 10/02/2025 (dd/mm/yyyy)
 
 Feature:
 --------
@@ -26,6 +26,7 @@ import re
 import string
 from itertools import chain, combinations
 from pathlib import Path
+from typing import Self
 
 from absfuyu.core import CLITextColor
 from absfuyu.logger import logger
@@ -58,7 +59,7 @@ class Base64EncodeDecode:
         img_path : Path | str
             Path to image
         data_tag : bool, optional
-            Add data tag before base64 string, by default False
+            Add data tag before base64 string, by default ``False``
 
         Returns
         -------
@@ -76,8 +77,6 @@ class Base64EncodeDecode:
 class ChemistryElement:
     """Chemistry Element"""
 
-    _VERSION = (1, 1, 0)
-
     def __init__(self, name: str, number: int, symbol: str, atomic_mass: float) -> None:
         """
         name: element name
@@ -111,7 +110,7 @@ class ChemistryElement:
         }
 
     @classmethod
-    def from_dict(cls, data: dict[str, str | int | float]) -> "ChemistryElement":
+    def from_dict(cls, data: dict[str, str | int | float]) -> Self:
         """
         Convert from ``dict`` data
 
@@ -159,7 +158,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]] | list:
         """
         Convert text to chemistry symbol
 
@@ -231,6 +230,36 @@ class Text2Chemistry:
 
         return output
 
+    @staticmethod
+    def beautify_result(
+        result: list[list[ChemistryElement]] | list,
+    ) -> str:  # Added in version 4.2.0
+        """Beautify the result from ``Text2Chemistry.convert()``
+
+        Parameters
+        ----------
+        result : list[list[ChemistryElement]] | list
+            Convert ``Text2Chemistry.convert()`` result
+
+        Returns
+        -------
+        str
+            Beautified output
+        """
+        if len(result) == 0:
+            res = "No possible combination"
+        else:
+            msg = []
+            for i, solution in enumerate(result, start=1):
+                msg.append(f"Option {i:02}: {', '.join([x.symbol for x in solution])}")
+                for x in solution:
+                    msg.append(
+                        f"{x.symbol} ({x.number}. {x.name} - {round(x.atomic_mass, 2)})"
+                    )
+                msg.append("---")
+            res = "\n".join(msg)
+        return res
+
 
 class Str2Pixel:
     """Convert str into pixel"""