stouputils 1.2.35__tar.gz → 1.2.36__tar.gz

{stouputils-1.2.35 → stouputils-1.2.36}/.gitignore

@@ -1,15 +1,21 @@
-
-# Python
-*__pycache__/
-
-# Miscellaneous
-__temporary__/
-output.log
-logfile.txt
-
-# Documentation
-docs/source/_static/
-docs/source/_templates/
-docs/source/modules/
-docs/source/index.rst
-
+
+# Python
+*__pycache__/
+
+# Miscellaneous
+__temporary__/
+output.log
+logfile.txt
+
+# Documentation
+docs/source/_static/
+docs/source/_templates/
+docs/source/modules/
+docs/source/index.rst
+
+# Examples
+examples/archive/repaired.zip
+examples/upscaler/input/*.mp4
+examples/upscaler/progress/
+examples/upscaler/output/
+

{stouputils-1.2.35 → stouputils-1.2.36}/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2024 Alexandre Collignon
-
-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) 2024 Alexandre Collignon
+
+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.

{stouputils-1.2.35 → stouputils-1.2.36}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: stouputils
-Version: 1.2.35
+Version: 1.2.36
 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.
 Project-URL: Homepage, https://github.com/Stoupy51/stouputils
 Project-URL: Issues, https://github.com/Stoupy51/stouputils/issues

{stouputils-1.2.35 → stouputils-1.2.36}/README.md

@@ -1,78 +1,78 @@
-# 🛠️ Project Badges
-[![GitHub](https://img.shields.io/github/v/release/Stoupy51/stouputils?logo=github&label=GitHub)](https://github.com/Stoupy51/stouputils/releases/latest)
-[![PyPI - Downloads](https://img.shields.io/pypi/dm/stouputils?logo=python&label=PyPI%20downloads)](https://pypi.org/project/stouputils/)
-[![Documentation](https://img.shields.io/github/v/release/Stoupy51/stouputils?logo=sphinx&label=Documentation&color=purple)](https://stoupy51.github.io/stouputils/latest/)
-
-<br>
-
-# 📚 Project Overview
-Stouputils is a collection of utility modules designed to simplify and enhance the development process.<br>
-It includes a range of tools for tasks such as execution of doctests, display utilities, decorators, as well as context managers.
-
-
-# 🚀 Project File Tree
-<html>
-<details style="display: none;">
-<summary></summary>
-<style>
-.code-tree {
-	border-radius: 6px; 
-	padding: 16px; 
-	font-family: monospace; 
-	line-height: 1.45; 
-	overflow: auto; 
-	white-space: pre;
-	background-color:rgb(43, 43, 43);
-	color: #d4d4d4;
-}
-.code-tree a {
-	color: #569cd6;
-	text-decoration: none;
-}
-.code-tree a:hover {
-	text-decoration: underline;
-}
-.code-tree .comment {
-	color:rgb(231, 213, 48);
-}
-</style>
-</details>
-
-<pre class="code-tree">stouputils/
-├── <a href="https://stoupy51.github.io/stouputils/latest/modules/stouputils.applications.html">applications/</a>
-│   ├── <a href="https://stoupy51.github.io/stouputils/latest/modules/stouputils.applications.automatic_docs.html">automatic_docs.py</a>    <span class="comment"># 📚 Documentation generation utilities (used to create this documentation)</span>
-│   └── ...
-│
-├── <a href="https://stoupy51.github.io/stouputils/latest/modules/stouputils.continuous_delivery.html">continuous_delivery/</a>
-│   ├── <a href="https://stoupy51.github.io/stouputils/latest/modules/stouputils.continuous_delivery.cd_utils.html">cd_utils.py</a>          <span class="comment"># 🔧 Common utilities for continuous delivery</span>
-│   ├── <a href="https://stoupy51.github.io/stouputils/latest/modules/stouputils.continuous_delivery.github.html">github.py</a>            <span class="comment"># 📦 GitHub utilities (upload_to_github)</span>
-│   ├── <a href="https://stoupy51.github.io/stouputils/latest/modules/stouputils.continuous_delivery.pypi.html">pypi.py</a>              <span class="comment"># 📦 PyPI utilities (pypi_full_routine)</span>
-│   ├── <a href="https://stoupy51.github.io/stouputils/latest/modules/stouputils.continuous_delivery.pyproject.html">pyproject.py</a>         <span class="comment"># 📝 Pyproject.toml utilities</span>
-│   └── ...
-│
-├── <a href="https://stoupy51.github.io/stouputils/latest/modules/stouputils.all_doctests.html">all_doctests.py</a>          <span class="comment"># ✅ Execution of all doctests for a given path</span>
-├── <a href="https://stoupy51.github.io/stouputils/latest/modules/stouputils.archive.html">archive.py</a>               <span class="comment"># 📦 Archive utilities (zip, repair_zip)</span>
-├── <a href="https://stoupy51.github.io/stouputils/latest/modules/stouputils.backup.html">backup.py</a>                <span class="comment"># 📦 Backup utilities (delta backup, consolidate)</span>
-├── <a href="https://stoupy51.github.io/stouputils/latest/modules/stouputils.collections.html">collections.py</a>           <span class="comment"># 🧰 Collection utilities (unique_list)</span>
-├── <a href="https://stoupy51.github.io/stouputils/latest/modules/stouputils.ctx.html">ctx.py</a>                   <span class="comment"># 🚫 Context managers (Muffle, LogToFile)</span>
-├── <a href="https://stoupy51.github.io/stouputils/latest/modules/stouputils.decorators.html">decorators.py</a>            <span class="comment"># 🎯 Decorators (silent, measure_time, error_handler, simple_cache)</span>
-├── <a href="https://stoupy51.github.io/stouputils/latest/modules/stouputils.image.html">image.py</a>                 <span class="comment"># 🖼️ Image utilities (image_resize)</span>
-├── <a href="https://stoupy51.github.io/stouputils/latest/modules/stouputils.io.html">io.py</a>                    <span class="comment"># 💻 I/O utilities (file management, json)</span>
-├── <a href="https://stoupy51.github.io/stouputils/latest/modules/stouputils.parallel.html">parallel.py</a>              <span class="comment"># 🧑‍🤝‍🧑 Parallel processing (multiprocessing, multithreading)</span>
-├── <a href="https://stoupy51.github.io/stouputils/latest/modules/stouputils.print.html">print.py</a>                 <span class="comment"># 🖨️ Display utilities (info, debug, warning, error)</span>
-└── ...
-</pre>
-</html>
-
-## ⭐ Star History
-
-<html>
-	<a href="https://star-history.com/#Stoupy51/stouputils&Date">
-		<picture>
-			<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=Stoupy51/stouputils&type=Date&theme=dark" />
-			<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=Stoupy51/stouputils&type=Date" />
-			<img alt="Star History Chart" src="https://api.star-history.com/svg?repos=Stoupy51/stouputils&type=Date" />
-		</picture>
-	</a>
-</html>
-
+# 🛠️ Project Badges
+[![GitHub](https://img.shields.io/github/v/release/Stoupy51/stouputils?logo=github&label=GitHub)](https://github.com/Stoupy51/stouputils/releases/latest)
+[![PyPI - Downloads](https://img.shields.io/pypi/dm/stouputils?logo=python&label=PyPI%20downloads)](https://pypi.org/project/stouputils/)
+[![Documentation](https://img.shields.io/github/v/release/Stoupy51/stouputils?logo=sphinx&label=Documentation&color=purple)](https://stoupy51.github.io/stouputils/latest/)
+
+<br>
+
+# 📚 Project Overview
+Stouputils is a collection of utility modules designed to simplify and enhance the development process.<br>
+It includes a range of tools for tasks such as execution of doctests, display utilities, decorators, as well as context managers.
+
+
+# 🚀 Project File Tree
+<html>
+<details style="display: none;">
+<summary></summary>
+<style>
+.code-tree {
+	border-radius: 6px; 
+	padding: 16px; 
+	font-family: monospace; 
+	line-height: 1.45; 
+	overflow: auto; 
+	white-space: pre;
+	background-color:rgb(43, 43, 43);
+	color: #d4d4d4;
+}
+.code-tree a {
+	color: #569cd6;
+	text-decoration: none;
+}
+.code-tree a:hover {
+	text-decoration: underline;
+}
+.code-tree .comment {
+	color:rgb(231, 213, 48);
+}
+</style>
+</details>
+
+<pre class="code-tree">stouputils/
+├── <a href="https://stoupy51.github.io/stouputils/latest/modules/stouputils.applications.html">applications/</a>
+│   ├── <a href="https://stoupy51.github.io/stouputils/latest/modules/stouputils.applications.automatic_docs.html">automatic_docs.py</a>    <span class="comment"># 📚 Documentation generation utilities (used to create this documentation)</span>
+│   └── ...
+│
+├── <a href="https://stoupy51.github.io/stouputils/latest/modules/stouputils.continuous_delivery.html">continuous_delivery/</a>
+│   ├── <a href="https://stoupy51.github.io/stouputils/latest/modules/stouputils.continuous_delivery.cd_utils.html">cd_utils.py</a>          <span class="comment"># 🔧 Common utilities for continuous delivery</span>
+│   ├── <a href="https://stoupy51.github.io/stouputils/latest/modules/stouputils.continuous_delivery.github.html">github.py</a>            <span class="comment"># 📦 GitHub utilities (upload_to_github)</span>
+│   ├── <a href="https://stoupy51.github.io/stouputils/latest/modules/stouputils.continuous_delivery.pypi.html">pypi.py</a>              <span class="comment"># 📦 PyPI utilities (pypi_full_routine)</span>
+│   ├── <a href="https://stoupy51.github.io/stouputils/latest/modules/stouputils.continuous_delivery.pyproject.html">pyproject.py</a>         <span class="comment"># 📝 Pyproject.toml utilities</span>
+│   └── ...
+│
+├── <a href="https://stoupy51.github.io/stouputils/latest/modules/stouputils.all_doctests.html">all_doctests.py</a>          <span class="comment"># ✅ Execution of all doctests for a given path</span>
+├── <a href="https://stoupy51.github.io/stouputils/latest/modules/stouputils.archive.html">archive.py</a>               <span class="comment"># 📦 Archive utilities (zip, repair_zip)</span>
+├── <a href="https://stoupy51.github.io/stouputils/latest/modules/stouputils.backup.html">backup.py</a>                <span class="comment"># 📦 Backup utilities (delta backup, consolidate)</span>
+├── <a href="https://stoupy51.github.io/stouputils/latest/modules/stouputils.collections.html">collections.py</a>           <span class="comment"># 🧰 Collection utilities (unique_list)</span>
+├── <a href="https://stoupy51.github.io/stouputils/latest/modules/stouputils.ctx.html">ctx.py</a>                   <span class="comment"># 🚫 Context managers (Muffle, LogToFile)</span>
+├── <a href="https://stoupy51.github.io/stouputils/latest/modules/stouputils.decorators.html">decorators.py</a>            <span class="comment"># 🎯 Decorators (silent, measure_time, error_handler, simple_cache)</span>
+├── <a href="https://stoupy51.github.io/stouputils/latest/modules/stouputils.image.html">image.py</a>                 <span class="comment"># 🖼️ Image utilities (image_resize)</span>
+├── <a href="https://stoupy51.github.io/stouputils/latest/modules/stouputils.io.html">io.py</a>                    <span class="comment"># 💻 I/O utilities (file management, json)</span>
+├── <a href="https://stoupy51.github.io/stouputils/latest/modules/stouputils.parallel.html">parallel.py</a>              <span class="comment"># 🧑‍🤝‍🧑 Parallel processing (multiprocessing, multithreading)</span>
+├── <a href="https://stoupy51.github.io/stouputils/latest/modules/stouputils.print.html">print.py</a>                 <span class="comment"># 🖨️ Display utilities (info, debug, warning, error)</span>
+└── ...
+</pre>
+</html>
+
+## ⭐ Star History
+
+<html>
+	<a href="https://star-history.com/#Stoupy51/stouputils&Date">
+		<picture>
+			<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=Stoupy51/stouputils&type=Date&theme=dark" />
+			<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=Stoupy51/stouputils&type=Date" />
+			<img alt="Star History Chart" src="https://api.star-history.com/svg?repos=Stoupy51/stouputils&type=Date" />
+		</picture>
+	</a>
+</html>
+

{stouputils-1.2.35 → stouputils-1.2.36}/pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "stouputils"
-version = "1.2.35"
+version = "1.2.36"
 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"
 requires-python = ">=3.10"
@@ -34,6 +34,38 @@ Issues = "https://github.com/Stoupy51/stouputils/issues"
 [tool.pyright]
 typeCheckingMode = "strict"
 
+[tool.ruff]
+exclude = [
+	".git",
+	".ruff_cache",
+	".venv",
+	".vscode",
+	".cursor",
+	"build",
+	"dist",
+]
+line-length = 200
+
 [tool.hatch.build]
 include = ["stouputils"]
 
+[tool.ruff.lint]
+select = [
+	"E",
+	"W",
+	"F",
+	"I",
+	"N",
+	"UP",
+	"B",
+	"C4",
+	"T20",
+	"RUF",
+]
+ignore = [
+	"T201",
+	"W191",
+	"N803",
+	"N806",
+]
+

{stouputils-1.2.35 → stouputils-1.2.36}/stouputils/__init__.py

@@ -1,32 +1,33 @@
-""" 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
-
-"""
-
-# Imports
-from .print import *
-from .archive import *
-from .io import *
-from .decorators import *
-from .ctx import *
-from .parallel import *
-from .all_doctests import *
-from .collections import *
-from .backup import *
-from .image import *
-
-# Folders
-from .continuous_delivery import *
-
+""" 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
+
+"""
+# ruff: noqa: F403
+
+# Imports
+from .all_doctests import *
+from .archive import *
+from .backup import *
+from .collections import *
+
+# Folders
+from .continuous_delivery import *
+from .ctx import *
+from .decorators import *
+from .image import *
+from .io import *
+from .parallel import *
+from .print import *
+

{stouputils-1.2.35 → stouputils-1.2.36}/stouputils/all_doctests.py

@@ -1,107 +1,113 @@
-"""
-This module is used to run all the doctests for all the modules in a given directory.
-
-.. image:: https://raw.githubusercontent.com/Stoupy51/stouputils/refs/heads/main/assets/all_doctests_module.gif
-  :alt: stouputils all_doctests examples
-"""
-
-# Imports
-import os
-import sys
-from .print import info, error, progress
-from .decorators import measure_time, handle_error, LogLevels
-from . import decorators
-from doctest import TestResults, testmod
-from types import ModuleType
-import importlib
-import pkgutil
-
-def test_module_with_progress(module: ModuleType, separator: str) -> TestResults:
-	@measure_time(progress, message=f"Testing module '{module.__name__}' {separator}took")
-	def internal() -> TestResults:
-		return testmod(m=module)
-	return internal()
-
-# Main program
-def launch_tests(root_dir: str, importing_errors: LogLevels = LogLevels.WARNING_TRACEBACK, strict: bool = True) -> int:
-	""" Main function to launch tests for all modules in the given directory.
-
-	Args:
-		root_dir				(str):			Root directory to search for modules
-		importing_errors		(LogLevels):	Log level for the errors when importing modules
-		strict					(bool):			Modify the force_raise_exception variable to True in the decorators module
-
-	Returns:
-		int: The number of failed tests
-
-	Examples:
-		>>> launch_tests("unknown_dir")
-		Traceback (most recent call last):
-			...
-		ValueError: No modules found in 'unknown_dir'
-
-	.. code-block:: python
-
-		> if launch_tests("/path/to/source") > 0:
-			sys.exit(1)
-		[PROGRESS HH:MM:SS] Importing module 'module1'	took 0.001s
-		[PROGRESS HH:MM:SS] Importing module 'module2'	took 0.002s
-		[PROGRESS HH:MM:SS] Importing module 'module3'	took 0.003s
-		[PROGRESS HH:MM:SS] Importing module 'module4'	took 0.004s
-		[INFO HH:MM:SS] Testing 4 modules...
-		[PROGRESS HH:MM:SS] Testing module 'module1'	took 0.005s
-		[PROGRESS HH:MM:SS] Testing module 'module2'	took 0.006s
-		[PROGRESS HH:MM:SS] Testing module 'module3'	took 0.007s
-		[PROGRESS HH:MM:SS] Testing module 'module4'	took 0.008s
-	"""
-	if strict:
-		old_value: bool = strict
-		decorators.force_raise_exception = True
-		strict = old_value
-
-
-	# Get all modules from folder
-	sys.path.insert(0, root_dir)
-	modules_file_paths: list[str] = []
-	for directory_path, _, _ in os.walk(root_dir):
-		for module_info in pkgutil.walk_packages([directory_path]):
-			absolute_module_path: str = os.path.join(directory_path, module_info.name)
-			path: str = absolute_module_path.split(root_dir, 1)[1].replace(os.sep, ".")[1:]
-			if path not in modules_file_paths:
-				modules_file_paths.append(path)
-	if not modules_file_paths:
-		raise ValueError(f"No modules found in '{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
-	modules: list[ModuleType] = []
-	separators: list[str] = []
-	for module_path in modules_file_paths:
-		separator: str = " " * (max_length - len(module_path))
-		@handle_error(error_log=importing_errors)
-		@measure_time(progress, message=f"Importing module '{module_path}' {separator}took")
-		def internal() -> None:
-			modules.append(importlib.import_module(module_path))
-			separators.append(separator)
-		internal()
-
-	# Run tests for each module
-	info(f"Testing {len(modules)} modules...")
-	separators = [s + " "*(len("Importing") - len("Testing")) for s in separators]
-	results: list[TestResults] = [test_module_with_progress(module, separator) for module, separator in zip(modules, separators)]
-
-	# Display any error lines for each module at the end of the script
-	nb_failed_tests: int = 0
-	for module, result in zip(modules, results):
-		if result.failed > 0:
-			error(f"Errors in module {module.__name__}", exit=False)
-			nb_failed_tests += result.failed
-
-	# Reset force_raise_exception back
-	decorators.force_raise_exception = strict
-
-	# Return the number of failed tests
-	return nb_failed_tests
-
+"""
+This module is used to run all the doctests for all the modules in a given directory.
+
+.. image:: https://raw.githubusercontent.com/Stoupy51/stouputils/refs/heads/main/assets/all_doctests_module.gif
+  :alt: stouputils all_doctests examples
+"""
+
+# Imports
+import importlib
+import os
+import pkgutil
+import sys
+from doctest import TestResults, testmod
+from types import ModuleType
+
+from . import decorators
+from .decorators import LogLevels, handle_error, measure_time
+from .print import error, info, progress
+
+
+def test_module_with_progress(module: ModuleType, separator: str) -> TestResults:
+	@measure_time(progress, message=f"Testing module '{module.__name__}' {separator}took")
+	def internal() -> TestResults:
+		return testmod(m=module)
+	return internal()
+
+# Main program
+def launch_tests(root_dir: str, importing_errors: LogLevels = LogLevels.WARNING_TRACEBACK, strict: bool = True) -> int:
+	""" Main function to launch tests for all modules in the given directory.
+
+	Args:
+		root_dir				(str):			Root directory to search for modules
+		importing_errors		(LogLevels):	Log level for the errors when importing modules
+		strict					(bool):			Modify the force_raise_exception variable to True in the decorators module
+
+	Returns:
+		int: The number of failed tests
+
+	Examples:
+		>>> launch_tests("unknown_dir")
+		Traceback (most recent call last):
+			...
+		ValueError: No modules found in 'unknown_dir'
+
+	.. code-block:: python
+
+		> if launch_tests("/path/to/source") > 0:
+			sys.exit(1)
+		[PROGRESS HH:MM:SS] Importing module 'module1'	took 0.001s
+		[PROGRESS HH:MM:SS] Importing module 'module2'	took 0.002s
+		[PROGRESS HH:MM:SS] Importing module 'module3'	took 0.003s
+		[PROGRESS HH:MM:SS] Importing module 'module4'	took 0.004s
+		[INFO HH:MM:SS] Testing 4 modules...
+		[PROGRESS HH:MM:SS] Testing module 'module1'	took 0.005s
+		[PROGRESS HH:MM:SS] Testing module 'module2'	took 0.006s
+		[PROGRESS HH:MM:SS] Testing module 'module3'	took 0.007s
+		[PROGRESS HH:MM:SS] Testing module 'module4'	took 0.008s
+	"""
+	if strict:
+		old_value: bool = strict
+		decorators.force_raise_exception = True
+		strict = old_value
+
+
+	# Get all modules from folder
+	sys.path.insert(0, root_dir)
+	modules_file_paths: list[str] = []
+	for directory_path, _, _ in os.walk(root_dir):
+		for module_info in pkgutil.walk_packages([directory_path]):
+			absolute_module_path: str = os.path.join(directory_path, module_info.name)
+			path: str = absolute_module_path.split(root_dir, 1)[1].replace(os.sep, ".")[1:]
+			if path not in modules_file_paths:
+				modules_file_paths.append(path)
+	if not modules_file_paths:
+		raise ValueError(f"No modules found in '{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
+	modules: list[ModuleType] = []
+	separators: list[str] = []
+	for module_path in modules_file_paths:
+		separator: str = " " * (max_length - len(module_path))
+
+		@handle_error(error_log=importing_errors)
+		@measure_time(progress, message=f"Importing module '{module_path}' {separator}took")
+		def internal(a: str = module_path, b: str = separator) -> None:
+			modules.append(importlib.import_module(a))
+			separators.append(b)
+		internal()
+
+	# Run tests for each module
+	info(f"Testing {len(modules)} modules...")
+	separators = [s + " "*(len("Importing") - len("Testing")) for s in separators]
+	results: list[TestResults] = [
+		test_module_with_progress(module, separator)
+		for module, separator in zip(modules, separators, strict=False)
+	]
+
+	# Display any error lines for each module at the end of the script
+	nb_failed_tests: int = 0
+	for module, result in zip(modules, results, strict=False):
+		if result.failed > 0:
+			error(f"Errors in module {module.__name__}", exit=False)
+			nb_failed_tests += result.failed
+
+	# Reset force_raise_exception back
+	decorators.force_raise_exception = strict
+
+	# Return the number of failed tests
+	return nb_failed_tests
+

{stouputils-1.2.35 → stouputils-1.2.36}/stouputils/applications/__init__.py

@@ -2,14 +2,21 @@
 
 This module provides higher-level utilities for specific application needs:
 
-Key Features:
+Automatic Documentation:
+
 - Automatic documentation generation with Sphinx: `update_documentation(...)`
 - Support for multi-version documentation
 - GitHub Pages integration
 - Markdown to RST conversion
 
+Upscaler:
+
+- TODO
+
 """
+# ruff: noqa: F403
 
 # Imports
 from .automatic_docs import *
+from .upscaler import *