Use a wide-range of icons derived from the simple-icons/simple-icons repo in python.
Project description
simpleicons
Use a wide-range of icons derived from the simple-icons repo in python.
Installation
Install with pip install simpleicons
. Keep in mind that this is a fairly large package due to all the icons (a couple of megabytes).
XML
The XML for each icon can be easily manipulated with either of two functions:
get_xml(icon_name: str, **attrs) -> ElementTree
from simpleicons.icon_xml import get_xml
# blue logo (simply adds <svg fill="blue"></svg>)
get_xml("github", fill="blue")
get_xml_bytes(icon_name: str, **attrs) -> bytes
from simpleicons.icon_xml import get_xml_bytes
get_xml_bytes("github", fill="blue")
To simply get the unparsed XML string for each icon, use get_str(icon_name: str) -> str
:
from simpleicons.icon_xml import get_str
get_str("github")
This string representation will allow for quick implementation in web pages, however it cannot be manipulated. Use get_xml_bytes
for easy web page implementation alongside manipulation.
Image
Icons can be converted to PIL Images with icon_to_image(icon_xml: bytes, bg: int=0xffffff, scale: Tuple[int, int]=(1, 1)) -> Image
:
from simpleicons.icon_xml import get_xml_bytes
from simpleicons.image import icon_to_image
xml_bytes = get_xml_bytes("github", fill="blue")
# black background and x5 scale
img = icon_to_image(xml_bytes, bg=0x000000, scale=(5, 5))
# manipulate PIL Image
img.putalpha(32)
img.save("github.png")
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for simpleicons-4.4.0.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 511cc1464d0d7730e2dc8f2634099187f63843dfc81c1aec76a96686c0671f29 |
|
MD5 | e88eff4f14663a5910ec87025acd736e |
|
BLAKE2b-256 | 1fa545608b0dc56a1b12982efd9da6867de164c228c0972bb4e1362a1e99ccc8 |