mirror of
https://github.com/kuhyx/utils.git
synced 2026-11-11 00:07:15 +01:00
Krzysztof kuhy Rudnicki
dccfe14ae9
Some checks are pending
dependency freshness / dependencies on newest stable (push) Waiting to run
file length / file-length (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
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
64 lines
2.6 KiB
Python
64 lines
2.6 KiB
Python
"""JitPack artifacts pinned to a commit: "newest" is the default branch's HEAD.
|
|
|
|
Some Android builds depend on `com.github.<owner>:<repo>` at a
|
|
short hash. No registry lists a "latest" for those, and a hash is not a
|
|
version, so the gate's question becomes the only one a commit pin admits:
|
|
is the pinned commit still what the source repository's default branch
|
|
points at? (kuhy, 2026-09-12: chosen over never-expiring allowlist entries.)
|
|
|
|
The answer is every branch head's full sha, default branch first; `evaluate`
|
|
compares by prefix so a 7-, 10- or 40-character pin all work, and reports
|
|
the default head's first ten characters, which is what JitPack accepts as
|
|
a version.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
from dep_freshness._tables import GITHUB_REMOTE, JITPACK_GROUP_PREFIX
|
|
from dep_freshness.registries._git import ls_remote
|
|
|
|
|
|
def source_repo(name: str) -> str | None:
|
|
"""`owner/repo` behind a JitPack coordinate, or None for anything else.
|
|
|
|
`com.github.mihonapp:image-decoder` -> `mihonapp/image-decoder`;
|
|
`com.github.arkon.FlexibleAdapter:flexible-adapter` -> `arkon/FlexibleAdapter`
|
|
(a multi-module build names the repo in the group, the module after the
|
|
colon).
|
|
"""
|
|
group, sep, artifact = name.partition(":")
|
|
if not sep or not artifact or not group.startswith(JITPACK_GROUP_PREFIX):
|
|
return None
|
|
parts = group[len(JITPACK_GROUP_PREFIX) :].split(".")
|
|
if not parts[0]:
|
|
return None
|
|
repo = parts[1] if len(parts) > 1 and parts[1] else artifact
|
|
return f"{parts[0]}/{repo}"
|
|
|
|
|
|
def latest(name: str) -> str | None:
|
|
"""Every branch head of the source repo, default branch first, space-joined.
|
|
|
|
A pin is current when it is SOME branch's head, not only the default one:
|
|
Mihon pins `deadlock-fix` of sqldelight-androidx-driver and Tachiyomi
|
|
pins `fix-build2` of FlexibleAdapter, both side branches whose heads are
|
|
exactly the pinned commits. Comparing those against `master` alone
|
|
called two current pins stale. None when `name` is not a JitPack pin.
|
|
"""
|
|
repo = source_repo(name)
|
|
if repo is None:
|
|
return None
|
|
default: str | None = None
|
|
heads: list[str] = []
|
|
# No `--heads`: that filter drops the symbolic HEAD line, which is the
|
|
# only way to learn WHICH head is the default branch's.
|
|
for line in ls_remote(GITHUB_REMOTE.format(repo=repo)):
|
|
sha, _, ref = line.partition("\t")
|
|
sha, ref = sha.strip(), ref.strip()
|
|
if ref == "HEAD":
|
|
default = sha
|
|
elif ref.startswith("refs/heads/"):
|
|
heads.append(sha)
|
|
ordered = ([default] if default else []) + [h for h in heads if h != default]
|
|
return " ".join(ordered) or None
|