#!/usr/bin/env python3 """Validate sample site file graph and generated preview; not a production schema validator.""" from pathlib import Path from html.parser import HTMLParser import re import yaml ROOT=Path(__file__).resolve().parents[1] load=lambda p:yaml.safe_load(p.read_text(encoding='utf-8')) def front(p): raw=p.read_text(encoding='utf8') if not raw.startswith('---\n'):raise ValueError('No YAML front matter '+str(p)) return yaml.safe_load(raw[4:].split('\n---\n',1)[0]) errors=[];warnings=[] def err(message):errors.append(message) def validate_yaml(): yaml_files=list(ROOT.rglob('*.yaml')) for p in yaml_files: try: load(p) except Exception as ex:err(f'Invalid YAML {p.relative_to(ROOT)}: {ex}') print('YAML files:',len(yaml_files)) return yaml_files frags={};layout_ids=set() for p in ROOT.glob('fragments/*/*/fragment.yaml'): f=load(p) frags[f['id']]=p if not (p.parent/'template.html.j2').is_file():err('Fragment template missing: '+str(p)) for p in ROOT.glob('layouts/*/layout.yaml'): obj=load(p);layout_ids.add(obj['id']) if not (p.parent/'layout.html.j2').is_file():err('Layout template missing: '+str(p)) routes={} for p in ROOT.glob('pages/**/*.md'): f=front(p) if f.get('route') in routes:err('Duplicate route '+f['route']) routes[f['route']]=p if f.get('layout') not in layout_ids:err('Unknown layout '+str(f['layout'])) allowed=next((set(r['allow']) for r in load(ROOT/'layouts'/f['layout']/'layout.yaml')['regions'] if r['id']=='main'),set()) ids=set() for b in f.get('regions',{}).get('main',[]): if b['id'] in ids:err(f'Duplicate block ID {b["id"]} in {p}') ids.add(b['id']) if b['fragment'] not in frags:err(f'Unknown Fragment {b["fragment"]} in {p}') if b['fragment'] not in allowed:err(f'Disallowed Fragment {b["fragment"]} in {p}') props=b.get('props',{}) for k in ('buttonUrl',): if props.get(k) and props[k] not in routes:pass # check after all files collected if b['fragment']=='form' and not (ROOT/'forms'/f"{props['form_id']}.yaml").is_file():err('Missing form '+props['form_id']) if p.name=='index.md' and len(f.get('regions',{}).get('main',[]))==0:err('Empty index') entries={} for p in ROOT.glob('content/*/*.md'): f=front(p) key=p.parent.name+'/'+f['slug'] if key in entries:err('Duplicate Entry '+key) entries[key]=f if not (ROOT/'collections'/f'{p.parent.name}.yaml').is_file():err('Missing collection '+p.parent.name) if not (ROOT/'display'/f'{p.parent.name}.yaml').is_file():err('Missing display '+p.parent.name) if not f.get('title'):err('Missing Entry.title '+key) for fk in ('hero_asset',): asset=f.get(fk) if asset and not (ROOT/asset).is_file(): if f['status']=='draft':warnings.append(f'Expected draft warning: {key} -> {asset}') else:err('Missing published asset '+asset) for fk,target in [('related_scenarios','scenarios'),('related_services','services')]: for slug in f.get(fk,[]): if not (ROOT/f'content/{target}/{slug}.md').is_file():err(f'Missing Entry reference {key} -> {target}/{slug}') for p in ROOT.glob('pages/**/*.md'): f=front(p) for b in f.get('regions',{}).get('main',[]): props=b.get('props',{}) for key in ('buttonUrl',): link=props.get(key) if link and link not in routes:err(f'Broken link {link} from {p}') for key in ('asset','background'): asset=props.get(key) if asset and not (ROOT/asset).is_file():err(f'Missing page asset {asset} in {p}') if b['fragment']=='collection_list' and not (ROOT/'collections'/f"{props.get('collection')}.yaml").is_file():err(f'Missing query collection {props.get("collection")}') if b['fragment']=='entry_card' and props.get('entry') not in entries:err('Missing entry_card ref '+str(props.get('entry'))) for p in ROOT.glob('menus/*.yaml'): for item in load(p)['items']: if item.get('enabled',True) and item.get('page') not in routes:err(f'Menu target not found: {item.get("page")} in {p}') for asset in load(ROOT/'assets/manifest.yaml')['files']: if not (ROOT/asset['path']).is_file():err('Asset manifest path missing: '+asset['path']) class Links(HTMLParser): def __init__(self):super().__init__();self.refs=[] def handle_starttag(self,tag,attrs): d=dict(attrs) if tag in ('a','link','script','img'): val=d.get('href') or d.get('src') if val:self.refs.append(val) html_docs=list((ROOT/'preview-dist').rglob('*.html')) for p in html_docs: links=Links();links.feed(p.read_text(encoding='utf8')) for ref in links.refs: if ref.startswith(('#','http:','https:','mailto:','tel:','data:')):continue r=(p.parent/ref.split('#',1)[0]).resolve() if not r.is_relative_to((ROOT/'preview-dist').resolve()):err(f'Preview link outside root {p}: {ref}') elif not r.is_file():err(f'Broken preview href/src {p.relative_to(ROOT)} -> {ref}') if len(html_docs)<12:err(f'Expected 12+ rendered pages, got {len(html_docs)}') print('Pages:',len(routes),'Entries:',len(entries),'Fragments:',len(frags),'Layouts:',len(layout_ids),'Static HTML:',len(html_docs)) print('Warnings:',*warnings,sep='\n ') if errors: print('ERRORS:',*errors,sep='\n - ') raise SystemExit(1) print('PASS: YAML, file paths, entry refs, block IDs, layouts, menus, HTML links')