absfuyu 4.1.0__tar.gz → 4.2.0__tar.gz

{absfuyu-4.1.0 → absfuyu-4.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: absfuyu
-Version: 4.1.0
+Version: 4.2.0
 Summary: A small collection of code
 Project-URL: Homepage, https://github.com/AbsoluteWinter/absfuyu-public
 Project-URL: Documentation, https://absolutewinter.github.io/absfuyu-docs/
@@ -42,30 +42,26 @@ Provides-Extra: extra
 Requires-Dist: numpy; extra == 'extra'
 Requires-Dist: pandas; extra == 'extra'
 Provides-Extra: full
-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
 
 <div align="center">
-	<h1 align="center">
-		<img src="https://github.com/AbsoluteWinter/AbsoluteWinter.github.io/blob/main/absfuyu/images/repository-image-crop.png?raw=true" alt="absfuyu"/>
-	</h1>
-	<p align="center">
-		<a href="https://pypi.org/project/absfuyu/"><img src="https://img.shields.io/pypi/pyversions/absfuyu?style=flat-square&logo=python" alt="PyPI Supported Versions"/></a>
-		<a href="https://pypi.org/project/absfuyu/"><img src="https://img.shields.io/pypi/dm/absfuyu?style=flat-square&color=blue" alt="PyPI Downloads"/></a>
-		<a href="https://pypi.org/project/absfuyu/"><img src="https://img.shields.io/pypi/v/absfuyu?style=flat-square&logo=pypi" /></a>
-		<a><img src="https://img.shields.io/pypi/l/absfuyu?style=flat-square&logo=github&color=blue"/></a>
-		<a><img src="https://img.shields.io/badge/code%20style-black-black?style=flat-square"/></a>
-		<a href="https://github.com/astral-sh/ruff"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json&style=flat-square" alt="Ruff" style="max-width:100%;"></a>
-	</p>
+    <h1 align="center">
+        <img src="https://github.com/AbsoluteWinter/AbsoluteWinter.github.io/blob/main/absfuyu/images/repository-image-crop.png?raw=true" alt="absfuyu"/>
+    </h1>
+    <p align="center">
+        <a href="https://pypi.org/project/absfuyu/"><img src="https://img.shields.io/pypi/pyversions/absfuyu?style=flat-square&logo=python" alt="PyPI Supported Versions"/></a>
+        <a href="https://pypi.org/project/absfuyu/"><img src="https://img.shields.io/pypi/dm/absfuyu?style=flat-square&color=blue" alt="PyPI Downloads"/></a>
+        <a href="https://pypi.org/project/absfuyu/"><img src="https://img.shields.io/pypi/v/absfuyu?style=flat-square&logo=pypi" /></a>
+        <a><img src="https://img.shields.io/pypi/l/absfuyu?style=flat-square&logo=github&color=blue"/></a>
+        <a><img src="https://img.shields.io/badge/code%20style-black-black?style=flat-square"/></a>
+        <a href="https://github.com/astral-sh/ruff"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json&style=flat-square" alt="Ruff" style="max-width:100%;"></a>
+    </p>
 </div>
 
-
 ---
 
 ## **SUMMARY:**
@@ -75,7 +71,7 @@ Description-Content-Type: text/markdown
 ## **INSTALLATION:**
 
 ```bash
-$ pip install -U absfuyu
+pip install -U absfuyu
 ```
 
 ## **USAGE:**
@@ -115,7 +111,6 @@ python -m pip install -e .[full,dev]
 hatch env show
 ```
 
-
 ## **LICENSE:**
 
 MIT License

absfuyu-4.2.0/README.md

@@ -0,0 +1,66 @@
+<div align="center">
+    <h1 align="center">
+        <img src="https://github.com/AbsoluteWinter/AbsoluteWinter.github.io/blob/main/absfuyu/images/repository-image-crop.png?raw=true" alt="absfuyu"/>
+    </h1>
+    <p align="center">
+        <a href="https://pypi.org/project/absfuyu/"><img src="https://img.shields.io/pypi/pyversions/absfuyu?style=flat-square&logo=python" alt="PyPI Supported Versions"/></a>
+        <a href="https://pypi.org/project/absfuyu/"><img src="https://img.shields.io/pypi/dm/absfuyu?style=flat-square&color=blue" alt="PyPI Downloads"/></a>
+        <a href="https://pypi.org/project/absfuyu/"><img src="https://img.shields.io/pypi/v/absfuyu?style=flat-square&logo=pypi" /></a>
+        <a><img src="https://img.shields.io/pypi/l/absfuyu?style=flat-square&logo=github&color=blue"/></a>
+        <a><img src="https://img.shields.io/badge/code%20style-black-black?style=flat-square"/></a>
+        <a href="https://github.com/astral-sh/ruff"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json&style=flat-square" alt="Ruff" style="max-width:100%;"></a>
+    </p>
+</div>
+
+---
+
+## **SUMMARY:**
+
+*TL;DR: A collection of code*
+
+## **INSTALLATION:**
+
+```bash
+pip install -U absfuyu
+```
+
+## **USAGE:**
+
+```python
+import absfuyu
+help(absfuyu)
+```
+
+## **DOCUMENTATION:**
+
+> [here](https://absolutewinter.github.io/absfuyu/)
+
+## **DEV SETUP**
+
+1. Create virtual environment
+
+```bash
+python -m venv env
+```
+
+Note: Might need to run this in powershell (windows)
+
+```powershell
+Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Scope CurrentUser
+```
+
+2. Install required packages
+
+```bash
+python -m pip install -e .[full,dev]
+```
+
+3. Getting info of dev environment
+
+```bash
+hatch env show
+```
+
+## **LICENSE:**
+
+MIT License

{absfuyu-4.1.0 → absfuyu-4.2.0}/pyproject.toml

@@ -59,8 +59,7 @@ Repository = "https://github.com/AbsoluteWinter/absfuyu-public"
 Issues = "https://github.com/AbsoluteWinter/absfuyu-public/issues"
 
 [project.optional-dependencies]
-res = ["absfuyu-res"]
-full = ["absfuyu-res", "numpy", "pandas", "rich", "tqdm"]
+full = ["numpy", "pandas", "rich", "tqdm"]
 beautiful = ["rich"]
 extra = ["numpy", "pandas"]
 dev = ["hatch", "pytest"]
@@ -212,7 +211,6 @@ build = [
     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
@@ -310,6 +308,9 @@ ignore = [
 ]
 "shorten_number.py" = ["B007"] # Loop control variable not used within loop body
 
+[tool.ruff.lint.pydocstyle]
+convention = "numpy"
+
 # MARK: TOOL: black
 [tool.black]
 line-length = 88

{absfuyu-4.1.0 → absfuyu-4.2.0}/src/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-4.1.0 → absfuyu-4.2.0}/src/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-4.1.0 → absfuyu-4.2.0}/src/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-4.2.0/src/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-4.1.0 → absfuyu-4.2.0}/src/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-4.1.0 → absfuyu-4.2.0}/src/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-4.1.0 → absfuyu-4.2.0}/src/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-4.2.0/src/absfuyu/tools/checksum.py

@@ -0,0 +1,154 @@
+"""
+Absufyu: Checksum
+-----------------
+Check MD5, SHA256, ...
+
+Version: 1.1.1
+Date updated: 05/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:
+        """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__":
+    pass