ernie-renderer 0.1.0.dev196__tar.gz → 0.1.0.dev266__tar.gz

ernie_renderer-0.1.0.dev266/.clang-format

@@ -0,0 +1,11 @@
+BasedOnStyle: LLVM
+IndentWidth: 4
+ColumnLimit: 70
+PointerAlignment: Left
+ReferenceAlignment: Left
+BreakBeforeBraces: Attach
+AllowShortFunctionsOnASingleLine: Empty
+AllowShortIfStatementsOnASingleLine: Never
+SortIncludes: CaseSensitive
+IncludeBlocks: Preserve
+SpacesBeforeTrailingComments: 2

ernie_renderer-0.1.0.dev266/.cmake-format.yaml

@@ -0,0 +1,11 @@
+format:
+  line_width: 70
+  tab_size: 4
+  max_subgroups_hwrap: 2
+  max_pargs_hwrap: 6
+  separate_ctrl_name_with_space: false
+  separate_fn_name_with_space: false
+  dangle_parens: false
+
+markup:
+  enable_markup: false

ernie_renderer-0.1.0.dev266/.github/scripts/ci_metrics.py

@@ -0,0 +1,166 @@
+# SPDX-License-Identifier: BSD-3-Clause
+"""One CI run's metrics for github-action-benchmark
+(customSmallerIsBetter): the run's wall time, each successful job's
+time and its build and test steps' from the Actions API, and from the
+jobs' Ninja logs their compile time, compile count and ccache miss
+rate.
+
+    export GH_TOKEN=... GITHUB_REPOSITORY=owner/repo
+    python ci_metrics.py RUN_ID LOG_DIR OUTPUT
+
+LOG_DIR holds one directory per job's artifact (ninja-log-<job>), each
+with the build's .ninja_log and, where the job uses ccache,
+ccache-stats.tsv (`ccache --print-stats`).
+"""
+
+import json
+import os
+import sys
+import urllib.request
+from datetime import datetime
+from pathlib import Path
+
+# The steps whose times are worth tracking on their own: building,
+# testing, wheels and packages.
+STEPS = (
+    "Build",
+    "Test on lavapipe",
+    "Build the packages",
+    "Run pypa/cibuildwheel",
+)
+
+
+def api(path):
+    repository = os.environ["GITHUB_REPOSITORY"]
+    request = urllib.request.Request(
+        f"https://api.github.com/repos/{repository}/{path}",
+        headers={
+            "Authorization": f"Bearer {os.environ['GH_TOKEN']}",
+            "Accept": "application/vnd.github+json",
+        },
+    )
+    with urllib.request.urlopen(request) as response:
+        return json.load(response)
+
+
+def parse(stamp):
+    return datetime.fromisoformat(stamp.replace("Z", "+00:00"))
+
+
+def seconds(start, end):
+    return (parse(end) - parse(start)).total_seconds()
+
+
+def metric(name, unit, value):
+    return {"name": name, "unit": unit, "value": round(value, 2)}
+
+
+def run_metrics(run_id):
+    run = api(f"actions/runs/{run_id}")
+    metrics = [
+        metric(
+            "CI: wall time",
+            "min",
+            seconds(run["run_started_at"], run["updated_at"]) / 60,
+        )
+    ]
+    jobs = api(f"actions/runs/{run_id}/jobs?per_page=100")["jobs"]
+    for job in jobs:
+        if job["conclusion"] != "success" or not job["completed_at"]:
+            continue
+        name = job["name"]
+        metrics.append(
+            metric(
+                f"{name}: job",
+                "min",
+                seconds(job["started_at"], job["completed_at"]) / 60,
+            )
+        )
+        for step in job.get("steps", []):
+            if step["conclusion"] == "success" and step[
+                "name"
+            ].startswith(STEPS):
+                label = (
+                    "wheel build"
+                    if step["name"].startswith(
+                        "Run pypa/cibuildwheel"
+                    )
+                    else step["name"]
+                )
+                duration = (
+                    seconds(step["started_at"], step["completed_at"])
+                    / 60
+                )
+                metrics.append(
+                    metric(f"{name}: {label}", "min", duration)
+                )
+    return metrics
+
+
+def ninja_metrics(job, log):
+    """Compile time and count from a .ninja_log: a "# ninja log vN"
+    header, then a line per output (start and end in ms, mtime,
+    output, hash), the last of an output rebuilt counting."""
+    outputs = {}
+    for line in log.read_text().splitlines():
+        fields = line.split("\t")
+        if line.startswith("#") or len(fields) < 4:
+            continue
+        outputs[fields[3]] = int(fields[1]) - int(fields[0])
+    compiles = [
+        ms
+        for output, ms in outputs.items()
+        if output.endswith((".o", ".obj"))
+    ]
+    if not compiles:
+        return []
+    return [
+        metric(f"{job}: compile time", "min", sum(compiles) / 60000),
+        metric(f"{job}: compiles", "files", len(compiles)),
+    ]
+
+
+def ccache_metrics(job, stats):
+    """The compiler cache's miss rate, from `ccache --print-stats`
+    (key, tab, value per line)."""
+    values = dict(
+        line.split("\t", 1)
+        for line in stats.read_text().splitlines()
+        if "\t" in line
+    )
+    hits = int(values.get("direct_cache_hit", 0)) + int(
+        values.get("preprocessed_cache_hit", 0)
+    )
+    misses = int(values.get("cache_miss", 0))
+    if hits + misses == 0:
+        return []
+    return [
+        metric(
+            f"{job}: ccache miss rate",
+            "%",
+            100 * misses / (hits + misses),
+        )
+    ]
+
+
+def main():
+    run_id, log_dir, output = (
+        sys.argv[1],
+        Path(sys.argv[2]),
+        Path(sys.argv[3]),
+    )
+    metrics = run_metrics(run_id)
+    for artifact in sorted(log_dir.glob("ninja-log-*")):
+        job = artifact.name.removeprefix("ninja-log-")
+        if (artifact / ".ninja_log").exists():
+            metrics += ninja_metrics(job, artifact / ".ninja_log")
+        if (artifact / "ccache-stats.tsv").exists():
+            metrics += ccache_metrics(
+                job, artifact / "ccache-stats.tsv"
+            )
+    output.write_text(json.dumps(metrics, indent=2))
+    print(f"{len(metrics)} metrics written to {output}")
+
+
+if __name__ == "__main__":
+    main()

ernie_renderer-0.1.0.dev266/.github/scripts/debug-windows.sh

@@ -0,0 +1,36 @@
+#!/usr/bin/env bash
+# SPDX-License-Identifier: BSD-3-Clause
+#
+# Runs a program under the Windows debugger with full page heap, so a
+# heap overrun stops at the write that makes it rather than at a later
+# free, and prints the call stack where it stopped. Exits with failure,
+# as it runs only to explain one.
+#
+#     debug-windows.sh SYMBOL_DIR PROGRAM [ARGUMENT...]
+set -uo pipefail
+
+symbols=$1
+program=$2
+shift 2
+debuggers="/c/Program Files (x86)/Windows Kits/10/Debuggers/x64"
+if [ ! -x "$debuggers/cdb.exe" ]; then
+    echo "No Windows debugger at $debuggers"
+    exit 1
+fi
+image=$(basename "$program")
+echo "Debugging $program $*"
+
+"$debuggers/gflags.exe" //p //enable "$image" //full
+commands="$RUNNER_TEMP/cdb-commands.txt"
+cat > "$commands" <<'EOF'
+.lines
+sxe -c ".echo *** Access violation; .ecxr; kn 60; q" av
+sxe -c ".echo *** Heap corruption; .ecxr; kn 60; q" c0000374
+sxe -c ".echo *** Break; kn 60; q" bpe
+g
+EOF
+timeout 1800 "$debuggers/cdb.exe" -G -y "$(cygpath -w "$symbols")" \
+    -cf "$(cygpath -w "$commands")" "$(cygpath -w "$program")" "$@" \
+    < /dev/null
+"$debuggers/gflags.exe" //p //disable "$image"
+exit 1

ernie_renderer-0.1.0.dev266/.github/scripts/install-lavapipe-windows.sh

@@ -0,0 +1,32 @@
+#!/usr/bin/env bash
+# SPDX-License-Identifier: BSD-3-Clause
+#
+# Mesa's lavapipe, the software Vulkan driver, on a Windows runner:
+# mesa-dist-win's build of it and LunarG's Vulkan loader, each checked
+# against its digest. The driver is registered where the loader looks
+# for drivers, as the loader ignores VK_DRIVER_FILES in an elevated
+# process, as the runner's are. The loader's directory goes on PATH
+# (GITHUB_PATH) for later steps.
+set -euo pipefail
+
+# 26.2.4 or later: earlier releases free llvmpipe's memory on Windows
+# with free() where _aligned_malloc() allocated it, which corrupts the
+# heap at every vkFreeMemory.
+mesa_version=26.2.4
+mesa_sha256=351fc8c8b695878ffb3eaa044b3ead08672a48b1a045e3c3e3975811df0f6695
+loader_version=1.4.363.0
+loader_sha256=a25a927aa8b9f0371048f1861cf88ac3b9bc9b1fb332c42d897c8ab32695769a
+
+vulkan="$RUNNER_TEMP/vulkan"
+mkdir -p "$vulkan"
+cd "$vulkan"
+curl -fsSL -o mesa.7z "https://github.com/pal1000/mesa-dist-win/releases/download/$mesa_version/mesa3d-$mesa_version-release-msvc.7z"
+curl -fsSL -o loader.zip "https://sdk.lunarg.com/sdk/download/$loader_version/windows/VulkanRT-X64-$loader_version-Components.zip"
+echo "$mesa_sha256  mesa.7z" | sha256sum -c -
+echo "$loader_sha256  loader.zip" | sha256sum -c -
+7z x -y -omesa mesa.7z > /dev/null
+7z x -y -oloader loader.zip > /dev/null
+cp loader/*/x64/vulkan-1.dll mesa/x64/
+cygpath -w "$vulkan/mesa/x64" >> "$GITHUB_PATH"
+reg add 'HKLM\SOFTWARE\Khronos\Vulkan\Drivers' //f //t REG_DWORD //d 0 \
+    //v "$(cygpath -w "$vulkan/mesa/x64/lvp_icd.x86_64.json")"