Metadata-Version: 2.1
Name: pyheroicons
Version: 1.0.4
Summary: Ready to use Tailwindcss Heroicons components for Python
Author-email: Burak Yilmaz <burakyilmaz321@gmail.com>
Project-URL: Homepage, https://github.com/burakyilmaz321/pyheroicons
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: dev
Requires-Dist: black; extra == "dev"
Requires-Dist: isort; extra == "dev"
Requires-Dist: ruff; extra == "dev"
Requires-Dist: pytest; extra == "dev"
Requires-Dist: tox; extra == "dev"
Requires-Dist: tox-gh-actions; extra == "dev"

# `pyheroicons`

[![PyPI version](https://badge.fury.io/py/pyheroicons.svg)](https://pypi.org/project/pyheroicons)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Python Versions](https://img.shields.io/pypi/pyversions/pyheroicons)](https://pypi.org/project/pyheroicons)
[![Package Status](https://img.shields.io/pypi/status/pyheroicons)](https://pypi.org/project/pyheroicons)
[![CI Build](https://github.com/burakyilmaz321/pyheroicons/actions/workflows/lint_and_test.yml/badge.svg)](https://github.com/burakyilmaz321/pyheroicons/actions/workflows/lint_and_test.yml)

`pyheroicons` is a Python library that offers a convenient interface to the [Tailwind CSS Heroicons](https://heroicons.com/) icon set. This library allows developers to easily integrate Heroicons into Python-based web frameworks such as Django, Flask, or FastAPI by generating SVG icon template strings.

## Installation

To install `pyheroicons`, simply use pip:

```bash
pip install pyheroicons
```

## Usage

Import `heroicon` function from `pyheroicons` and use it to generate icon templates:

```python
from pyheroicons import heroicon
```

## `heroicon` API

- **name** The name of the Heroicon (e.g., "academic-cap").
- **variant** The variant of the icon ("outline", "solid", "mini", or "micro").
- **cls** Optional. A CSS class to apply to the SVG icon.
- **strokewidth** Optional. The stroke width of the icon. <ins>Only applicable if the original SVG contains a stroke-width attribute. i.e. Only works for the "outline" variant.</ins>

## Example usage

```python
icon_svg = heroicon(name="academic-cap", variant="outline", cls="icon-class", strokewidth="2")
print(icon_svg)
```

## Keeping Up-to-Date

`pyheroicons` aims to stay up-to-date with the Heroicons library. When a new version of Heroicons is released, `pyheroicons` will also release a corresponding version to ensure compatibility.

| pyheroicons Version | Heroicons Version |
| ------------------- | ----------------- |
| 1.0.2               | 2.1.1             |

## Contributing

Contributions to `pyheroicons` are welcomed!

## License

`pyheroicons` is released under the MIT License.
