absfuyu 3.4.0__tar.gz → 4.1.0__tar.gz

{absfuyu-3.4.0 → absfuyu-4.1.0}/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-3.4.0 → absfuyu-4.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.3
+Metadata-Version: 2.4
 Name: absfuyu
-Version: 3.4.0
+Version: 4.1.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/
@@ -18,24 +18,20 @@ Classifier: Natural Language :: English
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Libraries
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: Utilities
-Requires-Python: <4,>=3.8
+Requires-Python: <4,>=3.11
 Requires-Dist: bs4
 Requires-Dist: click>=8.0.0
 Requires-Dist: colorama
 Requires-Dist: deprecated
-Requires-Dist: importlib-resources; python_version < '3.10'
 Requires-Dist: python-dateutil
 Requires-Dist: requests
-Requires-Dist: tomli>=1.1.0; python_version < '3.11'
-Requires-Dist: typing-extensions>=4.0.1; python_version < '3.11'
+Requires-Dist: typing-extensions>=4.5.0; python_version < '3.12'
 Requires-Dist: unidecode
 Provides-Extra: beautiful
 Requires-Dist: rich; extra == 'beautiful'
@@ -50,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-3.4.0 → absfuyu-4.1.0}/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 ====================
@@ -18,17 +18,15 @@ build-backend = "hatchling.build"
 name = "absfuyu"
 description = "A small collection of code"
 readme = { "file" = "README.md", "content-type" = "text/markdown" }
-requires-python = ">=3.8, <4"
+requires-python = ">=3.11, <4"
 license = { text = "MIT License" }
 keywords = ["utilities"]
 authors = [{ name = "somewhatcold (AbsoluteWinter)" }]
 classifiers = [
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.8",
-    "Programming Language :: Python :: 3.9",
-    "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
     "Programming Language :: Python :: 3 :: Only",
     "License :: OSI Approved :: MIT License",
     "Operating System :: OS Independent",
@@ -46,11 +44,9 @@ dependencies = [
     "click>=8.0.0",
     "colorama",
     "Deprecated",
-    "importlib_resources; python_version < '3.10'",
     "python-dateutil",
     "requests",
-    "tomli>=1.1.0; python_version < '3.11'",
-    "typing_extensions>=4.0.1; python_version < '3.11'",
+    "typing_extensions>=4.5.0; python_version < '3.12'",
     "unidecode",
 ]
 
@@ -64,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"]
@@ -113,7 +109,7 @@ Use `hatch run all:install` when occur "no module named" error
 install = "pip install -e .[full]" # This command fix "no module named"
 
 [[tool.hatch.envs.all.matrix]] # hatch env run -e all test
-python = ["3.8", "3.9", "3.10", "3.11", "3.12"]
+python = ["3.11", "3.12", "3.13"]
 
 [tool.hatch.envs.types]
 dependencies = ["mypy>=1.0.0"]
@@ -175,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]
@@ -190,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
@@ -227,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
@@ -247,7 +272,7 @@ no_implicit_reexport = true
 [tool.ruff]
 line-length = 88
 indent-width = 4
-target-version = "py38"
+target-version = "py311"
 include = ["pyproject.toml", "src/**", "tests/**"]
 
 [tool.ruff.format]
@@ -263,19 +288,27 @@ ignore = [
     "E266", # too many leading "#" for block comment
     "E501", # line too long
     "W291", # trailing whitespace
+    "B905", # `zip()` without an explicit `strict=` parameter
 ]
 
 [tool.ruff.lint.per-file-ignores]
 "__init__.py" = ["E402", "F401"] # module level import not at top of file
 "core.py" = ["E402"]
-"human.py" = ["E741"] # Ambiguous variable name
-"test_everything.py" = ["F403"] # unable to detect undefined names
+"human.py" = [
+    "E741", # Ambiguous variable name
+]
+"test_everything.py" = [
+    "F403", # unable to detect undefined names
+]
 "test_version.py" = [
     # Within an `except` clause, raise exceptions with `raise ... from err`
     # or `raise ... from None` to distinguish them from errors in exception handling
     "B904",
 ]
-"tests/*" = ["F401"] # imported but unused
+"tests/*" = [
+    "F401", # imported but unused
+]
+"shorten_number.py" = ["B007"] # Loop control variable not used within loop body
 
 # MARK: TOOL: black
 [tool.black]

{absfuyu-3.4.0 → absfuyu-4.1.0}/src/absfuyu/__init__.py

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

{absfuyu-3.4.0 → absfuyu-4.1.0}/src/absfuyu/cli/do_group.py

@@ -3,13 +3,14 @@ ABSFUYU CLI
 -----------
 Do
 
-Version: 1.1.0
-Date updated: 15/08/2024 (dd/mm/yyyy)
+Version: 1.3.0
+Date updated: 01/02/2025 (dd/mm/yyyy)
 """
 
 __all__ = ["do_group"]
 
 import subprocess
+from typing import Literal
 
 import click
 
@@ -17,6 +18,8 @@ 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.util.zipped import Zipper
 from absfuyu.version import PkgVersion
 
 
@@ -85,6 +88,50 @@ def info(date: str) -> None:
     print(instance.info())
 
 
+@click.command(name="unzip")
+@click.argument("dir", type=str)
+def unzip_files_in_dir(dir: str) -> None:
+    """Unzip every files in directory"""
+
+    engine = Zipper(dir)
+    engine.unzip()
+    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.group(name="do")
 def do_group() -> None:
     """Perform functionalities"""
@@ -96,3 +143,5 @@ do_group.add_command(install)
 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-3.4.0 → absfuyu-4.1.0}/src/absfuyu/config/__init__.py

@@ -3,8 +3,8 @@ Absfuyu: Configuration
 ----------------------
 Package configuration module
 
-Version: 2.0.4
-Date updated: 06/04/2024 (dd/mm/yyyy)
+Version: 2.0.5
+Date updated: 14/11/2024 (dd/mm/yyyy)
 """
 
 # Module level
@@ -19,7 +19,7 @@ __all__ = [
 # Library
 ###########################################################################
 from pathlib import Path
-from typing import Any, Dict, List, Optional, TypedDict
+from typing import Any, TypedDict
 
 from absfuyu.core import CONFIG_PATH
 from absfuyu.util.json_method import JsonFile
@@ -55,7 +55,7 @@ class ConfigFormat(TypedDict):
     :type version: VersionDictFormat
     """
 
-    setting: Dict[str, SettingDictFormat]
+    setting: dict[str, SettingDictFormat]
 
 
 # Class
@@ -82,7 +82,7 @@ class Setting:
         return self.__str__()
 
     @classmethod
-    def from_dict(cls, dict_data: Dict[str, SettingDictFormat]):
+    def from_dict(cls, dict_data: dict[str, SettingDictFormat]):
         """
         Convert ``dict`` into ``Setting`` (``len==1`` only)
         """
@@ -104,11 +104,11 @@ class Setting:
         """Update current value"""
         self.value = value
 
-    def to_dict(self) -> Dict[str, SettingDictFormat]:
+    def to_dict(self) -> dict[str, SettingDictFormat]:
         """
         Convert ``Setting`` into ``dict``
         """
-        output: Dict[str, SettingDictFormat] = {
+        output: dict[str, SettingDictFormat] = {
             self.name: {"default": self.default, "help": self.help, "value": self.value}
         }
         return output
@@ -119,7 +119,7 @@ class Config:
     Config handling
     """
 
-    def __init__(self, config_file: Path, name: Optional[str] = None) -> None:
+    def __init__(self, config_file: Path, name: str | None = None) -> None:
         """
         config_file: Path to `.json` config file
         """
@@ -132,7 +132,7 @@ class Config:
             self.name = self.config_path.name
 
         # Data
-        self.settings: List[Setting] = None  # type: ignore
+        self.settings: list[Setting] = None  # type: ignore
         self._fetch_data()  # Load data
 
     def __str__(self) -> str:
@@ -145,7 +145,7 @@ class Config:
     def _fetch_data(self) -> None:
         """Load data from ``self.config_file`` file"""
         data: dict = self.json_engine.load_json()
-        settings: Dict[str, SettingDictFormat] = data.get("setting")  # type: ignore
+        settings: dict[str, SettingDictFormat] = data.get("setting")  # type: ignore
         self.settings = [Setting.from_dict({k: v}) for k, v in settings.items()]
 
     def _prepare_data(self) -> ConfigFormat:
@@ -164,7 +164,7 @@ class Config:
 
     # Setting method
     @property
-    def setting_list(self) -> List[str]:
+    def setting_list(self) -> list[str]:
         """List of name of available settings"""
         return [setting.name for setting in self.settings]
 
@@ -183,7 +183,7 @@ class Config:
         [setting.reset() for setting in self.settings]  # type: ignore
         self.save()
 
-    def show_settings(self) -> List[Setting]:
+    def show_settings(self) -> list[Setting]:
         """
         Returns a list of available settings
         (wrapper for ``Config.settings``)
@@ -276,7 +276,7 @@ class Config:
 
 # Init
 ###########################################################################
-ABSFUYU_CONFIG = Config(CONFIG_PATH)
+ABSFUYU_CONFIG = Config(CONFIG_PATH)  # type: ignore
 
 # TODO: Create a config file when not available [W.I.P]
 # _settings = [

{absfuyu-3.4.0 → absfuyu-4.1.0}/src/absfuyu/core.py

@@ -3,8 +3,8 @@ Absfuyu: Core
 -------------
 Contain type hints and other stuffs
 
-Version: 2.2.0
-Date updated: 14/04/2024 (dd/mm/yyyy)
+Version: 2.3.0
+Date updated: 01/02/2025 (dd/mm/yyyy)
 """
 
 # Module Package
@@ -21,18 +21,11 @@ __all__ = [
 __package_feature__ = ["beautiful", "extra", "res", "full", "dev"]
 
 
-from pathlib import Path
-
-# import sys
-# from sys import version_info as _python_version
-
-# if sys.version_info.minor >= 10:
-#     from importlib.resources import files
-# else:
-#     try:
-#         from importlib_resources import files
-#     except:
-#         raise ImportError("Please install importlib-resources")
+# Library
+###########################################################################
+from importlib import import_module
+from importlib.resources import files
+from typing import Iterable
 
 
 class CLITextColor:
@@ -50,7 +43,16 @@ class CLITextColor:
     RESET = "\x1b[39m"
 
 
-CORE_PATH = Path(__file__).parent.absolute()
-# CORE_PATH = files("absfuyu")
+# CORE_PATH = Path(__file__).parent.absolute()
+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: Iterable, **kwargs):
+        return iterable