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.29.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.29.0
File Size Uploaded
simplepycons-1!16.29.0.tar.gz 2.6 MB Details

Built distribution (wheel)

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

Total release size: 7.9 MB

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

Download URL simplepycons-1!16.29.0.tar.gz
Size 2.6 MB
Tags Source
SHA-256 checksum
How to use checksums
b591e33dbbcecd3c223c1f2212d34cbfd6b1ce92523d22c8463a1421579d7cf8
BLAKE2b-256 checksum
How to use checksums
311a046800dc5566731fb213b7643c3d5b5f8903653b2828608ad8eb8dd6a289
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.29.0-py3-none-any.whl

Download URL simplepycons-1!16.29.0-py3-none-any.whl
Size 5.4 MB
Tags Python 3
SHA-256 checksum
How to use checksums
5ac14836665aa09499f597a91212023300e55096742fa5d8acf4760d7e20eda2
BLAKE2b-256 checksum
How to use checksums
f850735c2fa88078a410fb9be4d0c3cc73315c5098138991a2c4136663f45011
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.29.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