Skip to main content

simplepycons

PyPI Simple Icons version Latest Simple Icons Release License pdm-managed

Python wrappers for simple-icons inspired by the wonderful work of sachinraja.

As latter project seems to be no longer maintained, this project starts as being compatible to simple-icons 13.x

Usage

The simplepycons namespace contains the following types:

  • Icon: The basic icon class, from which all Icons are inherited. It is abstract and hence cannot be inherited.
  • all_icons: A collection of all icons found.
  • IconFactory: A simple wrapper providing a callable interface and a prototype.

as well as a class for each icon provided.

So, you can run:

from simplepycons import all_icons, PythonIcon

icon1 = PythonIcon()
icon2 = all_icons.get_python_icon()
icon3 = all_icons["python"]

All calls should provide a new Icon instance of the python icon.

For all simple-icons, a get icon method is provided using the name of the icon.

An instance of Icon offers the following properties:

  • name (str): The name of the icon, i.e. the name of the simple-icon id.
  • original_file_name (str): The name of the file it was created from.
  • title (str): The name of the brand
  • primary_color (str): The primary color of the brand.
  • raw_svg (str): The RAW SVG graphics as string.
  • guidelines_url (str | None): The url to the usage guidelines (optional).
  • license (tuple[str | None, str | None]): The license as a tuple. The first element is the SPDX identifier, the second element is the URL to the license document (optional).
  • source (str): The source URL of the icon.
  • aliases (Iterable[str]): A list of aliases used as alternative titles

An instance of Icon offers the following methods:

  • svg_tree() (xml.ElementTree.Element): The SVG as XML Element
  • customize_svg(**svg_attr: str) (xml.ElementTree.Element): The SVG with custom attributes on the root node.
  • customize_svg_as_bytes(**svg_attr: str) (bytes): The SVG with custom attributes on the root node, converted to a bytes object.
  • customize_svg_as_str(**svg_attr: str) (str): The SVG with custom attributes on the root node, converted to string.
  • customize_svg_as_data_url_(**svg_attr: str) (str): The SVG with custom attributes on the root node, converted to a base64 encoded data url.

The svg_attr keyword arguments can be used to add any arbitrary svg attribute to the SVG root node. If fill is not used, the primary_color is used.

Metadata

Release files for simplepycons 1!16.30.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for simplepycons 1!16.30.0
File Size Uploaded
simplepycons-1!16.30.0.tar.gz 2.6 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for simplepycons 1!16.30.0
File Interpreter ABI Platform
simplepycons-1!16.30.0-py3-none-any.whl Python 3 none any Details

Total release size: 7.9 MB

Release files / simplepycons-1!16.30.0.tar.gz

Download URL simplepycons-1!16.30.0.tar.gz
Size 2.6 MB
Tags Source
SHA-256 checksum
How to use checksums
91718e302eb9a94673ea0c32fdffdc478d8de79c6aa2b0dc756e004aa9f7fd5c
BLAKE2b-256 checksum
How to use checksums
9a643901eb9f6544debfee3539eb48d3cb7431e218c9ad3a854c7a0b817dc463
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via pdm/2.29.0 CPython/3.14.7 Linux/6.17.0-1022-azure

Release files / simplepycons-1!16.30.0-py3-none-any.whl

Download URL simplepycons-1!16.30.0-py3-none-any.whl
Size 5.4 MB
Tags Python 3
SHA-256 checksum
How to use checksums
34a6b767d42265673465a5b7c490d62dd25dd87532e84bd95a1314e7fb9e0a52
BLAKE2b-256 checksum
How to use checksums
06e8ac3e6f3cecd5bfb94315c44a6eeaef01917eaded189ac6ec987071c5b62e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via pdm/2.29.0 CPython/3.14.7 Linux/6.17.0-1022-azure

Release history Release notifications | RSS feed

This release

1!16.30.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page