onevcs 0.56.3

Version control and remote-host abstraction for agent workflows: host-neutral change requests, sessions, and a rules system.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62

"""Private release-boundary validation from the existing npm target authority."""
import pathlib
import re
import sys

ROOT = pathlib.Path(__file__).resolve().parents[3]


def fail(message):
    raise ValueError(message)


def target(value):
    assembler = (ROOT / "crates/onevcs/release/npm-build.mjs").read_text()
    targets = re.findall(r'^  "([a-z0-9_]+-[a-z0-9_-]+)": \{ platform:', assembler, re.M)
    if not targets:
        fail("cannot read target authority in crates/onevcs/release/npm-build.mjs")
    if value not in targets:
        fail(f"unsupported release target {value!r}")
    return value


def version(value):
    if not isinstance(value, str) or not re.fullmatch(r"\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?", value):
        fail(f"invalid release version {value!r}")
    return value


def binary(value, triple):
    path = pathlib.Path(value)
    expected = "onevcs.exe" if "windows" in triple else "onevcs"
    if not path.is_file() or path.name != expected:
        fail(f"missing release executable {path}; expected {expected}")
    return path


def directory(value):
    path = pathlib.Path(value)
    if not path.is_dir():
        fail(f"missing staging directory {path}")
    return path


def one(items, label):
    values = list(items)
    if len(values) != 1:
        fail(f"expected exactly one {label}; found {len(values)}")
    return values[0]


def diagnostic(error):
    print(f"release packaging: {error}\nACTION: rebuild the workflow-declared target, then restage its artifacts", file=sys.stderr)
    return 1


if __name__ == "__main__":
    try:
        if len(sys.argv) != 2:
            fail("expected exactly one release target")
        target(sys.argv[1])
    except (ValueError, OSError) as error:
        sys.exit(diagnostic(error))