stouputils 1.15.1__tar.gz → 1.16.1__tar.gz

{stouputils-1.15.1 → stouputils-1.16.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: stouputils
-Version: 1.15.1
+Version: 1.16.1
 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
@@ -94,6 +94,7 @@ Start now by installing the package: `pip install stouputils`.<br>
 ├── <a href="https://stoupy51.github.io/stouputils/latest/modules/stouputils.parallel.html">parallel.py</a>      <span class="comment"># 🔀 Utility functions for parallel processing <span class="paren">(multiprocessing, multithreading, run_in_subprocess)</span></span>
 ├── <a href="https://stoupy51.github.io/stouputils/latest/modules/stouputils.image.html">image.py</a>         <span class="comment"># 🖼️ Little utilities for image processing <span class="paren">(image_resize, auto_crop, numpy_to_gif, numpy_to_obj)</span></span>
 ├── <a href="https://stoupy51.github.io/stouputils/latest/modules/stouputils.collections.html">collections.py</a>   <span class="comment"># 🧰 Utilities for collection manipulation <span class="paren">(unique_list, sort_dict_keys, upsert_in_dataframe, array_to_disk)</span></span>
+├── <a href="https://stoupy51.github.io/stouputils/latest/modules/stouputils.typing.html">typing.py</a>        <span class="comment"># 📝 Utilities for typing enhancements <span class="paren">(IterAny, JsonDict, JsonList, ..., convert_to_serializable)</span></span>
 ├── <a href="https://stoupy51.github.io/stouputils/latest/modules/stouputils.all_doctests.html">all_doctests.py</a>  <span class="comment"># ✅ Run all doctests for all modules in a given directory <span class="paren">(launch_tests, test_module_with_progress)</span></span>
 ├── <a href="https://stoupy51.github.io/stouputils/latest/modules/stouputils.backup.html">backup.py</a>        <span class="comment"># 💾 Utilities for backup management <span class="paren">(delta backup, consolidate)</span></span>
 ├── <a href="https://stoupy51.github.io/stouputils/latest/modules/stouputils.archive.html">archive.py</a>       <span class="comment"># 📦 Functions for creating and managing archives</span>

{stouputils-1.15.1 → stouputils-1.16.1}/README.md

@@ -52,6 +52,7 @@ Start now by installing the package: `pip install stouputils`.<br>
 ├── <a href="https://stoupy51.github.io/stouputils/latest/modules/stouputils.parallel.html">parallel.py</a>      <span class="comment"># 🔀 Utility functions for parallel processing <span class="paren">(multiprocessing, multithreading, run_in_subprocess)</span></span>
 ├── <a href="https://stoupy51.github.io/stouputils/latest/modules/stouputils.image.html">image.py</a>         <span class="comment"># 🖼️ Little utilities for image processing <span class="paren">(image_resize, auto_crop, numpy_to_gif, numpy_to_obj)</span></span>
 ├── <a href="https://stoupy51.github.io/stouputils/latest/modules/stouputils.collections.html">collections.py</a>   <span class="comment"># 🧰 Utilities for collection manipulation <span class="paren">(unique_list, sort_dict_keys, upsert_in_dataframe, array_to_disk)</span></span>
+├── <a href="https://stoupy51.github.io/stouputils/latest/modules/stouputils.typing.html">typing.py</a>        <span class="comment"># 📝 Utilities for typing enhancements <span class="paren">(IterAny, JsonDict, JsonList, ..., convert_to_serializable)</span></span>
 ├── <a href="https://stoupy51.github.io/stouputils/latest/modules/stouputils.all_doctests.html">all_doctests.py</a>  <span class="comment"># ✅ Run all doctests for all modules in a given directory <span class="paren">(launch_tests, test_module_with_progress)</span></span>
 ├── <a href="https://stoupy51.github.io/stouputils/latest/modules/stouputils.backup.html">backup.py</a>        <span class="comment"># 💾 Utilities for backup management <span class="paren">(delta backup, consolidate)</span></span>
 ├── <a href="https://stoupy51.github.io/stouputils/latest/modules/stouputils.archive.html">archive.py</a>       <span class="comment"># 📦 Functions for creating and managing archives</span>

{stouputils-1.15.1 → stouputils-1.16.1}/pyproject.toml

@@ -8,7 +8,7 @@ module-root = ""
 
 [project]
 name = "stouputils"
-version = "1.15.1"
+version = "1.16.1"
 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"]

{stouputils-1.15.1 → stouputils-1.16.1}/stouputils/__init__.py

@@ -1,18 +1,7 @@
-""" A collection of utility modules designed to simplify and enhance the development process.
-
-This package provides various tools and utilities for common development tasks including:
-
-Key Features:
-- Continuous delivery utilities (GitHub, PyPI)
-- Display and logging utilities (print)
-- File and I/O management (io)
-- Decorators for common patterns
-- Context managers
-- Archive and backup tools
-- Parallel processing helpers
-- Collection utilities
-- Doctests utilities
+""" 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.
 
+Check the documentation for more details: https://stoupy51.github.io/stouputils/
 """
 # Version (handle case where the package is not installed)
 from importlib.metadata import PackageNotFoundError
@@ -31,6 +20,7 @@ from .image import *
 from .io import *
 from .parallel import *
 from .print import *
+from .typing import *
 from .version_pkg import *
 
 try:

{stouputils-1.15.1 → stouputils-1.16.1}/stouputils/__init__.pyi

@@ -10,6 +10,7 @@ from .image import *
 from .io import *
 from .parallel import *
 from .print import *
+from .typing import *
 from .version_pkg import *
 
 __version__: str

{stouputils-1.15.1 → stouputils-1.16.1}/stouputils/__main__.py

@@ -7,12 +7,7 @@ import sys
 
 import argcomplete
 
-from .all_doctests import launch_tests
-from .archive import archive_cli
-from .backup import backup_cli
 from .decorators import handle_error
-from .print import CYAN, GREEN, RESET
-from .version_pkg import show_version_cli
 
 # Argument Parser Setup for Auto-Completion
 parser = argparse.ArgumentParser(prog="stouputils", add_help=False)
@@ -29,22 +24,28 @@ def main() -> None:
 
 	# Print the version of stouputils and its dependencies
 	if second_arg in ("--version", "-v", "version", "show_version"):
+		from .version_pkg import show_version_cli
 		return show_version_cli()
 
 	# Handle "all_doctests" command
 	if second_arg == "all_doctests":
-		if launch_tests("." if len(sys.argv) == 2 else sys.argv[2]) > 0:
+		root_dir: str = "." if len(sys.argv) == 2 else sys.argv[2]
+		pattern: str = sys.argv[3] if len(sys.argv) >= 4 else "*"
+		from .all_doctests import launch_tests
+		if launch_tests(root_dir, pattern=pattern) > 0:
 			sys.exit(1)
 		return
 
 	# Handle "archive" command
 	if second_arg == "archive":
 		sys.argv.pop(1)  # Remove "archive" from argv so archive_cli gets clean arguments
+		from .archive import archive_cli
 		return archive_cli()
 
 	# Handle "backup" command
 	if second_arg == "backup":
 		sys.argv.pop(1)  # Remove "backup" from argv so backup_cli gets clean arguments
+		from .backup import backup_cli
 		return backup_cli()
 
 	# Handle "build" command
@@ -64,6 +65,7 @@ def main() -> None:
 		pkg_version = "unknown"
 
 	# Print help with nice formatting
+	from .print import CYAN, GREEN, RESET
 	separator: str = "─" * 60
 	print(f"""
 {CYAN}{separator}{RESET}
@@ -73,7 +75,7 @@ def main() -> None:
 
 {CYAN}Available commands:{RESET}
   {GREEN}--version, -v{RESET} [pkg] [-t <depth>]    Show version information (optionally for a specific package)
-  {GREEN}all_doctests{RESET} [dir]                  Run all doctests in the specified directory
+  {GREEN}all_doctests{RESET} [dir] [pattern]        Run all doctests in the specified directory (optionally filter by pattern)
   {GREEN}archive{RESET} --help                      Archive utilities (make, repair)
   {GREEN}backup{RESET} --help                       Backup utilities (delta, consolidate, limit)
   {GREEN}build{RESET} [--no_stubs] [<minor|major>]  Build and publish package to PyPI using 'uv' tool (complete routine)

{stouputils-1.15.1 → stouputils-1.16.1}/stouputils/all_doctests.py

@@ -9,29 +9,26 @@ This module is used to run all the doctests for all the modules in a given direc
 """
 
 # Imports
-import importlib
-import os
-import pkgutil
-import sys
-from types import ModuleType
 from typing import TYPE_CHECKING
 
 from . import decorators
 from .decorators import measure_time
 from .io import clean_path, relative_path
-from .print import error, info, progress, warning
+from .print import error, info, warning
 
 if TYPE_CHECKING:
 	from doctest import TestResults
+	from types import ModuleType
 
 
 # Main program
-def launch_tests(root_dir: str, strict: bool = True) -> int:
+def launch_tests(root_dir: str, strict: bool = True, pattern: str = "*") -> int:
 	""" Main function to launch tests for all modules in the given directory.
 
 	Args:
 		root_dir				(str):			Root directory to search for modules
 		strict					(bool):			Modify the force_raise_exception variable to True in the decorators module
+		pattern					(str):			Pattern to filter module names (fnmatch style, e.g., '*typ*', 'io', etc.)
 
 	Returns:
 		int: The number of failed tests
@@ -62,11 +59,14 @@ def launch_tests(root_dir: str, strict: bool = True) -> int:
 		strict = old_value
 
 	# Get the path of the directory to check modules from
+	import os
 	working_dir: str = clean_path(os.getcwd())
 	root_dir = clean_path(os.path.abspath(root_dir))
 	dir_to_check: str = os.path.dirname(root_dir) if working_dir != root_dir else root_dir
 
 	# Get all modules from folder
+	import pkgutil
+	import sys
 	sys.path.insert(0, dir_to_check)
 	modules_file_paths: list[str] = []
 	for directory_path, _, _ in os.walk(root_dir):
@@ -94,10 +94,21 @@ def launch_tests(root_dir: str, strict: bool = True) -> int:
 	if not modules_file_paths:
 		raise ValueError(f"No modules found in '{relative_path(root_dir)}'")
 
+	# Filter modules based on pattern
+	if pattern != "*":
+		import fnmatch
+		modules_file_paths = [
+			path for path in modules_file_paths
+			if fnmatch.fnmatch(path.split(".")[-1], pattern)
+		]
+		if not modules_file_paths:
+			raise ValueError(f"No modules matching pattern '{pattern}' found in '{relative_path(root_dir)}'")
+
 	# Find longest module path for alignment
 	max_length: int = max(len(path) for path in modules_file_paths)
 
 	# Dynamically import all modules from iacob package recursively using pkgutil and importlib
+	import importlib
 	modules: list[ModuleType] = []
 	separators: list[str] = []
 	for module_path in modules_file_paths:
@@ -143,7 +154,7 @@ def launch_tests(root_dir: str, strict: bool = True) -> int:
 	return total_failed
 
 
-def test_module_with_progress(module: ModuleType, separator: str) -> "TestResults":
+def test_module_with_progress(module: ModuleType, separator: str) -> TestResults:
 	""" Test a module with testmod and measure the time taken with progress printing.
 
 	Args:
@@ -152,7 +163,7 @@ def test_module_with_progress(module: ModuleType, separator: str) -> "TestResult
 	Returns:
 		TestResults: The results of the tests
 	"""
-	from doctest import TestResults, testmod
+	from doctest import testmod
 	@measure_time(message=f"Testing module '{module.__name__}' {separator}took")
 	def internal() -> TestResults:
 		return testmod(m=module)

{stouputils-1.15.1 → stouputils-1.16.1}/stouputils/all_doctests.pyi

@@ -1,16 +1,17 @@
 from . import decorators as decorators
 from .decorators import measure_time as measure_time
 from .io import clean_path as clean_path, relative_path as relative_path
-from .print import error as error, info as info, progress as progress, warning as warning
+from .print import error as error, info as info, warning as warning
 from doctest import TestResults as TestResults
 from types import ModuleType
 
-def launch_tests(root_dir: str, strict: bool = True) -> int:
+def launch_tests(root_dir: str, strict: bool = True, pattern: str = '*') -> int:
     ''' Main function to launch tests for all modules in the given directory.
 
 \tArgs:
 \t\troot_dir\t\t\t\t(str):\t\t\tRoot directory to search for modules
 \t\tstrict\t\t\t\t\t(bool):\t\t\tModify the force_raise_exception variable to True in the decorators module
+\t\tpattern\t\t\t\t\t(str):\t\t\tPattern to filter module names (fnmatch style, e.g., \'*typ*\', \'io\', etc.)
 
 \tReturns:
 \t\tint: The number of failed tests

{stouputils-1.15.1 → stouputils-1.16.1}/stouputils/applications/automatic_docs.py

@@ -141,6 +141,10 @@ def get_sphinx_conf_content(
 # Imports
 import sys
 from typing import Any
+import typing
+
+# Set TYPE_CHECKING to avoid import issues during documentation generation
+typing.TYPE_CHECKING = True
 
 # Add project_dir directory to Python path for module discovery
 sys.path.insert(0, "{parent_of_project_dir}")

{stouputils-1.15.1 → stouputils-1.16.1}/stouputils/collections.py

@@ -30,7 +30,7 @@ T = TypeVar("T")
 
 # Functions
 def unique_list[T](list_to_clean: Iterable[T], method: Literal["id", "hash", "str"] = "str") -> list[T]:
-	""" Remove duplicates from the list while keeping the order using ids (default) or hash or str
+	""" Remove duplicates from the list while keeping the order using ids, hash, or str
 
 	Args:
 		list_to_clean	(Iterable[T]):					The list to clean

{stouputils-1.15.1 → stouputils-1.16.1}/stouputils/collections.pyi

@@ -7,7 +7,7 @@ from typing import Any, Literal, TypeVar
 T = TypeVar('T')
 
 def unique_list[T](list_to_clean: Iterable[T], method: Literal['id', 'hash', 'str'] = 'str') -> list[T]:
-    ''' Remove duplicates from the list while keeping the order using ids (default) or hash or str
+    ''' Remove duplicates from the list while keeping the order using ids, hash, or str
 
 \tArgs:
 \t\tlist_to_clean\t(Iterable[T]):\t\t\t\t\tThe list to clean

{stouputils-1.15.1 → stouputils-1.16.1}/stouputils/continuous_delivery/pypi.py

@@ -10,6 +10,7 @@
 
 # Imports
 import os
+import subprocess
 import sys
 from collections.abc import Callable
 from typing import Any
@@ -22,17 +23,17 @@ def update_pip_and_required_packages() -> int:
 	""" Update pip and required packages.
 
 	Returns:
-		int: Return code of the os.system call.
+		int: Return code of the subprocess.run call.
 	"""
-	return os.system(f"{sys.executable} -m pip install --upgrade pip setuptools build twine pkginfo packaging")
+	return subprocess.run(f"{sys.executable} -m pip install --upgrade pip setuptools build twine pkginfo packaging", shell=True).returncode
 
 def build_package() -> int:
 	""" Build the package.
 
 	Returns:
-		int: Return code of the os.system call.
+		int: Return code of the subprocess.run call.
 	"""
-	return os.system(f"{sys.executable} -m build")
+	return subprocess.run(f"{sys.executable} -m build", shell=True).returncode
 
 def upload_package(repository: str, filepath: str) -> int:
 	""" Upload the package to PyPI.
@@ -42,9 +43,9 @@ def upload_package(repository: str, filepath: str) -> int:
 		filepath    (str): Path to the file to upload.
 
 	Returns:
-		int: Return code of the os.system call.
+		int: Return code of the subprocess.run call.
 	"""
-	return os.system(f"{sys.executable} -m twine upload --verbose -r {repository} {filepath}")
+	return subprocess.run(f"{sys.executable} -m twine upload --verbose -r {repository} {filepath}", shell=True).returncode
 
 @handle_error(message="Error while doing the pypi full routine", error_log=LogLevels.ERROR_TRACEBACK)
 def pypi_full_routine(
@@ -115,16 +116,16 @@ def pypi_full_routine_using_uv() -> None:
 	# Increment version in pyproject.toml
 	if "--no-bump" not in sys.argv and "--no_bump" not in sys.argv:
 		increment: str = "patch" if sys.argv[-1] not in ("minor", "major") else sys.argv[-1]
-		if os.system(f"uv version --bump {increment} --frozen") != 0:
+		if subprocess.run(f"uv version --bump {increment} --frozen", shell=True).returncode != 0:
 			raise Exception("Error while incrementing version using 'uv version'")
 
 	# Build the package using 'uv build'
 	import shutil
 	shutil.rmtree("dist", ignore_errors=True)
-	if os.system(f"{sys.executable} -m uv build") != 0:
+	if subprocess.run(f"{sys.executable} -m uv build", shell=True).returncode != 0:
 		raise Exception("Error while building the package using 'uv build'")
 
 	# Upload the most recent file to PyPI using 'uv publish'
-	if os.system(f"{sys.executable} -m uv publish") != 0:
+	if subprocess.run(f"{sys.executable} -m uv publish", shell=True).returncode != 0:
 		raise Exception("Error while publishing the package using 'uv publish'")
 

{stouputils-1.15.1 → stouputils-1.16.1}/stouputils/continuous_delivery/pypi.pyi

@@ -6,13 +6,13 @@ def update_pip_and_required_packages() -> int:
     """ Update pip and required packages.
 
 \tReturns:
-\t\tint: Return code of the os.system call.
+\t\tint: Return code of the subprocess.run call.
 \t"""
 def build_package() -> int:
     """ Build the package.
 
 \tReturns:
-\t\tint: Return code of the os.system call.
+\t\tint: Return code of the subprocess.run call.
 \t"""
 def upload_package(repository: str, filepath: str) -> int:
     """ Upload the package to PyPI.
@@ -22,7 +22,7 @@ def upload_package(repository: str, filepath: str) -> int:
 \t\tfilepath    (str): Path to the file to upload.
 
 \tReturns:
-\t\tint: Return code of the os.system call.
+\t\tint: Return code of the subprocess.run 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.

{stouputils-1.15.1 → stouputils-1.16.1}/stouputils/continuous_delivery/stubs.py

@@ -24,7 +24,7 @@ def generate_stubs(
 		package_name  (str): Name of the package to generate stubs for.
 		extra_args    (str): Extra arguments to pass to stubgen. Defaults to "--include-docstrings --include-private".
 	Returns:
-		int: Return code of the os.system call.
+		int: 0 if successful, non-zero otherwise.
 	"""
 	try:
 		from mypy.stubgen import main as stubgen_main

{stouputils-1.15.1 → stouputils-1.16.1}/stouputils/continuous_delivery/stubs.pyi

@@ -10,7 +10,7 @@ def generate_stubs(package_name: str, extra_args: str = '--include-docstrings --
 \t\tpackage_name  (str): Name of the package to generate stubs for.
 \t\textra_args    (str): Extra arguments to pass to stubgen. Defaults to "--include-docstrings --include-private".
 \tReturns:
-\t\tint: Return code of the os.system call.
+\t\tint: 0 if successful, non-zero otherwise.
 \t'''
 def clean_stubs_directory(output_directory: str, package_name: str) -> None:
     """ Clean the stubs directory by deleting all .pyi files.

{stouputils-1.15.1 → stouputils-1.16.1}/stouputils/data_science/scripts/exhaustive_process.py

@@ -2,11 +2,12 @@
 # Imports
 import argparse
 import os
+import subprocess
 import sys
 
 from ...decorators import handle_error, measure_time
-from ...print import info
 from ...parallel import multithreading
+from ...print import info
 from ..config.get import DataScienceConfig
 from ..dataset import LOWER_GS
 from ..models.all import ALL_MODELS, CLASS_MAP
@@ -122,7 +123,7 @@ def exhaustive_process(
 		info(f"Executing command: '{cmd}'")
 		sys.stdout.flush()
 		sys.stderr.flush()
-		os.system(cmd)
+		subprocess.run(cmd, shell=True)
 	multithreading(
 		runner,
 		commands,

{stouputils-1.15.1 → stouputils-1.16.1}/stouputils/image.py

@@ -28,7 +28,7 @@ PIL_Image_or_NDArray = TypeVar("PIL_Image_or_NDArray", bound="Image.Image | NDAr
 def image_resize[PIL_Image_or_NDArray](
 	image: PIL_Image_or_NDArray,
 	max_result_size: int,
-	resampling: "Image.Resampling | None" = None,
+	resampling: Image.Resampling | None = None,
 	min_or_max: Callable[[int, int], int] = max,
 	return_type: type[PIL_Image_or_NDArray] | str = "same",
 	keep_aspect_ratio: bool = True,
@@ -37,7 +37,7 @@ def image_resize[PIL_Image_or_NDArray](
 	Scales the image so that its largest dimension equals max_result_size.
 
 	Args:
-		image             (Image.Image | np.ndarray): The image to resize.
+		image             (Image.Image | NDArray):    The image to resize.
 		max_result_size   (int):                      Maximum size for the largest dimension.
 		resampling        (Image.Resampling | None):  PIL resampling filter to use (default: Image.Resampling.LANCZOS).
 		min_or_max        (Callable):                 Function to use to get the minimum or maximum of the two ratios.
@@ -84,7 +84,7 @@ def image_resize[PIL_Image_or_NDArray](
 
 	# Convert numpy array to PIL Image if needed
 	if not original_was_pil:
-		image = Image.fromarray(image)
+		image = Image.fromarray(image) # type: ignore
 
 	if keep_aspect_ratio:
 
@@ -123,8 +123,8 @@ def image_resize[PIL_Image_or_NDArray](
 
 def auto_crop[PIL_Image_or_NDArray](
 	image: PIL_Image_or_NDArray,
-	mask: "NDArray[np.bool_] | None" = None,
-	threshold: int | float | Callable[["NDArray[np.number]"], int | float] | None = None,
+	mask: NDArray[np.bool_] | None = None,
+	threshold: int | float | Callable[[NDArray[np.number]], int | float] | None = None,
 	return_type: type[PIL_Image_or_NDArray] | str = "same",
 	contiguous: bool = True,
 ) -> Any:
@@ -263,7 +263,7 @@ def auto_crop[PIL_Image_or_NDArray](
 
 def numpy_to_gif(
 	path: str,
-	array: "NDArray[np.integer | np.floating | np.bool_]",
+	array: NDArray[np.integer | np.floating | np.bool_],
 	duration: int = 100,
 	loop: int = 0,
 	mkdir: bool = True,
@@ -344,7 +344,7 @@ def numpy_to_gif(
 
 def numpy_to_obj(
 	path: str,
-	array: "NDArray[np.integer | np.floating | np.bool_]",
+	array: NDArray[np.integer | np.floating | np.bool_],
 	threshold: float = 0.5,
 	step_size: int = 1,
 	pad_array: bool = True,
@@ -372,7 +372,6 @@ def numpy_to_obj(
 	"""
 	# Imports
 	import numpy as np
-	from numpy.typing import NDArray
 	from skimage import measure
 
 	# Assertions

{stouputils-1.15.1 → stouputils-1.16.1}/stouputils/image.pyi

@@ -13,7 +13,7 @@ def image_resize[PIL_Image_or_NDArray](image: PIL_Image_or_NDArray, max_result_s
 \tScales the image so that its largest dimension equals max_result_size.
 
 \tArgs:
-\t\timage             (Image.Image | np.ndarray): The image to resize.
+\t\timage             (Image.Image | NDArray):    The image to resize.
 \t\tmax_result_size   (int):                      Maximum size for the largest dimension.
 \t\tresampling        (Image.Resampling | None):  PIL resampling filter to use (default: Image.Resampling.LANCZOS).
 \t\tmin_or_max        (Callable):                 Function to use to get the minimum or maximum of the two ratios.

{stouputils-1.15.1 → stouputils-1.16.1}/stouputils/parallel.py

@@ -432,36 +432,21 @@ def _set_process_priority(nice_value: int) -> None:
 		if sys.platform == "win32":
 			# Map Unix nice values to Windows priority classes
 			# -20 to -10: HIGH, -9 to -1: ABOVE_NORMAL, 0: NORMAL, 1-9: BELOW_NORMAL, 10-19: IDLE
-			try:
-				import psutil
-				if nice_value <= -10:
-					priority = psutil.HIGH_PRIORITY_CLASS
-				elif nice_value < 0:
-					priority = psutil.ABOVE_NORMAL_PRIORITY_CLASS
-				elif nice_value == 0:
-					priority = psutil.NORMAL_PRIORITY_CLASS
-				elif nice_value < 10:
-					priority = psutil.BELOW_NORMAL_PRIORITY_CLASS
-				else:
-					priority = psutil.IDLE_PRIORITY_CLASS
-				psutil.Process().nice(priority)
-			except ImportError:
-				# Fallback to ctypes if psutil is not available
-				import ctypes
-				# Windows priority class constants
-				if nice_value <= -10:
-					priority = 0x00000080  # HIGH_PRIORITY_CLASS
-				elif nice_value < 0:
-					priority = 0x00008000  # ABOVE_NORMAL_PRIORITY_CLASS
-				elif nice_value == 0:
-					priority = 0x00000020  # NORMAL_PRIORITY_CLASS
-				elif nice_value < 10:
-					priority = 0x00004000  # BELOW_NORMAL_PRIORITY_CLASS
-				else:
-					priority = 0x00000040  # IDLE_PRIORITY_CLASS
-				kernel32 = ctypes.windll.kernel32
-				handle = kernel32.GetCurrentProcess()
-				kernel32.SetPriorityClass(handle, priority)
+			import ctypes
+			# Windows priority class constants
+			if nice_value <= -10:
+				priority = 0x00000080  # HIGH_PRIORITY_CLASS
+			elif nice_value < 0:
+				priority = 0x00008000  # ABOVE_NORMAL_PRIORITY_CLASS
+			elif nice_value == 0:
+				priority = 0x00000020  # NORMAL_PRIORITY_CLASS
+			elif nice_value < 10:
+				priority = 0x00004000  # BELOW_NORMAL_PRIORITY_CLASS
+			else:
+				priority = 0x00000040  # IDLE_PRIORITY_CLASS
+			kernel32 = ctypes.windll.kernel32
+			handle = kernel32.GetCurrentProcess()
+			kernel32.SetPriorityClass(handle, priority)
 		else:
 			# Unix-like systems
 			os.nice(nice_value)

{stouputils-1.15.1 → stouputils-1.16.1}/stouputils/print.py

@@ -36,7 +36,8 @@ T = TypeVar("T")
 
 # Enable colors on Windows 10 terminal if applicable
 if os.name == "nt":
-	os.system("color")
+	import subprocess
+	subprocess.run("color", shell=True)
 
 # Print functions
 previous_args_kwards: tuple[Any, Any] = ((), {})

stouputils-1.16.1/stouputils/typing.py

@@ -0,0 +1,71 @@
+"""
+This module provides utilities for typing enhancements such as JSON type aliases:
+- JsonDict
+- JsonList
+- JsonMap
+- MutJsonMap
+- IterAny
+"""
+
+# Imports
+from collections.abc import Iterable, Mapping, MutableMapping
+from dataclasses import asdict, is_dataclass
+from typing import Any, cast
+
+# Typing aliases
+JsonDict = dict[str, Any]
+""" A type alias for JSON dictionaries """
+JsonList = list[Any]
+""" A type alias for JSON lists """
+JsonMap = Mapping[str, Any]
+""" A type alias for JSON mapping """
+MutJsonMap = MutableMapping[str, Any]
+""" A type alias for mutable JSON mapping """
+IterAny = Iterable[Any]
+""" A type alias for iterable of any type """
+
+
+## Utility functions
+def convert_to_serializable(obj: Any) -> Any:
+	""" Recursively convert objects to JSON-serializable forms.
+
+	Objects with a `to_dict()` or `asdict()` method are converted to their dictionary representation.
+	Dictionaries and lists are recursively processed.
+
+	Can also be used to convert nested structures containing custom objects,
+	such as defaultdict, dataclasses, or other user-defined types.
+
+	Args:
+		obj (Any): The object to convert
+	Returns:
+		Any: The JSON-serializable version of the object
+	Examples:
+		>>> from typing import defaultdict
+		>>> my_dict = defaultdict(lambda: defaultdict(int))
+		>>> my_dict['a']['b'] += 6
+		>>> my_dict['c']['d'] = 4
+		>>> my_dict['a']
+		defaultdict(<class 'int'>, {'b': 6})
+		>>> my_dict['c']
+		defaultdict(<class 'int'>, {'d': 4})
+		>>> convert_to_serializable(my_dict)
+		{'a': {'b': 6}, 'c': {'d': 4}}
+
+		>>> from dataclasses import dataclass
+		>>> @dataclass
+		... class Point:
+		...     x: int
+		...     y: int
+		>>> convert_to_serializable(Point(3, 4))
+		{'x': 3, 'y': 4}
+	"""
+	if hasattr(obj, "to_dict"):
+		return obj.to_dict()
+	elif is_dataclass(obj):
+		return asdict(obj) # pyright: ignore[reportArgumentType]
+	elif isinstance(obj, dict | Mapping | MutableMapping):
+		return {k: convert_to_serializable(v) for k, v in cast(JsonDict, obj).items()}
+	elif isinstance(obj, Iterable) and not isinstance(obj, (str, bytes)):
+		return [convert_to_serializable(item) for item in cast(IterAny, obj)]
+	return obj
+

stouputils-1.16.1/stouputils/typing.pyi

@@ -0,0 +1,42 @@
+from collections.abc import Iterable, Mapping, MutableMapping
+from typing import Any
+
+JsonDict = dict[str, Any]
+JsonList = list[Any]
+JsonMap = Mapping[str, Any]
+MutJsonMap = MutableMapping[str, Any]
+IterAny = Iterable[Any]
+
+def convert_to_serializable(obj: Any) -> Any:
+    """ Recursively convert objects to JSON-serializable forms.
+
+\tObjects with a `to_dict()` or `asdict()` method are converted to their dictionary representation.
+\tDictionaries and lists are recursively processed.
+
+\tCan also be used to convert nested structures containing custom objects,
+\tsuch as defaultdict, dataclasses, or other user-defined types.
+
+\tArgs:
+\t\tobj (Any): The object to convert
+\tReturns:
+\t\tAny: The JSON-serializable version of the object
+\tExamples:
+\t\t>>> from typing import defaultdict
+\t\t>>> my_dict = defaultdict(lambda: defaultdict(int))
+\t\t>>> my_dict['a']['b'] += 6
+\t\t>>> my_dict['c']['d'] = 4
+\t\t>>> my_dict['a']
+\t\tdefaultdict(<class 'int'>, {'b': 6})
+\t\t>>> my_dict['c']
+\t\tdefaultdict(<class 'int'>, {'d': 4})
+\t\t>>> convert_to_serializable(my_dict)
+\t\t{'a': {'b': 6}, 'c': {'d': 4}}
+
+\t\t>>> from dataclasses import dataclass
+\t\t>>> @dataclass
+\t\t... class Point:
+\t\t...     x: int
+\t\t...     y: int
+\t\t>>> convert_to_serializable(Point(3, 4))
+\t\t{'x': 3, 'y': 4}
+\t"""