embedded-3dgfx 0.3.0

3D graphics rendering for embedded systems (fork of embedded-gfx by Kezii)
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
65
66
67
68
69

#!/usr/bin/env python3
"""Guard against obvious heap allocation calls in frame-path functions."""

from __future__ import annotations

import re
import sys
from pathlib import Path

FRAME_FUNCS = (
    "record",
    "record_with_fallback",
    "record_with_degradation",
    "execute",
)

FORBIDDEN_PATTERNS = (
    r"(?<!heapless::)\bVec::new\(",
    r"\bString::new\(",
    r"\bboxed::",
    r"\bBox<",
    r"\bformat!\(",
)


def extract_block(content: str, fn_name: str) -> str:
    match = re.search(rf"(?m)^\s*pub fn\s+{re.escape(fn_name)}(?:<|\s*\()", content)
    if not match:
        return ""
    idx = match.start()
    start = content.rfind("\n", 0, idx) + 1
    brace = content.find("{", match.end())
    if brace < 0:
        return ""
    depth = 0
    for i in range(brace, len(content)):
        ch = content[i]
        if ch == "{":
            depth += 1
        elif ch == "}":
            depth -= 1
            if depth == 0:
                return content[start : i + 1]
    return ""


def main() -> int:
    lib = Path("src/lib.rs")
    text = lib.read_text(encoding="utf-8")
    failures: list[str] = []
    for fn_name in FRAME_FUNCS:
        block = extract_block(text, fn_name)
        if not block:
            failures.append(f"missing frame function: {fn_name}")
            continue
        for pat in FORBIDDEN_PATTERNS:
            if re.search(pat, block):
                failures.append(f"{fn_name}: matches forbidden pattern {pat}")

    if failures:
        for line in failures:
            print(f"::error::{line}", file=sys.stderr)
        return 1
    print("no-alloc frame path guard passed")
    return 0


if __name__ == "__main__":
    raise SystemExit(main())