Prepare Capital Quest public edition and player manual

This commit is contained in:
Brian Holman committed 2026-11-11 19:27:51 -07:00
1 parent 46f4b9cae0
commit afa6f3c2a0
40 files changed
+1072 -106

No files matched your search

+73
View File
@@ -0,0 +1,73 @@
#!/usr/bin/env python3
"""Create a deterministic, source-only Capital Quest starter ZIP.
No compiler, network, Git mutation, private inputs or game execution is involved.
"""
import argparse
import hashlib
import json
from pathlib import Path
from zipfile import ZIP_DEFLATED, ZipFile, ZipInfo
ROOT = Path(__file__).resolve().parents[1]
ROOT_FILES = ('AGENTS.md', 'LICENSE', 'Makefile', 'README.md', '.gitignore',
'vccplus-project.json', 'main.c', 'quiz.h', 'ui.h', 'map_data.h')
DIRECTORIES = ('src', 'data', 'assets', 'tests', 'tools', 'docs/manual')
EXTRA_FILES = ('docs/PROVENANCE.md', 'docs/PUBLIC_RELEASE.md')
def source_files():
names = set(ROOT_FILES + EXTRA_FILES)
for directory in DIRECTORIES:
for path in (ROOT / directory).rglob('*'):
if path.is_dir():
continue
name = path.relative_to(ROOT).as_posix()
if '__pycache__' in path.parts or path.suffix == '.pyc' or path.name == '.DS_Store':
continue
if path.is_symlink() or not path.is_file():
raise ValueError('Only regular source files are permitted: ' + name)
names.add(name)
result = {}
for name in sorted(names):
path = ROOT / name
if path.is_symlink() or not path.is_file():
raise ValueError('Missing regular source input: ' + name)
if any(word in name.casefold() for word in ('connection', 'vccgrant')):
raise ValueError('Private-connection filename is not a source input: ' + name)
if path.suffix.casefold() in ('.dsk', '.rom', '.bin', '.o', '.a', '.pdf', '.zip'):
raise ValueError('Binary, archive or generated output is not source: ' + name)
result['CapitalQuest/' + name] = path.read_bytes()
return result
def main():
parser = argparse.ArgumentParser(description=__doc__)
parser.add_argument('--destination', type=Path, required=True)
args = parser.parse_args()
destination = args.destination.resolve()
if destination.is_relative_to(ROOT):
parser.error('Keep package output outside the source project.')
if destination.exists():
parser.error('Destination already exists; retain completed packages unchanged.')
files = source_files()
destination.parent.mkdir(parents=True, exist_ok=True)
with ZipFile(destination, 'x', compression=ZIP_DEFLATED, compresslevel=9) as archive:
for name, data in files.items():
info = ZipInfo(name, date_time=(1980, 1, 1, 0, 0, 0))
info.create_system = 3
info.external_attr = 0o100644 << 16
info.compress_type = ZIP_DEFLATED
archive.writestr(info, data)
manifest = dict(schemaVersion=1,projectDirectory='CapitalQuest',
configurationFile='CapitalQuest/vccplus-project.json',entrySource='main.c',
archive=destination.name,byteSize=destination.stat().st_size,
sha256=hashlib.sha256(destination.read_bytes()).hexdigest(),
files=[dict(path=name,byteSize=len(data),sha256=hashlib.sha256(data).hexdigest())
for name,data in files.items()])
destination.with_suffix('.manifest.json').write_text(json.dumps(manifest,indent=2)+'\n')
print(json.dumps({k:v for k,v in manifest.items() if k!='files'},indent=2))
if __name__ == '__main__':
main()