[none] Project utility improvement

- Replaced the deprecated license info in `pyproject.toml` with a viable solution
- Improved repo url hanlding in the `process_md_doc.py` script
- Aligned Makefile targets to use colorized info logs and suppress unnecessary command output
- Added the `upload-test` Makefile target for uploading the project to testpypi

Author: SpectraL519

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024 Jakub Musiał
+Copyright (c) 2024-2025 Jakub Musiał
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

Makefile

@@ -1,6 +1,12 @@
 PY := python3
 PYM := $(PY) -m
 
+COLOR_RESET  := \033[0m
+COLOR_GREEN  := \033[1;32m
+COLOR_CYAN := \033[1;33m
+COLOR_CYAN   := \033[1;36m
+COLOR_RED    := \033[1;31m
+
 .PHONY: \
 	prepare-venv \
 	clean-venv \
@@ -17,47 +23,78 @@ PYM := $(PY) -m
 	upload
 
 prepare-venv:
+	@echo "$(COLOR_CYAN)> Creating virtual environment...$(COLOR_RESET)"; \
 	$(PYM) venv venv && \
-	. venv/bin/activate && \
-	pip install -r requirements-dev.txt
+	echo "$(COLOR_CYAN)> Installing dev dependencies...$(COLOR_RESET)"; \
+	. venv/bin/activate && pip install -r requirements-dev.txt > /dev/null
 
 clean-venv:
+	@echo "$(COLOR_CYAN)> Removing virtual environment...$(COLOR_RESET)"; \
 	rm -rf venv/
 
-source-venv:
-	. venv/bin/activate
-
 tests-simple:
+	@echo "$(COLOR_CYAN)> Running tests (simple) ...$(COLOR_RESET)"; \
 	$(PYM) pytest test/
 
-# tox will generate the coverage report
 tests-tox:
+	@echo "$(COLOR_CYAN)> Running tests (tox)...$(COLOR_RESET)"; \
 	$(PYM) tox
 
 clean-tests:
+	@echo "$(COLOR_CYAN)> Cleaning test artifacts...$(COLOR_RESET)"; \
 	rm -rf .pytest_cache/ .tox/
 
 clean-cov:
+	@echo "$(COLOR_CYAN)> Cleaning coverage files...$(COLOR_RESET)"; \
 	rm -rf .coverage*
 
-build:
-	$(PY) scripts/preprocess_md_doc.py
-	$(PYM) build
-
 clean-build:
+	@echo "$(COLOR_CYAN)> Cleaning build artifacts...$(COLOR_RESET)"; \
 	rm -rf build/ dist/ *.egg-info README_pypi.md
 
+build: clean-build
+	@ALL_TAGS=$$(git tag | grep -E '^v[0-9]+\.[0-9]+\.[0-9]+$$' | sort -V); \
+	LATEST_TAG=$$(echo "$$ALL_TAGS" | tail -n 1); \
+	echo "$(COLOR_CYAN)> Latest git tag: $(COLOR_YELLOW)$$LATEST_TAG$(COLOR_RESET)"; \
+	PY_VERSION=$$(sed -n 's/^version *= *"\([^"]*\)".*$$/\1/p' pyproject.toml); \
+	echo "$(COLOR_CYAN)> Current version (pyproject.toml): $(COLOR_CYAN)$$PY_VERSION$(COLOR_RESET)"; \
+	if [ "$${LATEST_TAG#v}" != "$$PY_VERSION" ]; then \
+		echo "$(COLOR_RED)> ERROR: Git tag ($$LATEST_TAG) and pyproject version ($$PY_VERSION) do not match.$(COLOR_RESET)"; \
+		exit 1; \
+	fi; \
+	echo "$(COLOR_CYAN)> Processing project README...$(COLOR_RESET)"; \
+	$(PY) scripts/process_md_doc.py --version $$LATEST_TAG > /dev/null; \
+	echo "$(COLOR_CYAN)> Building the distribution...$(COLOR_RESET)"; \
+	$(PYM) build > /dev/null; \
+	BUILD_EXIT_CODE=$$?; \
+	if [ $$BUILD_EXIT_CODE -eq 0 ]; then \
+		echo "$(COLOR_GREEN)> Build complete.$(COLOR_RESET)"; \
+	else \
+		echo "$(COLOR_RED)> Build failed.$(COLOR_RESET)"; \
+		exit $$BUILD_EXIT_CODE; \
+	fi
+
 ruff:
-	$(PYM) ruff format && ruff check --fix
+	@echo "$(COLOR_CYAN)> Running formatter...$(COLOR_RESET)"; \
+	$(PYM) ruff format; \
+	echo "$(COLOR_CYAN)> Running linter...$(COLOR_RESET)"; \
+	$(PYM) ruff check --fix
 
 clean-ruff:
+	@echo "$(COLOR_CYAN)> Cleaning ruff cache...$(COLOR_RESET)"; \
 	rm -rf .ruff_cache/
 
 clean-all: clean-venv clean-tests clean-cov clean-build clean-ruff
 
 install:
-	$(PYM) pip uninstall -y pypformat || true
-	$(PYM) pip install .
+	@echo "$(COLOR_CYAN)> Reinstalling local package...$(COLOR_RESET)"; \
+	$(PYM) pip uninstall -y pypformat > /dev/null || true; \
+	$(PYM) pip install . > /dev/null
 
-upload: build
+upload: clean-build build
+	@echo "$(COLOR_CYAN)> Uploading distribution to pypi...$(COLOR_RESET)"; \
 	$(PYM) twine upload dist/*
+
+upload-test: clean-build build
+	@echo "$(COLOR_CYAN)> Uploading distribution to testpypi...$(COLOR_RESET)"; \
+	$(PYM) twine upload --repository testpypi dist/*

pyproject.toml

@@ -5,13 +5,14 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pypformat"
-version = "1.2.2"
+version = "1.2.3"
 description = "Python pretty formatting package"
 authors = [
   {name = "SpectraL519"}
 ]
 readme = {file = "README_pypi.md", content-type = "text/markdown; charset=UTF-8; variant=GFM"}
-license = {file = "LICENSE"}
+license = "MIT"
+license-files = ["LICENSE"]
 requires-python = ">= 3.9"
 dependencies = ["colored==2.2.*"]
 keywords = ["string", "format", "formatting", "pretty", "print"]
@@ -21,8 +22,6 @@ classifiers = [
   "Intended Audience :: Developers",
   "Topic :: Software Development :: Libraries :: Python Modules",
 
-  "License :: OSI Approved :: MIT License",
-
   "Programming Language :: Python :: 3",
   "Programming Language :: Python :: 3.9",
   "Programming Language :: Python :: 3.10",

scripts/preprocess_md_doc.py renamed to scripts/process_md_doc.py

@@ -3,10 +3,12 @@
 from pathlib import Path
 
 
-def preprocess_md_doc(input_file: Path, output_file: Path, repo_url: str):
+def process_md_doc(input_file: Path, output_file: Path, version: str):
     with open(input_file, "r", encoding="utf-8") as f:
         content = f.read()
 
+    repo_url = f"https://github.com/SpectraL519/pypformat/blob/{version}"
+
     updated_content = re.sub(
         r"\[([^\]]+)\]\((?!http)(.*?)\)",
         lambda match: f"[{match.group(1)}]({repo_url}/{match.group(2).lstrip('./')})",
@@ -30,14 +32,13 @@ def parse_args():
         help="Path to the output README file.",
     )
     parser.add_argument(
-        "-r",
-        "--repo-url",
+        "-v",
+        "--version",
         type=str,
-        default="https://github.com/SpectraL519/repo/blob/master",
         help="Base URL of the repository.",
     )
     return vars(parser.parse_args())
 
 
 if __name__ == "__main__":
-    preprocess_md_doc(**parse_args())
+    process_md_doc(**parse_args())