🐛 Enhance reqs target in Makefile to support upgrading packages with startswith option

Author: pcrespov

requirements/tools/Makefile

@@ -24,6 +24,9 @@ SERVICES_DIR := $(abspath $(REPODIR)/services)
 IMAGE := local/requirements/tools
 
 UPGRADE_OPTION := $(if $(upgrade),upgrade=$(upgrade),)
+STARTSWITH_OPTION := $(if $(startswith),startswith=$(startswith),)
+UPGRADE_OR_STARTSWITH_OPTION := $(if $(upgrade),upgrade=$(upgrade),$(if $(startswith),startswith=$(startswith),))
+UPGRADE_OR_STARTSWITH_OR_CLEAN_OPTION := $(if $(upgrade),upgrade=$(upgrade),$(if $(startswith),startswith=$(startswith),$(if $(clean),clean=$(clean),)))
 
 # tools
 MAKE_C := $(MAKE) --directory
@@ -70,20 +73,20 @@ touch: ## touches all package requirement inputs
 
 only-tools: ## upgrades tools repo wide
 	# Upgrading ONLY _tools.in
-	@$(foreach p,${_tools-in},echo Touching $(p);touch $(p);$(MAKE_C) $(dir $(p)) reqs $(UPGRADE_OPTION);)
+	@$(foreach p,${_tools-in},echo Touching $(p);touch $(p);$(MAKE_C) $(dir $(p)) reqs $(UPGRADE_OR_STARTSWITH_OR_CLEAN_OPTION);)
 
-reqs: ## updates test & tooling requirements
-	# Upgrading $(upgrade) requirements
-	@$(foreach p,${_target-inputs},echo Touching $(p);touch $(p);$(MAKE_C) $(dir $(p)) reqs $(UPGRADE_OPTION);)
+reqs: guard-UPGRADE_OR_STARTSWITH_OR_CLEAN_OPTION ## updates test & tooling requirements
+	# Upgrading $(upgrade)$(startswith)$(if $(clean), cleaning) requirements
+	@$(foreach p,${_target-inputs},echo Touching $(p);touch $(p);$(MAKE_C) $(dir $(p)) reqs $(UPGRADE_OR_STARTSWITH_OR_CLEAN_OPTION);)
 
 
-reqs-all: guard-UPGRADE_OPTION ## updates a given package repository-wise IN ALL `requirements/` folders (e.g. make reqs-all upgrade=foo==1.2.3 )
-	# Upgrading $(upgrade) ALL requirements
-	@$(foreach p,${_all-in},echo Touching $(p);touch $(p);$(MAKE_C) $(dir $(p)) reqs $(UPGRADE_OPTION);)
+reqs-all: guard-UPGRADE_OR_STARTSWITH_OR_CLEAN_OPTION ## updates a given package or pattern repository-wise IN ALL `requirements/` folders (e.g. make reqs-all upgrade=foo==1.2.3 or make reqs-all startswith=pytest or make reqs-all clean=1)
+	# Upgrading $(upgrade)$(startswith)$(if $(clean), cleaning) ALL requirements
+	@$(foreach p,${_all-in},echo Touching $(p);touch $(p);$(MAKE_C) $(dir $(p)) reqs $(UPGRADE_OR_STARTSWITH_OR_CLEAN_OPTION);)
 
-reqs-services: guard-UPGRADE_OPTION ## updates a given package on all services [and not packages] (e.g. make reqs-services upgrade=foo==1.2.3 )
-	# Upgrading $(upgrade) in services
-	@$(foreach p,${_services-in},echo Touching $(p);touch $(p);$(MAKE_C) $(dir $(p)) reqs $(UPGRADE_OPTION);)
+reqs-services: guard-UPGRADE_OR_STARTSWITH_OR_CLEAN_OPTION ## updates a given package or pattern on all services [and not packages] (e.g. make reqs-services upgrade=foo==1.2.3 or make reqs-services startswith=pytest or make reqs-services clean=1)
+	# Upgrading $(upgrade)$(startswith)$(if $(clean), cleaning) in services
+	@$(foreach p,${_services-in},echo Touching $(p);touch $(p);$(MAKE_C) $(dir $(p)) reqs $(UPGRADE_OR_STARTSWITH_OR_CLEAN_OPTION);)
 
 
 reqs-ci: ## upgrades requirements for pylint recipe in CI
@@ -112,7 +115,7 @@ run: build ## Runs upgrade in a container [WARNING! UNDER DEV. USE CAREFULY]
 		--user=$(shell id -u):$(shell id -g) \
 		--entrypoint=/bin/bash \
 		${IMAGE_NAME} \
-		-c "cd requirements/tools; make reqs $(if $(upgrade),upgrade=$(upgrade),)"
+		-c "cd requirements/tools; make reqs $(UPGRADE_OR_STARTSWITH_OR_CLEAN_OPTION)"
 
 
 .PHONY: shell
@@ -134,6 +137,21 @@ help: ## this colorful help
 	@echo ""
 	@awk --posix 'BEGIN {FS = ":.*?## "} /^[[:alpha:][:space:]_-]+:.*?## / {printf "\033[36m%-20s\033[0m %s\n", $$1, $$2}' $(MAKEFILE_LIST)
 	@echo ""
+	@echo "Examples:"
+	@echo "  make reqs                                # Upgrade all test & tooling requirements"
+	@echo "  make reqs upgrade=pytest                 # Upgrade only pytest package in test & tooling"
+	@echo "  make reqs startswith=pytest              # Upgrade all packages starting with 'pytest' in test & tooling"
+	@echo "  make reqs clean=1                        # Clean and rebuild all test & tooling requirements"
+	@echo ""
+	@echo "  make reqs-all upgrade=fastapi            # Upgrade fastapi in ALL requirements files"
+	@echo "  make reqs-all startswith=pydantic        # Upgrade all packages starting with pydantic repo-wide"
+	@echo "  make reqs-all clean=1                    # Clean and rebuild ALL requirements"
+	@echo ""
+	@echo "  make reqs-services upgrade=uvicorn       # Upgrade uvicorn only in services"
+	@echo "  make reqs-services startswith=sqlalchemy # Upgrade all packages starting with sqlalchemy in services folder"
+	@echo ""
+	@echo "  make only-tools upgrade=black            # Upgrade black only in tools requirements"
+	@echo ""
 
 
 .PHONY: guard-%