%global _empty_manifest_terminate_build 0
Name: python-simpleicons
Version: 7.21.0
Release: 1
Summary: Use a wide-range of icons derived from the simple-icons/simple-icons repo in python.
License: MIT
URL: https://github.com/sachinraja/simple-icons-py
Source0: https://mirrors.aliyun.com/pypi/web/packages/88/3f/e8ba6586158e1e6c1b3fe760f27442aeccd486ac091ffa79f7acfbf997ec/simpleicons-7.21.0.tar.gz
BuildArch: noarch
Requires: python3-reportlab
Requires: python3-Pillow
Requires: python3-svglib
Requires: python3-semantic-version
Requires: python3-requests
Requires: python3-GitPython
%description
simpleicons
[](https://github.com/psf/black)
Use a wide-range of icons derived from the [simple-icons](https://github.com/simple-icons/simple-icons) repo in python. Go to [their website](https://simpleicons.org/) 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](https://github.com/simple-icons/simple-icons/releases/latest). 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:
```py
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': '',
'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:
```py
# 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:
```py
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`
```py
from simpleicons.icons import si_simpleicons
# blue logo, adds the fill attribute:
si_simpleicons.get_xml(fill="blue")
```
`Icon.get_xml_bytes(**attrs) -> bytes`
```py
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`:
```py
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")
```
%package -n python3-simpleicons
Summary: Use a wide-range of icons derived from the simple-icons/simple-icons repo in python.
Provides: python-simpleicons
BuildRequires: python3-devel
BuildRequires: python3-setuptools
BuildRequires: python3-pip
%description -n python3-simpleicons
simpleicons
[](https://github.com/psf/black)
Use a wide-range of icons derived from the [simple-icons](https://github.com/simple-icons/simple-icons) repo in python. Go to [their website](https://simpleicons.org/) 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](https://github.com/simple-icons/simple-icons/releases/latest). 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:
```py
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': '',
'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:
```py
# 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:
```py
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`
```py
from simpleicons.icons import si_simpleicons
# blue logo, adds the fill attribute:
si_simpleicons.get_xml(fill="blue")
```
`Icon.get_xml_bytes(**attrs) -> bytes`
```py
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`:
```py
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")
```
%package help
Summary: Development documents and examples for simpleicons
Provides: python3-simpleicons-doc
%description help
simpleicons
[](https://github.com/psf/black)
Use a wide-range of icons derived from the [simple-icons](https://github.com/simple-icons/simple-icons) repo in python. Go to [their website](https://simpleicons.org/) 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](https://github.com/simple-icons/simple-icons/releases/latest). 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:
```py
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': '',
'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:
```py
# 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:
```py
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`
```py
from simpleicons.icons import si_simpleicons
# blue logo, adds the fill attribute:
si_simpleicons.get_xml(fill="blue")
```
`Icon.get_xml_bytes(**attrs) -> bytes`
```py
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`:
```py
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")
```
%prep
%autosetup -n simpleicons-7.21.0
%build
%py3_build
%install
%py3_install
install -d -m755 %{buildroot}/%{_pkgdocdir}
if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi
if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi
if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi
if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi
pushd %{buildroot}
if [ -d usr/lib ]; then
find usr/lib -type f -printf "\"/%h/%f\"\n" >> filelist.lst
fi
if [ -d usr/lib64 ]; then
find usr/lib64 -type f -printf "\"/%h/%f\"\n" >> filelist.lst
fi
if [ -d usr/bin ]; then
find usr/bin -type f -printf "\"/%h/%f\"\n" >> filelist.lst
fi
if [ -d usr/sbin ]; then
find usr/sbin -type f -printf "\"/%h/%f\"\n" >> filelist.lst
fi
touch doclist.lst
if [ -d usr/share/man ]; then
find usr/share/man -type f -printf "\"/%h/%f.gz\"\n" >> doclist.lst
fi
popd
mv %{buildroot}/filelist.lst .
mv %{buildroot}/doclist.lst .
%files -n python3-simpleicons -f filelist.lst
%dir %{python3_sitelib}/*
%files help -f doclist.lst
%{_docdir}/*
%changelog
* Thu Jun 08 2023 Python_Bot - 7.21.0-1
- Package Spec generated
simpleicons