#!/usr/bin/env python3 """ตรวจความสอดคล้องของ SPA/PWA แบบ static (ไม่ต้องเปิดเบราว์เซอร์) ตรวจ: 1. ลิงก์ภายใน partial ต้องเป็น "#/..." เท่านั้น (ห้าม "#section" หรือ "./x.html") 2. ทุก route ใน router.js ต้องมีไฟล์ partial อยู่จริง และไฟล์ partial ที่มีต้องถูกอ้างใน router 3. ทุกไฟล์ใน PRECACHE ของ sw.js ต้องมีอยู่จริง 4. VERSION ของ sw.js / app/version.js / app/version.json / index.html ?v= ต้องตรงกัน 5. shell (index.html) ต้องมี , theme-color, และสคริปต์ register 6. ไม่มีอีโมจิในไฟล์ที่ผู้ใช้เห็น (partial, css, js) ใช้: python tools/check_app.py (exit 1 ถ้าเจอปัญหา) """ import json import os import re import sys import urllib.parse PROBLEMS = [] NOTES = [] EMOJI = re.compile( "[\U0001F300-\U0001FAFF\U00002600-\U000027BF\U0001F000-\U0001F0FF\U00002190-\U000021FF\U00002B00-\U00002BFF]" ) # สัญลักษณ์ที่ยอมให้ใช้ (ลูกศร/ขีดคั่น/เครื่องหมายคำพูด) — ไม่นับเป็นอีโมจิ ALLOWED_SYMBOLS = set("→←↑↓↔⇒⇐✓✔✗·–—«»…‰°±×÷") def problem(message): PROBLEMS.append(message) def read(path): with open(path, encoding="utf-8") as handle: return handle.read() def check_partial_links(): partial_dir = "partials" for name in sorted(os.listdir(partial_dir)): if not name.endswith(".html"): continue path = os.path.join(partial_dir, name) body = read(path) for match in re.finditer(r'href="([^"]+)"', body): href = match.group(1) if href.startswith(("#/", "http://", "https://", "mailto:", "tel:")): continue if href.startswith("#"): problem("%s: ลิงก์ '%s' เป็น hash ธรรมดา (จะทำให้ router เปลี่ยนหน้า) — ใช้ '#/...'" % (path, href)) continue if href.endswith(".html"): problem("%s: ลิงก์ '%s' จะโหลดหน้าใหม่ — ใช้ '#/...'" % (path, href)) def check_routes(): router = read("app/router.js") routes = re.findall(r"^\s*'?([a-z-]+)'?:\s*\{\s*partial:\s*'([^']+)'", router, re.MULTILINE) declared = set() for _name, partial in routes: declared.add(partial) if not os.path.exists(partial): problem("router.js ชี้ %s ที่ไม่มีอยู่จริง" % partial) for name in sorted(os.listdir("partials")): if name.endswith(".html") and "partials/" + name not in declared: NOTES.append("partials/%s ไม่มี route (เข้าถึงไม่ได้แต่ไม่พัง)" % name) def check_precache(): sw = read("sw.js") block = sw.split("const PRECACHE = [")[1].split("];")[0] urls = re.findall(r'"([^"]+)"', block) for url in urls: path = urllib.parse.unquote(url.replace("./", "", 1)) if not os.path.exists(path): problem("PRECACHE ชี้ไฟล์ที่ไม่มี: %s" % url) NOTES.append("PRECACHE: %d ไฟล์" % len(urls)) def check_versions(): sw = re.search(r'const VERSION = "([^"]+)"', read("sw.js")).group(1) version_js = re.search(r'window\.FARM_VERSION = "([^"]+)"', read("app/version.js")).group(1) version_json = json.loads(read("app/version.json"))["version"] shell = set(re.findall(r"\?v=([0-9][^\"&]*)", read("index.html"))) package = json.loads(read("package.json"))["version"] versions = {"sw.js": sw, "app/version.js": version_js, "app/version.json": version_json, "package.json": package} for key, value in versions.items(): if value != sw: problem("เวอร์ชันไม่ตรง: %s = %s แต่ sw.js = %s" % (key, value, sw)) if shell != {sw}: problem("index.html ?v= = %s แต่ sw.js = %s" % (sorted(shell), sw)) NOTES.append("version: %s" % sw) def check_shell(): shell = read("index.html") for needle, label in [ ('rel="manifest"', "ไม่มี "), ('name="theme-color"', "ไม่มี meta theme-color"), ('app/pwa.js', "ไม่มีสคริปต์ app/pwa.js"), ('app/router.js', "ไม่มีสคริปต์ app/router.js"), ('id="view"', "ไม่มี
"), ]: if needle not in shell: problem("index.html: %s" % label) manifest = json.loads(read("manifest.json")) for icon in manifest["icons"]: if not os.path.exists(icon["src"]): problem("manifest ชี้ไอคอนที่ไม่มี: %s" % icon["src"]) NOTES.append("manifest icons: %d" % len(manifest["icons"])) def check_emoji(): targets = ["index.html", "sw.js", "manifest.json"] for folder in ("partials", "app", "core", "assets/css"): for name in os.listdir(folder): if name.endswith((".html", ".js", ".css")): targets.append(os.path.join(folder, name)) for path in targets: for line_number, line in enumerate(read(path).splitlines(), 1): hit = EMOJI.search(line) if hit and hit.group(0) not in ALLOWED_SYMBOLS: problem("%s:%d มีอีโมจิ: %s" % (path, line_number, line.strip()[:60])) def main(): os.chdir(os.path.dirname(os.path.dirname(os.path.abspath(__file__)))) for check in (check_partial_links, check_routes, check_precache, check_versions, check_shell, check_emoji): check() for note in NOTES: print(" · " + note) if PROBLEMS: print("\nพบปัญหา %d จุด:" % len(PROBLEMS)) for item in PROBLEMS: print(" ✗ " + item) return 1 print("\nOK — SPA/PWA ผ่านการตรวจ static ทั้งหมด") return 0 if __name__ == "__main__": sys.exit(main())