feat: Add Font Awesome glyph support

Author: caksoylar

README.md

@@ -168,6 +168,7 @@ The following `source` values are currently supported:
 - `material`: [Google Material Symbols](https://fonts.google.com/icons) (use value in "Android" tab as `id`)
 - `tabler`: [Tabler Icons](https://tabler.io/icons) ("Outline" style, use icon name as `id`)
 - `phosphor`: [Phosphor Icons](https://phosphoricons.com) (use `<weight>/<name>` as `id`, e.g. `$$phosphor:bold/lock$$`)
+- `fa`: [Font Awesome](https://fontawesome.com/search?ic=free) (use `<type>/<name>` as `id` where `type` is `solid`, `regular` or `brands`, e.g. `$$fa:brands/apple$$`)
 
 Fetched SVGs will be [cached by default](CONFIGURATION.md#use_local_cache) to speed up future runs.
 

keymap_drawer/config.py

@@ -269,6 +269,7 @@ class KeySidePars(BaseModel):
             "mdil": "https://raw.githubusercontent.com/Pictogrammers/MaterialDesignLight/master/svg/{}.svg",
             "material": "https://fonts.gstatic.com/s/i/short-term/release/materialsymbolsoutlined/{}/default/48px.svg",
             "phosphor": "https://unpkg.com/@phosphor-icons/core/assets/{}.svg",
+            "fa": "https://unpkg.com/@fortawesome/fontawesome-free/svgs/{}.svg",
         },
     )
 

keymap_drawer/draw/glyph.py

@@ -83,13 +83,13 @@ def _fetch_glyphs(self, names: Iterable[str]) -> dict[str, str]:
             if ":" in name:  # templated source:ID format
                 source, glyph_id = name.split(":", maxsplit=1)
                 if templated_url := self.cfg.glyph_urls.get(source):
-                    if source == "phosphor":  # special case to handle variants
-                        assert "/" in glyph_id, "phosphor glyphs should be in `$$phosphor:<type>/<id>$$` format"
-                        ph_type, ph_id = glyph_id.split("/", maxsplit=1)
-                        ph_type = ph_type.lower()
-                        glyph_id = f"{ph_type}/{ph_id}"
-                        if ph_type != "regular":
-                            glyph_id += f"-{ph_type}"
+                    if source in ("phosphor", "fa"):  # special case to handle variants
+                        assert "/" in glyph_id, "phosphor/fa glyphs should be in `$$<source>:<type>/<id>$$` format"
+                        sub_type, sub_id = glyph_id.split("/", maxsplit=1)
+                        sub_type = sub_type.lower()
+                        glyph_id = f"{sub_type}/{sub_id}"
+                        if source == "phosphor" and sub_type != "regular":
+                            glyph_id += f"-{sub_type}"
                     urls.append(templated_url.format(glyph_id))
             if url := self.cfg.glyph_urls.get(name):  # source only
                 urls.append(url)