95 lines
4.9 KiB
Python
95 lines
4.9 KiB
Python
#!/usr/bin/env python3
|
|
# SPDX-License-Identifier: GPL-3.0-or-later
|
|
"""Prepare the real CoCo Letters Make project for local VCC Plus qualification.
|
|
|
|
This is a test fixture, not an application resource. The explicitly supplied
|
|
private standalone disk source and generated game stay in the chosen local
|
|
output folder and are never copied into the public toolchain or Git snapshot.
|
|
"""
|
|
import argparse
|
|
import hashlib
|
|
import json
|
|
from pathlib import Path
|
|
import shutil
|
|
import subprocess
|
|
import sys
|
|
|
|
ROOT = Path(__file__).resolve().parents[2]
|
|
|
|
|
|
def main():
|
|
parser = argparse.ArgumentParser(description=__doc__)
|
|
parser.add_argument('--output', type=Path, required=True)
|
|
parser.add_argument('--standalone-disk-source', type=Path, required=True)
|
|
args = parser.parse_args()
|
|
output = args.output.resolve()
|
|
if output.exists(): parser.error('Choose a fresh project directory')
|
|
if output == ROOT or ROOT / 'third_party' == output or ROOT / 'third_party' in output.parents:
|
|
parser.error('Choose local test storage outside the source snapshots')
|
|
record = json.loads((ROOT / 'third_party/manifests/cmoc.json').read_text())
|
|
expected = record['excludedFileSHA256']['src/stdlib/dskcon-standalone.c']
|
|
if hashlib.sha256(args.standalone_disk_source.read_bytes()).hexdigest() != expected:
|
|
parser.error('Private disk source does not match the reviewed CMOC release')
|
|
subprocess.run([sys.executable, ROOT / 'tools/toolchain/verify-sources.py'], check=True)
|
|
shutil.copytree(ROOT / 'third_party/examples/coco-letters', output)
|
|
# A grouped target makes the upstream two-output dictionary recipe safe when
|
|
# GNU Make runs in parallel. The vendored source itself remains unchanged.
|
|
upstream = (output / 'Makefile').read_text()
|
|
original = '$(DATA_FILENAME) $(WORD_LENGTH_FILENAME): $(BUILD_DATA)'
|
|
if upstream.count(original) != 1: raise SystemExit('Review updated dictionary generation rule')
|
|
upstream = upstream.replace(original, '$(DATA_FILENAME) $(WORD_LENGTH_FILENAME) &: $(BUILD_DATA)')
|
|
(output / 'Game.mk').write_text(upstream)
|
|
for name in ('decbfile', 'bcontrol', 'bsound'):
|
|
shutil.copytree(ROOT / 'third_party/cmoc-libraries' / name, output / 'libraries' / name)
|
|
(output / 'private').mkdir()
|
|
shutil.copyfile(args.standalone_disk_source, output / 'private/dskcon-standalone.c')
|
|
(output / 'Makefile').write_text('''# VCC Plus local qualification wrapper. GPL-3.0-or-later.
|
|
# Game.mk is the upstream game Makefile, with its dictionary recipe grouped.
|
|
override DECBFILE_LIB_DIR = libraries/decbfile
|
|
override BCONTROL_LIB_DIR = libraries/bcontrol
|
|
override BSOUND_LIB_DIR = libraries/bsound
|
|
include Game.mk
|
|
.DEFAULT_GOAL := all
|
|
INTERMEDIATE = --intermediate
|
|
LIBS += private/dskcon-standalone.o
|
|
|
|
$(BIN): private/dskcon-standalone.o
|
|
private/dskcon-standalone.o: private/dskcon-standalone.c
|
|
\t$(CMOC) --coco --intermediate -O2 -c -o $@ $<
|
|
|
|
libraries/decbfile/libdecbfile.a: $(wildcard libraries/decbfile/*.c libraries/decbfile/*.h) libraries/decbfile/Makefile
|
|
\t$(MAKE) -C libraries/decbfile libdecbfile.a
|
|
libraries/bcontrol/libbcontrol.a: $(wildcard libraries/bcontrol/*.c libraries/bcontrol/*.h) libraries/bcontrol/Makefile
|
|
\t$(MAKE) -C libraries/bcontrol libbcontrol.a
|
|
libraries/bsound/libbsound.a: $(wildcard libraries/bsound/*.c libraries/bsound/*.h) libraries/bsound/Makefile
|
|
\t$(MAKE) -C libraries/bsound libbsound.a
|
|
|
|
.PHONY: clean-libraries
|
|
clean: clean-libraries
|
|
clean-libraries:
|
|
\t$(MAKE) -C libraries/decbfile clean
|
|
\t$(MAKE) -C libraries/bcontrol clean
|
|
\t$(MAKE) -C libraries/bsound clean
|
|
\trm -f private/*.o private/*.s private/*.lst $(DSK)
|
|
''')
|
|
(output / 'vccplus-project.json').write_text(json.dumps({
|
|
'entrySource': 'main.c', 'makefile': 'Makefile', 'buildTarget': 'all',
|
|
'cleanTarget': 'clean', 'diskTarget': 'all', 'binary': 'letters.bin',
|
|
'diskImage': 'coco-letters-0.1.0.dsk', 'launchMode': 'disk',
|
|
'launchCommands': ['DOS'], 'jobs': 4,
|
|
'configurations': [{'name': 'Debug', 'makeArguments': ['INTERMEDIATE=--intermediate']},
|
|
{'name': 'Release', 'makeArguments': []}]
|
|
}, indent=2) + '\n')
|
|
(output / '.gitignore').write_text('private/\n*.bin\n*.dsk\n*.dat\n*.o\n*.s\n*.lst\n*.map\n*.link\n*.d\nword-length-index.c\n')
|
|
(output / 'VCC-QUALIFICATION.txt').write_text(
|
|
'Local qualification fixture. Includes separately supplied private disk source.\n'
|
|
'Do not distribute this folder as part of VCC Plus or its public toolchain.\n'
|
|
'Open the folder in C Development, build the all target, then mount/boot its disk.\n'
|
|
'Requires CoCo 3, at least 128 KB, floppy controller with Disk BASIC, and RGB video.\n'
|
|
'The original optimization flags are retained to fit its memory map.\n'
|
|
'Source breakpoints are available only where exact executable mappings are verified.\n')
|
|
print('Prepared local Make project:', output)
|
|
|
|
|
|
if __name__ == '__main__': main()
|