stouputils 1.12.2__tar.gz → 1.13.0__tar.gz

{stouputils-1.12.2 → stouputils-1.13.0}/PKG-INFO

@@ -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 → stouputils-1.13.0}/pyproject.toml

@@ -5,12 +5,10 @@ build-backend = "uv_build"
 
 [tool.uv.build-backend]
 module-root = ""
-module-name = "stouputils"
-ignore-vcs = true
 
 [project]
 name = "stouputils"
-version = "1.12.2"
+version = "1.13.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"
 keywords = ["utilities", "tools", "helpers", "development", "python"]

{stouputils-1.12.2 → stouputils-1.13.0}/stouputils/__main__.py

@@ -17,7 +17,7 @@ from .version_pkg import show_version_cli
 # Argument Parser Setup for Auto-Completion
 parser = argparse.ArgumentParser(prog="stouputils", add_help=False)
 parser.add_argument("command", nargs="?", choices=[
-	"--version", "-v", "version", "show_version", "all_doctests", "archive", "backup"
+	"--version", "-v", "version", "show_version", "all_doctests", "archive", "backup", "build"
 ])
 parser.add_argument("args", nargs="*")
 argcomplete.autocomplete(parser)
@@ -47,6 +47,11 @@ def main() -> None:
 		sys.argv.pop(1)  # Remove "backup" from argv so backup_cli gets clean arguments
 		return backup_cli()
 
+	# Handle "build" command
+	if second_arg == "build":
+		from .continuous_delivery.pypi import pypi_full_routine_using_uv
+		return pypi_full_routine_using_uv()
+
 	# Check if the command is any package name
 	if second_arg in (): # type: ignore
 		return
@@ -67,11 +72,11 @@ def main() -> None:
 {CYAN}Usage:{RESET} stouputils <command> [options]
 
 {CYAN}Available commands:{RESET}
-  {GREEN}--version, -v{RESET} [pkg] [-t <depth>]
-        Show version information (optionally for a specific package)
-  {GREEN}all_doctests{RESET} [dir]   Run all doctests in the specified directory
-  {GREEN}archive{RESET} --help       Archive utilities (make, repair)
-  {GREEN}backup{RESET} --help        Backup utilities (delta, consolidate, limit)
+  {GREEN}--version, -v{RESET} [pkg] [-t <depth>]    Show version information (optionally for a specific package)
+  {GREEN}all_doctests{RESET} [dir]                  Run all doctests in the specified directory
+  {GREEN}archive{RESET} --help                      Archive utilities (make, repair)
+  {GREEN}backup{RESET} --help                       Backup utilities (delta, consolidate, limit)
+  {GREEN}build{RESET} [--no_stubs] [<minor|major>]  Build and publish package to PyPI using 'uv' tool (complete routine)
 {CYAN}{separator}{RESET}
 """.strip())
 	return

{stouputils-1.12.2 → stouputils-1.13.0}/stouputils/continuous_delivery/pypi.py

@@ -1,7 +1,8 @@
 """ This module contains utilities for PyPI.
 (Using build and twine packages)
 
-- pypi_full_routine: Upload the most recent file(s) to PyPI after updating pip and required packages and building the package
+- pypi_full_routine: Upload the most recent file(s) to PyPI after updating pip and required packages and building the package (using build and twine)
+- pypi_full_routine_using_uv: Full build and publish routine using 'uv' command line tool
 
 .. image:: https://raw.githubusercontent.com/Stoupy51/stouputils/refs/heads/main/assets/continuous_delivery/pypi_module.gif
   :alt: stouputils pypi examples
@@ -11,8 +12,10 @@
 import os
 import sys
 from collections.abc import Callable
+from typing import Any
 
 from ..decorators import LogLevels, handle_error
+from .pyproject import read_pyproject
 
 
 def update_pip_and_required_packages() -> int:
@@ -88,4 +91,39 @@ def pypi_full_routine(
 	for file in files[:last_files]:
 		upload_package_function(repository, f"{dist_directory}/{file}")
 
+def pypi_full_routine_using_uv() -> None:
+	""" Full build and publish routine using 'uv' command line tool.
+
+	Steps:
+		1. Generate stubs unless '--no-stubs' is passed
+		2. Increment version in pyproject.toml (patch by default, minor if 'minor' is passed as last argument, 'major' if 'major' is passed)
+		3. Build the package using 'uv build'
+		4. Upload the most recent file to PyPI using 'uv publish'
+	"""
+	# Get package name from pyproject.toml
+	pyproject_data: dict[str, Any] = read_pyproject("pyproject.toml")
+	package_name: str = pyproject_data["project"]["name"]
+	package_dir: str = package_name
+	if not os.path.isdir(package_dir):
+		package_dir = "src/" + package_name
+
+	# Generate stubs unless '--no-stubs' is passed
+	if "--no-stubs" not in sys.argv:
+		from .stubs import stubs_full_routine
+		stubs_full_routine(package_name, output_directory=package_dir, clean_before=True)
+
+	# Increment version in pyproject.toml
+	increment: str = "patch" if sys.argv[-1] not in ("minor", "major") else sys.argv[-1]
+	if os.system(f"uv version --bump {increment} --frozen") != 0:
+		raise Exception("Error while incrementing version using 'uv version'")
+
+	# Build the package using 'uv build'
+	import shutil
+	shutil.rmtree("dist", ignore_errors=True)
+	if os.system(f"{sys.executable} -m uv build") != 0:
+		raise Exception("Error while building the package using 'uv build'")
+
+	# Upload the most recent file to PyPI using 'uv publish'
+	if os.system(f"{sys.executable} -m uv publish") != 0:
+		raise Exception("Error while publishing the package using 'uv publish'")
 

{stouputils-1.12.2 → stouputils-1.13.0}/stouputils/continuous_delivery/pypi.pyi

@@ -1,4 +1,5 @@
 from ..decorators import LogLevels as LogLevels, handle_error as handle_error
+from .pyproject import read_pyproject as read_pyproject
 from collections.abc import Callable as Callable
 
 def update_pip_and_required_packages() -> int:
@@ -41,3 +42,11 @@ def pypi_full_routine(repository: str, dist_directory: str, last_files: int = 1,
 \tReturns:
 \t\tint: Return code of the command.
 \t'''
+def pypi_full_routine_using_uv() -> None:
+    """ Full build and publish routine using 'uv' command line tool.
+
+\tSteps:
+\t\t1. Generate stubs unless '--no-stubs' is passed
+\t\t2. Build the package using 'uv build'
+\t\t3. Upload the most recent file to PyPI using 'uv publish'
+\t"""