stouputils 1.14.0__tar.gz → 1.14.2__tar.gz

{stouputils-1.14.0 → stouputils-1.14.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: stouputils
-Version: 1.14.0
+Version: 1.14.2
 Summary: Stouputils is a collection of utility modules designed to simplify and enhance the development process. It includes a range of tools for tasks such as execution of doctests, display utilities, decorators, as well as context managers, and many more.
 Keywords: utilities,tools,helpers,development,python
 Author: Stoupy51

{stouputils-1.14.0 → stouputils-1.14.2}/pyproject.toml

@@ -1,102 +1,102 @@
-
-[build-system]
-requires = ["uv_build"]
-build-backend = "uv_build"
-
-[tool.uv.build-backend]
-module-root = ""
-
-[project]
-name = "stouputils"
-version = "1.14.0"
-description = "Stouputils is a collection of utility modules designed to simplify and enhance the development process. It includes a range of tools for tasks such as execution of doctests, display utilities, decorators, as well as context managers, and many more."
-readme = "README.md"
-keywords = ["utilities", "tools", "helpers", "development", "python"]
-requires-python = ">=3.12"
-classifiers = [
-    "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.12",
-    "Programming Language :: Python :: 3.13",
-    "Programming Language :: Python :: 3.14",
-    "License :: OSI Approved :: MIT License",
-    "Operating System :: OS Independent",
-]
-dependencies = [
-    "tqdm>=4.0.0",
-    "requests>=2.20.0",
-    "msgspec[toml,yaml]>=0.20.0",
-    "pillow>=12.0.0",
-    "python-box>=7.0.0",
-    "argcomplete>=3.0.0",
-    "numpy",
-]
-authors = [
-    { name = "Stoupy51", email = "stoupy51@gmail.com" },
-]
-
-[project.optional-dependencies]
-docs = [
-    "m2r2",
-    "myst_parser",
-    "sphinx_copybutton",
-    "sphinx_design",
-    "sphinx_treeview",
-    "sphinx_breeze_theme",
-    "pydata_sphinx_theme",
-]
-data_science = [
-    "opencv-python",
-    "scikit-image",
-    "simpleitk",
-    "mlflow",
-    "tensorflow",
-    "scikit-learn",
-    "PyWavelets",
-]
-
-[project.urls]
-Homepage = "https://stoupy51.github.io/stouputils"
-Issues = "https://github.com/Stoupy51/stouputils/issues"
-Source = "https://github.com/Stoupy51/stouputils"
-
-[project.scripts]
-stouputils = "stouputils.__main__:main"
-
-[tool.pyright]
-typeCheckingMode = "strict"
-
-[tool.ruff]
-exclude = [
-    ".git",
-    ".ruff_cache",
-    ".venv",
-    ".vscode",
-    ".cursor",
-    "build",
-    "dist",
-    "*.pyi",
-]
-line-length = 200
-
-[tool.ruff.lint]
-select = [
-    "E",
-    "W",
-    "F",
-    "I",
-    "N",
-    "UP",
-    "B",
-    "C4",
-    "T20",
-    "RUF",
-]
-ignore = [
-    "T201",
-    "W191",
-    "N803",
-    "N806",
-    "F403",
-    "F405",
-]
-
+
+[build-system]
+requires = ["uv_build"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-root = ""
+
+[project]
+name = "stouputils"
+version = "1.14.2"
+description = "Stouputils is a collection of utility modules designed to simplify and enhance the development process. It includes a range of tools for tasks such as execution of doctests, display utilities, decorators, as well as context managers, and many more."
+readme = "README.md"
+keywords = ["utilities", "tools", "helpers", "development", "python"]
+requires-python = ">=3.12"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+dependencies = [
+    "tqdm>=4.0.0",
+    "requests>=2.20.0",
+    "msgspec[toml,yaml]>=0.20.0",
+    "pillow>=12.0.0",
+    "python-box>=7.0.0",
+    "argcomplete>=3.0.0",
+    "numpy",
+]
+authors = [
+    { name = "Stoupy51", email = "stoupy51@gmail.com" },
+]
+
+[project.optional-dependencies]
+docs = [
+    "m2r2",
+    "myst_parser",
+    "sphinx_copybutton",
+    "sphinx_design",
+    "sphinx_treeview",
+    "sphinx_breeze_theme",
+    "pydata_sphinx_theme",
+]
+data_science = [
+    "opencv-python",
+    "scikit-image",
+    "simpleitk",
+    "mlflow",
+    "tensorflow",
+    "scikit-learn",
+    "PyWavelets",
+]
+
+[project.urls]
+Homepage = "https://stoupy51.github.io/stouputils"
+Issues = "https://github.com/Stoupy51/stouputils/issues"
+Source = "https://github.com/Stoupy51/stouputils"
+
+[project.scripts]
+stouputils = "stouputils.__main__:main"
+
+[tool.pyright]
+typeCheckingMode = "strict"
+
+[tool.ruff]
+exclude = [
+    ".git",
+    ".ruff_cache",
+    ".venv",
+    ".vscode",
+    ".cursor",
+    "build",
+    "dist",
+    "*.pyi",
+]
+line-length = 200
+
+[tool.ruff.lint]
+select = [
+    "E",
+    "W",
+    "F",
+    "I",
+    "N",
+    "UP",
+    "B",
+    "C4",
+    "T20",
+    "RUF",
+]
+ignore = [
+    "T201",
+    "W191",
+    "N803",
+    "N806",
+    "F403",
+    "F405",
+]
+

{stouputils-1.14.0 → stouputils-1.14.2}/stouputils/applications/automatic_docs.py

@@ -286,6 +286,7 @@ def get_versions_from_github(github_user: str, github_repo: str, recent_minor_ve
 					if d["type"] == "dir" and d["name"].startswith("v")
 				], key=version_to_float, reverse=True
 			)
+			info(f"Found versions from GitHub: {all_versions}")
 
 			# Group versions by major.minor
 			from collections import defaultdict
@@ -295,9 +296,11 @@ def get_versions_from_github(github_user: str, github_repo: str, recent_minor_ve
 				if len(parts) >= 2:
 					minor_key = f"{parts[0]}.{parts[1]}"
 					minor_versions[minor_key].append(version)
+			info(f"Grouped minor versions: {dict(minor_versions)}")
 
 			# Get the sorted minor version keys
 			sorted_minors = sorted(minor_versions.keys(), key=version_to_float, reverse=True)
+			info(f"Sorted minor versions: {sorted_minors}")
 
 			# Build final version list
 			final_versions: list[str] = []

stouputils-1.14.2/stouputils/continuous_delivery/pypi.pyi

@@ -0,0 +1,52 @@
+from ..decorators import LogLevels as LogLevels, handle_error as handle_error
+from .pyproject import read_pyproject as read_pyproject
+from collections.abc import Callable as Callable
+
+def update_pip_and_required_packages() -> int:
+    """ Update pip and required packages.
+
+\tReturns:
+\t\tint: Return code of the os.system call.
+\t"""
+def build_package() -> int:
+    """ Build the package.
+
+\tReturns:
+\t\tint: Return code of the os.system call.
+\t"""
+def upload_package(repository: str, filepath: str) -> int:
+    """ Upload the package to PyPI.
+
+\tArgs:
+\t\trepository  (str): Repository to upload to.
+\t\tfilepath    (str): Path to the file to upload.
+
+\tReturns:
+\t\tint: Return code of the os.system call.
+\t"""
+def pypi_full_routine(repository: str, dist_directory: str, last_files: int = 1, endswith: str = '.tar.gz', update_all_function: Callable[[], int] = ..., build_package_function: Callable[[], int] = ..., upload_package_function: Callable[[str, str], int] = ...) -> None:
+    ''' Upload the most recent file(s) to PyPI after updating pip and required packages and building the package.
+
+\tArgs:
+\t\trepository               (str):                        Repository to upload to.
+\t\tdist_directory           (str):                        Directory to upload from.
+\t\tlast_files               (int):                        Number of most recent files to upload. Defaults to 1.
+\t\tendswith                 (str):                        End of the file name to upload. Defaults to ".tar.gz".
+\t\tupdate_all_function      (Callable[[], int]):          Function to update pip and required packages.
+\t\t\tDefaults to :func:`update_pip_and_required_packages`.
+\t\tbuild_package_function   (Callable[[], int]):          Function to build the package.
+\t\t\tDefaults to :func:`build_package`.
+\t\tupload_package_function  (Callable[[str, str], int]):  Function to upload the package.
+\t\t\tDefaults to :func:`upload_package`.
+
+\tReturns:
+\t\tint: Return code of the command.
+\t'''
+def pypi_full_routine_using_uv() -> None:
+    """ Full build and publish routine using 'uv' command line tool.
+
+\tSteps:
+\t\t1. Generate stubs unless '--no-stubs' is passed
+\t\t2. Build the package using 'uv build'
+\t\t3. Upload the most recent file to PyPI using 'uv publish'
+\t"""

{stouputils-1.14.0 → stouputils-1.14.2}/stouputils/data_science/config/get.py

@@ -1,51 +1,51 @@
-""" Load configuration from the set.py file and handle some special cases.
-
-Proper way to get the configuration is by importing this module, not the set.py file directly.
-"""
-
-# pyright: reportUnknownMemberType=false
-# pyright: reportUnknownVariableType=false
-# pyright: reportMissingTypeStubs=false
-
-# Imports
-import os
-from typing import Any
-
-from .set import DataScienceConfig
-
-# Special cases
-# Hide GPU when using CPU
-if DataScienceConfig.TENSORFLOW_DEVICE.lower().startswith("/cpu"):
-	os.environ["CUDA_VISIBLE_DEVICES"] = "-1"
-
-# Precise which GPU we use
-elif DataScienceConfig.TENSORFLOW_DEVICE.lower().startswith("/gpu"):
-	os.environ["CUDA_VISIBLE_DEVICES"] = DataScienceConfig.TENSORFLOW_DEVICE.split(":")[-1]
-
-	# Configure TensorFlow (if available)
-	try:
-		from tensorflow import config as tf_config
-
-		# Get the physical devices
-		physical_devices: list[Any] = tf_config.list_physical_devices("GPU")
-
-		# Configure TensorFlow GPU memory management to allocate memory dynamically
-		# This prevents TensorFlow from allocating all GPU memory upfront
-		# Instead, memory will grow as needed, allowing better resource sharing
-		for device in physical_devices:
-			tf_config.experimental.set_memory_growth(device, True)
-
-		# Disable eager execution mode in TensorFlow
-		# This improves performance by allowing TensorFlow to create an optimized graph
-		# of operations instead of executing operations one by one (at the cost of debugging difficulty)
-		tf_config.run_functions_eagerly(False)
-	except ImportError:
-		pass
-
-	# Enable mixed precision training (if available)
-	try:
-		from keras import mixed_precision
-		mixed_precision.set_global_policy(DataScienceConfig.MIXED_PRECISION_POLICY)
-	except ImportError:
-		pass
-
+""" Load configuration from the set.py file and handle some special cases.
+
+Proper way to get the configuration is by importing this module, not the set.py file directly.
+"""
+
+# pyright: reportUnknownMemberType=false
+# pyright: reportUnknownVariableType=false
+# pyright: reportMissingTypeStubs=false
+
+# Imports
+import os
+from typing import Any
+
+from .set import DataScienceConfig
+
+# Special cases
+# Hide GPU when using CPU
+if DataScienceConfig.TENSORFLOW_DEVICE.lower().startswith("/cpu"):
+	os.environ["CUDA_VISIBLE_DEVICES"] = "-1"
+
+# Precise which GPU we use
+elif DataScienceConfig.TENSORFLOW_DEVICE.lower().startswith("/gpu"):
+	os.environ["CUDA_VISIBLE_DEVICES"] = DataScienceConfig.TENSORFLOW_DEVICE.split(":")[-1]
+
+	# Configure TensorFlow (if available)
+	try:
+		from tensorflow import config as tf_config
+
+		# Get the physical devices
+		physical_devices: list[Any] = tf_config.list_physical_devices("GPU")
+
+		# Configure TensorFlow GPU memory management to allocate memory dynamically
+		# This prevents TensorFlow from allocating all GPU memory upfront
+		# Instead, memory will grow as needed, allowing better resource sharing
+		for device in physical_devices:
+			tf_config.experimental.set_memory_growth(device, True)
+
+		# Disable eager execution mode in TensorFlow
+		# This improves performance by allowing TensorFlow to create an optimized graph
+		# of operations instead of executing operations one by one (at the cost of debugging difficulty)
+		tf_config.run_functions_eagerly(False)
+	except ImportError:
+		pass
+
+	# Enable mixed precision training (if available)
+	try:
+		from keras import mixed_precision
+		mixed_precision.set_global_policy(DataScienceConfig.MIXED_PRECISION_POLICY)
+	except ImportError:
+		pass
+

{stouputils-1.14.0 → stouputils-1.14.2}/stouputils/data_science/data_processing/image/__init__.py

@@ -1,66 +1,66 @@
-
-# Imports
-from .auto_contrast import auto_contrast_image
-from .axis_flip import flip_image
-from .bias_field_correction import bias_field_correction_image
-from .binary_threshold import binary_threshold_image
-from .blur import blur_image
-from .brightness import brightness_image
-from .canny import canny_image
-from .clahe import clahe_image
-from .contrast import contrast_image
-from .curvature_flow_filter import curvature_flow_filter_image
-from .denoise import (
-    adaptive_denoise_image,
-    bilateral_denoise_image,
-    nlm_denoise_image,
-    tv_denoise_image,
-    wavelet_denoise_image,
-)
-from .invert import invert_image
-from .laplacian import laplacian_image
-from .median_blur import median_blur_image
-from .noise import noise_image
-from .normalize import normalize_image
-from .random_erase import random_erase_image
-from .resize import resize_image
-from .rotation import rotate_image
-from .salt_pepper import salt_pepper_image
-from .sharpening import sharpen_image
-from .shearing import shear_image
-from .threshold import threshold_image
-from .translation import translate_image
-from .zoom import zoom_image
-
-__all__ = [
-    "adaptive_denoise_image",
-    "auto_contrast_image",
-    "bias_field_correction_image",
-    "bilateral_denoise_image",
-    "binary_threshold_image",
-    "blur_image",
-    "brightness_image",
-    "canny_image",
-    "clahe_image",
-    "contrast_image",
-    "curvature_flow_filter_image",
-    "flip_image",
-    "invert_image",
-    "laplacian_image",
-    "median_blur_image",
-    "nlm_denoise_image",
-    "noise_image",
-    "normalize_image",
-    "random_erase_image",
-    "resize_image",
-    "rotate_image",
-    "salt_pepper_image",
-    "sharpen_image",
-    "shear_image",
-    "threshold_image",
-    "translate_image",
-    "tv_denoise_image",
-    "wavelet_denoise_image",
-    "zoom_image",
-]
-
+
+# Imports
+from .auto_contrast import auto_contrast_image
+from .axis_flip import flip_image
+from .bias_field_correction import bias_field_correction_image
+from .binary_threshold import binary_threshold_image
+from .blur import blur_image
+from .brightness import brightness_image
+from .canny import canny_image
+from .clahe import clahe_image
+from .contrast import contrast_image
+from .curvature_flow_filter import curvature_flow_filter_image
+from .denoise import (
+    adaptive_denoise_image,
+    bilateral_denoise_image,
+    nlm_denoise_image,
+    tv_denoise_image,
+    wavelet_denoise_image,
+)
+from .invert import invert_image
+from .laplacian import laplacian_image
+from .median_blur import median_blur_image
+from .noise import noise_image
+from .normalize import normalize_image
+from .random_erase import random_erase_image
+from .resize import resize_image
+from .rotation import rotate_image
+from .salt_pepper import salt_pepper_image
+from .sharpening import sharpen_image
+from .shearing import shear_image
+from .threshold import threshold_image
+from .translation import translate_image
+from .zoom import zoom_image
+
+__all__ = [
+    "adaptive_denoise_image",
+    "auto_contrast_image",
+    "bias_field_correction_image",
+    "bilateral_denoise_image",
+    "binary_threshold_image",
+    "blur_image",
+    "brightness_image",
+    "canny_image",
+    "clahe_image",
+    "contrast_image",
+    "curvature_flow_filter_image",
+    "flip_image",
+    "invert_image",
+    "laplacian_image",
+    "median_blur_image",
+    "nlm_denoise_image",
+    "noise_image",
+    "normalize_image",
+    "random_erase_image",
+    "resize_image",
+    "rotate_image",
+    "salt_pepper_image",
+    "sharpen_image",
+    "shear_image",
+    "threshold_image",
+    "translate_image",
+    "tv_denoise_image",
+    "wavelet_denoise_image",
+    "zoom_image",
+]
+