acceptbox 0.1.0a1__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
Metadata-Version: 2.5
|
|
2
|
+
Name: acceptbox
|
|
3
|
+
Version: 0.1.0a1
|
|
4
|
+
Summary: Подготовка входов для независимой приёмки коммитов с WitnessBox
|
|
5
|
+
Classifier: Development Status :: 3 - Alpha
|
|
6
|
+
Classifier: Environment :: Console
|
|
7
|
+
Classifier: Programming Language :: Python :: 3
|
|
8
|
+
Classifier: Topic :: Software Development :: Testing
|
|
9
|
+
Requires-Python: >=3.11
|
|
10
|
+
Description-Content-Type: text/markdown
|
|
11
|
+
|
|
12
|
+
# AcceptBox
|
|
13
|
+
|
|
14
|
+
Первый предварительный выпуск помогает зафиксировать версию набора проверок EBT
|
|
15
|
+
и проверить совместимость установленного WitnessBox.
|
|
16
|
+
|
|
17
|
+
Установка предварительной версии:
|
|
18
|
+
|
|
19
|
+
```sh
|
|
20
|
+
uv tool install acceptbox==0.1.0a1
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
Чтобы собрать wheel и исходный архив, выполни `uv build` в каталоге с
|
|
24
|
+
`pyproject.toml` пакета.
|
|
25
|
+
|
|
26
|
+
Чтобы зафиксировать набор проверок, передайте путь или URL репозитория и полный
|
|
27
|
+
SHA коммита. Команда читает дерево `ebt/` из объектов Git и печатает 64 символа
|
|
28
|
+
SHA-256. Для неё нужен Git.
|
|
29
|
+
|
|
30
|
+
```sh
|
|
31
|
+
acceptbox pin --ebt-repo /path/to/project --ebt-sha "$(git -C /path/to/project rev-parse HEAD)"
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
Отпечаток учитывает пути, типы и режимы записей, а также содержимое файлов.
|
|
35
|
+
Для символической ссылки учитывается записанный в Git путь, для подмодуля —
|
|
36
|
+
идентификатор его коммита. Незакоммиченные правки и файлы вне `ebt/` на отпечаток
|
|
37
|
+
не влияют.
|
|
38
|
+
|
|
39
|
+
Команда `acceptbox --installation` выводит JSON с версией AcceptBox, путём и версией
|
|
40
|
+
WitnessBox из `PATH`. Поддерживаются выпуски WitnessBox 0.9.x. Код 0 означает
|
|
41
|
+
совместимую установку, код 2 — отсутствие команды, несовместимую версию или сбой
|
|
42
|
+
диагностики.
|
|
43
|
+
|
|
44
|
+
Вердикт приёмки и отчёт `accept.json` запланированы на полный выпуск 0.1.0.
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
# AcceptBox
|
|
2
|
+
|
|
3
|
+
Первый предварительный выпуск помогает зафиксировать версию набора проверок EBT
|
|
4
|
+
и проверить совместимость установленного WitnessBox.
|
|
5
|
+
|
|
6
|
+
Установка предварительной версии:
|
|
7
|
+
|
|
8
|
+
```sh
|
|
9
|
+
uv tool install acceptbox==0.1.0a1
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
Чтобы собрать wheel и исходный архив, выполни `uv build` в каталоге с
|
|
13
|
+
`pyproject.toml` пакета.
|
|
14
|
+
|
|
15
|
+
Чтобы зафиксировать набор проверок, передайте путь или URL репозитория и полный
|
|
16
|
+
SHA коммита. Команда читает дерево `ebt/` из объектов Git и печатает 64 символа
|
|
17
|
+
SHA-256. Для неё нужен Git.
|
|
18
|
+
|
|
19
|
+
```sh
|
|
20
|
+
acceptbox pin --ebt-repo /path/to/project --ebt-sha "$(git -C /path/to/project rev-parse HEAD)"
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
Отпечаток учитывает пути, типы и режимы записей, а также содержимое файлов.
|
|
24
|
+
Для символической ссылки учитывается записанный в Git путь, для подмодуля —
|
|
25
|
+
идентификатор его коммита. Незакоммиченные правки и файлы вне `ebt/` на отпечаток
|
|
26
|
+
не влияют.
|
|
27
|
+
|
|
28
|
+
Команда `acceptbox --installation` выводит JSON с версией AcceptBox, путём и версией
|
|
29
|
+
WitnessBox из `PATH`. Поддерживаются выпуски WitnessBox 0.9.x. Код 0 означает
|
|
30
|
+
совместимую установку, код 2 — отсутствие команды, несовместимую версию или сбой
|
|
31
|
+
диагностики.
|
|
32
|
+
|
|
33
|
+
Вердикт приёмки и отчёт `accept.json` запланированы на полный выпуск 0.1.0.
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
[build-system]
|
|
2
|
+
requires = ["hatchling>=1.27"]
|
|
3
|
+
build-backend = "hatchling.build"
|
|
4
|
+
|
|
5
|
+
[project]
|
|
6
|
+
name = "acceptbox"
|
|
7
|
+
version = "0.1.0a1"
|
|
8
|
+
description = "Подготовка входов для независимой приёмки коммитов с WitnessBox"
|
|
9
|
+
readme = "README.md"
|
|
10
|
+
requires-python = ">=3.11"
|
|
11
|
+
dependencies = []
|
|
12
|
+
classifiers = [
|
|
13
|
+
"Development Status :: 3 - Alpha",
|
|
14
|
+
"Environment :: Console",
|
|
15
|
+
"Programming Language :: Python :: 3",
|
|
16
|
+
"Topic :: Software Development :: Testing",
|
|
17
|
+
]
|
|
18
|
+
|
|
19
|
+
[project.scripts]
|
|
20
|
+
acceptbox = "acceptbox.cli:main"
|
|
21
|
+
|
|
22
|
+
[tool.hatch.build.targets.wheel]
|
|
23
|
+
packages = ["src/acceptbox"]
|
|
24
|
+
|
|
25
|
+
[tool.hatch.build.targets.sdist]
|
|
26
|
+
include = ["/src/acceptbox", "/README.md", "/pyproject.toml"]
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
"""Подготовка входов для независимой приёмки коммитов."""
|
|
@@ -0,0 +1,81 @@
|
|
|
1
|
+
"""Командная строка AcceptBox."""
|
|
2
|
+
|
|
3
|
+
import argparse
|
|
4
|
+
import json
|
|
5
|
+
import re
|
|
6
|
+
import shutil
|
|
7
|
+
import subprocess
|
|
8
|
+
import sys
|
|
9
|
+
from importlib.metadata import version
|
|
10
|
+
|
|
11
|
+
from .pin import tree_sha256
|
|
12
|
+
|
|
13
|
+
|
|
14
|
+
WITNESSBOX_RANGE = ">=0.9.0,<0.10"
|
|
15
|
+
|
|
16
|
+
|
|
17
|
+
def _installation(acceptbox_version: str) -> int:
|
|
18
|
+
executable = shutil.which("witnessbox")
|
|
19
|
+
found_version = None
|
|
20
|
+
status = "missing"
|
|
21
|
+
if executable:
|
|
22
|
+
status = "error"
|
|
23
|
+
try:
|
|
24
|
+
result = subprocess.run(
|
|
25
|
+
[executable, "--version"], capture_output=True, encoding="utf-8",
|
|
26
|
+
errors="replace", check=True, timeout=10,
|
|
27
|
+
)
|
|
28
|
+
except (OSError, subprocess.SubprocessError):
|
|
29
|
+
pass
|
|
30
|
+
else:
|
|
31
|
+
name, _, candidate = result.stdout.strip().partition(" ")
|
|
32
|
+
if name == "witnessbox" and candidate:
|
|
33
|
+
found_version = candidate
|
|
34
|
+
status = "incompatible"
|
|
35
|
+
if re.fullmatch(r"0\.9\.[0-9]+(?:\.post[0-9]+)?(?:\+[a-z0-9.]+)?", candidate):
|
|
36
|
+
status = "compatible"
|
|
37
|
+
|
|
38
|
+
print(json.dumps({
|
|
39
|
+
"distribution": "acceptbox",
|
|
40
|
+
"version": acceptbox_version,
|
|
41
|
+
"witnessbox": {
|
|
42
|
+
"path": executable,
|
|
43
|
+
"version": found_version,
|
|
44
|
+
"supported": WITNESSBOX_RANGE,
|
|
45
|
+
"status": status,
|
|
46
|
+
},
|
|
47
|
+
}, ensure_ascii=False, indent=2))
|
|
48
|
+
return 0 if status == "compatible" else 2
|
|
49
|
+
|
|
50
|
+
|
|
51
|
+
def main(argv: list[str] | None = None) -> int:
|
|
52
|
+
acceptbox_version = version("acceptbox")
|
|
53
|
+
parser = argparse.ArgumentParser(
|
|
54
|
+
prog="acceptbox", description="Подготовка входов для приёмки коммитов."
|
|
55
|
+
)
|
|
56
|
+
options = parser.add_mutually_exclusive_group()
|
|
57
|
+
options.add_argument("--version", action="version", version=f"%(prog)s {acceptbox_version}")
|
|
58
|
+
options.add_argument("--installation", action="store_true", help="проверить версию WitnessBox")
|
|
59
|
+
commands = parser.add_subparsers(dest="command")
|
|
60
|
+
pin = commands.add_parser("pin", help="вычислить SHA-256 дерева ebt/ из Git-коммита")
|
|
61
|
+
pin.add_argument("--ebt-repo", required=True, help="путь или URL репозитория")
|
|
62
|
+
pin.add_argument("--ebt-sha", required=True, help="полный SHA коммита")
|
|
63
|
+
args = parser.parse_args(argv)
|
|
64
|
+
|
|
65
|
+
if args.installation:
|
|
66
|
+
if args.command:
|
|
67
|
+
parser.error("--installation используется отдельно")
|
|
68
|
+
return _installation(acceptbox_version)
|
|
69
|
+
if args.command == "pin":
|
|
70
|
+
try:
|
|
71
|
+
print(tree_sha256(args.ebt_repo, args.ebt_sha))
|
|
72
|
+
except subprocess.CalledProcessError as error:
|
|
73
|
+
print(f"acceptbox: {error.stderr.decode(errors='replace').strip()}", file=sys.stderr)
|
|
74
|
+
return 2
|
|
75
|
+
except (OSError, ValueError) as error:
|
|
76
|
+
print(f"acceptbox: {error}", file=sys.stderr)
|
|
77
|
+
return 2
|
|
78
|
+
return 0
|
|
79
|
+
|
|
80
|
+
parser.print_help()
|
|
81
|
+
return 0
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
"""Отпечаток дерева EBT из объектов Git."""
|
|
2
|
+
|
|
3
|
+
import hashlib
|
|
4
|
+
import os
|
|
5
|
+
import re
|
|
6
|
+
import subprocess
|
|
7
|
+
from pathlib import Path
|
|
8
|
+
from tempfile import TemporaryDirectory
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
def _git(cwd: Path, env: dict[str, str], *args: str) -> bytes:
|
|
12
|
+
return subprocess.run(
|
|
13
|
+
["git", "--no-replace-objects", "-C", str(cwd), *args],
|
|
14
|
+
env=env,
|
|
15
|
+
capture_output=True,
|
|
16
|
+
check=True,
|
|
17
|
+
).stdout
|
|
18
|
+
|
|
19
|
+
|
|
20
|
+
def _hash_tree(repo: Path, commit: str, env: dict[str, str]) -> str:
|
|
21
|
+
if _git(repo, env, "cat-file", "-t", commit).strip() != b"commit":
|
|
22
|
+
raise ValueError("--ebt-sha должен указывать на коммит")
|
|
23
|
+
|
|
24
|
+
entries = _git(repo, env, "ls-tree", "--full-tree", "-r", "-t", "-z", f"{commit}:ebt")
|
|
25
|
+
digest = hashlib.sha256()
|
|
26
|
+
for entry in entries.split(b"\0")[:-1]:
|
|
27
|
+
metadata, path = entry.split(b"\t", 1)
|
|
28
|
+
mode, kind, object_id = metadata.split()
|
|
29
|
+
digest.update(mode + b" " + kind + b" " + path + b"\0")
|
|
30
|
+
if kind == b"blob":
|
|
31
|
+
blob = _git(repo, env, "cat-file", "blob", object_id.decode("ascii"))
|
|
32
|
+
digest.update(hashlib.sha256(blob).digest())
|
|
33
|
+
elif kind == b"commit":
|
|
34
|
+
digest.update(hashlib.sha256(object_id).digest())
|
|
35
|
+
return digest.hexdigest()
|
|
36
|
+
|
|
37
|
+
|
|
38
|
+
def tree_sha256(repository: str, commit: str) -> str:
|
|
39
|
+
if not re.fullmatch(r"(?:[0-9a-fA-F]{40}|[0-9a-fA-F]{64})", commit):
|
|
40
|
+
raise ValueError("--ebt-sha должен содержать полный SHA коммита Git")
|
|
41
|
+
commit = commit.lower()
|
|
42
|
+
|
|
43
|
+
cwd = Path.cwd()
|
|
44
|
+
local_variables = _git(cwd, dict(os.environ), "rev-parse", "--local-env-vars")
|
|
45
|
+
env = os.environ.copy()
|
|
46
|
+
for name in local_variables.decode("ascii").splitlines():
|
|
47
|
+
env.pop(name, None)
|
|
48
|
+
|
|
49
|
+
local_repo = Path(repository).expanduser()
|
|
50
|
+
if local_repo.is_dir():
|
|
51
|
+
return _hash_tree(local_repo, commit, env)
|
|
52
|
+
with TemporaryDirectory(prefix="acceptbox-pin-") as temp:
|
|
53
|
+
clone = Path(temp) / "repo"
|
|
54
|
+
_git(cwd, env, "clone", "--quiet", "--no-checkout", "--", repository, str(clone))
|
|
55
|
+
return _hash_tree(clone, commit, env)
|