Use Claude Code, Codex, VSCode, Pi, and OpenCode (and 6 other harnesses) for free (1.3B+ free tokens) from your terminal, app, IDE, or phone, and now from the browser with native browser sessions (multi-harness + multi-model) like OpenClaw (voice supported + ToS friendly)
Python
"""Release intent is validated against committed paths, not edited numbers."""
import os
import shutil
import subprocess
import sys
from pathlib import Path
import pytest
CHECKER = Path(__file__).resolve().parents[2] / "scripts/check_version_policy.py"
def git(repo: Path, *args: str) -> str:
return subprocess.run(
["git", "-C", str(repo), *args],
check=True,
capture_output=True,
text=True,
env=os.environ
| {
"GIT_CONFIG_GLOBAL": os.devnull,
"GIT_CONFIG_NOSYSTEM": "1",
"GIT_AUTHOR_NAME": "Test",
"GIT_AUTHOR_EMAIL": "[email protected]",
"GIT_COMMITTER_NAME": "Test",
"GIT_COMMITTER_EMAIL": "[email protected]",
},
).stdout.strip()
def write(repo: Path, path: str, content: str) -> None:
target = repo / path
target.parent.mkdir(parents=True, exist_ok=True)
target.write_text(content, encoding="utf-8")
def commit(repo: Path, title: str = "test change") -> str:
git(repo, "add", ".")
git(repo, "commit", "--no-gpg-sign", "-m", title)
return git(repo, "rev-parse", "HEAD")
@pytest.fixture(scope="session")
def history_template(tmp_path_factory):
tmp_path = tmp_path_factory.mktemp("version-policy-template")
git(tmp_path, "init", "--template=", "-b", "main")
git(tmp_path, "config", "core.autocrlf", "false")
write(
tmp_path,
"pyproject.toml",
'[project]\nname="free-claude-code"\ndynamic=["version"]\n',
)
write(
tmp_path,
"uv.lock",
'[[package]]\nname="free-claude-code"\nsource={editable="."}\n',
)
write(tmp_path, "src/file.py", "original\n")
return tmp_path, commit(tmp_path)
@pytest.fixture
def history(tmp_path, history_template):
source, base = history_template
# Copy the immutable seed, including Git objects and refs. Every test can
# change its worktree, index, and history without affecting another test.
shutil.copytree(source, tmp_path, dirs_exist_ok=True)
return tmp_path, base
def check(repo: Path, base: str, title: str) -> subprocess.CompletedProcess[str]:
return subprocess.run(
[
sys.executable,
str(CHECKER),
"--base",
base,
"--head",
"HEAD",
"--title",
title,
],
cwd=repo,
capture_output=True,
text=True,
check=False,
)
@pytest.mark.parametrize(
"path",
[
"assets/a.svg",
"scripts/a.sh",
"src/a.py",
".python-version",
"pyproject.toml",
"uv.lock",
],
)
@pytest.mark.parametrize(
"title,allowed",
[
("patch: Fix it", True),
("minor: Add it", True),
("major: Replace it", True),
("Fix it", False),
],
)
def test_release_inputs_require_prefix(history, path, title, allowed):
repo, base = history
target = repo / path
write(repo, path, (target.read_text() if target.exists() else "") + "\n# change\n")
commit(repo)
result = check(repo, base, title)
assert (result.returncode == 0) is allowed, result.stdout + result.stderr
@pytest.mark.parametrize(
"title",
["patch: Missing release", "minor: Missing release", "major: Missing release"],
)
def test_nonrelease_changes_forbid_prefix(history, title):
repo, base = history
write(repo, "README.md", "docs")
commit(repo)
assert check(repo, base, title).returncode != 0
@pytest.mark.parametrize(
"title",
[
"Patch: Change",
" patch: Change",
"patch:Change",
"patch: Change",
"patch:\tChange",
"patch: ",
"patch : Change",
"major\uff1a Change",
],
)
def test_malformed_release_title_rejected(history, title):
repo, base = history
write(repo, "src/file.py", "change")
commit(repo)
assert check(repo, base, title).returncode != 0
@pytest.mark.parametrize("move", [False, True])
def test_delete_or_move_out_counts_as_release(history, move):
repo, base = history
if move:
(repo / "src/file.py").rename(repo / "outside.py")
else:
(repo / "src/file.py").unlink()
commit(repo)
assert check(repo, base, "Docs").returncode != 0
assert check(repo, base, "patch: Remove file").returncode == 0
def test_unrelated_main_and_dirty_files_do_not_change_pr_classification(history):
repo, original = history
write(repo, "src/main.py", "main")
base = commit(repo)
git(repo, "checkout", "-b", "docs", original)
write(repo, "README.md", "docs")
commit(repo)
write(repo, "src/file.py", "uncommitted")
assert check(repo, base, "Explain setup").returncode == 0
def test_title_is_data_and_multiple_commits_have_one_intent(history):
repo, base = history
write(repo, "src/file.py", "one")
commit(repo)
write(repo, "src/file.py", "two")
commit(repo)
assert check(repo, base, 'patch: $(echo unsafe) `literal` "quoted"').returncode == 0
def test_manual_version_is_rejected(history):
repo, base = history
write(
repo, "pyproject.toml", '[project]\nname="free-claude-code"\nversion="1.2.3"\n'
)
commit(repo)
assert check(repo, base, "patch: Manual version").returncode != 0
def test_pr_snapshot_uses_latest_title_and_rejects_stale_head(history, tmp_path):
import json
repo, base = history
write(repo, "src/file.py", "change")
head = commit(repo)
payload = tmp_path / "current-pr.json"
payload.write_text(
json.dumps(
{"head": {"sha": head}, "base": {"sha": base}, "title": "patch: New title"}
)
)
result = subprocess.run(
[sys.executable, str(CHECKER), "--head", head, "--pr-json", str(payload)],
cwd=repo,
capture_output=True,
text=True,
)
assert result.returncode == 0, result.stdout
payload.write_text(
json.dumps(
{"head": {"sha": base}, "base": {"sha": base}, "title": "patch: New title"}
)
)
result = subprocess.run(
[sys.executable, str(CHECKER), "--head", head, "--pr-json", str(payload)],
cwd=repo,
capture_output=True,
text=True,
)
assert result.returncode != 0
assert "head changed" in result.stdout