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. Go to their website for a full list of icons. The slug version must be used for the icon_name
. The icons folder that accompanies the package has all the files. The package uses the latest verison of Simple Icons. It does not depend on the filesystem.
Installation
Install with pip install simpleicons
. Keep in mind that this is a fairly large package due to all the icons.
Usage
General Usage
The API can then be used as follows, where [ICON SLUG] is replaced by a slug:
from simpleicons.all import icons
# Get a specific icon by its slug as:
icons.get('[ICON SLUG]')
# For example:
icon = icons.get('simpleicons')
print(icon.__dict__)
"""
{
'title': 'Simple Icons',
'slug': 'simpleicons',
'hex': '111111',
'source': 'https://simpleicons.org/',
'svg': '<svg role="img" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg">...</svg>',
'path': 'M12 12v-1.5c-2.484 ...',
'guidelines': 'https://simpleicons.org/styleguide',
'license': {
type: '...',
url: 'https://example.com/'
}
}
"""
NOTE: The guidelines
entry will be None
if we do not yet have guidelines data for the icon.
NOTE: The license
entry will be None
if we do not yet have license data for the icon.
Alternatively you can import the needed icons individually, where [ICON SLUG] is replaced by a slug:
# Import a specific icon by its slug as:
from simpleicons.icons import si_[ICON_SLUG]
# For example:
from simpleicons.icons import si_simpleicons
Lastly, the icons
object is also enumerable. This is useful if you want to do a computation on every icon:
from simpleicons.all import icons
for (key, icon in icons) {
# do stuff
}
XML
The XML for each icon can be easily manipulated with either of two functions:
Icon.get_xml(**attrs) -> ElementTree
from simpleicons.icons import si_simpleicons
# blue logo, adds the fill attribute: <svg fill="blue"></svg>
si_simpleicons.get_xml(fill="blue")
Icon.get_xml_bytes(**attrs) -> bytes
from simpleicons.icons import si_simpleicons
si_simpleicons.get_xml_bytes(fill="blue")
Image
In order to use this, you must install the extras: pip install -e simpleicons[imaging]
. 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.icons import si_simpleicons
from simpleicons.image import icon_to_image
xml_bytes = si_simpleicons.get_xml_bytes(fill="blue")
# black background and 5x scale
img = icon_to_image(xml_bytes, bg=0x000000, scale=(5, 5))
# manipulate PIL Image
img.putalpha(32)
img.save("simpleicons_blue.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
File details
Details for the file simpleicons-7.21.0.tar.gz
.
File metadata
- Download URL: simpleicons-7.21.0.tar.gz
- Upload date:
- Size: 3.5 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/1.2.2 CPython/3.10.8 Linux/5.15.0-1023-azure
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 5b6cad4610d8dc76e9b163d93ff0d18ef31e6a6201d30a69f33333108267c375 |
|
MD5 | e4fac0c1cb06927d9ea83d230a4bafd8 |
|
BLAKE2b-256 | 883fe8ba6586158e1e6c1b3fe760f27442aeccd486ac091ffa79f7acfbf997ec |
File details
Details for the file simpleicons-7.21.0-py3-none-any.whl
.
File metadata
- Download URL: simpleicons-7.21.0-py3-none-any.whl
- Upload date:
- Size: 3.5 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/1.2.2 CPython/3.10.8 Linux/5.15.0-1023-azure
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | f7fc8dad1646c76a81d925550ad601a1d02817c814f4443b2e9addf573b9f631 |
|
MD5 | d1af43331e55c828c177e687a8f6003c |
|
BLAKE2b-256 | d040fe3e2439a7b8e00e0c397983187b791d8a14adc9946f204f880558af8765 |