Merge pull request #49 from Mr-Sunglasses/fix/release

Author: Mr-Sunglasses

CONTRIBUTING.md

@@ -186,6 +186,9 @@ The project includes a `Makefile` with convenient commands for common developmen
 | `make check` | Run lint + test (full CI check) |
 | `make run` | Run bitssh CLI |
 | `make build` | Build distribution packages |
+| `make bumpver-patch` | Bump patch version (e.g. 3.7.0 → 3.7.1) |
+| `make bumpver-minor` | Bump minor version (e.g. 3.7.0 → 3.8.0) |
+| `make bumpver-major` | Bump major version (e.g. 3.7.0 → 4.0.0) |
 | `make clean` | Remove build artifacts, caches, and venv |
 
 ## Styleguides
@@ -222,3 +225,31 @@ Examples:
 - `fix(utils): handle missing SSH config gracefully`
 - `docs: update installation instructions`
 - `test(cli): add tests for argument parsing`
+
+### Version Bumping
+
+This project uses [bumpver](https://github.com/mbarkhau/bumpver) for version management. The version is defined in a single place — `src/bitssh/_version.py` — and everything else reads from it:
+
+| File | What it does |
+|---|---|
+| `src/bitssh/_version.py` | Single source of truth: `__version__ = "3.7.0"` |
+| `pyproject.toml` → `[tool.setuptools.dynamic]` | Reads version from `_version.py` at build time |
+| `pyproject.toml` → `[tool.bumpver]` | Tracks the current version for bumpver CLI |
+| `src/bitssh/__init__.py` | Imports `__version__` from `_version.py`, overrides with `importlib.metadata` at runtime |
+
+To bump the version, use one of these make commands:
+
+```bash
+make bumpver-patch   # 3.7.0 → 3.7.1
+make bumpver-minor   # 3.7.0 → 3.8.0
+make bumpver-major   # 3.7.0 → 4.0.0
+```
+
+Each command will:
+
+1. Update `__version__` in `src/bitssh/_version.py`
+2. Update `current_version` in `pyproject.toml` `[tool.bumpver]`
+3. Create a git commit with the message `"Bump version {old} -> {new}"`
+4. Create a git tag (e.g. `v3.7.1`)
+
+> **Note:** bumpver does **not** push to remote by default (`push = false`). You need to `git push && git push --tags` manually when ready.

Makefile

@@ -1,4 +1,4 @@
-.PHONY: setup install dev test lint format clean build run check help
+.PHONY: setup install dev test lint format clean build run check bumpver help
 
 UV ?= uv
 
@@ -36,4 +36,13 @@ clean: ## Remove build artifacts, caches, and the venv
 run: ## Run the CLI directly
 	$(UV) run bitssh
 
-check: lint test ## Run lint + test (full CI check)
+check: lint test ## Run lint + test (full CI check)
+
+bumpver-major: ## Bump major version (e.g. 3.7.0 -> 4.0.0)
+	$(UV) run bumpver update --major
+
+bumpver-minor: ## Bump minor version (e.g. 3.7.0 -> 3.8.0)
+	$(UV) run bumpver update --minor
+
+bumpver-patch: ## Bump patch version (e.g. 3.7.0 -> 3.7.1)
+	$(UV) run bumpver update --patch

pyproject.toml

@@ -2,9 +2,15 @@
 requires = ["setuptools>=80.9.0", "wheel"]
 build-backend = "setuptools.build_meta"
 
+[tool.setuptools.dynamic]
+version = {attr = "bitssh._version.__version__"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
 [project]
 name = "bitssh"
-version = "3.7.0"
+dynamic = ["version"]
 description = "A new and modern SSH connector written in Python."
 readme = "README.md"
 license = "MIT"
@@ -61,7 +67,8 @@ tag = true
 push = false
 
 [tool.bumpver.file_patterns]
-"pyproject.toml" = ['current_version = "{version}"', 'version = "{version}"']
+"src/bitssh/_version.py" = ['__version__ = "{version}"']
+"pyproject.toml" = ['current_version = "{version}"']
 
 [tool.pytest.ini_options]
 pythonpath = ["src"]

src/bitssh/__init__.py

@@ -1,6 +1,8 @@
+from ._version import __version__
+
 try:
     from importlib.metadata import version
 
     __version__ = version("bitssh")
 except Exception:  # pragma: no cover
-    __version__ = "0.0.0"
+    pass

src/bitssh/_version.py

@@ -0,0 +1 @@
+__version__ = "3.7.0"

src/bitssh/cli.py

@@ -85,4 +85,4 @@ def run():
     except KeyboardInterrupt:
         pass
     except Exception as e:
-        print(f"Error Happed {e}")
+        print(f"Error Happened: {e}")

src/bitssh/utils.py

@@ -21,7 +21,7 @@ def _ensure_config_file() -> None:
     if not os.path.exists(CONFIG_FILE_PATH):
         with open(CONFIG_FILE_PATH, "w", encoding="utf-8") as f:
             f.write("")
-        os.chmod(CONFIG_FILE_PATH, 0o644)
+        os.chmod(CONFIG_FILE_PATH, 0o600)
 
 
 def get_config_content():