Metadata-Version: 2.4
Name: ttkbootstrap-icons-ion
Version: 0.1.0
Summary: Ion Icons (font-based) provider for ttkbootstrap-icons
Author: Israel Dryer
License-Expression: MIT
Project-URL: Homepage, https://github.com/israel-dryer/ttkbootstrap-icons
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: Pillow>=9.1
Requires-Dist: ttkbootstrap-icons>=1.0.0

# Ionicons (ttkbootstrap-icons-ion)

Ion Icons provider for ttkbootstrap-icons.

## Install

```bash
pip install ttkbootstrap-icons-ion
```

Requires `ttkbootstrap-icons` (installed automatically) and `Pillow`.

## Info

- Name: Ionicons v2 (font-based)
- Icon Version (preset default): 2.0.1
- Source: https://ionic.io/ionicons (CDN: https://cdnjs.com/libraries/ionicons)

## License and Attribution

- Icons and code: MIT License
- Attribution: Ionicons — https://ionic.io/ionicons

## Usage

```python
import tkinter as tk
from ttkbootstrap_icons_ion import IonIcon

root = tk.Tk()

icon = IonIcon("home", size=24, color="#198754")
tk.Button(root, image=icon.image).pack()

root.mainloop()
```

This package registers a provider entry point, so the base icon previewer will automatically discover it.

## Generate assets (developer)

```bash
# Preset for Ionicons v2 font via cdnjs (automatically fetches CSS for readable names)
ttkicons-ion-build --preset ion2 --version 2.0.1

# Or direct URL
ttkicons-ion-build --font-url https://cdnjs.cloudflare.com/ajax/libs/ionicons/2.0.1/fonts/ionicons.ttf
```

Readable names
- The builder will try to fetch the matching CSS (ionicons.min.css) to map class names (e.g., `.ion-alert`) to codepoints.
- You can explicitly pass a CSS source:

```bash
ttkicons-ion-build \
  --font-url https://cdnjs.cloudflare.com/ajax/libs/ionicons/2.0.1/fonts/ionicons.ttf \
  --css-url  https://cdnjs.cloudflare.com/ajax/libs/ionicons/2.0.1/css/ionicons.min.css
```

Omitting metadata uses TTF-only extraction (needs `fonttools`).
