A collection that does not pack the Apps controller opens with Breeze's own reviewed controller, also on the preparation worker, and its covers arrive as one separate art download published with its games. Pins the Apps host with both and the shared-code toolchain, and Kryon's browser missing-file fix. The 2.1.49 notes name the smaller Arcade and its plain covers.
96 lines
3.6 KiB
Python
96 lines
3.6 KiB
Python
#!/usr/bin/env python3
|
|
"""Verify a release's separate games against its authenticated catalog."""
|
|
import argparse
|
|
from hashlib import sha256
|
|
import json
|
|
from pathlib import Path
|
|
import re
|
|
import shutil
|
|
import tarfile
|
|
import tempfile
|
|
|
|
from practice_content import bundle_assets
|
|
|
|
GAME_LIMIT = 16
|
|
PAYLOAD_LIMIT = 64 * 1024 * 1024
|
|
|
|
|
|
def required_games(bundle):
|
|
assets = bundle_assets(bundle.read_bytes())
|
|
catalog = assets.get('assets/apps/catalog.json')
|
|
if catalog is None:
|
|
return set()
|
|
catalog = json.loads(catalog)
|
|
children = catalog['children']
|
|
if len(children) > GAME_LIMIT:
|
|
raise ValueError('collection has too many games')
|
|
names = set()
|
|
for child in children:
|
|
if child['bundle'] in assets:
|
|
continue
|
|
digest = child['sha256']
|
|
if not re.fullmatch(r'[0-9a-f]{64}', digest):
|
|
raise ValueError('invalid game digest in catalog')
|
|
names.add(digest + '.zx')
|
|
# The library art a collection does not pack downloads like a game.
|
|
art = catalog.get('art')
|
|
if art is not None and 'assets/apps/art.zx' not in assets:
|
|
if not re.fullmatch(r'[0-9a-f]{64}', art.get('sha256', '')):
|
|
raise ValueError('invalid art digest in catalog')
|
|
names.add(art['sha256'] + '.zx')
|
|
return names
|
|
|
|
|
|
def stage_games(bundle, archive, output):
|
|
expected = required_games(bundle)
|
|
output.parent.mkdir(parents=True, exist_ok=True)
|
|
with tempfile.TemporaryDirectory(prefix='node-games-', dir=output.parent) as directory:
|
|
staging = Path(directory) / 'games'
|
|
staging.mkdir()
|
|
seen = set()
|
|
with tarfile.open(archive) as source:
|
|
for member in source:
|
|
if (member.name not in expected or member.name in seen or not member.isfile()
|
|
or not 8 <= member.size <= PAYLOAD_LIMIT):
|
|
raise ValueError('unexpected, repeated or invalid game archive entry')
|
|
digest = sha256()
|
|
total = 0
|
|
with source.extractfile(member) as data, (staging / member.name).open('wb') as target:
|
|
while chunk := data.read(1024 * 1024):
|
|
total += len(chunk)
|
|
if total > member.size:
|
|
raise ValueError('game exceeds its declared archive size')
|
|
digest.update(chunk)
|
|
target.write(chunk)
|
|
if total != member.size or digest.hexdigest() + '.zx' != member.name:
|
|
raise ValueError('game bytes differ from the authenticated catalog')
|
|
with (staging / member.name).open('rb') as data:
|
|
if data.read(4) != b'ZX\0\0':
|
|
raise ValueError('game is not a ZX bundle')
|
|
seen.add(member.name)
|
|
if seen != expected:
|
|
raise ValueError('game archive is missing a declared game')
|
|
if output.exists():
|
|
shutil.rmtree(output)
|
|
staging.replace(output)
|
|
|
|
|
|
def main():
|
|
parser = argparse.ArgumentParser(description=__doc__)
|
|
parser.add_argument('--bundle', type=Path, required=True)
|
|
parser.add_argument('--list', action='store_true')
|
|
parser.add_argument('--archive', type=Path)
|
|
parser.add_argument('--output', type=Path)
|
|
args = parser.parse_args()
|
|
if args.list:
|
|
for name in sorted(required_games(args.bundle)):
|
|
print(name)
|
|
else:
|
|
if args.archive is None or args.output is None:
|
|
parser.error('give --archive and --output')
|
|
stage_games(args.bundle, args.archive, args.output)
|
|
|
|
|
|
if __name__ == '__main__':
|
|
main()
|