Merge pull request #9 from frankovo/release/0.2.1

Release/0.2.1

Author: frankovo

.gitignore

@@ -53,4 +53,6 @@ Thumbs.db
 # -----------------
 benchmark_results/
 release.sh
+release-tag.sh
+gpg-check.sh
 notes/

CONTRIBUTING.md

@@ -52,3 +52,8 @@ We welcome improvements, bug fixes, and new ideas.
 
 - Be respectful and constructive in discussions.
 - Focus on clear communication and collaborative problem‑solving.
+
+## Releases
+
+Releases are managed separately by the maintainer.  
+See [RELEASE.md](./RELEASE.md) for the full release process.

MANIFEST.in

@@ -1,4 +1,7 @@
-include README-pypi.md LICENSE
+include README-pypi.md
+include LICENSE
+include CONTRIBUTING.md
+include RELEASE.md
 recursive-include src/dns_benchmark *.py
 recursive-include docs/screenshots *.png
 exclude sample_data/*

Makefile

@@ -1,4 +1,5 @@
-.PHONY: install install-dev uninstall mypy black isort flake8 cov test clean cli-test
+.PHONY: install install-dev uninstall mypy black isort flake8 cov test clean cli-test \
+	gpg-check release-patch release-minor release-major release-tag
 
 # 🔧 Install package (runtime only)
 install:
@@ -40,3 +41,25 @@ clean:
 cli-test:
     # Run only the CLI smoke tests marked with @pytest.mark.cli
 	pytest -vv -s -m cli tests/test_cli_commands.py
+
+# GPG sanity check
+gpg-check:
+	./gpg-check.sh
+
+# Release targets
+release-patch:
+	./release.sh patch
+
+release-minor:
+	./release.sh minor
+
+release-major:
+	./release.sh major
+
+# Tag after PR merge
+release-tag:
+	@if [ -z "$(VERSION)" ]; then \
+    	echo "❌ Usage: make release-tag VERSION=X.Y.Z"; exit 1; \
+    fi
+	./release-tag.sh $(VERSION)
+

README-pypi.md

@@ -7,6 +7,14 @@
 
 ![Python Version](https://img.shields.io/badge/python-3.9%2B-blue.svg)
 ![License](https://img.shields.io/badge/license-MIT-green.svg)
+![Coverage](https://img.shields.io/badge/coverage-91%25-brightgreen.svg)
+
+[![Downloads](https://img.shields.io/pypi/dm/dns-benchmark-tool.svg)](https://pypi.org/project/dns-benchmark-tool/)
+[![GitHub stars](https://img.shields.io/github/stars/frankovo/dns-benchmark-tool.svg?style=social&label=Star)](https://github.com/frankovo/dns-benchmark-tool/stargazers)
+[![GitHub forks](https://img.shields.io/github/forks/frankovo/dns-benchmark-tool.svg?style=social&label=Fork)](https://github.com/frankovo/dns-benchmark-tool/network/members)
+[![Issues](https://img.shields.io/github/issues/frankovo/dns-benchmark-tool.svg)](https://github.com/frankovo/dns-benchmark-tool/issues)
+[![Last commit](https://img.shields.io/github/last-commit/frankovo/dns-benchmark-tool.svg)](https://github.com/frankovo/dns-benchmark-tool/commits/main)
+[![Main branch protected](https://img.shields.io/badge/branch%20protection-main%20✅-brightgreen)](./RELEASE.md)
 
 Benchmark DNS resolvers across domains and record types.  
 Generates analytics and exports to CSV, Excel, PDF, and JSON.

README.md

@@ -9,6 +9,13 @@
 ![License](https://img.shields.io/badge/license-MIT-green.svg)
 ![Coverage](https://img.shields.io/badge/coverage-91%25-brightgreen.svg)
 
+[![Downloads](https://img.shields.io/pypi/dm/dns-benchmark-tool.svg)](https://pypi.org/project/dns-benchmark-tool/)
+[![GitHub stars](https://img.shields.io/github/stars/frankovo/dns-benchmark-tool.svg?style=social&label=Star)](https://github.com/frankovo/dns-benchmark-tool/stargazers)
+[![GitHub forks](https://img.shields.io/github/forks/frankovo/dns-benchmark-tool.svg?style=social&label=Fork)](https://github.com/frankovo/dns-benchmark-tool/network/members)
+[![Issues](https://img.shields.io/github/issues/frankovo/dns-benchmark-tool.svg)](https://github.com/frankovo/dns-benchmark-tool/issues)
+[![Last commit](https://img.shields.io/github/last-commit/frankovo/dns-benchmark-tool.svg)](https://github.com/frankovo/dns-benchmark-tool/commits/main)
+[![Main branch protected](https://img.shields.io/badge/branch%20protection-main%20✅-brightgreen)](./RELEASE.md)
+
 A powerful open-source CLI tool to benchmark DNS resolvers across domains and record types.  
 Generates detailed analytics, exports to CSV/Excel/PDF/JSON, and supports automation in CI/CD.
 

RELEASE.md

@@ -0,0 +1,68 @@
+# Release Process
+
+This document describes how releases are managed for `dns-benchmark-tool`.
+
+---
+
+## Workflow Overview
+
+1. **Create a release branch**
+   - From `main`, create a branch named `release/x.y.z`.
+   - Example: `release/0.2.1`.
+
+2. **Make changes**
+   - Update `pyproject.toml` and `src/dns_benchmark/__init__.py` with the new version.
+   - Update changelog or documentation as needed.
+   - Commit changes with **signed commits**.
+
+3. **Push the branch**
+
+   ```bash
+   git push origin release/x.y.z
+   ```
+
+4. **Open a Pull Request**
+   - Target branch: `main`.
+   - CI must pass before merge.
+   - Branch protection rules apply (signed commits, tests, etc.).
+
+5. **Merge the PR**
+   - Once stable, merge `release/x.y.z` into `main`.
+   - At this point, `main` reflects the new version.
+
+6. **Tag the release**
+
+   - After merging, create and push a tag on `main`:
+  
+     ```bash
+     git checkout main
+     git pull origin main
+     git tag vX.Y.Z
+     git push origin vX.Y.Z
+     ```
+
+   - Example: `v0.2.1`.
+
+7. **Publish**
+   - GitHub Actions sees the tag and publishes the package to PyPI.
+   - Verify the new version is available on PyPI.
+
+---
+
+## Notes
+
+- **Do not push tags from release branches.** Tags should only be created on `main` after the PR is merged.
+- **One tag per version.** PyPI does not allow re‑uploads of the same version.
+- **Iterate freely** on the release branch until you are satisfied, then merge and tag.
+- **Only the maintainer** (with write access) should create and push release tags.
+
+---
+
+## Hotfixes
+
+For urgent bug fixes:
+
+- Create a new branch from `main` named `release/x.y.z` (next patch version).
+- Apply the fix, commit, and push.
+- Open a PR into `main`, merge once CI passes.
+- Tag the merge commit (`vX.Y.Z`) to publish the hotfix.

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "dns-benchmark-tool"
-version = "0.2.0"
+version = "0.2.1"
 description = "Benchmark DNS resolvers across domains and record types with analytics and reports (CSV, Excel, PDF, JSON)."
 readme = "README-pypi.md"
 authors = [

src/dns_benchmark/__init__.py

@@ -1 +1 @@
-__version__ = "0.2.0"
+__version__ = "0.2.1"