nerd_gtk_icons 0.1.1

Nerd Fonts SVG icons as GResource for GTK4/Adwaita Rust applications.
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
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160

import argparse
import os
import shutil
import re
import fontforge
import json

# ----------------------------
# CLI
# ----------------------------

parser = argparse.ArgumentParser(
    description="Export Nerd Fonts to GTK4 symbolic icons + GResource"
)

parser.add_argument("font", help="Path to the TTF/OTF font file")

parser.add_argument(
    "-o",
    "--output",
    default="resources",
    help="Output root directory (default: resources)"
)

# ----------------------------
# Helpers
# ----------------------------

def normalize_name(name: str) -> str:
    """
    Convert Nerd Font glyph names into GTK-friendly icon names.
    """
    name = name.lower()
    name = name.replace("_", "-")
    name = re.sub(r"[^a-z0-9\-]", "-", name)
    name = re.sub(r"-+", "-", name).strip("-")

    return f"nf-{name}-symbolic"


def clean_svg(path: str):
    """
    Make SVG compatible with GTK symbolic icon style.
    """
    with open(path, "r", encoding="utf-8") as f:
        svg = f.read()

    svg = re.sub(r'fill="[^"]+"', 'fill="currentColor"', svg)
    svg = re.sub(r'<\?xml.*?\?>', '', svg)
    svg = re.sub(r'<!DOCTYPE.*?>', '', svg)

    with open(path, "w", encoding="utf-8") as f:
        f.write(svg.strip())


# ----------------------------
# Main
# ----------------------------

if __name__ == "__main__":
    args = parser.parse_args()

    font = fontforge.open(args.font)

    # Output paths
    icons_dir = os.path.join(args.output, "icons")
    xml_path = os.path.join(args.output, "icons.gresource.xml")
    json_path = os.path.join(args.output, "metadata.json")

    # Clean output directory
    if os.path.exists(args.output):
        shutil.rmtree(args.output)

    os.makedirs(icons_dir, exist_ok=True)

    icons = []

    # ----------------------------
    # DEDUP STORAGE (IMPORTANT FIX)
    # ----------------------------
    seen_names = set()

    # ----------------------------
    # EXPORT GLYPHS
    # ----------------------------

    for glyph in font.glyphs():
        name = glyph.glyphname

        # Skip invalid glyphs
        if (
            not glyph.isWorthOutputting()
            or not name
            or name.startswith(".")
            or name.startswith("uni")
            or name.startswith("u")
        ):
            continue

        safe_name = normalize_name(name)

        if not safe_name:
            continue

        # ❗ prevent duplicate SVG exports (MAIN FIX)
        if safe_name in seen_names:
            continue

        seen_names.add(safe_name)

        codepoint = glyph.unicode
        codepoint_hex = f"{codepoint:04X}" if codepoint != -1 else None

        filename = os.path.join(icons_dir, f"{safe_name}.svg")

        try:
            glyph.export(filename)
            clean_svg(filename)
        except Exception:
            continue

        icons.append({
            "code": codepoint_hex,
            "name": safe_name,
            "file": f"resources/icons/{safe_name}.svg",
            "resource_path": f"/com/nerd/icons/{safe_name}"
        })

    # ----------------------------
    # GENERATE GRESOURCE XML
    # ----------------------------

    xml = [
        '<?xml version="1.0" encoding="UTF-8"?>',
        '<gresources>',
        '  <gresource prefix="/com/nerd">'
    ]

    # stable ordering (optional but good practice)
    for icon in sorted(icons, key=lambda x: x["name"]):
        xml.append(f'    <file>icons/{icon["name"]}.svg</file>')

    xml += [
        '  </gresource>',
        '</gresources>'
    ]

    with open(xml_path, "w", encoding="utf-8") as f:
        f.write("\n".join(xml))

    # ----------------------------
    # EXPORT METADATA JSON
    # ----------------------------

    with open(json_path, "w", encoding="utf-8") as f:
        json.dump(icons, f, ensure_ascii=False, indent=4)

    print(f"✔ Exported {len(icons)} icons")
    print(f"✔ Icons directory: {icons_dir}")
    print(f"✔ GResource XML: {xml_path}")