Files
Neutron/tools/recon/fidelity.py
T

66 lines
3.1 KiB
Python

#!/usr/bin/env python3
"""Local preserved-session and typed evidence CLI (never launches originals).
Examples: stage --source ../Original --manifest docs/original-manifest.json
--output artifacts/fidelity/sessions --session-id fresh-001; identify dist/linux-x64;
import BUNDLE/receipt.json --root BUNDLE --output artifacts/fidelity/receipts;
validate RECEIPT --root IMPORTED_DIR --allow-open. Synthetic imports require a
separate output directory whose name contains 'test'. All outputs remain local.
"""
import argparse
import json
from pathlib import Path
import sys
from fidelity_receipts import (identify_tree, identify_report, import_receipt,
read_json, stage_original, validate_receipt)
def main(argv=None):
parser = argparse.ArgumentParser(description=__doc__)
sub = parser.add_subparsers(dest='command', required=True)
stage = sub.add_parser('stage')
for flag in ('source', 'manifest', 'output'):
stage.add_argument('--' + flag, type=Path, required=True)
stage.add_argument('--session-id', required=True)
identify = sub.add_parser('identify')
identify.add_argument('path', type=Path)
for flag in ('report', 'executable', 'resources', 'launcher', 'project'):
identify.add_argument('--' + flag, type=Path)
imp = sub.add_parser('import')
imp.add_argument('receipt', type=Path)
imp.add_argument('--root', type=Path, required=True)
imp.add_argument('--output', type=Path, required=True)
validate = sub.add_parser('validate')
validate.add_argument('receipt', type=Path)
validate.add_argument('--root', type=Path, required=True)
mode = validate.add_mutually_exclusive_group()
mode.add_argument('--allow-open', action='store_true')
mode.add_argument('--require-complete', action='store_true')
args = parser.parse_args(argv)
try:
if args.command == 'stage':
result = stage_original(args.source, args.manifest, args.output, args.session_id)
elif args.command == 'identify':
result = identify_report(args.path, args.report, args.executable, args.resources,
args.launcher, args.project) if any(
getattr(args, k) is not None for k in ('report', 'executable', 'resources', 'launcher', 'project')) else identify_tree(args.path)
elif args.command == 'import':
result = import_receipt(args.receipt, args.root, args.output)
else:
result = validate_receipt(read_json(args.receipt), args.root)
print('Receipt {receipt_id}: {evidence_kind}, status={status}'.format(**result))
print('Acceptance: ' + ('ACCEPTED' if result['accepted'] else 'OPEN'))
for missing in result['missing_evidence']:
print('Missing/open: ' + str(missing))
return 1 if args.require_complete and not result['accepted'] else 0
print(json.dumps(result, indent=2, allow_nan=False))
return 0
except (ValueError, OSError, KeyError, TypeError) as error:
print('Invalid fidelity evidence: ' + str(error), file=sys.stderr)
return 2
if __name__ == '__main__':
sys.exit(main())