day-piece-webview 0.4.4

An embedded native web view for Day apps: remote pages and bundled sites
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64

#!/usr/bin/env python3
# Copyright © The Daybrite Project
# SPDX-License-Identifier: MPL-2.0
"""Require complete, equally sized renderer pairs and intact screenshot metadata."""
import argparse
import hashlib
import json
from pathlib import Path
import struct

SCENES = ("bundled", "resources")
ENGINES = ("webview", "servo")
COMPARISONS = {f"renderer-{scene}-{engine}" for scene in SCENES for engine in ENGINES}


def verify(root, target):
    directory = Path(root) / target
    index = json.loads((directory / "gallery.json").read_text())
    if index.get("target") != target:
        raise ValueError("Screenshot index target does not match the CI target")
    captures = {}
    for entry in index["screenshots"]:
        if not entry["shot"].startswith("renderer-"):
            continue
        key = (entry["shot"], entry["variant"])
        if key in captures:
            raise ValueError(f"Duplicate comparison capture: {key}")
        captures[key] = entry
        # Pixel-proof captures intentionally have no publication metadata and stay out of
        # the website gallery. Still check their bytes and dimensions below.
        if entry["shot"] in COMPARISONS and (not entry.get("title") or not entry.get("caption")):
            raise ValueError(f"Missing localized publication metadata: {key}")
        path = directory / entry["variant"] / entry["file"]
        data = path.read_bytes()
        if data[:8] != b"\x89PNG\r\n\x1a\n" or data[12:16] != b"IHDR":
            raise ValueError(f"Invalid PNG: {path}")
        dimensions = struct.unpack(">II", data[16:24])
        if min(dimensions) == 0 or dimensions != (entry["width"], entry["height"]):
            raise ValueError(f"Screenshot dimensions disagree with the index: {path}")
        if len(data) != entry["bytes"] or hashlib.sha256(data).hexdigest() != entry["sha256"]:
            raise ValueError(f"Screenshot bytes disagree with the index: {path}")
    variants = {variant for shot, variant in captures if shot in COMPARISONS}
    if not variants:
        raise ValueError("No renderer comparison captures")
    for variant in variants:
        for scene in SCENES:
            pair = []
            for engine in ENGINES:
                key = (f"renderer-{scene}-{engine}", variant)
                if key not in captures:
                    raise ValueError(f"Missing comparison capture: {key}")
                pair.append(captures[key])
            fields = ("width", "height", "locale", "theme")
            if any(pair[0].get(field) != pair[1].get(field) for field in fields):
                raise ValueError(f"Comparison conditions differ: {scene}/{variant}")
    print(f"Verified {len(SCENES) * len(variants)} WebView/Servo pairs for {target}")


if __name__ == "__main__":
    parser = argparse.ArgumentParser(description=__doc__)
    parser.add_argument("root", type=Path)
    parser.add_argument("--target", required=True)
    arguments = parser.parse_args()
    verify(arguments.root, arguments.target)