stouputils 1.12.2__py3-none-any.whl → 1.13.0__py3-none-any.whl

stouputils/stouputils/parallel.pyi

@@ -0,0 +1,211 @@
+from .ctx import SetMPStartMethod as SetMPStartMethod
+from .print import BAR_FORMAT as BAR_FORMAT, MAGENTA as MAGENTA
+from collections.abc import Callable, Iterable
+from typing import Any, TypeVar
+
+def doctest_square(x: int) -> int: ...
+def doctest_slow(x: int) -> int: ...
+
+CPU_COUNT: int
+T = TypeVar('T')
+R = TypeVar('R')
+
+def multiprocessing[T, R](func: Callable[..., R] | list[Callable[..., R]], args: Iterable[T], use_starmap: bool = False, chunksize: int = 1, desc: str = '', max_workers: int | float = ..., delay_first_calls: float = 0, color: str = ..., bar_format: str = ..., ascii: bool = False) -> list[R]:
+    ''' Method to execute a function in parallel using multiprocessing
+
+\t- For CPU-bound operations where the GIL (Global Interpreter Lock) is a bottleneck.
+\t- When the task can be divided into smaller, independent sub-tasks that can be executed concurrently.
+\t- For computationally intensive tasks like scientific simulations, data analysis, or machine learning workloads.
+
+\tArgs:
+\t\tfunc\t\t\t\t(Callable | list[Callable]):\tFunction to execute, or list of functions (one per argument)
+\t\targs\t\t\t\t(Iterable):\t\t\tIterable of arguments to pass to the function(s)
+\t\tuse_starmap\t\t\t(bool):\t\t\t\tWhether to use starmap or not (Defaults to False):
+\t\t\tTrue means the function will be called like func(\\*args[i]) instead of func(args[i])
+\t\tchunksize\t\t\t(int):\t\t\t\tNumber of arguments to process at a time
+\t\t\t(Defaults to 1 for proper progress bar display)
+\t\tdesc\t\t\t\t(str):\t\t\t\tDescription displayed in the progress bar
+\t\t\t(if not provided no progress bar will be displayed)
+\t\tmax_workers\t\t\t(int | float):\t\tNumber of workers to use (Defaults to CPU_COUNT), -1 means CPU_COUNT.
+\t\t\tIf float between 0 and 1, it\'s treated as a percentage of CPU_COUNT.
+\t\t\tIf negative float between -1 and 0, it\'s treated as a percentage of len(args).
+\t\tdelay_first_calls\t(float):\t\t\tApply i*delay_first_calls seconds delay to the first "max_workers" calls.
+\t\t\tFor instance, the first process will be delayed by 0 seconds, the second by 1 second, etc.
+\t\t\t(Defaults to 0): This can be useful to avoid functions being called in the same second.
+\t\tcolor\t\t\t\t(str):\t\t\t\tColor of the progress bar (Defaults to MAGENTA)
+\t\tbar_format\t\t\t(str):\t\t\t\tFormat of the progress bar (Defaults to BAR_FORMAT)
+\t\tascii\t\t\t\t(bool):\t\t\t\tWhether to use ASCII or Unicode characters for the progress bar
+
+\tReturns:
+\t\tlist[object]:\tResults of the function execution
+
+\tExamples:
+\t\t.. code-block:: python
+
+\t\t\t> multiprocessing(doctest_square, args=[1, 2, 3])
+\t\t\t[1, 4, 9]
+
+\t\t\t> multiprocessing(int.__mul__, [(1,2), (3,4), (5,6)], use_starmap=True)
+\t\t\t[2, 12, 30]
+
+\t\t\t> # Using a list of functions (one per argument)
+\t\t\t> multiprocessing([doctest_square, doctest_square, doctest_square], [1, 2, 3])
+\t\t\t[1, 4, 9]
+
+\t\t\t> # Will process in parallel with progress bar
+\t\t\t> multiprocessing(doctest_slow, range(10), desc="Processing")
+\t\t\t[0, 1, 2, 3, 4, 5, 6, 7, 8, 9]
+
+\t\t\t> # Will process in parallel with progress bar and delay the first threads
+\t\t\t> multiprocessing(
+\t\t\t.     doctest_slow,
+\t\t\t.     range(10),
+\t\t\t.     desc="Processing with delay",
+\t\t\t.     max_workers=2,
+\t\t\t.     delay_first_calls=0.6
+\t\t\t. )
+\t\t\t[0, 1, 2, 3, 4, 5, 6, 7, 8, 9]
+\t'''
+def multithreading[T, R](func: Callable[..., R] | list[Callable[..., R]], args: Iterable[T], use_starmap: bool = False, desc: str = '', max_workers: int | float = ..., delay_first_calls: float = 0, color: str = ..., bar_format: str = ..., ascii: bool = False) -> list[R]:
+    ''' Method to execute a function in parallel using multithreading, you should use it:
+
+\t- For I/O-bound operations where the GIL is not a bottleneck, such as network requests or disk operations.
+\t- When the task involves waiting for external resources, such as network responses or user input.
+\t- For operations that involve a lot of waiting, such as GUI event handling or handling user input.
+
+\tArgs:
+\t\tfunc\t\t\t\t(Callable | list[Callable]):\tFunction to execute, or list of functions (one per argument)
+\t\targs\t\t\t\t(Iterable):\t\t\tIterable of arguments to pass to the function(s)
+\t\tuse_starmap\t\t\t(bool):\t\t\t\tWhether to use starmap or not (Defaults to False):
+\t\t\tTrue means the function will be called like func(\\*args[i]) instead of func(args[i])
+\t\tdesc\t\t\t\t(str):\t\t\t\tDescription displayed in the progress bar
+\t\t\t(if not provided no progress bar will be displayed)
+\t\tmax_workers\t\t\t(int | float):\t\tNumber of workers to use (Defaults to CPU_COUNT), -1 means CPU_COUNT.
+\t\t\tIf float between 0 and 1, it\'s treated as a percentage of CPU_COUNT.
+\t\t\tIf negative float between -1 and 0, it\'s treated as a percentage of len(args).
+\t\tdelay_first_calls\t(float):\t\t\tApply i*delay_first_calls seconds delay to the first "max_workers" calls.
+\t\t\tFor instance with value to 1, the first thread will be delayed by 0 seconds, the second by 1 second, etc.
+\t\t\t(Defaults to 0): This can be useful to avoid functions being called in the same second.
+\t\tcolor\t\t\t\t(str):\t\t\t\tColor of the progress bar (Defaults to MAGENTA)
+\t\tbar_format\t\t\t(str):\t\t\t\tFormat of the progress bar (Defaults to BAR_FORMAT)
+\t\tascii\t\t\t\t(bool):\t\t\t\tWhether to use ASCII or Unicode characters for the progress bar
+
+\tReturns:
+\t\tlist[object]:\tResults of the function execution
+
+\tExamples:
+\t\t.. code-block:: python
+
+\t\t\t> multithreading(doctest_square, args=[1, 2, 3])
+\t\t\t[1, 4, 9]
+
+\t\t\t> multithreading(int.__mul__, [(1,2), (3,4), (5,6)], use_starmap=True)
+\t\t\t[2, 12, 30]
+
+\t\t\t> # Using a list of functions (one per argument)
+\t\t\t> multithreading([doctest_square, doctest_square, doctest_square], [1, 2, 3])
+\t\t\t[1, 4, 9]
+
+\t\t\t> # Will process in parallel with progress bar
+\t\t\t> multithreading(doctest_slow, range(10), desc="Threading")
+\t\t\t[0, 1, 2, 3, 4, 5, 6, 7, 8, 9]
+
+\t\t\t> # Will process in parallel with progress bar and delay the first threads
+\t\t\t> multithreading(
+\t\t\t.     doctest_slow,
+\t\t\t.     range(10),
+\t\t\t.     desc="Threading with delay",
+\t\t\t.     max_workers=2,
+\t\t\t.     delay_first_calls=0.6
+\t\t\t. )
+\t\t\t[0, 1, 2, 3, 4, 5, 6, 7, 8, 9]
+\t'''
+def run_in_subprocess[R](func: Callable[..., R], *args: Any, timeout: float | None = None, **kwargs: Any) -> R:
+    ''' Execute a function in a subprocess with positional and keyword arguments.
+
+\tThis is useful when you need to run a function in isolation to avoid memory leaks,
+\tresource conflicts, or to ensure a clean execution environment. The subprocess will
+\tbe created, run the function with the provided arguments, and return the result.
+
+\tArgs:
+\t\tfunc         (Callable):     The function to execute in a subprocess.
+\t\t\t(SHOULD BE A TOP-LEVEL FUNCTION TO BE PICKLABLE)
+\t\t*args        (Any):          Positional arguments to pass to the function.
+\t\ttimeout      (float | None): Maximum time in seconds to wait for the subprocess.
+\t\t\tIf None, wait indefinitely. If the subprocess exceeds this time, it will be terminated.
+\t\t**kwargs     (Any):          Keyword arguments to pass to the function.
+
+\tReturns:
+\t\tR: The return value of the function.
+
+\tRaises:
+\t\tRuntimeError: If the subprocess exits with a non-zero exit code or times out.
+\t\tTimeoutError: If the subprocess exceeds the specified timeout.
+
+\tExamples:
+\t\t.. code-block:: python
+
+\t\t\t> # Simple function execution
+\t\t\t> run_in_subprocess(doctest_square, 5)
+\t\t\t25
+
+\t\t\t> # Function with multiple arguments
+\t\t\t> def add(a: int, b: int) -> int:
+\t\t\t.     return a + b
+\t\t\t> run_in_subprocess(add, 10, 20)
+\t\t\t30
+
+\t\t\t> # Function with keyword arguments
+\t\t\t> def greet(name: str, greeting: str = "Hello") -> str:
+\t\t\t.     return f"{greeting}, {name}!"
+\t\t\t> run_in_subprocess(greet, "World", greeting="Hi")
+\t\t\t\'Hi, World!\'
+
+\t\t\t> # With timeout to prevent hanging
+\t\t\t> run_in_subprocess(some_gpu_func, data, timeout=300.0)
+\t'''
+def _subprocess_wrapper[R](result_queue: Any, func: Callable[..., R], args: tuple[Any, ...], kwargs: dict[str, Any]) -> None:
+    """ Wrapper function to execute the target function and store the result in the queue.
+
+\tMust be at module level to be pickable on Windows (spawn context).
+
+\tArgs:
+\t\tresult_queue (multiprocessing.Queue):  Queue to store the result or exception.
+\t\tfunc         (Callable):               The target function to execute.
+\t\targs         (tuple):                  Positional arguments for the function.
+\t\tkwargs       (dict):                   Keyword arguments for the function.
+\t"""
+def _starmap[T, R](args: tuple[Callable[[T], R], list[T]]) -> R:
+    """ Private function to use starmap using args[0](\\*args[1])
+
+\tArgs:
+\t\targs (tuple): Tuple containing the function and the arguments list to pass to the function
+\tReturns:
+\t\tobject: Result of the function execution
+\t"""
+def _delayed_call[T, R](args: tuple[Callable[[T], R], float, T]) -> R:
+    """ Private function to apply delay before calling the target function
+
+\tArgs:
+\t\targs (tuple): Tuple containing the function, delay in seconds, and the argument to pass to the function
+\tReturns:
+\t\tobject: Result of the function execution
+\t"""
+def _handle_parameters[T, R](func: Callable[[T], R] | list[Callable[[T], R]], args: list[T], use_starmap: bool, delay_first_calls: float, max_workers: int, desc: str, color: str) -> tuple[str, Callable[[T], R], list[T]]:
+    ''' Private function to handle the parameters for multiprocessing or multithreading functions
+
+\tArgs:
+\t\tfunc\t\t\t\t(Callable | list[Callable]):\tFunction to execute, or list of functions (one per argument)
+\t\targs\t\t\t\t(list):\t\t\t\tList of arguments to pass to the function(s)
+\t\tuse_starmap\t\t\t(bool):\t\t\t\tWhether to use starmap or not (Defaults to False):
+\t\t\tTrue means the function will be called like func(\\*args[i]) instead of func(args[i])
+\t\tdelay_first_calls\t(int):\t\t\t\tApply i*delay_first_calls seconds delay to the first "max_workers" calls.
+\t\t\tFor instance, the first process will be delayed by 0 seconds, the second by 1 second, etc. (Defaults to 0):
+\t\t\tThis can be useful to avoid functions being called in the same second.
+\t\tmax_workers\t\t\t(int):\t\t\t\tNumber of workers to use (Defaults to CPU_COUNT)
+\t\tdesc\t\t\t\t(str):\t\t\t\tDescription of the function execution displayed in the progress bar
+\t\tcolor\t\t\t\t(str):\t\t\t\tColor of the progress bar
+
+\tReturns:
+\t\ttuple[str, Callable[[T], R], list[T]]:\tTuple containing the description, function, and arguments
+\t'''

stouputils/stouputils/print.pyi

@@ -0,0 +1,136 @@
+from collections.abc import Callable as Callable, Iterable, Iterator
+from typing import Any, IO, TextIO, TypeVar
+
+RESET: str
+RED: str
+GREEN: str
+YELLOW: str
+BLUE: str
+MAGENTA: str
+CYAN: str
+LINE_UP: str
+BAR_FORMAT: str
+T = TypeVar('T')
+previous_args_kwards: tuple[Any, Any]
+nb_values: int
+import_time: float
+
+def colored_for_loop[T](iterable: Iterable[T], desc: str = 'Processing', color: str = ..., bar_format: str = ..., ascii: bool = False, **kwargs: Any) -> Iterator[T]:
+    ''' Function to iterate over a list with a colored TQDM progress bar like the other functions in this module.
+
+\tArgs:
+\t\titerable\t(Iterable):\t\t\tList to iterate over
+\t\tdesc\t\t(str):\t\t\t\tDescription of the function execution displayed in the progress bar
+\t\tcolor\t\t(str):\t\t\t\tColor of the progress bar (Defaults to MAGENTA)
+\t\tbar_format\t(str):\t\t\t\tFormat of the progress bar (Defaults to BAR_FORMAT)
+\t\tascii\t\t(bool):\t\t\t\tWhether to use ASCII or Unicode characters for the progress bar (Defaults to False)
+\t\tverbose\t\t(int):\t\t\t\tLevel of verbosity, decrease by 1 for each depth (Defaults to 1)
+\t\t**kwargs:\t\t\t\t\t\tAdditional arguments to pass to the TQDM progress bar
+
+\tYields:
+\t\tT: Each item of the iterable
+
+\tExamples:
+\t\t>>> for i in colored_for_loop(range(10), desc="Time sleeping loop"):
+\t\t...     time.sleep(0.01)
+\t\t>>> # Time sleeping loop: 100%|██████████████████| 10/10 [ 95.72it/s, 00:00<00:00]
+\t'''
+def info(*values: Any, color: str = ..., text: str = 'INFO ', prefix: str = '', file: TextIO | list[TextIO] | None = None, **print_kwargs: Any) -> None:
+    ''' Print an information message looking like "[INFO HH:MM:SS] message" in green by default.
+
+\tArgs:
+\t\tvalues\t\t\t(Any):\t\t\t\t\tValues to print (like the print function)
+\t\tcolor\t\t\t(str):\t\t\t\t\tColor of the message (default: GREEN)
+\t\ttext\t\t\t(str):\t\t\t\t\tText of the message (default: "INFO ")
+\t\tprefix\t\t\t(str):\t\t\t\t\tPrefix to add to the values
+\t\tfile\t\t\t(TextIO|list[TextIO]):\tFile(s) to write the message to (default: sys.stdout)
+\t\tprint_kwargs\t(dict):\t\t\t\t\tKeyword arguments to pass to the print function
+\t'''
+def debug(*values: Any, **print_kwargs: Any) -> None:
+    ''' Print a debug message looking like "[DEBUG HH:MM:SS] message" in cyan by default. '''
+def alt_debug(*values: Any, **print_kwargs: Any) -> None:
+    ''' Print a debug message looking like "[DEBUG HH:MM:SS] message" in blue by default. '''
+def suggestion(*values: Any, **print_kwargs: Any) -> None:
+    ''' Print a suggestion message looking like "[SUGGESTION HH:MM:SS] message" in cyan by default. '''
+def progress(*values: Any, **print_kwargs: Any) -> None:
+    ''' Print a progress message looking like "[PROGRESS HH:MM:SS] message" in magenta by default. '''
+def warning(*values: Any, **print_kwargs: Any) -> None:
+    ''' Print a warning message looking like "[WARNING HH:MM:SS] message" in yellow by default and in sys.stderr. '''
+def error(*values: Any, exit: bool = False, **print_kwargs: Any) -> None:
+    """ Print an error message (in sys.stderr and in red by default)
+\tand optionally ask the user to continue or stop the program.
+
+\tArgs:
+\t\tvalues\t\t\t(Any):\t\tValues to print (like the print function)
+\t\texit\t\t\t(bool):\t\tWhether to ask the user to continue or stop the program,
+\t\t\tfalse to ignore the error automatically and continue
+\t\tprint_kwargs\t(dict):\t\tKeyword arguments to pass to the print function
+\t"""
+def whatisit(*values: Any, print_function: Callable[..., None] = ..., max_length: int = 250, color: str = ..., **print_kwargs: Any) -> None:
+    ''' Print the type of each value and the value itself, with its id and length/shape.
+
+\tThe output format is: "type, <id id_number>:\t(length/shape) value"
+
+\tArgs:
+\t\tvalues\t\t\t(Any):\t\tValues to print
+\t\tprint_function\t(Callable):\tFunction to use to print the values (default: debug())
+\t\tmax_length\t\t(int):\t\tMaximum length of the value string to print (default: 250)
+\t\tcolor\t\t\t(str):\t\tColor of the message (default: CYAN)
+\t\tprint_kwargs\t(dict):\t\tKeyword arguments to pass to the print function
+\t'''
+def breakpoint(*values: Any, print_function: Callable[..., None] = ..., **print_kwargs: Any) -> None:
+    """ Breakpoint function, pause the program and print the values.
+
+\tArgs:
+\t\tvalues\t\t\t(Any):\t\tValues to print
+\t\tprint_function\t(Callable):\tFunction to use to print the values (default: warning())
+\t\tprint_kwargs\t(dict):\t\tKeyword arguments to pass to the print function
+\t"""
+
+class TeeMultiOutput:
+    ''' File-like object that duplicates output to multiple file-like objects.
+
+\tArgs:
+\t\t*files         (IO[Any]):  One or more file-like objects that have write and flush methods
+\t\tstrip_colors   (bool):     Strip ANSI color codes from output sent to non-stdout/stderr files
+\t\tascii_only     (bool):     Replace non-ASCII characters with their ASCII equivalents for non-stdout/stderr files
+\t\tignore_lineup  (bool):     Ignore lines containing LINE_UP escape sequence in non-terminal outputs
+
+\tExamples:
+\t\t>>> f = open("logfile.txt", "w")
+\t\t>>> sys.stdout = TeeMultiOutput(sys.stdout, f)
+\t\t>>> print("Hello World")  # Output goes to both console and file
+\t\tHello World
+\t\t>>> f.close()\t# TeeMultiOutput will handle any future writes to closed files gracefully
+\t'''
+    files: tuple[IO[Any], ...]
+    strip_colors: bool
+    ascii_only: bool
+    ignore_lineup: bool
+    def __init__(self, *files: IO[Any], strip_colors: bool = True, ascii_only: bool = True, ignore_lineup: bool = True) -> None: ...
+    @property
+    def encoding(self) -> str:
+        ''' Get the encoding of the first file, or "utf-8" as fallback.
+
+\t\tReturns:
+\t\t\tstr: The encoding, ex: "utf-8", "ascii", "latin1", etc.
+\t\t'''
+    def write(self, obj: str) -> int:
+        """ Write the object to all files while stripping colors if needed.
+
+\t\tArgs:
+\t\t\tobj (str): String to write
+\t\tReturns:
+\t\t\tint: Number of characters written to the first file
+\t\t"""
+    def flush(self) -> None:
+        """ Flush all files. """
+    def fileno(self) -> int:
+        """ Return the file descriptor of the first file. """
+
+def remove_colors(text: str) -> str:
+    """ Remove the colors from a text """
+def is_same_print(*args: Any, **kwargs: Any) -> bool:
+    """ Checks if the current print call is the same as the previous one. """
+def current_time() -> str:
+    ''' Get the current time as "HH:MM:SS" if less than 24 hours since import, else "YYYY-MM-DD HH:MM:SS" '''

stouputils/stouputils/version_pkg.pyi

@@ -0,0 +1,15 @@
+from .print import CYAN as CYAN, GREEN as GREEN, RESET as RESET, YELLOW as YELLOW
+
+def show_version(main_package: str = 'stouputils', primary_color: str = ..., secondary_color: str = ..., max_depth: int = 2) -> None:
+    ''' Print the version of the main package and its dependencies.
+
+\tUsed by the "stouputils --version" command.
+
+\tArgs:
+\t\tmain_package\t(str):\tName of the main package to show version for
+\t\tprimary_color\t(str):\tColor to use for the primary package name
+\t\tsecondary_color\t(str):\tColor to use for the secondary package names
+\t\tmax_depth\t\t(int):\tMaximum depth for dependency tree (<= 2 for flat, >=3 for tree)
+\t'''
+def show_version_cli() -> None:
+    ''' Handle the "stouputils --version" CLI command '''

{stouputils-1.12.2.dist-info → stouputils-1.13.0.dist-info}/METADATA

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

@@ -1,6 +1,6 @@
 stouputils/__init__.py,sha256=KMJoy8FCiiiXJ53QfgU3rz7AY7AJ_j5kP3j24JuznC0,1136
 stouputils/__init__.pyi,sha256=J8LeijIkWrTdGlevNR8dlGlgYg-Dh_MvGjp2EsPZ8UM,351
-stouputils/__main__.py,sha256=n4_wlF2VrY1HlMuJ8_1LT6G76rh94DRqfuvEPlyWvEk,2430
+stouputils/__main__.py,sha256=sJSncuTWua7jA9pTw4BUoDzNUUExZKeyATbmY4lhl0E,2764
 stouputils/_deprecated.py,sha256=Bcq6YjdM9Rk9Vq-WMhc_tuEbPORX6U8HAJ9Vh-VIWTA,1478
 stouputils/_deprecated.pyi,sha256=6-8YsftJd2fRAdBLsysc6jf-uA8V2wiqkiFAbdfWfJQ,664
 stouputils/all_doctests.py,sha256=1bGGUg80nvLBY3wrPkFrkcuQRjFTWmTpHZtai9X-vnY,5891
@@ -29,16 +29,16 @@ stouputils/continuous_delivery/cd_utils.py,sha256=fkaHk2V3j66uFAUsM2c_UddNhXW2KA
 stouputils/continuous_delivery/cd_utils.pyi,sha256=nxTLQydVOSVIix88dRtBXjMrUPpI5ftiQYbLI_nMByQ,4848
 stouputils/continuous_delivery/github.py,sha256=Iva2XNm60Th78P_evnhCJHn0Q9-06udPlOZAxtZB5vw,19464
 stouputils/continuous_delivery/github.pyi,sha256=RHRsSroEsT0I1qeuq-Wg0JLdEEDttLrzgHZPVRtLZ0Q,6641
-stouputils/continuous_delivery/pypi.py,sha256=E4jAu8bYscdUU_0svIxmCDdapxXTDzwbx2TkbMFzeXs,3428
-stouputils/continuous_delivery/pypi.pyi,sha256=uZeu3GaDrA9ptMARd3Dj_jyzN65eSmZdKBuG3m8QQAQ,1977
+stouputils/continuous_delivery/pypi.py,sha256=pxXnf6-vQhAFuKDxIw-pCR3ex6zQiSBj5Oc5m1IglMA,5196
+stouputils/continuous_delivery/pypi.pyi,sha256=qmMeHDzezN_ZW-_jGRFbaccG_rkfELbmW9hUPU6vptY,2325
 stouputils/continuous_delivery/pyproject.py,sha256=olD3QqzLfCLnTBw8IkSKSLBPWyeMv6uS7A0yGdFuIvQ,4802
 stouputils/continuous_delivery/pyproject.pyi,sha256=bMWwqyG0Auo46dt-dWGePQ9yJ8rSrgb7mnJTfbiS3TQ,2053
 stouputils/continuous_delivery/stubs.py,sha256=xUAcP21Y03PLEr7X6LrIBMvPeLI8Rp-EyaTLxocA0C4,3512
 stouputils/continuous_delivery/stubs.pyi,sha256=sLZypdz1oGoymQIRPez50rnH8TQhvEIx6A7xUdGtnys,2390
-stouputils/ctx.py,sha256=xjFQHgAKpqXZ2zD6P8AJYrnuhMwKV9VbLV1A7B46ZCI,15178
+stouputils/ctx.py,sha256=KVVDmL3pAPX2WM_QzjsmctbG-YfjJ-4aWBSoI7eU_ws,15586
 stouputils/ctx.pyi,sha256=-7AJwD9bKzKBFsYlgyULPznstq3LvXRXe2r_2at72FI,9799
 stouputils/data_science/config/get.py,sha256=-9Yo5go7sw7eZNDwMfV3V9qOyk6q3Nrrb0V1eg-F1LE,1722
-stouputils/data_science/config/set.py,sha256=vzmDjj_GYCUiM_BzswAGbCUnPa7BAQSI8M5pkZiSJWk,4050
+stouputils/data_science/config/set.py,sha256=PBBnWhgSptWTPkMtq3N1UxmEz_E4ywUcl3daS43wA2M,4175
 stouputils/data_science/data_processing/image/__init__.py,sha256=dJY410JsVxfwloQiH1TPAwxVsRYAI4vhaZ3w1IAkUCk,1823
 stouputils/data_science/data_processing/image/auto_contrast.py,sha256=grKz4cxMEnLWAP6k4o0CuFyzcw8_v51d6Ep3fufb6Ew,2289
 stouputils/data_science/data_processing/image/axis_flip.py,sha256=6OsDeA6SK_jIv3NcbCEe4Q5NzH3KgWIPQf-EWkLzTP0,1663
@@ -95,7 +95,7 @@ stouputils/data_science/models/keras/xception.py,sha256=NKv5zTNtPiR3oV7_X-FIFvt5
 stouputils/data_science/models/keras_utils/callbacks/__init__.py,sha256=Wvlbv7dAZd6stAJKi1kPevNVwpG6ULme_Pl-ZAFV8nE,853
 stouputils/data_science/models/keras_utils/callbacks/colored_progress_bar.py,sha256=a6zjVzXsheU2l-ecRWhSC0Vkyk55eWbp74C8NQFert4,7641
 stouputils/data_science/models/keras_utils/callbacks/learning_rate_finder.py,sha256=ftimXot3or5ykJwauv1_-JjUScq7ckX4XjMSDnecBcE,5058
-stouputils/data_science/models/keras_utils/callbacks/model_checkpoint_v2.py,sha256=_9UXBP-Ryef_WCpRaWT0exhSX8VLezXF-FRDMlYTc58,966
+stouputils/data_science/models/keras_utils/callbacks/model_checkpoint_v2.py,sha256=KTsVin5sozwy6XVDt1Vj7J6obrkGH40NV-AfX4mBmq4,935
 stouputils/data_science/models/keras_utils/callbacks/progressive_unfreezing.py,sha256=okoiMpJ0a_DKY9ZE6JIdovbxn--Ao-XbE74xC_baKEk,9605
 stouputils/data_science/models/keras_utils/callbacks/warmup_scheduler.py,sha256=6aErEB8XHfvgqGqG8sFRtmMyZW-VSXbEK2OiIHmCujM,2312
 stouputils/data_science/models/keras_utils/losses/__init__.py,sha256=6HQkqTZd-W3YPrxg_-2956j_iCmLm4PmbeW2uIPv-4I,174
@@ -108,22 +108,22 @@ stouputils/data_science/scripts/augment_dataset.py,sha256=zGcQ2uSn_DO570NIFEs2DU
 stouputils/data_science/scripts/exhaustive_process.py,sha256=Ty2lHBZBweWxH6smpjoUEqpGz6JmMUO_oaNZO7d-gtQ,5483
 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/data_science/utils.py,sha256=MQ5-S21W2uvtKiwUFsyKJdeN9s9y7MxuvjfjRbwKTD8,10799
 stouputils/decorators.py,sha256=dBw_TCzd3m3HWL_SrtuGPN444ncMJWBFu1lDpDfvpuk,21189
 stouputils/decorators.pyi,sha256=k7kAOPM6c2LkhskUatoiv95JmfnMcKIxJRvhZN63axM,10561
 stouputils/image.py,sha256=NtduEVzgbCuZhDRpDZHGTW7-wTs7MqoxUwSQcipvb08,16633
 stouputils/image.pyi,sha256=Dkf64KmXJTAEcbtYDHFZ1kqEHqOf2FgJ2Z2BlJgp4fU,8455
-stouputils/installer/__init__.py,sha256=DBwI9w3xvw0NR_jDMxmURwPi1F79kPLe7EuNjmrxW_U,502
+stouputils/installer/__init__.py,sha256=Ff_al_z6GSaazLHqfsSxsxmooXcIRmE--ffb1gZt0Q0,484
 stouputils/installer/__init__.pyi,sha256=ZB-8frAUOW-0pCEJL-e2AdbFodivv46v3EBYwEXCxRo,117
 stouputils/installer/common.py,sha256=UJr5u02h4LQZQdkmVOkJ3vvW_0-ROGgVMMh0PNoVS1A,2209
 stouputils/installer/common.pyi,sha256=5aG0-58omFkkNYeVHnQ0uHUBsaI7xoMD-WqWVdOgOms,1403
 stouputils/installer/downloader.py,sha256=IIV_zI1lnKCD-9OsnroOoo4nDPOLr2Vn6oOYHnXshj8,3659
 stouputils/installer/downloader.pyi,sha256=8Xp0sXyba4flHAZ0nNqNlFU4VUmfPvllmPUkWalkvRA,1273
-stouputils/installer/linux.py,sha256=6BsMFoBDn1-RPMCW8rAciuxHwxbk9QTX0DmA-meQdDE,5512
+stouputils/installer/linux.py,sha256=5hlG7sh4Idk6rBXbfWP9oU-99TNd6njl9D5FjSnux1o,5368
 stouputils/installer/linux.pyi,sha256=V-EbY7seOFnC6LL844bqWRNvQ7rHmMhDkcFj5r1V7Tk,1943
-stouputils/installer/main.py,sha256=8wrx_cnQo1dFGRf6x8vtxh6-96tQ-AzMyvJ0S64j0io,8538
+stouputils/installer/main.py,sha256=pbcEdKOX1P4VLJlVjzxq-hmdk6zrFt_V3aj6pYYQ8cY,8315
 stouputils/installer/main.pyi,sha256=r3j4GoMBpU06MpOqjSwoDTiSMOmbA3WWUA87970b6KE,3134
-stouputils/installer/windows.py,sha256=r2AIuoyAmtMEuoCtQBH9GWQWI-JUT2J9zoH28j9ruOU,4880
+stouputils/installer/windows.py,sha256=WJcsRvEj00uAlJVAWgePhR7Hq0chYE0_n2QUZG9011A,4744
 stouputils/installer/windows.pyi,sha256=tHogIFhPVDQS0I10liLkAxnpaFFAvmFtEVMpPIae5LU,1616
 stouputils/io.py,sha256=yQ4jGWoI81cP-ZWxgYwqXmuD6s_IbpkKkZf5jjqqIAE,16841
 stouputils/io.pyi,sha256=TCBTVEWUkI3dO_jWI9oPMF9SbnT1yLzFChE551JPbSY,9076
@@ -131,10 +131,41 @@ stouputils/parallel.py,sha256=I8STOb-VV9VlSeTm_8ZKCJLdL_ahGL61iFSCptDwHhQ,17512
 stouputils/parallel.pyi,sha256=cvNMT0FyjOmehaVghurwVKABqvTO3BUbPF8f8ISp8Bw,10855
 stouputils/print.py,sha256=4IIUWkShAZ77Q7rZBDnUs-gSuAt7V1IGj9DbWwECbc4,16198
 stouputils/print.pyi,sha256=-uYWZ-hlPhkeu8E0gSoQqY0u-4UhkJAtPUioQb3Xujo,6674
-stouputils/py.typed,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
+stouputils/py.typed,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+stouputils/stouputils/__init__.pyi,sha256=J8LeijIkWrTdGlevNR8dlGlgYg-Dh_MvGjp2EsPZ8UM,351
+stouputils/stouputils/_deprecated.pyi,sha256=6-8YsftJd2fRAdBLsysc6jf-uA8V2wiqkiFAbdfWfJQ,664
+stouputils/stouputils/all_doctests.pyi,sha256=8JD8qn7neYuR0PolabWxX6id1dNEvQDrvOhMS2aYhTM,1907
+stouputils/stouputils/applications/__init__.pyi,sha256=DTYq2Uqq1uLzCMkFByjRqdtREA-9SaQnp4QpgmCEPFg,56
+stouputils/stouputils/applications/automatic_docs.pyi,sha256=sfFXpVE5y5Z907HEjKzpZ_9zM34d-jKNDQCdMx7E-9s,6189
+stouputils/stouputils/applications/upscaler/__init__.pyi,sha256=VSp6Tq09ATCTdfnjhbDnu7lblaLLGbCNi-E22jYxa88,67
+stouputils/stouputils/applications/upscaler/config.pyi,sha256=lsRHAW3mvvM2inKSJ66VXb511ovmIScLABrUzckmUfk,608
+stouputils/stouputils/applications/upscaler/image.pyi,sha256=AB92XoKt8Q2c_J72ZdDdyVDuCGOEiM7E6v8L-uFmAxI,4786
+stouputils/stouputils/applications/upscaler/video.pyi,sha256=AyRlb7iHqCwdW7lHiW8Dy_czin8CbN-GiK2_xoVJvNU,2918
+stouputils/stouputils/archive.pyi,sha256=Z2BbQAiErRYntv53QC9uf_XPw3tx3Oy73wB0Bbil11c,3246
+stouputils/stouputils/backup.pyi,sha256=-SLVykkR5U8479T84zjNPVBNnV193s0zyWjathY2DDA,4923
+stouputils/stouputils/collections.pyi,sha256=mKIBV4K7mm-PTvtoYi_cVOAGjW7bo3iIASqosSXFUzE,3519
+stouputils/stouputils/continuous_delivery/__init__.pyi,sha256=_Sz2D10n1CDEyY8qDFwXNKdr01HVxanY4qdq9aN19cc,117
+stouputils/stouputils/continuous_delivery/cd_utils.pyi,sha256=nxTLQydVOSVIix88dRtBXjMrUPpI5ftiQYbLI_nMByQ,4848
+stouputils/stouputils/continuous_delivery/github.pyi,sha256=RHRsSroEsT0I1qeuq-Wg0JLdEEDttLrzgHZPVRtLZ0Q,6641
+stouputils/stouputils/continuous_delivery/pypi.pyi,sha256=fRAu8ocLNpEN6dhUTMuFxlmRgt3-LRjKPOJjFlUPrJ4,2463
+stouputils/stouputils/continuous_delivery/pyproject.pyi,sha256=bMWwqyG0Auo46dt-dWGePQ9yJ8rSrgb7mnJTfbiS3TQ,2053
+stouputils/stouputils/continuous_delivery/stubs.pyi,sha256=sLZypdz1oGoymQIRPez50rnH8TQhvEIx6A7xUdGtnys,2390
+stouputils/stouputils/ctx.pyi,sha256=-7AJwD9bKzKBFsYlgyULPznstq3LvXRXe2r_2at72FI,9799
+stouputils/stouputils/decorators.pyi,sha256=k7kAOPM6c2LkhskUatoiv95JmfnMcKIxJRvhZN63axM,10561
+stouputils/stouputils/image.pyi,sha256=Dkf64KmXJTAEcbtYDHFZ1kqEHqOf2FgJ2Z2BlJgp4fU,8455
+stouputils/stouputils/installer/__init__.pyi,sha256=ZB-8frAUOW-0pCEJL-e2AdbFodivv46v3EBYwEXCxRo,117
+stouputils/stouputils/installer/common.pyi,sha256=5aG0-58omFkkNYeVHnQ0uHUBsaI7xoMD-WqWVdOgOms,1403
+stouputils/stouputils/installer/downloader.pyi,sha256=8Xp0sXyba4flHAZ0nNqNlFU4VUmfPvllmPUkWalkvRA,1273
+stouputils/stouputils/installer/linux.pyi,sha256=V-EbY7seOFnC6LL844bqWRNvQ7rHmMhDkcFj5r1V7Tk,1943
+stouputils/stouputils/installer/main.pyi,sha256=r3j4GoMBpU06MpOqjSwoDTiSMOmbA3WWUA87970b6KE,3134
+stouputils/stouputils/installer/windows.pyi,sha256=tHogIFhPVDQS0I10liLkAxnpaFFAvmFtEVMpPIae5LU,1616
+stouputils/stouputils/io.pyi,sha256=TCBTVEWUkI3dO_jWI9oPMF9SbnT1yLzFChE551JPbSY,9076
+stouputils/stouputils/parallel.pyi,sha256=cvNMT0FyjOmehaVghurwVKABqvTO3BUbPF8f8ISp8Bw,10855
+stouputils/stouputils/print.pyi,sha256=-uYWZ-hlPhkeu8E0gSoQqY0u-4UhkJAtPUioQb3Xujo,6674
+stouputils/stouputils/version_pkg.pyi,sha256=QPvqp1U3QA-9C_CC1dT9Vahv1hXEhstbM7x5uzMZSsQ,755
 stouputils/version_pkg.py,sha256=Jsp-s03L14DkiZ94vQgrlQmaxApfn9DC8M_nzT1SJLk,7014
 stouputils/version_pkg.pyi,sha256=QPvqp1U3QA-9C_CC1dT9Vahv1hXEhstbM7x5uzMZSsQ,755
-stouputils-1.12.2.dist-info/WHEEL,sha256=ZyFSCYkV2BrxH6-HRVRg3R9Fo7MALzer9KiPYqNxSbo,79
-stouputils-1.12.2.dist-info/entry_points.txt,sha256=tx0z9VOnE-sfkmbFbA93zaBMzV3XSsKEJa_BWIqUzxw,57
-stouputils-1.12.2.dist-info/METADATA,sha256=7GyfVHC5zHyTuBx7WsW7R3p_uzDZ1MppXjkFefmCOTg,13615
-stouputils-1.12.2.dist-info/RECORD,,
+stouputils-1.13.0.dist-info/WHEEL,sha256=ZyFSCYkV2BrxH6-HRVRg3R9Fo7MALzer9KiPYqNxSbo,79
+stouputils-1.13.0.dist-info/entry_points.txt,sha256=tx0z9VOnE-sfkmbFbA93zaBMzV3XSsKEJa_BWIqUzxw,57
+stouputils-1.13.0.dist-info/METADATA,sha256=Tc6LE1z8Gbch2G-mLmzwx-hzrD06GLBSx5_ECwngFWU,13615
+stouputils-1.13.0.dist-info/RECORD,,