stouputils 1.18.3__py3-none-any.whl → 1.18.4__py3-none-any.whl

stouputils/decorators.py

@@ -76,7 +76,7 @@ def measure_time(
 			def wrapper(*args: tuple[Any, ...], **kwargs: dict[str, Any]) -> Any:
 				with MeasureTime(print_func=printer, message=new_msg, perf_counter=perf_counter):
 					return func(*args, **kwargs)
-		wrapper.__name__ = _get_wrapper_name("stouputils.decorators.measure_time", func)
+		_set_wrapper_name(wrapper, _get_wrapper_name("stouputils.decorators.measure_time", func))
 		return wrapper
 
 	# Handle both @measure_time and @measure_time(printer=..., message=..., perf_counter=..., is_generator=...)
@@ -160,7 +160,7 @@ def handle_error(
 				# Sleep for the specified time, only if the error_log is not ERROR_TRACEBACK (because it's blocking)
 				if sleep_time > 0.0 and error_log != LogLevels.ERROR_TRACEBACK:
 					time.sleep(sleep_time)
-		wrapper.__name__ = _get_wrapper_name("stouputils.decorators.handle_error", func)
+		_set_wrapper_name(wrapper, _get_wrapper_name("stouputils.decorators.handle_error", func))
 		return wrapper
 
 	# Handle both @handle_error and @handle_error(exceptions=..., message=..., error_log=...)
@@ -277,7 +277,7 @@ def timeout(
 			if result_container:
 				return result_container[0]
 
-		wrapper.__name__ = _get_wrapper_name("stouputils.decorators.timeout", func)
+		_set_wrapper_name(wrapper, _get_wrapper_name("stouputils.decorators.timeout", func))
 		return wrapper
 
 	# Handle both @timeout and @timeout(seconds=..., message=...)
@@ -352,7 +352,7 @@ def retry(
 					time.sleep(current_delay)
 					current_delay *= backoff
 
-		wrapper.__name__ = _get_wrapper_name("stouputils.decorators.retry", func)
+		_set_wrapper_name(wrapper, _get_wrapper_name("stouputils.decorators.retry", func))
 		return wrapper
 
 	# Handle both @retry and @retry(exceptions=..., max_attempts=..., delay=...)
@@ -427,7 +427,7 @@ def simple_cache(
 				return result
 
 		# Return the wrapper
-		wrapper.__name__ = _get_wrapper_name("stouputils.decorators.simple_cache", func)
+		_set_wrapper_name(wrapper, _get_wrapper_name("stouputils.decorators.simple_cache", func))
 		return wrapper
 
 	# Handle both @simple_cache and @simple_cache(method=...)
@@ -477,10 +477,10 @@ def abstract(
 
 		@wraps(func)
 		@handle_error(exceptions=NotImplementedError, error_log=error_log)
-		def wrapper(*args: tuple[Any, ...], **kwargs: dict[str, Any]) -> Any:
+		def not_implemented_error(*args: tuple[Any, ...], **kwargs: dict[str, Any]) -> Any:
 			raise NotImplementedError(message)
-		wrapper.__name__ = _get_wrapper_name("stouputils.decorators.abstract", func)
-		return wrapper
+		_set_wrapper_name(not_implemented_error, _get_wrapper_name("stouputils.decorators.abstract", func))
+		return not_implemented_error
 
 	# Handle both @abstract and @abstract(error_log=...)
 	if func is None:
@@ -541,7 +541,7 @@ def deprecated(
 
 			# Call the original function
 			return func(*args, **kwargs)
-		wrapper.__name__ = _get_wrapper_name("stouputils.decorators.deprecated", func)
+		_set_wrapper_name(wrapper, _get_wrapper_name("stouputils.decorators.deprecated", func))
 		return wrapper
 
 	# Handle both @deprecated and @deprecated(message=..., error_log=...)
@@ -582,7 +582,7 @@ def silent(
 			# Use Muffle context manager to silence output
 			with Muffle(mute_stderr=mute_stderr):
 				return func(*args, **kwargs)
-		wrapper.__name__ = _get_wrapper_name("stouputils.decorators.silent", func)
+		_set_wrapper_name(wrapper, _get_wrapper_name("stouputils.decorators.silent", func))
 		return wrapper
 
 	# Handle both @silent and @silent(mute_stderr=...)
@@ -613,7 +613,31 @@ def _get_wrapper_name(decorator_name: str, func: Callable[..., Any]) -> str:
 
 	# Remove "stouputils.decorators.*" prefix if present
 	if func_name.startswith("stouputils.decorators."):
-		func_name = ".".join(func_name.split(".")[3:])
+		func_name = func_name.split(".", 2)[-1]
 
 	return f"{decorator_name}@{func_name}"
 
+
+def _set_wrapper_name(wrapper: Callable[..., Any], name: str) -> None:
+	""" Set the wrapper function's visible name, qualname and code object name for clearer tracebacks.
+
+	Args:
+		wrapper	(Callable[..., Any]):	Wrapper function to update
+		name	(str):					New name to set
+	"""
+	# __name__ affects repr and some introspection
+	wrapper.__name__ = name
+
+	# __qualname__ helps when using nested scopes and in some introspection tools
+	try:
+		wrapper.__qualname__ = name
+	except Exception:
+		pass
+
+	# Update the code object's co_name so tracebacks show the new name
+	try:
+		wrapper.__code__ = wrapper.__code__.replace(co_name=name)
+	except Exception:
+		# If code.replace isn't available, ignore silently
+		pass
+

stouputils/decorators.pyi

@@ -250,3 +250,10 @@ def _get_wrapper_name(decorator_name: str, func: Callable[..., Any]) -> str:
 \tReturns:
 \t\tstr: Combined name for the wrapper function (e.g., "stouputils.decorators.handle_error@function_name")
 \t'''
+def _set_wrapper_name(wrapper: Callable[..., Any], name: str) -> None:
+    """ Set the wrapper function's visible name, qualname and code object name for clearer tracebacks.
+
+\tArgs:
+\t\twrapper\t(Callable[..., Any]):\tWrapper function to update
+\t\tname\t(str):\t\t\t\t\tNew name to set
+\t"""

{stouputils-1.18.3.dist-info → stouputils-1.18.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: stouputils
-Version: 1.18.3
+Version: 1.18.4
 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.18.3.dist-info → stouputils-1.18.4.dist-info}/RECORD

@@ -109,8 +109,8 @@ stouputils/data_science/scripts/exhaustive_process.py,sha256=Dc5gceIlIiP8U0m1qt3
 stouputils/data_science/scripts/preprocess_dataset.py,sha256=OLC2KjEtSMeyHHPpNOATfNDuq0lZ09utKhsuzBA4MN4,2929
 stouputils/data_science/scripts/routine.py,sha256=FkTLzmcdm_qUp69D-dPAKJm2RfXZZLtPgje6lEopu2I,7662
 stouputils/data_science/utils.py,sha256=HFXI2RQZ53RbBOn_4Act2bi0z4xQlTtsuR5Am80v9JU,11084
-stouputils/decorators.py,sha256=Emgr0XfUOh-MBqkznVOCNmwdHf7o3h1AyIoQklxgULw,21838
-stouputils/decorators.pyi,sha256=vbPRsvox4dotqcln3StgE6iZ1cWCOeAn56M9zMpdw2U,10948
+stouputils/decorators.py,sha256=n09JOhE7WamBuD1bmRPI4dBezZuAyP9-s34C_MfvlCs,22677
+stouputils/decorators.pyi,sha256=cFPYyQOR6hFq2sOmDXjT9Ozfl2UcU1avPwbd5ffL6ho,11249
 stouputils/image.py,sha256=E6RYfLhE19KGxn9VdgPCTYXVmOUNK8Qe3RrwSp9OiPs,16479
 stouputils/image.pyi,sha256=bGbNTG4piQ2PCLFqZCE360O8yE635cKX94SGK0aHNJ8,8311
 stouputils/installer/__init__.py,sha256=DBwI9w3xvw0NR_jDMxmURwPi1F79kPLe7EuNjmrxW_U,502
@@ -156,7 +156,7 @@ stouputils/typing.py,sha256=TwvxrvxhBRkyHkoOpfyXebN13M3xJb8MAjKXiNIWjew,2205
 stouputils/typing.pyi,sha256=U2UmFZausMYpnsUQROQE2JOwHcjx2hKV0rJuOdR57Ew,1341
 stouputils/version_pkg.py,sha256=Jsp-s03L14DkiZ94vQgrlQmaxApfn9DC8M_nzT1SJLk,7014
 stouputils/version_pkg.pyi,sha256=QPvqp1U3QA-9C_CC1dT9Vahv1hXEhstbM7x5uzMZSsQ,755
-stouputils-1.18.3.dist-info/WHEEL,sha256=e_m4S054HL0hyR3CpOk-b7Q7fDX6BuFkgL5OjAExXas,80
-stouputils-1.18.3.dist-info/entry_points.txt,sha256=tx0z9VOnE-sfkmbFbA93zaBMzV3XSsKEJa_BWIqUzxw,57
-stouputils-1.18.3.dist-info/METADATA,sha256=jA1lFVcNiNE1xCh5-QlKwvLG-VRVpK-BKKms71jisoI,14011
-stouputils-1.18.3.dist-info/RECORD,,
+stouputils-1.18.4.dist-info/WHEEL,sha256=e_m4S054HL0hyR3CpOk-b7Q7fDX6BuFkgL5OjAExXas,80
+stouputils-1.18.4.dist-info/entry_points.txt,sha256=tx0z9VOnE-sfkmbFbA93zaBMzV3XSsKEJa_BWIqUzxw,57
+stouputils-1.18.4.dist-info/METADATA,sha256=4VyZ0zxM9F5r4C1No_8NCtX6LOgUgU0rQrR2XrA0zkU,14011
+stouputils-1.18.4.dist-info/RECORD,,