#!/usr/bin/env python3
"""Preserve local Sanctuary web references outside build, with a portable index."""
import argparse
from collections import Counter, defaultdict
import hashlib
import html
import json
from pathlib import Path
import re
import shutil
import subprocess
from urllib.parse import quote
import zipfile
ROOT = Path(__file__).resolve().parents[1]
ARCHIVES = ROOT / 'archives/web'
MEDIA = {'.png', '.jpg', '.jpeg', '.svg', '.webp', '.pdf'}
SKIP = {'node_modules', 'site-packages', '.git', '.gradle', 'source', 'sources', 'src'}
def sha(path):
digest = hashlib.sha256()
with path.open('rb') as stream:
for block in iter(lambda: stream.read(1024 * 1024), b''):
digest.update(block)
return digest.hexdigest()
def version_hint(path):
match = re.search(r'alpha\.(\d+(?:\.\d+)?)', str(path))
if match:
return 'alpha.' + match.group(1)
match = re.search(r'(?:alpha|atlas)(\d+)', str(path))
if match:
value = match.group(1)
return 'alpha.' + (value[:2] + '.' + value[2:] if len(value) == 3 and value.startswith('30') else value)
match = re.search(r'beta(\d+)', str(path))
return 'beta.' + match.group(1) if match else None
def collect():
selected = {}
def add(path, destination, category, status):
if path.is_symlink() or not path.is_file():
return
if destination in selected:
raise ValueError('Duplicate archive path: ' + destination)
selected[destination] = (path, category, status)
for folder in sorted((ROOT / 'build').iterdir()):
if not folder.is_dir() or 'isolated' in folder.name:
continue
historic = re.match(r'^(alpha\d+|atlas30[567])(?:\D|$)', folder.name)
current = folder.name in {'beta003-preview', 'beta004-preview'}
if not historic and not current:
continue
for path in sorted(folder.rglob('*')):
relative = path.relative_to(folder)
if set(relative.parts) & SKIP or any('venv' in part for part in relative.parts):
continue
is_atlas_data = folder.name in {'atlas305', 'atlas306', 'atlas307'} and path.suffix == '.json'
if path.suffix.lower() not in MEDIA and not is_atlas_data:
continue
destination = 'assets/' + path.relative_to(ROOT / 'build').as_posix()
category = 'beta-previews' if current else 'alpha-atlas' if folder.name.startswith('atlas') else 'alpha-research'
add(path, destination, category, 'development-output')
for path in sorted((ROOT / 'build').iterdir()):
if path.is_file() and path.suffix.lower() in MEDIA and re.match(r'^(Sanctuary-.*alpha\.|alpha\d+)', path.name):
add(path, 'assets/' + path.name, 'alpha-figures', 'release-named' if path.name.startswith('Sanctuary-') else 'development-output')
for path in sorted((ROOT / 'build').glob('Sanctuary-Atlas-0.1.0-alpha.30.[567].zip')):
with zipfile.ZipFile(path) as archive:
if archive.testzip() is not None:
raise ValueError('Invalid atlas: ' + path.name)
manifest = json.loads(archive.read('manifest.json'))
for name, expected in manifest['files_sha256'].items():
if hashlib.sha256(archive.read(name)).hexdigest() != expected:
raise ValueError('Atlas manifest mismatch: ' + name)
add(path, 'atlases/' + path.name, 'alpha-release-atlas', 'original-manifest-verified')
for path in sorted((ROOT / 'docs').rglob('*')):
if path.suffix.lower() in MEDIA | {'.md', '.json'}:
add(path, 'references/' + path.relative_to(ROOT).as_posix(), 'documentation', 'snapshot-at-archive-date')
for name in ['README.md', 'CHANGELOG.md', 'THIRD_PARTY_NOTICES.md', 'LICENSE']:
add(ROOT / name, 'references/' + name, 'documentation', 'snapshot-at-archive-date')
for name in ['terrain_atlas.py', 'structure_atlas.py', 'finishing_atlas.py', 'archive_terrain_atlas.py', 'terrain-atlas-requirements.txt', 'archive_web_assets.py']:
add(ROOT / 'scripts' / name, 'references/scripts/' + name, 'reproduction-script', 'snapshot-at-archive-date')
for path in sorted((ARCHIVES / 'blocodex-navigation-v1').iterdir()):
add(path, 'blocodex-navigation/' + path.name, 'blocodex-concept', 'approved-concept-fictional-data')
for path in sorted((ARCHIVES / 'references').glob('*.json')):
add(path, 'references/integration/' + path.name, 'integration-intake', 'metadata-only')
for path in sorted((ROOT / 'mods/sanctuary/src/main/resources/assets/sanctuary/textures/gui/progression').glob('*.png')):
add(path, 'assets/progression-icons/' + path.name, 'creator-icons', 'original-user-asset')
title = ROOT / 'ressources-pack/helloworld/assets/minecraft_title.png'
add(title, 'assets/title/minecraft_title.png', 'title-reference', 'project-reference')
return selected
def gallery(rows, identifier):
groups = defaultdict(list)
for row in rows:
if Path(row['path']).suffix.lower() in MEDIA:
groups[row['category'] + ' / ' + (row['version_hint'] or 'référence')].append(row)
escape = html.escape
link = lambda path: quote(path, safe='/')
parts = ['',
'',
'Archives Sanctuary',
'Archives Sanctuary
',
'Collection ' + escape(identifier) + ' · références pour le site et le Galactium.
',
'',
'La maquette contient des données fictives. Les images de recherche et les étapes intermédiaires ne décrivent pas toutes le jeu livré.
',
'Atlas de livraison complets
Documents et sources
')
for row in rows:
if row['category'] in {'documentation', 'reproduction-script', 'integration-intake'} and Path(row['path']).suffix.lower() not in MEDIA:
parts.append(f'- {escape(row["path"])}
')
parts.append('
Images et planches
')
for group, entries in sorted(groups.items()):
parts.append(f'{escape(group)} · {len(entries)} fichiers
'
parts.append(f'