stouputils 1.10.3__tar.gz → 1.11.0__tar.gz

{stouputils-1.10.3 → stouputils-1.11.0}/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.10.3 → stouputils-1.11.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: stouputils
-Version: 1.10.3
+Version: 1.11.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.
 Project-URL: Homepage, https://github.com/Stoupy51/stouputils
 Project-URL: Issues, https://github.com/Stoupy51/stouputils/issues
@@ -9,22 +9,20 @@ License-File: LICENSE
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Requires-Python: >=3.12
 Requires-Dist: argcomplete>=3.0.0
-Requires-Dist: mypy>=1.18.2
-Requires-Dist: numpy>=2.4.0
-Requires-Dist: opencv-python>=4.0.0
-Requires-Dist: orjson>=3.0.0
+Requires-Dist: msgspec[toml,yaml]>=0.20.0
+Requires-Dist: numpy>=2.3.0
 Requires-Dist: pillow>=10.0.0
-Requires-Dist: pyfastcopy>=1.0.0
-Requires-Dist: python-box[all]>=7.0.0
-Requires-Dist: pyyaml>=6.0.0
+Requires-Dist: python-box>=7.0.0
 Requires-Dist: requests>=2.20.0
-Requires-Dist: toml>=0.10.0
 Requires-Dist: tqdm>=4.0.0
-Requires-Dist: zarr>=2.18.3
 Provides-Extra: data-science
 Requires-Dist: mlflow; extra == 'data-science'
+Requires-Dist: opencv-python; extra == 'data-science'
 Requires-Dist: pywavelets; extra == 'data-science'
 Requires-Dist: scikit-image; extra == 'data-science'
 Requires-Dist: scikit-learn; extra == 'data-science'
@@ -32,6 +30,7 @@ Requires-Dist: simpleitk; extra == 'data-science'
 Requires-Dist: tensorflow; extra == 'data-science'
 Provides-Extra: docs
 Requires-Dist: m2r2; extra == 'docs'
+Requires-Dist: mypy; extra == 'docs'
 Requires-Dist: myst-parser; extra == 'docs'
 Requires-Dist: pydata-sphinx-theme; extra == 'docs'
 Requires-Dist: sphinx-breeze-theme; extra == 'docs'

stouputils-1.11.0/pyproject.toml

@@ -0,0 +1,106 @@
+
+[build-system]
+requires = [
+    "hatchling",
+]
+build-backend = "hatchling.build"
+
+[project]
+name = "stouputils"
+version = "1.11.0"
+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.12"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+dependencies = [
+    "tqdm>=4.0.0",
+    "requests>=2.20.0",
+    "msgspec[toml,yaml]>=0.20.0",
+    "pillow>=10.0.0",
+    "numpy>=2.3.0",
+    "python-box>=7.0.0",
+    "argcomplete>=3.0.0",
+]
+authors = [
+    { name = "Stoupy51", email = "stoupy51@gmail.com" },
+]
+
+[project.optional-dependencies]
+docs = [
+    "mypy",
+    "m2r2",
+    "myst_parser",
+    "sphinx_copybutton",
+    "sphinx_design",
+    "sphinx_treeview",
+    "sphinx_breeze_theme",
+    "pydata_sphinx_theme",
+]
+data_science = [
+    "opencv-python",
+    "scikit-image",
+    "simpleitk",
+    "mlflow",
+    "tensorflow",
+    "scikit-learn",
+    "PyWavelets",
+]
+
+[project.urls]
+Homepage = "https://github.com/Stoupy51/stouputils"
+Issues = "https://github.com/Stoupy51/stouputils/issues"
+
+[project.scripts]
+stouputils = "stouputils.__main__:main"
+
+[tool.pyright]
+typeCheckingMode = "strict"
+
+[tool.ruff]
+exclude = [
+    ".git",
+    ".ruff_cache",
+    ".venv",
+    ".vscode",
+    ".cursor",
+    "build",
+    "dist",
+    "*.pyi",
+]
+line-length = 200
+
+[tool.ruff.lint]
+select = [
+    "E",
+    "W",
+    "F",
+    "I",
+    "N",
+    "UP",
+    "B",
+    "C4",
+    "T20",
+    "RUF",
+]
+ignore = [
+    "T201",
+    "W191",
+    "N803",
+    "N806",
+    "F403",
+    "F405",
+]
+
+[tool.hatch.build]
+include = [
+    "stouputils",
+]
+ignore-vcs = true
+

{stouputils-1.10.3 → stouputils-1.11.0}/stouputils/applications/automatic_docs.py

@@ -566,7 +566,7 @@ a:hover {
 	background-clip: text;
 	-webkit-background-clip: text;
 	-webkit-text-fill-color: transparent;
-	animation: shine-slide 2s linear infinite;
+	animation: shine-slide 3.5s linear infinite;
 }
 """)
 

{stouputils-1.10.3 → stouputils-1.11.0}/stouputils/collections.py

@@ -29,7 +29,7 @@ if TYPE_CHECKING:
 T = TypeVar("T")
 
 # Functions
-def unique_list(list_to_clean: Iterable[T], method: Literal["id", "hash", "str"] = "str") -> list[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
 
 	Args:
@@ -77,7 +77,7 @@ def unique_list(list_to_clean: Iterable[T], method: Literal["id", "hash", "str"]
 	# Return the cleaned list
 	return result
 
-def sort_dict_keys(dictionary: dict[T, Any], order: list[T], reverse: bool = False) -> dict[T, Any]:
+def sort_dict_keys[T](dictionary: dict[T, Any], order: list[T], reverse: bool = False) -> dict[T, Any]:
 	""" Sort dictionary keys using a given order list (reverse optional)
 
 	Args:
@@ -185,7 +185,10 @@ def array_to_disk(
 		)
 
 	# Imports
-	import zarr  # pyright: ignore[reportMissingTypeStubs]
+	try:
+		import zarr  # pyright: ignore[reportMissingTypeStubs]
+	except ImportError as e:
+		raise ImportError("zarr is required for array_to_disk function. Please install it via 'pip install zarr'.") from e
 
 	# If data is already a zarr.Array and more_data is present, just append and return
 	if isinstance(data, zarr.Array) and more_data is not None:

{stouputils-1.10.3 → stouputils-1.11.0}/stouputils/collections.pyi

@@ -6,7 +6,7 @@ from typing import Any, Literal, TypeVar
 
 T = TypeVar('T')
 
-def unique_list(list_to_clean: Iterable[T], method: Literal['id', 'hash', 'str'] = 'str') -> list[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
 
 \tArgs:
@@ -31,7 +31,7 @@ def unique_list(list_to_clean: Iterable[T], method: Literal['id', 'hash', 'str']
 \t\t>>> unique_list([s1, s2, s1, s1, s3, s2, s3], method="str")
 \t\t[{1, 2, 3}, {2, 3, 4}]
 \t'''
-def sort_dict_keys(dictionary: dict[T, Any], order: list[T], reverse: bool = False) -> dict[T, Any]:
+def sort_dict_keys[T](dictionary: dict[T, Any], order: list[T], reverse: bool = False) -> dict[T, Any]:
     ''' Sort dictionary keys using a given order list (reverse optional)
 
 \tArgs:

{stouputils-1.10.3 → stouputils-1.11.0}/stouputils/continuous_delivery/cd_utils.py

@@ -63,9 +63,9 @@ def load_credentials(credentials_path: str) -> dict[str, Any]:
 
 	# Else, load the file if it's a YAML file
 	elif credentials_path.endswith((".yml", ".yaml")):
-		import yaml
+		from msgspec import yaml
 		with open(credentials_path) as f:
-			return yaml.safe_load(f)
+			return yaml.decode(f.read())
 
 	# Else, raise an error
 	else:

{stouputils-1.10.3 → stouputils-1.11.0}/stouputils/continuous_delivery/pypi.py

@@ -1,90 +1,90 @@
-""" This module contains utilities for PyPI.
-
-- pypi_full_routine: Upload the most recent file(s) to PyPI after updating pip and required packages and building the package
-
-.. image:: https://raw.githubusercontent.com/Stoupy51/stouputils/refs/heads/main/assets/continuous_delivery/pypi_module.gif
-  :alt: stouputils pypi examples
-"""
-
-# Imports
-import os
-import sys
-from collections.abc import Callable
-
-from ..decorators import LogLevels, handle_error
-
-
-def update_pip_and_required_packages() -> int:
-	""" Update pip and required packages.
-
-	Returns:
-		int: Return code of the os.system call.
-	"""
-	return os.system(f"{sys.executable} -m pip install --upgrade pip setuptools build twine pkginfo packaging")
-
-def build_package() -> int:
-	""" Build the package.
-
-	Returns:
-		int: Return code of the os.system call.
-	"""
-	return os.system(f"{sys.executable} -m build")
-
-def upload_package(repository: str, filepath: str) -> int:
-	""" Upload the package to PyPI.
-
-	Args:
-		repository  (str): Repository to upload to.
-		filepath    (str): Path to the file to upload.
-
-	Returns:
-		int: Return code of the os.system call.
-	"""
-	return os.system(f"{sys.executable} -m twine upload --verbose -r {repository} {filepath}")
-
-@handle_error(message="Error while doing the pypi full routine", error_log=LogLevels.ERROR_TRACEBACK)
-def pypi_full_routine(
-	repository: str,
-	dist_directory: str,
-	last_files: int = 1,
-	endswith: str = ".tar.gz",
-
-	update_all_function: Callable[[], int] = update_pip_and_required_packages,
-	build_package_function: Callable[[], int] = build_package,
-	upload_package_function: Callable[[str, str], int] = upload_package,
-) -> None:
-	""" Upload the most recent file(s) to PyPI after updating pip and required packages and building the package.
-
-	Args:
-		repository               (str):                        Repository to upload to.
-		dist_directory           (str):                        Directory to upload from.
-		last_files               (int):                        Number of most recent files to upload. Defaults to 1.
-		endswith                 (str):                        End of the file name to upload. Defaults to ".tar.gz".
-		update_all_function      (Callable[[], int]):          Function to update pip and required packages.
-			Defaults to :func:`update_pip_and_required_packages`.
-		build_package_function   (Callable[[], int]):          Function to build the package.
-			Defaults to :func:`build_package`.
-		upload_package_function  (Callable[[str, str], int]):  Function to upload the package.
-			Defaults to :func:`upload_package`.
-
-	Returns:
-		int: Return code of the command.
-	"""
-	if update_all_function() != 0:
-		raise Exception("Error while updating pip and required packages")
-
-	if build_package_function() != 0:
-		raise Exception("Error while building the package")
-
-	# Get list of tar.gz files in dist directory sorted by modification time
-	files: list[str] = sorted(
-		[x for x in os.listdir(dist_directory) if x.endswith(endswith)],	# Get list of tar.gz files in dist directory
-		key=lambda x: os.path.getmtime(f"{dist_directory}/{x}"),			# Sort by modification time
-		reverse=True														# Sort in reverse order
-	)
-
-	# Upload the most recent file(s)
-	for file in files[:last_files]:
-		upload_package_function(repository, f"{dist_directory}/{file}")
-
-
+""" This module contains utilities for PyPI.
+
+- pypi_full_routine: Upload the most recent file(s) to PyPI after updating pip and required packages and building the package
+
+.. image:: https://raw.githubusercontent.com/Stoupy51/stouputils/refs/heads/main/assets/continuous_delivery/pypi_module.gif
+  :alt: stouputils pypi examples
+"""
+
+# Imports
+import os
+import sys
+from collections.abc import Callable
+
+from ..decorators import LogLevels, handle_error
+
+
+def update_pip_and_required_packages() -> int:
+	""" Update pip and required packages.
+
+	Returns:
+		int: Return code of the os.system call.
+	"""
+	return os.system(f"{sys.executable} -m pip install --upgrade pip setuptools build twine pkginfo packaging")
+
+def build_package() -> int:
+	""" Build the package.
+
+	Returns:
+		int: Return code of the os.system call.
+	"""
+	return os.system(f"{sys.executable} -m build")
+
+def upload_package(repository: str, filepath: str) -> int:
+	""" Upload the package to PyPI.
+
+	Args:
+		repository  (str): Repository to upload to.
+		filepath    (str): Path to the file to upload.
+
+	Returns:
+		int: Return code of the os.system call.
+	"""
+	return os.system(f"{sys.executable} -m twine upload --verbose -r {repository} {filepath}")
+
+@handle_error(message="Error while doing the pypi full routine", error_log=LogLevels.ERROR_TRACEBACK)
+def pypi_full_routine(
+	repository: str,
+	dist_directory: str,
+	last_files: int = 1,
+	endswith: str = ".tar.gz",
+
+	update_all_function: Callable[[], int] = update_pip_and_required_packages,
+	build_package_function: Callable[[], int] = build_package,
+	upload_package_function: Callable[[str, str], int] = upload_package,
+) -> None:
+	""" Upload the most recent file(s) to PyPI after updating pip and required packages and building the package.
+
+	Args:
+		repository               (str):                        Repository to upload to.
+		dist_directory           (str):                        Directory to upload from.
+		last_files               (int):                        Number of most recent files to upload. Defaults to 1.
+		endswith                 (str):                        End of the file name to upload. Defaults to ".tar.gz".
+		update_all_function      (Callable[[], int]):          Function to update pip and required packages.
+			Defaults to :func:`update_pip_and_required_packages`.
+		build_package_function   (Callable[[], int]):          Function to build the package.
+			Defaults to :func:`build_package`.
+		upload_package_function  (Callable[[str, str], int]):  Function to upload the package.
+			Defaults to :func:`upload_package`.
+
+	Returns:
+		int: Return code of the command.
+	"""
+	if update_all_function() != 0:
+		raise Exception("Error while updating pip and required packages")
+
+	if build_package_function() != 0:
+		raise Exception("Error while building the package")
+
+	# Get list of tar.gz files in dist directory sorted by modification time
+	files: list[str] = sorted(
+		[x for x in os.listdir(dist_directory) if x.endswith(endswith)],	# Get list of tar.gz files in dist directory
+		key=lambda x: os.path.getmtime(f"{dist_directory}/{x}"),			# Sort by modification time
+		reverse=True														# Sort in reverse order
+	)
+
+	# Upload the most recent file(s)
+	for file in files[:last_files]:
+		upload_package_function(repository, f"{dist_directory}/{file}")
+
+

{stouputils-1.10.3 → stouputils-1.11.0}/stouputils/continuous_delivery/pyproject.py

@@ -25,12 +25,17 @@ def read_pyproject(pyproject_path: str) -> dict[str, Any]:
 
 	Args:
 		pyproject_path: Path to the pyproject.toml file.
-
 	Returns:
 		dict[str, Any]: The content of the pyproject.toml file.
+	Example:
+		>>> content = read_pyproject("pyproject.toml")
+		>>> "." in content["project"]["version"]
+		True
 	"""
-	import toml
-	return toml.load(pyproject_path)
+	from msgspec import toml
+	with open(pyproject_path) as file:
+		content = file.read()
+	return toml.decode(content)
 
 
 def format_toml_lists(content: str) -> str:
@@ -38,9 +43,18 @@ def format_toml_lists(content: str) -> str:
 
 	Args:
 		content (str): The content of the pyproject.toml file.
-
 	Returns:
 		str: The formatted content with properly indented lists.
+	Example:
+		>>> toml_content = '''[project]
+		... dependencies = [ "tqdm>=4.0.0", "requests>=2.20.0", "pyyaml>=6.0.0", ]'''
+		>>> format_toml_lists(toml_content).replace("\\t", "    ") == '''[project]
+		... dependencies = [
+		...     "tqdm>=4.0.0",
+		...     "requests>=2.20.0",
+		...     "pyyaml>=6.0.0",
+		... ]'''
+		True
 	"""
 	# Split the content into individual lines for processing
 	lines: list[str] = content.split("\n")
@@ -78,14 +92,20 @@ def format_toml_lists(content: str) -> str:
 	return "\n".join(formatted_lines)
 
 
-def write_pyproject(pyproject_path: str, pyproject_content: dict[str, Any]) -> None:
-	""" Write to the pyproject.toml file with properly indented lists. """
-	import toml
-	content: str = "\n" + toml.dumps(pyproject_content) + "\n"
-	content = format_toml_lists(content)  # Apply formatting
+def write_pyproject(path: str, content: dict[str, Any]) -> None:
+	""" Write to the pyproject.toml file with properly indented lists.
+
+	Args:
+		path: Path to the pyproject.toml file.
+		content: Content to write to the pyproject.toml file.
+	"""
+	from msgspec.toml import _import_tomli_w  # pyright: ignore[reportPrivateUsage]
+	toml = _import_tomli_w()
+	string: str = "\n" + toml.dumps(content) + "\n"
+	string = format_toml_lists(string)  # Apply formatting
 
-	with super_open(pyproject_path, "w") as file:
-		file.write(content)
+	with super_open(path, "w") as file:
+		file.write(string)
 
 
 def increment_version_from_input(version: str) -> str:
@@ -93,32 +113,35 @@ def increment_version_from_input(version: str) -> str:
 
 	Args:
 		version: The version to increment. (ex: "0.1.0")
-
 	Returns:
 		str: The incremented version. (ex: "0.1.1")
+	Example:
+		>>> increment_version_from_input("0.1.0")
+		'0.1.1'
+		>>> increment_version_from_input("1.2.9")
+		'1.2.10'
 	"""
 	version_parts: list[str] = version.split(".")
 	version_parts[-1] = str(int(version_parts[-1]) + 1)
 	return ".".join(version_parts)
 
-def increment_version_from_pyproject(pyproject_path: str) -> None:
+def increment_version_from_pyproject(path: str) -> None:
 	""" Increment the version in the pyproject.toml file.
 
 	Args:
-		pyproject_path: Path to the pyproject.toml file.
+		path: Path to the pyproject.toml file.
 	"""
-	pyproject_content: dict[str, Any] = read_pyproject(pyproject_path)
+	pyproject_content: dict[str, Any] = read_pyproject(path)
 	pyproject_content["project"]["version"] = increment_version_from_input(pyproject_content["project"]["version"])
-	write_pyproject(pyproject_path, pyproject_content)
+	write_pyproject(path, pyproject_content)
 
-def get_version_from_pyproject(pyproject_path: str) -> str:
+def get_version_from_pyproject(path: str) -> str:
 	""" Get the version from the pyproject.toml file.
 
 	Args:
-		pyproject_path: Path to the pyproject.toml file.
-
+		path: Path to the pyproject.toml file.
 	Returns:
 		str: The version. (ex: "0.1.0")
 	"""
-	return read_pyproject(pyproject_path)["project"]["version"]
+	return read_pyproject(path)["project"]["version"]
 

stouputils-1.11.0/stouputils/continuous_delivery/pyproject.pyi

@@ -0,0 +1,67 @@
+from ..io import super_open as super_open
+from typing import Any
+
+def read_pyproject(pyproject_path: str) -> dict[str, Any]:
+    ''' Read the pyproject.toml file.
+
+\tArgs:
+\t\tpyproject_path: Path to the pyproject.toml file.
+\tReturns:
+\t\tdict[str, Any]: The content of the pyproject.toml file.
+\tExample:
+\t\t>>> content = read_pyproject("pyproject.toml")
+\t\t>>> "." in content["project"]["version"]
+\t\tTrue
+\t'''
+def format_toml_lists(content: str) -> str:
+    ''' Format TOML lists with indentation.
+
+\tArgs:
+\t\tcontent (str): The content of the pyproject.toml file.
+\tReturns:
+\t\tstr: The formatted content with properly indented lists.
+\tExample:
+\t\t>>> toml_content = \'\'\'[project]
+\t\t... dependencies = [ "tqdm>=4.0.0", "requests>=2.20.0", "pyyaml>=6.0.0", ]\'\'\'
+\t\t>>> format_toml_lists(toml_content).replace("\\t", "    ") == \'\'\'[project]
+\t\t... dependencies = [
+\t\t...     "tqdm>=4.0.0",
+\t\t...     "requests>=2.20.0",
+\t\t...     "pyyaml>=6.0.0",
+\t\t... ]\'\'\'
+\t\tTrue
+\t'''
+def write_pyproject(path: str, content: dict[str, Any]) -> None:
+    """ Write to the pyproject.toml file with properly indented lists.
+
+\tArgs:
+\t\tpath: Path to the pyproject.toml file.
+\t\tcontent: Content to write to the pyproject.toml file.
+\t"""
+def increment_version_from_input(version: str) -> str:
+    ''' Increment the version.
+
+\tArgs:
+\t\tversion: The version to increment. (ex: "0.1.0")
+\tReturns:
+\t\tstr: The incremented version. (ex: "0.1.1")
+\tExample:
+\t\t>>> increment_version_from_input("0.1.0")
+\t\t\'0.1.1\'
+\t\t>>> increment_version_from_input("1.2.9")
+\t\t\'1.2.10\'
+\t'''
+def increment_version_from_pyproject(path: str) -> None:
+    """ Increment the version in the pyproject.toml file.
+
+\tArgs:
+\t\tpath: Path to the pyproject.toml file.
+\t"""
+def get_version_from_pyproject(path: str) -> str:
+    ''' Get the version from the pyproject.toml file.
+
+\tArgs:
+\t\tpath: Path to the pyproject.toml file.
+\tReturns:
+\t\tstr: The version. (ex: "0.1.0")
+\t'''

{stouputils-1.10.3 → stouputils-1.11.0}/stouputils/continuous_delivery/stubs.py

@@ -26,7 +26,10 @@ def generate_stubs(
 	Returns:
 		int: Return code of the os.system call.
 	"""
-	from mypy.stubgen import main as stubgen_main
+	try:
+		from mypy.stubgen import main as stubgen_main
+	except ImportError as e:
+		raise ImportError("mypy is required for array_to_disk function. Please install it via 'pip install mypy'.") from e
 	try:
 		stubgen_main(["-p", package_name, *extra_args.split()])
 		return 0