stouputils 1.2.15__tar.gz → 1.2.17__tar.gz

{stouputils-1.2.15 → stouputils-1.2.17}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: stouputils
-Version: 1.2.15
+Version: 1.2.17
 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
@@ -14,6 +14,9 @@ Requires-Dist: furo>=2024.8.6
 Requires-Dist: hatch>=1.14.0
 Requires-Dist: m2r2>=0.3.3.post2
 Requires-Dist: myst-parser>=4.0.1
+Requires-Dist: numpy>=2.2.4
+Requires-Dist: opencv-python>=4.8.1.78
+Requires-Dist: pillow>=11.1.0
 Requires-Dist: pyyaml>=6.0.0
 Requires-Dist: requests>=2.30.0
 Requires-Dist: sphinx-rtd-theme>=3.0.2

{stouputils-1.2.15 → stouputils-1.2.17}/pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "stouputils"
-version = "1.2.15"
+version = "1.2.17"
 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"
@@ -25,6 +25,9 @@ dependencies = [
 	"myst-parser>=4.0.1",
 	"furo>=2024.8.6",
 	"hatch>=1.14.0",
+	"pillow>=11.1.0",
+	"numpy>=2.2.4",
+	"opencv-python>=4.8.1.78",
 ]
 [[project.authors]]
 name = "Stoupy51"

{stouputils-1.2.15 → stouputils-1.2.17}/stouputils/all_doctests.py

@@ -30,10 +30,10 @@ def launch_tests(root_dir: str, importing_errors: LogLevels = LogLevels.WARNING_
 		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):

{stouputils-1.2.15 → stouputils-1.2.17}/stouputils/applications/automatic_docs.py

@@ -276,7 +276,7 @@ def generate_index_rst(
 	get_versions_function: Callable[[str, str], list[str]] = get_versions_from_github,
 ) -> None:
 	""" Generate index.rst from README.md content.
-	
+
 	Args:
 		readme_path             (str): Path to the README.md file
 		index_path             (str): Path where index.rst should be created
@@ -291,10 +291,10 @@ def generate_index_rst(
 
 	# Generate version selector
 	version_selector: str = "\n\n**Versions**: "
-	
+
 	# Get versions from GitHub
 	version_list: list[str] = get_versions_function(github_user, github_repo)
-	
+
 	# Create version links
 	version_links: list[str] = []
 	for version in version_list:
@@ -303,7 +303,7 @@ def generate_index_rst(
 		else:
 			version_links.append(f"`v{version} <../v{version}/index.html>`_")
 	version_selector += ", ".join(version_links)
-		
+
 	# Generate module documentation section
 	project_module: str = project.lower()
 	module_docs: str = f"""
@@ -325,7 +325,7 @@ def generate_index_rst(
 {'-' * 100}
 {module_docs}
 """
-	
+
 	# Write the RST file
 	with open(index_path, "w", encoding="utf-8") as f:
 		f.write(rst_content)
@@ -444,7 +444,7 @@ def update_documentation(
 	# Modify build directory if version is specified
 	latest_dir: str = f"{html_dir}/latest"
 	build_dir: str = latest_dir if not version else f"{html_dir}/v{version}"
-	
+
 	# Create directories if they don't exist
 	for dir in [modules_dir, static_dir, templates_dir]:
 		os.makedirs(dir, exist_ok=True)
@@ -495,7 +495,7 @@ def update_documentation(
 		project_dir=project_dir if project_dir else f"{root_path}/{project}",
 		build_dir=build_dir,
 	)
-	
+
 	# Add index.html to the build directory that redirects to the latest version
 	generate_redirect_function(f"{html_dir}/index.html")
 

{stouputils-1.2.15 → stouputils-1.2.17}/stouputils/archive.py

@@ -86,7 +86,7 @@ def repair_zip_file(file_path: str, destination: str) -> bool:
 		destination		(str):	Destination of the new file
 	Returns:
 		bool: Always returns True unless any strong error
-	
+
 	Examples:
 
 	.. code-block:: python
@@ -113,7 +113,7 @@ def repair_zip_file(file_path: str, destination: str) -> bool:
 					new_zip_file.writestr(file_name, zip_file.read(file_name))
 				except KeyboardInterrupt:
 					continue
-	
+
 	return True
 
 

{stouputils-1.2.15 → stouputils-1.2.17}/stouputils/backup.py

@@ -155,11 +155,11 @@ def create_delta_backup(source_path: str, destination_folder: str, exclude_patte
 				for file in files:
 					full_path: str = clean_path(os.path.join(root, file))
 					arcname: str = clean_path(os.path.relpath(full_path, start=os.path.dirname(source_path)))
-					
+
 					# Skip file if it matches any exclude pattern
 					if exclude_patterns and any(fnmatch.fnmatch(arcname, pattern) for pattern in exclude_patterns):
 						continue
-					
+
 					file_hash: str | None = get_file_hash(full_path)
 					if file_hash is None:
 						continue
@@ -170,7 +170,7 @@ def create_delta_backup(source_path: str, destination_folder: str, exclude_patte
 							zip_info: zipfile.ZipInfo = zipfile.ZipInfo(arcname)
 							zip_info.compress_type = zipfile.ZIP_DEFLATED
 							zip_info.comment = file_hash.encode()  # Store hash in comment
-							
+
 							# Read and write file in chunks
 							with open(full_path, "rb") as f:
 								with zipf.open(zip_info, "w", force_zip64=True) as zf:
@@ -179,20 +179,20 @@ def create_delta_backup(source_path: str, destination_folder: str, exclude_patte
 							has_changes = True
 						except Exception as e:
 							warning(f"Error writing file {full_path} to backup: {e}")
-					
+
 					# Track current files for deletion detection
 					if arcname in previous_files:
 						previous_files.remove(arcname)
 		else:
 			arcname: str = clean_path(os.path.basename(source_path))
 			file_hash: str | None = get_file_hash(source_path)
-			
+
 			if file_hash is not None and not is_file_in_any_previous_backup(arcname, file_hash, previous_backups):
 				try:
 					zip_info: zipfile.ZipInfo = zipfile.ZipInfo(arcname)
 					zip_info.compress_type = zipfile.ZIP_DEFLATED
 					zip_info.comment = file_hash.encode()
-					
+
 					with open(source_path, "rb") as f:
 						with zipf.open(zip_info, "w", force_zip64=True) as zf:
 							for chunk in iter(lambda: f.read(4096), b""):
@@ -260,7 +260,7 @@ def consolidate_backups(zip_path: str, destination_zip: str) -> None:
 						and filename not in final_files \
 						and filename not in deleted_files:
 						final_files.add(filename)
-						
+
 						# Copy file in chunks
 						with zipf_in.open(inf, "r") as source:
 							with zipf_out.open(inf, "w", force_zip64=True) as target:

{stouputils-1.2.15 → stouputils-1.2.17}/stouputils/collections.py

@@ -19,7 +19,7 @@ def unique_list(list_to_clean: list[Any], method: Literal["id", "hash", "str"] =
 		method			(Literal["id", "hash", "str"]):	The method to use to identify duplicates
 	Returns:
 		list[Any]: The cleaned list
-	
+
 	Examples:
 		>>> unique_list([1, 2, 3, 2, 1], method="id")
 		[1, 2, 3]

{stouputils-1.2.15 → stouputils-1.2.17}/stouputils/continuous_delivery/cd_utils.py

@@ -50,7 +50,7 @@ def load_credentials(credentials_path: str) -> dict[str, Any]:
 	# Check if the file exists
 	if not os.path.exists(credentials_path):
 		raise FileNotFoundError(f"Credentials file not found at '{credentials_path}'")
-	
+
 	# Load the file if it's a JSON file
 	if credentials_path.endswith(".json"):
 		return super_json_load(credentials_path)
@@ -59,7 +59,7 @@ def load_credentials(credentials_path: str) -> dict[str, Any]:
 	elif credentials_path.endswith((".yml", ".yaml")):
 		with open(credentials_path, "r") as f:
 			return yaml.safe_load(f)
-			
+
 	# Else, raise an error
 	else:
 		raise ValueError("Credentials file must be .json or .yml format")
@@ -87,7 +87,7 @@ def clean_version(version: str, keep: str = "") -> str:
 		keep	(str): The characters to keep in the version string
 	Returns:
 		str: The cleaned version string
-	
+
 	>>> clean_version("v1.e0.zfezf0.1.2.3zefz")
 	'1.0.0.1.2.3'
 	>>> clean_version("v1.e0.zfezf0.1.2.3zefz", keep="v")
@@ -107,7 +107,7 @@ def version_to_float(version: str) -> float:
 		version (str): The version string to convert. (e.g. "v1.0.0.1.2.3")
 	Returns:
 		float: The float representation of the version. (e.g. 0)
-	
+
 	>>> version_to_float("v1.0.0")
 	1.0
 	>>> version_to_float("v1.0.0.1")

{stouputils-1.2.15 → stouputils-1.2.17}/stouputils/continuous_delivery/github.py

@@ -41,7 +41,7 @@ def validate_credentials(credentials: dict[str, dict[str, str]]) -> tuple[str, d
 	Returns:
 		tuple[str, dict[str, str]]:
 			str:			Owner (the username of the account to use)
-			
+
 			dict[str, str]:	Headers (for the requests to the GitHub API)
 	"""
 	if "github" not in credentials:
@@ -50,7 +50,7 @@ def validate_credentials(credentials: dict[str, dict[str, str]]) -> tuple[str, d
 		raise ValueError("The credentials file must contain a 'github' key, which is a dictionary containing a 'api_key' key (a PAT for the GitHub API: https://github.com/settings/tokens) and a 'username' key (the username of the account to use)")
 	if "username" not in credentials["github"]:
 		raise ValueError("The credentials file must contain a 'github' key, which is a dictionary containing a 'api_key' key (a PAT for the GitHub API: https://github.com/settings/tokens) and a 'username' key (the username of the account to use)")
-	
+
 	api_key: str = credentials["github"]["api_key"]
 	owner: str = credentials["github"]["username"]
 	headers: dict[str, str] = {"Authorization": f"Bearer {api_key}"}
@@ -64,11 +64,11 @@ def validate_config(github_config: dict[str, Any]) -> tuple[str, str, str, list[
 	Returns:
 		tuple[str, str, str, list[str]]:
 			str: Project name on GitHub
-			
+
 			str: Version of the project
-			
+
 			str: Build folder path containing zip files to upload to the release
-			
+
 			list[str]: List of zip files to upload to the release
 	"""
 	if "project_name" not in github_config:
@@ -182,10 +182,10 @@ def get_commits_since_tag(owner: str, project_name: str, latest_tag_sha: str|Non
 	# Get the commits URL and parameters
 	commits_url: str = f"{PROJECT_ENDPOINT}/{owner}/{project_name}/commits"
 	commits_params: dict[str, str] = {"per_page": "100"}
-	
+
 	# Initialize tag_date as None
 	tag_date: str|None = None	# type: ignore
-	
+
 	# If there is a latest tag, use it to get the commits since the tag date
 	if latest_tag_sha:
 
@@ -194,10 +194,10 @@ def get_commits_since_tag(owner: str, project_name: str, latest_tag_sha: str|Non
 		tag_response = requests.get(tag_commit_url, headers=headers)
 		handle_response(tag_response, "Failed to get tag commit")
 		tag_date: str = tag_response.json()["commit"]["committer"]["date"]
-		
+
 		# Use the date as the 'since' parameter to get all commits after that date
 		commits_params["since"] = tag_date
-	
+
 	# Get the commits
 	response = requests.get(commits_url, headers=headers, params=commits_params)
 	handle_response(response, "Failed to get commits")
@@ -210,7 +210,7 @@ def get_commits_since_tag(owner: str, project_name: str, latest_tag_sha: str|Non
 
 def generate_changelog(commits: list[dict[str, Any]], owner: str, project_name: str, latest_tag_version: str|None, version: str) -> str:
 	""" Generate changelog from commits. They must follow the conventional commits convention.
-	
+
 	Convention format: <type>: <description>
 
 	Args:
@@ -226,21 +226,21 @@ def generate_changelog(commits: list[dict[str, Any]], owner: str, project_name:
 	"""
 	# Initialize the commit groups
 	commit_groups: dict[str, list[tuple[str, str]]] = {}
-	
+
 	# Iterate over the commits
 	for commit in commits:
 		message: str = commit["commit"]["message"].split("\n")[0]
 		sha: str = commit["sha"]
-		
+
 		# If the message contains a colon, split the message into a type and a description
 		if ":" in message:
 			type_, desc = message.split(":", 1)
-			
+
 			# Clean the type
 			type_ = type_.split('(')[0]
 			type_ = "".join(c for c in type_.lower().strip() if c in "abcdefghijklmnopqrstuvwxyz")
 			type_ = COMMIT_TYPES.get(type_, type_.title())
-			
+
 			# Add the commit to the commit groups
 			if type_ not in commit_groups:
 				commit_groups[type_] = []
@@ -248,7 +248,7 @@ def generate_changelog(commits: list[dict[str, Any]], owner: str, project_name:
 
 	# Initialize the changelog
 	changelog: str = "## Changelog\n\n"
-	
+
 	# Iterate over the commit groups
 	for type_ in sorted(commit_groups.keys()):
 		changelog += f"### {type_}\n"
@@ -257,10 +257,10 @@ def generate_changelog(commits: list[dict[str, Any]], owner: str, project_name:
 		for desc, sha in commit_groups[type_][::-1]:
 			changelog += f"- {desc} ([{sha[:7]}](https://github.com/{owner}/{project_name}/commit/{sha}))\n"
 		changelog += "\n"
-	
+
 	# Add the full changelog link if there is a latest tag and return the changelog
 	if latest_tag_version:
-		changelog += f"**Full Changelog**: https://github.com/{owner}/{project_name}/compare/v{latest_tag_version}...v{version}\n"	
+		changelog += f"**Full Changelog**: https://github.com/{owner}/{project_name}/compare/v{latest_tag_version}...v{version}\n"
 	return changelog
 
 def create_tag(owner: str, project_name: str, version: str, headers: dict[str, str]) -> None:
@@ -276,12 +276,12 @@ def create_tag(owner: str, project_name: str, version: str, headers: dict[str, s
 	progress(f"Creating tag v{version}")
 	create_tag_url: str = f"{PROJECT_ENDPOINT}/{owner}/{project_name}/git/refs"
 	latest_commit_url: str = f"{PROJECT_ENDPOINT}/{owner}/{project_name}/git/refs/heads/main"
-	
+
 	# Get the latest commit SHA
 	commit_response: requests.Response = requests.get(latest_commit_url, headers=headers)
 	handle_response(commit_response, "Failed to get latest commit")
 	commit_sha: str = commit_response.json()["object"]["sha"]
-	
+
 	# Create the tag
 	tag_data: dict[str, str] = {
 		"ref": f"refs/tags/v{version}",
@@ -312,7 +312,7 @@ def create_release(owner: str, project_name: str, version: str, changelog: str,
 		"draft": False,
 		"prerelease": False
 	}
-	
+
 	# Create the release and return the release ID
 	response: requests.Response = requests.post(release_url, headers=headers, json=release_data)
 	handle_response(response, "Failed to create release")
@@ -335,13 +335,13 @@ def upload_assets(owner: str, project_name: str, release_id: int, build_folder:
 	if not build_folder:
 		return
 	progress("Uploading assets")
-	
+
 	# Get the release details
 	response: requests.Response = requests.get(f"{PROJECT_ENDPOINT}/{owner}/{project_name}/releases/{release_id}", headers=headers)
 	handle_response(response, "Failed to get release details")
 	upload_url_template: str = response.json()["upload_url"]
 	upload_url_base: str = upload_url_template.split("{", maxsplit=1)[0]
-	
+
 	# Iterate over the files in the build folder
 	for file in os.listdir(build_folder):
 		if file.endswith(endswith_tuple):
@@ -354,7 +354,7 @@ def upload_assets(owner: str, project_name: str, release_id: int, build_folder:
 					"Content-Type": "application/zip"
 				}
 				params: dict[str, str] = {"name": file}
-				
+
 				# Upload the file
 				response: requests.Response = requests.post(
 					upload_url_base,
@@ -400,17 +400,17 @@ def upload_to_github(credentials: dict[str, Any], github_config: dict[str, Any])
 
 	# Handle existing tag
 	can_create: bool = handle_existing_tag(owner, project_name, version, headers)
-	
+
 	# Get the latest tag and commits since the tag
 	latest_tag_sha, latest_tag_version = get_latest_tag(owner, project_name, version, headers)
 	commits: list[dict[str, Any]] = get_commits_since_tag(owner, project_name, latest_tag_sha, headers)
 	changelog: str = generate_changelog(commits, owner, project_name, latest_tag_version, version)
-	
+
 	# Create the tag and release if needed
 	if can_create:
 		create_tag(owner, project_name, version, headers)
 		release_id: int = create_release(owner, project_name, version, changelog, headers)
-		upload_assets(owner, project_name, release_id, build_folder, headers, endswith)	
+		upload_assets(owner, project_name, release_id, build_folder, headers, endswith)
 		info(f"Project '{project_name}' updated on GitHub!")
 	return changelog
 

{stouputils-1.2.15 → stouputils-1.2.17}/stouputils/continuous_delivery/pyproject.py

@@ -52,12 +52,12 @@ def format_toml_lists(content: str) -> str:
 				# Split into key and values parts
 				key, values = line.split("=", 1)
 				values = values.strip()
-				
+
 				# Check if values portion is a list
 				if values.startswith("[") and values.endswith("]"):
 					# Parse list values, removing empty entries
 					values = [v.strip() for v in values[1:-1].split(",") if v.strip()]
-					
+
 					# For lists with multiple items, format across multiple lines
 					if len(values) > 1:
 						formatted_lines.append(f"{key}= [")

{stouputils-1.2.15 → stouputils-1.2.17}/stouputils/ctx.py

@@ -12,15 +12,16 @@ This module provides context managers for temporarily silencing output.
 import os
 import sys
 from typing import IO, TextIO, Callable, Any
-from .print import logging_to
+from .print import remove_colors
 from .io import super_open
 
+
 # Context manager to temporarily silence output
 class Muffle:
 	""" Context manager that temporarily silences output.
 
 	Alternative to stouputils.decorators.silent()
-	
+
 	Examples:
 		>>> with Muffle():
 		...     print("This will not be printed")
@@ -54,6 +55,55 @@ class Muffle:
 			sys.stderr = self.original_stderr
 
 
+# TeeMultiOutput class to duplicate output to multiple file-like objects
+class TeeMultiOutput(object):
+	""" File-like object that duplicates output to multiple file objects.
+
+	Args:
+		*files        (IO[Any]):  One or more file-like objects that have write and flush methods
+		strip_colors  (bool):     Whether to strip ANSI color codes from output sent to non-stdout/stderr files
+
+	Examples:
+		>>> f = open("logfile.txt", "w")
+		>>> original_stdout = sys.stdout
+		>>> sys.stdout = TeeMultiOutput(sys.stdout, f)
+		>>> print("Hello World")  # Output goes to both console and file
+		>>> sys.stdout = original_stdout
+		>>> f.close()
+	"""
+	def __init__(self, *files: IO[Any], strip_colors: bool = True) -> None:
+		self.files: tuple[IO[Any], ...] = files
+		""" File-like objects to write to """
+		self.strip_colors: bool = strip_colors
+		""" Whether to strip ANSI color codes from output sent to non-stdout/stderr files """
+
+	def write(self, obj: str) -> None:
+		""" Write the object to all files.
+
+		Args:
+			obj (str): String to write
+		"""
+		for f in self.files:
+			# Strip colors for files that are not stdout or stderr
+			if self.strip_colors and f not in (sys.stdout, sys.stderr):
+				f.write(remove_colors(obj))
+			else:
+				f.write(obj)
+
+	def flush(self) -> None:
+		""" Flush all files. """
+		for f in self.files:
+			f.flush()
+
+	# Add other methods that might be expected from a file-like object
+	def isatty(self) -> bool:
+		""" Return whether the first file is connected to a tty-like device. """
+		return hasattr(self.files[0], 'isatty') and self.files[0].isatty()
+
+	def fileno(self) -> int:
+		""" Return the file descriptor of the first file. """
+		return self.files[0].fileno()
+
 # Context manager to log to a file
 class LogToFile:
 	""" Context manager to log to a file.
@@ -65,6 +115,8 @@ class LogToFile:
 		path (str): Path to the log file
 		mode (str): Mode to open the file in (default: "w")
 		encoding (str): Encoding to use for the file (default: "utf-8")
+		tee_stdout (bool): Whether to redirect stdout to the file (default: True)
+		tee_stderr (bool): Whether to redirect stderr to the file (default: True)
 
 	Examples:
 		.. code-block:: python
@@ -72,30 +124,54 @@ class LogToFile:
 			> import stouputils as stp
 			> with stp.LogToFile("output.log"):
 			>     stp.info("This will be logged to output.log and printed normally")
+			>     print("This will also be logged")
 	"""
-	def __init__(self, path: str, mode: str = "w", encoding: str = "utf-8") -> None:
+	def __init__(
+		self,
+		path: str,
+		mode: str = "w",
+		encoding: str = "utf-8",
+		tee_stdout: bool = True,
+		tee_stderr: bool = True
+	) -> None:
 		self.path: str = path
 		""" Attribute remembering path to the log file """
 		self.mode: str = mode
 		""" Attribute remembering mode to open the file in """
 		self.encoding: str = encoding
 		""" Attribute remembering encoding to use for the file """
+		self.tee_stdout: bool = tee_stdout
+		""" Whether to redirect stdout to the file """
+		self.tee_stderr: bool = tee_stderr
+		""" Whether to redirect stderr to the file """
 		self.file: IO[Any] = super_open(self.path, mode=self.mode, encoding=self.encoding)
 		""" Attribute remembering opened file """
+		self.original_stdout: TextIO = sys.stdout
+		""" Original stdout before redirection """
+		self.original_stderr: TextIO = sys.stderr
+		""" Original stderr before redirection """
 
 	def __enter__(self) -> None:
-		""" Enter context manager which opens the log file and adds it to the logging_to list """
-		# Add file to logging_to list
-		logging_to.add(self.file)
+		""" Enter context manager which opens the log file and redirects stdout/stderr """
+		# Redirect stdout and stderr if requested
+		if self.tee_stdout:
+			sys.stdout = TeeMultiOutput(self.original_stdout, self.file)
+
+		if self.tee_stderr:
+			sys.stderr = TeeMultiOutput(self.original_stderr, self.file)
 
 	def __exit__(self, exc_type: type[BaseException]|None, exc_val: BaseException|None, exc_tb: Any|None) -> None:
-		""" Exit context manager which closes the log file and removes it from the logging_to list """
+		""" Exit context manager which closes the log file and restores stdout/stderr """
+		# Restore original stdout and stderr
+		if self.tee_stdout:
+			sys.stdout = self.original_stdout
+
+		if self.tee_stderr:
+			sys.stderr = self.original_stderr
+
 		# Close file
 		self.file.close()
 
-		# Remove file from logging_to list
-		logging_to.discard(self.file)
-	
 	@staticmethod
 	def common(logs_folder: str, filepath: str, func: Callable[..., Any], *args: Any, **kwargs: Any) -> Any:
 		""" Common code used at the beginning of a program to launch main function
@@ -108,7 +184,7 @@ class LogToFile:
 			**kwargs    (dict[str, Any]): Keyword arguments to pass to the main function
 		Returns:
 			Any: Return value of the main function
-		
+
 		Examples:
 			>>> if __name__ == "__main__":
 			...     LogToFile.common(f"{ROOT}/logs", __file__, main)

{stouputils-1.2.15 → stouputils-1.2.17}/stouputils/decorators.py

@@ -86,7 +86,7 @@ def measure_time(
 		perf_counter	(bool):		Whether to use time.perf_counter_ns or time.time_ns
 	Returns:
 		Callable:	Decorator to measure the time of the function.
-	
+
 	Examples:
 		.. code-block:: python
 
@@ -171,7 +171,7 @@ def handle_error(
 			LogLevels.WARNING_TRACEBACK:	Show as warning with traceback
 			LogLevels.ERROR_TRACEBACK:		Show as error with traceback
 			LogLevels.RAISE_EXCEPTION:		Raise exception (as if the decorator didn't exist)
-	
+
 	Examples:
 		.. code-block:: python
 
@@ -179,7 +179,7 @@ def handle_error(
 			> def test():
 			>     raise ValueError("Let's fail")
 			> test()	# [WARNING HH:MM:SS] Error during test: (ValueError) Let's fail
-	"""	
+	"""
 	# Update error_log if needed
 	if force_raise_exception:
 		error_log = LogLevels.RAISE_EXCEPTION
@@ -279,7 +279,7 @@ def deprecated(
 			LogLevels.RAISE_EXCEPTION:   Raise exception
 	Returns:
 		Callable[..., Any]: Decorator that marks a function as deprecated
-	
+
 	Examples:
 		.. code-block:: python
 

{stouputils-1.2.15 → stouputils-1.2.17}/stouputils/image.py

@@ -15,7 +15,7 @@ def image_resize(
 ) -> Any:
 	""" Resize an image while preserving its aspect ratio by default.
 	Scales the image so that its largest dimension equals max_result_size.
-	
+
 	Args:
 		image             (Image.Image | np.ndarray): The image to resize.
 		max_result_size   (int):                      Maximum size for the largest dimension.
@@ -54,7 +54,7 @@ def image_resize(
 	# Convert numpy array to PIL Image if needed
 	if isinstance(image, np.ndarray):
 		image = Image.fromarray(image)
-	
+
 	if keep_aspect_ratio:
 
 		# Get original image dimensions
@@ -66,7 +66,7 @@ def image_resize(
 
 		# Calculate scaling factor
 		scale: float = max_result_size / max_dimension
-		
+
 		# Calculate new dimensions while preserving aspect ratio
 		new_width: int = int(width * scale)
 		new_height: int = int(height * scale)
@@ -76,7 +76,7 @@ def image_resize(
 	else:
 		# If not keeping aspect ratio, resize to square with max_result_size
 		new_image: Image.Image = image.resize((max_result_size, max_result_size), resampling)
-	
+
 	# Return the image in the requested format
 	if return_type == np.ndarray:
 		return np.array(new_image)

{stouputils-1.2.15 → stouputils-1.2.17}/stouputils/io.py

@@ -183,7 +183,7 @@ def super_json_dump(data: Any, file: IO[Any]|None = None, max_level: int = 2, in
 		indent (str):				The indentation character (default: '\t')
 	Returns:
 		str: The content of the file in every case
-	
+
 	>>> super_json_dump({"a": [[1,2,3]], "b": 2}, max_level = 2)
 	'{\\n\\t"a": [\\n\\t\\t[1,2,3]\\n\\t],\\n\\t"b": 2\\n}\\n'
 	"""
@@ -209,7 +209,7 @@ def super_json_dump(data: Any, file: IO[Any]|None = None, max_level: int = 2, in
 		for char in finishes:
 			to_replace: str = "\n" + indent * max_level + char
 			content = content.replace(to_replace, char)
-	
+
 	# Write file content and return it
 	content += "\n"
 	if file:

{stouputils-1.2.15 → stouputils-1.2.17}/stouputils/parallel.py

@@ -72,7 +72,7 @@ def __handle_parameters(
 	if use_starmap:
 		args = [(func, arg) for arg in args] # type: ignore
 		func = __starmap # type: ignore
-	
+
 	# Prepare delayed function calls if delay_first_calls is set
 	if delay_first_calls > 0:
 		args = [
@@ -80,7 +80,7 @@ def __handle_parameters(
 			for i, arg in enumerate(args)
 		]
 		func = __delayed_call  # type: ignore
-	
+
 	return desc, func, args
 
 @handle_error(error_log=LogLevels.ERROR_TRACEBACK)

{stouputils-1.2.15 → stouputils-1.2.17}/stouputils/print.py

@@ -10,7 +10,7 @@ If a message is printed multiple times, it will be displayed as "(xN) message" w
 # Imports
 import sys
 import time
-from typing import Callable, TextIO, IO, Any
+from typing import Callable, TextIO, Any
 
 # Colors constants
 RESET: str   = "\033[0m"
@@ -22,9 +22,6 @@ MAGENTA: str = "\033[95m"
 CYAN: str    = "\033[96m"
 LINE_UP: str = "\033[1A"
 
-# Logging utilities
-logging_to: set[IO[Any]] = set()	# Used by LogToFile context manager
-
 def remove_colors(text: str) -> str:
 	""" Remove the colors from a text """
 	for color in [RESET, RED, GREEN, YELLOW, BLUE, MAGENTA, CYAN, LINE_UP]:
@@ -65,22 +62,24 @@ def info(*values: Any, color: str = GREEN, text: str = "INFO ", prefix: str = ""
 		file			(TextIO|list[TextIO]):	File(s) to write the message to (default: sys.stdout)
 		print_kwargs	(dict):					Keyword arguments to pass to the print function
 	"""
+	# Use stdout if no file is specified
 	if file is None:
 		file = sys.stdout
+
+	# If file is a list, recursively call info() for each file
 	if isinstance(file, list):
 		for f in file:
 			info(*values, color=color, text=text, prefix=prefix, file=f, **print_kwargs)
 	else:
+		# Build the message with prefix, color, text and timestamp
 		message: str = f"{prefix}{color}[{text} {current_time()}]"
+
+		# If this is a repeated print, add a line up and counter
 		if is_same_print(*values, color=color, text=text, prefix=prefix, **print_kwargs):
 			message = f"{LINE_UP}{message} (x{nb_values})"
 
-		# Print normally with colors, and log to any registered logging files without colors
+		# Print the message with the values and reset color
 		print(message, *values, RESET, file=file, **print_kwargs)
-		if logging_to:
-			print_kwargs["flush"] = True
-			for log_file in logging_to:
-				print(remove_colors(message), *(remove_colors(str(v)) for v in values), file=log_file, **print_kwargs)
 
 def debug(*values: Any, **print_kwargs: Any) -> None:
 	""" Print a debug message looking like "[DEBUG HH:MM:SS] message" in cyan by default. """