absfuyu 4.1.1__tar.gz → 5.0.0__tar.gz

absfuyu-5.0.0/PKG-INFO

@@ -0,0 +1,143 @@
+Metadata-Version: 2.4
+Name: absfuyu
+Version: 5.0.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/
+Project-URL: Repository, https://github.com/AbsoluteWinter/absfuyu-public
+Project-URL: Issues, https://github.com/AbsoluteWinter/absfuyu-public/issues
+Author: somewhatcold (AbsoluteWinter)
+License-Expression: MIT
+License-File: LICENSE
+Keywords: utilities
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+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.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.11
+Requires-Dist: bs4
+Requires-Dist: click>=8.0.0
+Requires-Dist: colorama
+Requires-Dist: requests
+Provides-Extra: beautiful
+Requires-Dist: rich; extra == 'beautiful'
+Provides-Extra: dev
+Requires-Dist: hatch; extra == 'dev'
+Requires-Dist: pytest; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: numpy; extra == 'docs'
+Requires-Dist: pandas; extra == 'docs'
+Requires-Dist: rich; extra == 'docs'
+Provides-Extra: extra
+Requires-Dist: numpy; extra == 'extra'
+Requires-Dist: pandas; extra == 'extra'
+Provides-Extra: full
+Requires-Dist: numpy; extra == 'full'
+Requires-Dist: pandas; extra == 'full'
+Requires-Dist: rich; extra == 'full'
+Requires-Dist: tqdm; extra == 'full'
+Requires-Dist: unidecode; extra == 'full'
+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>
+</div>
+
+---
+
+## **SUMMARY:**
+
+This project is a collection of code primarily developed as a personal hobby. It aims to provide practical experience and enhance my coding skills while exploring potential future applications.
+
+## **INSTALLATION:**
+
+To install the package, run the following command:
+
+```bash
+pip install -U absfuyu
+```
+
+## **USAGE:**
+
+```python
+import absfuyu
+help(absfuyu)
+```
+
+### Notable features
+
+**absfuyu.core**: Provides foundational components for additional functionalities.
+
+```python
+# Decorators that adds info to __doc__
+from absfuyu.core.docstring import versionadded, versionchanged, deprecated
+
+# Class mixins for enhanced functionality
+from absfuyu.core.baseclass import AutoREPRMixin, ShowAllMethodsMixin
+```
+
+**absfuyu.dxt**: Extension for `list`, `str`, `dict`, `int`.
+
+```python
+from absfuyu.dxt import DictExt, IntExt, ListExt, Text
+for x in [DictExt, IntExt, ListExt, Text]:
+    x.show_all_methods(print_result=1)
+```
+
+There are many additional features available to explore.
+
+## **DOCUMENTATION:**
+
+For more detailed information about the project, please refer to the documentation available at the following link:
+
+> [Project Documentation](https://absolutewinter.github.io/absfuyu/)
+
+## **DEVELOPMENT SETUP**
+
+1. Create a Virtual Environment
+
+```bash
+python -m venv env
+```
+
+Note: You may need to execute this command in PowerShell on Windows:
+
+```powershell
+Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Scope CurrentUser
+```
+
+2. Install Required Packages
+
+```bash
+python -m pip install -e .[full,dev]
+```
+
+3. Acquire Information About the Development Environment Configuration
+
+```bash
+hatch env show
+```
+
+## **LICENSE:**
+
+This project is licensed under the MIT License.

absfuyu-5.0.0/README.md

@@ -0,0 +1,92 @@
+<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:**
+
+This project is a collection of code primarily developed as a personal hobby. It aims to provide practical experience and enhance my coding skills while exploring potential future applications.
+
+## **INSTALLATION:**
+
+To install the package, run the following command:
+
+```bash
+pip install -U absfuyu
+```
+
+## **USAGE:**
+
+```python
+import absfuyu
+help(absfuyu)
+```
+
+### Notable features
+
+**absfuyu.core**: Provides foundational components for additional functionalities.
+
+```python
+# Decorators that adds info to __doc__
+from absfuyu.core.docstring import versionadded, versionchanged, deprecated
+
+# Class mixins for enhanced functionality
+from absfuyu.core.baseclass import AutoREPRMixin, ShowAllMethodsMixin
+```
+
+**absfuyu.dxt**: Extension for `list`, `str`, `dict`, `int`.
+
+```python
+from absfuyu.dxt import DictExt, IntExt, ListExt, Text
+for x in [DictExt, IntExt, ListExt, Text]:
+    x.show_all_methods(print_result=1)
+```
+
+There are many additional features available to explore.
+
+## **DOCUMENTATION:**
+
+For more detailed information about the project, please refer to the documentation available at the following link:
+
+> [Project Documentation](https://absolutewinter.github.io/absfuyu/)
+
+## **DEVELOPMENT SETUP**
+
+1. Create a Virtual Environment
+
+```bash
+python -m venv env
+```
+
+Note: You may need to execute this command in PowerShell on Windows:
+
+```powershell
+Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Scope CurrentUser
+```
+
+2. Install Required Packages
+
+```bash
+python -m pip install -e .[full,dev]
+```
+
+3. Acquire Information About the Development Environment Configuration
+
+```bash
+hatch env show
+```
+
+## **LICENSE:**
+
+This project is licensed under the MIT License.

absfuyu-5.0.0/docs/_template/versioning.html

@@ -0,0 +1,27 @@
+{%- if current_version %}
+<div class="rst-versions" data-toggle="rst-versions" role="note" aria-label="versions">
+    <span class="rst-current-version" data-toggle="rst-current-version">
+        <span class="fa fa-book"> Other Versions</span>
+        v: {{ current_version.name }}
+        <span class="fa fa-caret-down"></span>
+    </span>
+    <div class="rst-other-versions">
+        {%- if versions.tags %}
+        <dl>
+            <dt>Tags</dt>
+            {%- for item in versions.tags %}
+            <dd><a href="{{ item.url }}">{{ item.name }}</a></dd>
+            {%- endfor %}
+        </dl>
+        {%- endif %}
+        {%- if versions.branches %}
+        <dl>
+            <dt>Branches</dt>
+            {%- for item in versions.branches %}
+            <dd><a href="{{ item.url }}">{{ item.name }}</a></dd>
+            {%- endfor %}
+        </dl>
+        {%- endif %}
+    </div>
+</div>
+{%- endif %}

{absfuyu-4.1.1 → absfuyu-5.0.0}/docs/conf.py

@@ -5,7 +5,6 @@
 
 import os
 import sys
-from datetime import datetime
 
 sys.path.insert(0, os.path.abspath(".."))
 
@@ -14,8 +13,8 @@ from absfuyu import __author__, __title__, __version__
 # -- Project information -----------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
 
-project = __title__
-copyright = f"2022-{datetime.now().year}, {__author__}"
+project = f"{__title__}"
+copyright = f"2022-%Y, {__author__}"
 author = __author__
 version = __version__
 release = version
@@ -23,6 +22,8 @@ release = version
 # -- General configuration ---------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
 
+needs_sphinx = "8.1"
+
 extensions = [
     "sphinx.ext.autodoc",  # include documentation
     "sphinx.ext.autosummary",
@@ -58,7 +59,9 @@ source_suffix = {
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
 
 
-# html_title = f"ABSFUYU'S DOCUMENTATION v{__version__}"
+html_title = f"{__title__.upper()}'S DOCUMENTATION v{__version__}"
+html_short_title = f"{__title__} v{__version__}"
+# html_logo = "https://github.com/AbsoluteWinter/AbsoluteWinter.github.io/blob/75568549d30f447a66baac8ecc3b5e6b49a67d18/absfuyu/images/LOGO.png?raw=true"
 
 html_theme = "sphinx_rtd_theme"
 html_static_path = ["_static"]
@@ -69,6 +72,11 @@ html_show_sourcelink = False
 # If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
 html_show_sphinx = False
 
+html_sidebars = {
+    "**": [
+        "versioning.html",
+    ],
+}
 
 # -- Extension configuration -------------------------------------------------
 

absfuyu-5.0.0/docs/info.md

@@ -0,0 +1,86 @@
+<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
+
+This project is a collection of code primarily developed as a personal hobby. It aims to provide practical experience and enhance my coding skills while exploring potential future applications.
+
+# INSTALLATION
+
+To install the package, run the following command:
+
+```bash
+pip install -U absfuyu
+```
+
+# USAGE
+
+```python
+import absfuyu
+help(absfuyu)
+```
+
+## Notable features
+
+**absfuyu.core**: Provides foundational components for additional functionalities.
+
+```python
+# Decorators that adds info to __doc__
+from absfuyu.core.docstring import versionadded, versionchanged, deprecated
+
+# Class mixins for enhanced functionality
+from absfuyu.core.baseclass import AutoREPRMixin, ShowAllMethodsMixin
+```
+
+**absfuyu.dxt**: Extension for `list`, `str`, `dict`, `int`.
+
+```python
+from absfuyu.dxt import DictExt, IntExt, ListExt, Text
+for x in [DictExt, IntExt, ListExt, Text]:
+    x.show_all_methods(print_result=1)
+```
+
+There are many additional features available to explore.
+
+# DEVELOPMENT SETUP
+
+1. Create a Virtual Environment
+
+```bash
+python -m venv env
+```
+
+Note: You may need to execute this command in PowerShell on Windows:
+
+```powershell
+Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Scope CurrentUser
+```
+
+2. Install Required Packages
+
+```bash
+python -m pip install -e .[full,dev]
+```
+
+3. Acquire Information About the Development Environment Configuration
+
+```bash
+hatch env show
+```
+
+# LICENSE
+
+This project is licensed under the MIT License.

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

@@ -10,7 +10,7 @@
 
 # MARK: BUILD ====================
 [build-system]
-requires = ["hatchling>=1.22.2", "hatch-vcs>=0.3.0"]
+requires = ["hatchling>=1.27.0", "hatch-vcs>=0.3.0"]
 build-backend = "hatchling.build"
 
 # MARK: PROJECT ====================
@@ -19,7 +19,8 @@ name = "absfuyu"
 description = "A small collection of code"
 readme = { "file" = "README.md", "content-type" = "text/markdown" }
 requires-python = ">=3.11, <4"
-license = { text = "MIT License" }
+license = "MIT"
+license-files = ["LICEN[CS]E*"]
 keywords = ["utilities"]
 authors = [{ name = "somewhatcold (AbsoluteWinter)" }]
 classifiers = [
@@ -43,11 +44,8 @@ dependencies = [
     "bs4",
     "click>=8.0.0",
     "colorama",
-    "Deprecated",
-    "python-dateutil",
     "requests",
-    "typing_extensions>=4.5.0; python_version < '3.12'",
-    "unidecode",
+    # "typing_extensions>=4.5.0; python_version < '3.12'",
 ]
 
 dynamic = ["version"]
@@ -59,8 +57,8 @@ 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", "unidecode"]
+docs = ["numpy", "pandas", "rich"]
 beautiful = ["rich"]
 extra = ["numpy", "pandas"]
 dev = ["hatch", "pytest"]
@@ -79,7 +77,7 @@ only-include = ["src", "tests", "docs", "images", "dev_requirements.txt"]
 
 # Set up virtual env: use hatch env show
 [tool.hatch.envs.default]
-dependencies = ["coverage[toml]", "pytest-cov", "pytest"]
+dependencies = ["coverage[toml]", "pytest", "pytest-cov"]
 description = """
 Default environment
 
@@ -97,6 +95,7 @@ cov = ["test-cov", "cov-report"]                                    # use this
 cov2 = "pytest --cov-report=term-missing --cov=absfuyu --cov=tests" # use this
 
 [tool.hatch.envs.all]
+dependencies = ["coverage[toml]", "pytest", "pytest-cov", "pytest-xdist"]
 features = ["full"]
 description = """
 All python version to test:
@@ -107,6 +106,7 @@ Use `hatch run all:install` when occur "no module named" error
 
 [tool.hatch.envs.all.scripts]
 install = "pip install -e .[full]" # This command fix "no module named"
+test2 = "pytest -n auto"           # parallel test
 
 [[tool.hatch.envs.all.matrix]] # hatch env run -e all test
 python = ["3.11", "3.12", "3.13"]
@@ -121,9 +121,9 @@ check = "mypy --install-types --non-interactive {args:src/absfuyu}"
 # check = "mypy --install-types --non-interactive {args:src/absfuyu tests}"
 
 [tool.hatch.envs.docs]
-features = ["full"]
+features = ["docs"]
 dependencies = [
-    "sphinx>=7.0.0",
+    "sphinx>=8.1.0",
     "sphinx_rtd_theme",
     "sphinx_copybutton",
     "myst-parser",       # Markdown parser
@@ -139,13 +139,36 @@ Main cmd:
 """
 
 [tool.hatch.envs.docs.scripts]
+clean = [
+    """
+    python -c "print('Cleaning up...')"
+    """,
+    """
+    python -c "import shutil;from pathlib import Path;shutil.rmtree(Path.cwd().joinpath('docs', 'build'))"
+    """, # Delete docs/build/ folder
+    """
+    python -c "from pathlib import Path;[x.unlink() for x in Path.cwd().joinpath('docs').glob('absfuyu*.rst')]"
+    """, # Clean .rst files in docs/ folder
+    """
+    python -c "print('Cleaning up...DONE')"
+    """,
+]
+build_private = [
+    # -f --force
+    # -e --separate
+    # -M --module-first
+    # -P --private
+    "sphinx-apidoc -o docs/ src/absfuyu -feMP",
+    "sphinx-build docs docs/build",
+]
 build = [
-    "sphinx-apidoc -o docs/ src/absfuyu", # Generate
-    "sphinx-build docs docs/build",       # Build
+    "clean",
+    "sphinx-apidoc -o docs/ src/absfuyu -eM", # Generate
+    "sphinx-build docs docs/build",           # Build
 ]
 live = [
-    "sphinx-apidoc -o docs/ src/absfuyu", # Generate
-    "sphinx-autobuild docs docs/build",   # Live preview
+    "sphinx-apidoc -o docs/ src/absfuyu -feM", # Generate
+    "sphinx-autobuild docs docs/build",        # Live preview
 ]
 
 [tool.hatch.envs.style]
@@ -180,9 +203,12 @@ Options:
 """
 
 [tool.hatch.envs.workflow.scripts]
-test = [
+qa = [
     "hatch run style:fmt",   # Code quality check
     "hatch run types:check", # type-hint check
+]
+test = [
+    "qa",
     "hatch run all:test",    # Test
 ]
 build = [
@@ -212,7 +238,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
@@ -245,7 +270,10 @@ addopts = [
 ]
 markers = [ # pytest -m <marker> -v
     "test_this: Select desire tests to test",
-    "data_extension: Test all data extension classes",
+    "abs_core: Test in absfuyu.core",
+    "abs_dxt: Test in absfuyu.dxt",
+    "abs_fun: Test in absfuyu.fun",
+    "abs_shape: Test in absfuyu.general.shape",
     "abs_tools: Test in absfuyu.tools",
     "abs_util: Test in absfuyu.util",
 ]
@@ -310,6 +338,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-5.0.0}/src/absfuyu/__init__.py

@@ -15,19 +15,19 @@ Normal import:
 >>> import absfuyu
 >>> help(absfuyu)
 
-Using in cmd (`absfuyu[cli]` required):
+Using in cmd:
 ``$ fuyu --help``
 """
 
 __title__ = "absfuyu"
 __author__ = "AbsoluteWinter"
 __license__ = "MIT License"
-__version__ = "4.1.1"
+__version__ = "5.0.0"
 __all__ = [
     "core",
     "config",
-    "everything",
-    "extensions",
+    "dxt",
+    "extra",
     "logger",
     "fun",
     "game",

absfuyu-5.0.0/src/absfuyu/__main__.py

@@ -0,0 +1,27 @@
+"""
+ABSFUYU
+-------
+COMMAND LINE INTERFACE
+
+Version: 5.0.0
+Date updated: 18/02/2025 (dd/mm/yyyy)
+"""
+
+# Library
+# ---------------------------------------------------------------------------
+try:
+    from absfuyu.cli import cli
+except ModuleNotFoundError:  # Check for `click`, `colorama`
+    from absfuyu.core.dummy_cli import cli
+
+
+# Function
+# ---------------------------------------------------------------------------
+def main() -> None:
+    cli()
+
+
+# Run
+# ---------------------------------------------------------------------------
+if __name__ == "__main__":
+    main()

{absfuyu-4.1.1 → absfuyu-5.0.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-5.0.0}/src/absfuyu/cli/color.py

@@ -7,10 +7,17 @@ Version: 1.0.0
 Date updated: 14/04/2024 (dd/mm/yyyy)
 """
 
+# Module Package
+# ---------------------------------------------------------------------------
 __all__ = ["COLOR"]
 
+
+# Library
+# ---------------------------------------------------------------------------
 import colorama
 
+# Color
+# ---------------------------------------------------------------------------
 COLOR = {
     "green": colorama.Fore.LIGHTGREEN_EX,
     "GREEN": colorama.Fore.GREEN,