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
"""Reject incomplete built distributions before they can be uploaded."""
import io
import subprocess
import sys
import tarfile
import zipfile
from pathlib import Path
import pytest
from tests.scripts.test_version_policy import git, write
VALIDATOR = Path(__file__).resolve().parents[2] / "scripts/validate_release.py"
@pytest.fixture
def release(tmp_path):
repo = tmp_path / "project"
repo.mkdir()
git(repo, "init")
files = {
"pyproject.toml": '[project]\nname="free-claude-code"\ndynamic=["version"]\n[project.scripts]\nfcc-server="free_claude_code.cli:serve"\n[project.gui-scripts]\nfcc-desktop="free_claude_code.desktop:launch"\n',
"README.md": "readme",
"LICENSE": "license",
"scripts/update/fcc-update": "#!/bin/sh\n",
"scripts/update/fcc-update.cmd": "@echo off\n",
"scripts/build_macos_launcher.py": "# native build\n",
"scripts/macos/launcher.m": "// launcher\n",
"src/free_claude_code/__init__.py": "",
"src/free_claude_code/cli.py": "",
"src/free_claude_code/desktop.py": "",
"src/free_claude_code/assets/icon.png": "icon",
"src/free_claude_code/api/admin_static/index.html": "page",
}
for name, content in files.items():
write(repo, name, content)
git(repo, "add", ".")
# Generated templates are deliberately absent from git ls-files.
for architecture in ("arm64", "x86_64"):
files[f"src/free_claude_code/assets/macos/fcc-desktop-{architecture}"] = (
architecture
)
metadata = "Name: free-claude-code\nVersion: 1.2.3\n"
wheel = {
name.removeprefix("src/"): content
for name, content in files.items()
if name.startswith("src/")
}
for name in ("fcc-update", "fcc-update.cmd"):
wheel[f"free_claude_code-1.2.3.data/scripts/{name}"] = files[
f"scripts/update/{name}"
]
wheel["free_claude_code-1.2.3.dist-info/METADATA"] = metadata
wheel["free_claude_code-1.2.3.dist-info/entry_points.txt"] = (
"[console_scripts]\nfcc-server=free_claude_code.cli:serve\n"
"[gui_scripts]\nfcc-desktop=free_claude_code.desktop:launch\n"
)
sdist = {f"free_claude_code-1.2.3/{name}": body for name, body in files.items()}
sdist["free_claude_code-1.2.3/PKG-INFO"] = metadata
return repo, wheel, sdist
def validate(release, tmp_path):
repo, wheel, sdist = release
dist = tmp_path / "built"
dist.mkdir()
(dist / ".gitignore").write_text("*")
with zipfile.ZipFile(
dist / "free_claude_code-1.2.3-py3-none-any.whl", "w"
) as archive:
for name, body in wheel.items():
archive.writestr(name, body)
with tarfile.open(dist / "free_claude_code-1.2.3.tar.gz", "w:gz") as archive:
for name, body in sdist.items():
data = body.encode()
info = tarfile.TarInfo(name)
info.size = len(data)
archive.addfile(info, io.BytesIO(data))
return subprocess.run(
[sys.executable, str(VALIDATOR), str(dist), "--version", "1.2.3"],
cwd=repo,
capture_output=True,
text=True,
check=False,
)
def test_complete_release_passes(release, tmp_path):
result = validate(release, tmp_path)
assert result.returncode == 0, result.stdout + result.stderr
@pytest.mark.parametrize("archive", [1, 2])
@pytest.mark.parametrize(
"suffix",
[
"assets/icon.png",
"scripts/fcc-update.cmd",
"entry_points.txt",
"METADATA",
"assets/macos/fcc-desktop-arm64",
"assets/macos/fcc-desktop-x86_64",
],
)
def test_missing_wheel_or_sdist_content_fails(release, tmp_path, archive, suffix):
if archive == 2:
suffix = {
"scripts/fcc-update.cmd": "scripts/update/fcc-update.cmd",
"entry_points.txt": "pyproject.toml",
"METADATA": "PKG-INFO",
}.get(suffix, suffix)
entries = release[archive]
missing = next(name for name in entries if name.endswith(suffix))
del entries[missing]
result = validate(release, tmp_path)
assert result.returncode != 0
assert "missing" in result.stdout.lower()
def test_wrong_version_or_entrypoint_fails(release, tmp_path):
release[1]["free_claude_code-1.2.3.dist-info/entry_points.txt"] = (
"[console_scripts]\nfcc-server=wrong:command\n"
)
result = validate(release, tmp_path)
assert result.returncode != 0
assert "entry" in result.stdout.lower()
def test_mismatched_metadata_fails(release, tmp_path):
release[2]["free_claude_code-1.2.3/PKG-INFO"] = (
"Name: free-claude-code\nVersion: 0.1.0\n"
)
result = validate(release, tmp_path)
assert result.returncode != 0
assert "metadata" in result.stdout.lower()
def test_mismatched_native_templates_fail(release, tmp_path):
release[1]["free_claude_code/assets/macos/fcc-desktop-arm64"] = "different"
result = validate(release, tmp_path)
assert result.returncode != 0
assert "template" in result.stdout.lower()
@pytest.mark.parametrize(
"name", ["scripts/macos/launcher.m", "scripts/build_macos_launcher.py"]
)
def test_native_sources_required_in_sdist(release, tmp_path, name):
del release[2][f"free_claude_code-1.2.3/{name}"]
result = validate(release, tmp_path)
assert result.returncode != 0
assert "missing" in result.stdout.lower()