pixelsrc 0.2.0

Pixelsrc - GenAI-native pixel art format and compiler
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
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121

#!/usr/bin/awk -f
# Parse @demo annotations from Rust test files
# Output: TAB-separated records: DEMO<TAB>demo_path<TAB>title<TAB>description<TAB>cli<TAB>jsonl_path

BEGIN {
    in_demo = 0
    found_fn = 0
    demo = ""
    title = ""
    desc = ""
    cli = ""
    jsonl = ""
}

# Start of @demo annotation
/^[[:space:]]*\/\/\/[[:space:]]*@demo[[:space:]]/ {
    # Emit previous demo if pending
    if (length(demo) > 0 && length(jsonl) > 0) {
        printf "DEMO\t%s\t%s\t%s\t%s\t%s\n", demo, title, desc, cli, jsonl
    }
    in_demo = 1
    found_fn = 0
    demo = $0
    sub(/^[[:space:]]*\/\/\/[[:space:]]*@demo[[:space:]]*/, "", demo)
    title = ""
    desc = ""
    cli = ""
    jsonl = ""
    next
}

# Parse @title annotation
in_demo == 1 && /^[[:space:]]*\/\/\/[[:space:]]*@title[[:space:]]/ {
    title = $0
    sub(/^[[:space:]]*\/\/\/[[:space:]]*@title[[:space:]]*/, "", title)
    next
}

# Parse @description annotation
in_demo == 1 && /^[[:space:]]*\/\/\/[[:space:]]*@description[[:space:]]/ {
    desc = $0
    sub(/^[[:space:]]*\/\/\/[[:space:]]*@description[[:space:]]*/, "", desc)
    next
}

# Parse @cli annotation
in_demo == 1 && /^[[:space:]]*\/\/\/[[:space:]]*@cli[[:space:]]/ {
    cli = $0
    sub(/^[[:space:]]*\/\/\/[[:space:]]*@cli[[:space:]]*/, "", cli)
    next
}

# Regular doc comment (not @-prefixed) - use as description if no @description found
in_demo == 1 && found_fn == 0 && /^[[:space:]]*\/\/\/[[:space:]]/ {
    if (!/^[[:space:]]*\/\/\/[[:space:]]*@/) {
        # Non-annotation doc comment
        line = $0
        sub(/^[[:space:]]*\/\/\/[[:space:]]*/, "", line)
        if (length(title) == 0 && length(desc) == 0) {
            # First non-annotation comment becomes title
            title = line
        } else if (length(desc) == 0) {
            # Second becomes description start
            desc = line
        } else {
            # Append to description
            desc = desc " " line
        }
        next
    }
}

# Skip #[test] attribute
in_demo == 1 && /^[[:space:]]*#\[test\]/ {
    next
}

# Track function definition
in_demo == 1 && /^[[:space:]]*fn[[:space:]]+test_/ {
    found_fn = 1
    next
}

# Find include_str! with JSONL path (comes after fn)
in_demo == 1 && found_fn == 1 && /include_str!\(/ {
    if (/\.jsonl/) {
        jsonl = $0
        sub(/.*include_str!\([[:space:]]*"/, "", jsonl)
        sub(/".*/, "", jsonl)
        # Strip all leading ../ sequences to get path relative to project root
        while (jsonl ~ /^\.\.\//) {
            sub(/^\.\.\//, "", jsonl)
        }
        # We got everything - emit and reset
        # Use <EMPTY> placeholder for empty fields (bash read can't handle consecutive delimiters)
        if (length(demo) > 0) {
            out_title = (length(title) > 0) ? title : "<EMPTY>"
            out_desc = (length(desc) > 0) ? desc : "<EMPTY>"
            out_cli = (length(cli) > 0) ? cli : "<EMPTY>"
            printf "DEMO\t%s\t%s\t%s\t%s\t%s\n", demo, out_title, out_desc, out_cli, jsonl
        }
        in_demo = 0
        found_fn = 0
        demo = ""
    }
}

# Closing brace after function - reset if no jsonl found
in_demo == 1 && found_fn == 1 && /^[[:space:]]*\}/ {
    # Did not find include_str!, skip this demo
    in_demo = 0
    found_fn = 0
    demo = ""
}

END {
    # Emit any pending demo
    if (length(demo) > 0 && length(jsonl) > 0) {
        printf "DEMO\t%s\t%s\t%s\t%s\t%s\n", demo, title, desc, cli, jsonl
    }
}