absfuyu 4.1.1__tar.gz → 4.2.0__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: absfuyu
-Version: 4.1.1
+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.1 → 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.1 → 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.1"
+__version__ = "4.2.0"
 __all__ = [
     "core",
     "config",

{absfuyu-4.1.1 → 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.1 → absfuyu-4.2.0}/src/absfuyu/cli/do_group.py

@@ -3,14 +3,13 @@ ABSFUYU CLI
 -----------
 Do
 
-Version: 1.3.1
-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
+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,61 +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(
-    "--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.command(name="shutdown")
+def os_shutdown() -> None:
+    """Shutdown"""
+    engine = ShutDownizer()
+    engine.shutdown()
 
 
 @click.group(name="do")
@@ -167,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.1 → absfuyu-4.2.0}/src/absfuyu/core.py

@@ -3,8 +3,8 @@ Absfuyu: Core
 -------------
 Contain type hints and other stuffs
 
-Version: 2.3.1
-Date updated: 01/02/2025 (dd/mm/yyyy)
+Version: 2.3.2
+Date updated: 11/02/2025 (dd/mm/yyyy)
 """
 
 # Module Package
@@ -18,7 +18,7 @@ __all__ = [
     "DATA_PATH",
 ]
 
-__package_feature__ = ["beautiful", "extra", "res", "full", "dev"]
+__package_feature__ = ["beautiful", "extra", "full", "dev"]
 
 
 # Library

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

@@ -3,8 +3,8 @@ Absufyu: Checksum
 -----------------
 Check MD5, SHA256, ...
 
-Version: 1.1.0
-Date updated: 01/02/2025 (dd/mm/yyyy)
+Version: 1.1.1
+Date updated: 05/02/2025 (dd/mm/yyyy)
 """
 
 # Module level
@@ -58,6 +58,17 @@ class Checksum:
         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
@@ -109,7 +120,7 @@ class Checksum:
         str
             Checksum hash
         """
-        if self.path.absolute().is_dir():
+        if self.path.absolute().is_dir():  # Dir
             new_path = self.path.joinpath(self.checksum_result_file_name)
             # List of files
             if recursive:
@@ -125,7 +136,7 @@ class Checksum:
                 name = x.relative_to(self.path)
                 res.append(f"{self._checksum_operation(x)} | {name}")
             output = "\n".join(res)
-        else:
+        else:  # File
             new_path = self.path.with_name(self.checksum_result_file_name)
             output = self._checksum_operation(self.path)
 

{absfuyu-4.1.1 → absfuyu-4.2.0}/src/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"""