debian-version Namespace Reference

Functions
	parse_tag (name)
	select_tag (names)
	versions (tag, exact, count)
	git (*args)
	main ()

Variables
str	NUMBER = r"(0|[1-9][0-9]*)"
	TAG

Function Documentation

parse_tag()

debian-version.parse_tag

(

name

)

Return a sortable precedence tuple, or None for an unsupported tag.

Definition at line 24 of file debian-version.py.

def parse_tag(name):
    """Return a sortable precedence tuple, or None for an unsupported tag."""
    match = TAG.fullmatch(name)
    if match is None:
        return None
    major, minor, patch, dev, _ = match.groups()
    return (int(major), int(minor), int(patch), dev is None,
            0 if dev is None else int(dev))
 
 

Referenced by select_tag(), and versions().

Here is the caller graph for this function:

select_tag()

debian-version.select_tag

(

names

)

Definition at line 34 of file debian-version.py.

def select_tag(names):
    candidates = []
    for name in names:
        rank = parse_tag(name)
        if rank is None:
            print(f"Ignoring unsupported version tag: {name}", file=sys.stderr)
        else:
            candidates.append((rank, name))
    if not candidates:
        raise ValueError("no supported version tags (expected vX.Y.Z or vX.Y.Z-dev.K)")
    highest = max(rank for rank, _ in candidates)
    # Metadata is irrelevant to precedence. Prefer the plain tag, then the
    # lexically first tag name, independent of Git's configured tag sorting.
    return min((name for rank, name in candidates if rank == highest),
               key=lambda name: ("+" in name, name))
 
 

References max, min, and parse_tag().

Referenced by main().

Here is the call graph for this function:

Here is the caller graph for this function:

versions()

debian-version.versions	(		tag,
			exact,
			count
	)

Definition at line 51 of file debian-version.py.

def versions(tag, exact, count):
    major, minor, patch, stable, dev = parse_tag(tag)
    if stable:
        base = f"{major}.{minor}.{patch if exact else patch + 1}"
        suffix = "" if exact else f"0.{count}"
    else:
        base = f"{major}.{minor}.{patch}"
        suffix = f"dev.{dev}" + ("" if exact else f".{count}")
    semver = base + (f"-{suffix}" if suffix else "")
    debian = base + ("~" + suffix.replace("dev.", "dev", 1) if suffix else "")
    return semver, debian
 
 

References parse_tag().

Referenced by main().

Here is the call graph for this function:

Here is the caller graph for this function:

git()

debian-version.git

(

*

args

)

Definition at line 64 of file debian-version.py.

def git(*args):
    return subprocess.check_output(["git", *args], text=True).strip()
 
 

Referenced by main().

Here is the caller graph for this function:

main()

debian-version.main

(

)

Definition at line 68 of file debian-version.py.

def main():
    try:
        if git("rev-parse", "--is-shallow-repository") != "false":
            raise ValueError("a full Git checkout is required; disable shallow cloning")
        head = git("rev-parse", "HEAD")
        # Fetch the scheduled commit, including on detached HEADs, and all tags.
        # Do not impose a depth limit or move HEAD to the selected tag.
        subprocess.run(["git", "fetch", "--no-recurse-submodules", "--tags",
                        "origin", head], check=True, stdout=sys.stderr)
        tag = select_tag(git("tag", "--list").splitlines())
        tagged_commit = git("rev-parse", f"{tag}^{{commit}}")
        count = int(git("rev-list", "--count", f"{tag}..{head}"))
        semver, debian = versions(tag, head == tagged_commit, count)
        print(f"Version tag: {tag}; HEAD: {head}; commits: {count}; "
              f"SemVer: {semver}; Debian: {debian}", file=sys.stderr)
        print(debian)
        return 0
    except (OSError, subprocess.CalledProcessError, ValueError) as error:
        print(f"Cannot determine CI version: {error}", file=sys.stderr)
        return 1
 
 

References git(), main(), select_tag(), and versions().

Referenced by main().

Here is the call graph for this function:

Here is the caller graph for this function:

Variable Documentation

NUMBER

str debian-version.NUMBER = r"(0|[1-9][0-9]*)"

Definition at line 17 of file debian-version.py.

TAG

debian-version.TAG

Initial value:

=  re.compile(
    rf"v{NUMBER}\.{NUMBER}\.{NUMBER}(?:-dev\.{NUMBER})?"
    r"(?:\+([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?"
)

Definition at line 18 of file debian-version.py.