utils/dep_freshness/tests/test_pacman_repo.py
Krzysztof kuhy Rudnicki 14f0f47c56
Some checks are pending
file length / file-length (push) Waiting to run
kuhy_credit drift / drift (push) Waiting to run
md-naming / markdown naming convention (push) Waiting to run
palette drift / palette (push) Waiting to run
repo-contract / repo contract (push) Waiting to run
shared gate tests / gate unit tests (push) Waiting to run
dep_freshness: add pacman-repo lock adapter
A key=value *.lock file (name/repo/version/sha256) pins one package out of
an Arch-style repo .db. The adapter reads the db (gzip or zstd tar) via a
new http.get_bytes, matches %NAME% in each desc, and the judge compares
with a port of pacman's vercmp (epoch:pkgver-pkgrel), not PEP 440. A right
version with a wrong sha256 is a lock mismatch.

Locks are recognised by content (a repo= line ending in .db in the first
4 KB of a *.lock), so explicit paths from pre-commit and --all both work.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-22 14:43:40 +01:00

147 lines
4.8 KiB
Python

"""The pacman-repo adapter: pacman `vercmp` order and reading a repo `.db`.
Versions here are `epoch:pkgver-pkgrel`, which PEP 440 cannot read at all:
`versions.behind` answers False for every pair, so a stale lock would read
as current. The ordering tests below come from the vercmp(8) man page, and
the differential test checks them against the real `/usr/bin/vercmp`.
"""
from __future__ import annotations
import io
import itertools
import shutil
import subprocess
import tarfile
import pytest
from dep_freshness.registries import pacman_repo
from dep_freshness.registries.http import Offline
REPO = "https://mirror.example.org/repo/x86_64/extra/extra.db"
SHA = "ab" * 32
# vercmp(8): "1.0a < 1.0b < 1.0beta < 1.0p < 1.0pre < 1.0rc < 1.0 < 1.0.a < 1.0.1"
MAN_ORDER = ["1.0a", "1.0b", "1.0beta", "1.0p", "1.0pre", "1.0rc", "1.0", "1.0.a",
"1.0.1"]
PAIRS = [
("1:1.0", "2.0", 1),
("0:2.0", "2.0", 0),
("1:11.0.20261015-1", "1:10.0.20250101-1", 1),
("1:11.0.20261015-1", "1:11.0.20261015-1", 0),
("1.0-1", "1.0-2", -1),
("1.0", "1.0-7", 0), # a missing pkgrel compares equal
("1.0.0", "1.0", 1),
("1.0_1", "1.0.1", 0), # any non-alphanumeric run is one separator
("1.0", "1.0.0.0", -1),
("2.0", "10.0", -1),
("1.001", "1.1", 0),
("r123", "r45", 1),
]
@pytest.mark.parametrize(("left", "right"), list(itertools.pairwise(MAN_ORDER)))
def test_vercmp_follows_the_man_page_order(left, right):
assert pacman_repo.vercmp(left, right) == -1
assert pacman_repo.vercmp(right, left) == 1
@pytest.mark.parametrize(("left", "right", "expected"), PAIRS)
def test_vercmp_epoch_and_pkgrel(left, right, expected):
assert pacman_repo.vercmp(left, right) == expected
@pytest.mark.skipif(not shutil.which("vercmp"), reason="pacman's vercmp absent")
@pytest.mark.parametrize(
("left", "right"),
[*itertools.pairwise(MAN_ORDER), *((a, b) for a, b, _ in PAIRS)],
)
def test_vercmp_agrees_with_pacman(left, right):
real = subprocess.run(
["vercmp", left, right], capture_output=True, text=True, check=True
).stdout.strip()
assert pacman_repo.vercmp(left, right) == int(real)
def _desc(name: str, version: str, sha: str = SHA) -> bytes:
return (
f"%FILENAME%\n{name}-{version}-x86_64.pkg.tar.zst\n\n%NAME%\n{name}\n\n"
f"%VERSION%\n{version}\n\n%SHA256SUM%\n{sha}\n\n"
).encode()
def build_db(
packages: dict[str, str], compression: str = "gz", sha: str = SHA
) -> bytes:
"""A repo db the way repo-add writes it: one `<name>-<ver>/desc` per package."""
raw = io.BytesIO()
with tarfile.open(fileobj=raw, mode=f"w:{compression}") as tar:
for name, version in packages.items():
body = _desc(name, version, sha)
info = tarfile.TarInfo(f"{name}-{version}/desc")
info.size = len(body)
tar.addfile(info, io.BytesIO(body))
return raw.getvalue()
@pytest.fixture
def serve(monkeypatch):
"""Answer the next `get_bytes` with `body`, recording the URL asked for."""
asked: list[str] = []
def install(body):
def fake(url):
asked.append(url)
return body
monkeypatch.setattr(pacman_repo, "get_bytes", fake)
return asked
return install
@pytest.mark.parametrize("compression", ["gz", "zst"])
def test_latest_reads_version_and_sha_from_the_db(serve, compression):
asked = serve(build_db({"proton-native": "1:11.0-1", "zlib": "1.3-1"},
compression))
name = pacman_repo.qualified_name(REPO, "proton-native")
assert pacman_repo.latest(name) == f"1:11.0-1 {SHA}"
assert asked == [REPO]
def test_a_sibling_sharing_the_name_prefix_is_not_the_package(serve):
serve(build_db({"proton-native-v3": "9:9.0-1", "proton-native": "1:2.0-1"}))
name = pacman_repo.qualified_name(REPO, "proton-native")
assert pacman_repo.latest(name).split()[0] == "1:2.0-1"
def test_a_package_the_db_does_not_list_is_none(serve):
serve(build_db({"zlib": "1.3-1"}))
assert pacman_repo.latest(pacman_repo.qualified_name(REPO, "nope")) is None
def test_a_missing_db_is_none(serve):
serve(None)
assert pacman_repo.latest(pacman_repo.qualified_name(REPO, "x")) is None
def test_a_db_that_is_not_a_tar_is_offline(serve):
serve(b"<html>captive portal</html>")
with pytest.raises(Offline):
pacman_repo.latest(pacman_repo.qualified_name(REPO, "x"))
def test_zstd_without_compression_zstd_names_the_missing_module(
serve, monkeypatch
):
serve(build_db({"x": "1.0-1"}, "zst"))
monkeypatch.setattr(pacman_repo, "_HAS_ZSTD", False)
with pytest.raises(Offline, match="compression.zstd"):
pacman_repo.latest(pacman_repo.qualified_name(REPO, "x"))
def test_qualified_name_round_trips():
assert pacman_repo.split_name(pacman_repo.qualified_name(REPO, "x")) == (
REPO,
"x",
)