Metadata-Version: 2.1
Name: tkfeather
Version: 1.0.0
Summary: Feather icons for tkinter
Home-page: https://github.com/JRiggles/tkfeather
License: MIT
Keywords: tkinter,icons,Feather
Author: John Riggles
Author-email: jriggles@icloud.com
Requires-Python: >=3.12,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: pillow (>=9.2.0)
Project-URL: Repository, https://github.com/JRiggles/tkfeather
Description-Content-Type: text/markdown

# tkfeather <img src="tkfeather-white.svg" width=48>

#### tkinter support for [feather icons](https://feathericons.com)

## Latest Changes
Current version: 1.0.0-rc1

- Initial release

## Usage

### Import

`from tkfeather import Feather`

Initialization:

`Feather(name: str, size: int [optional])`

### Args
- `name: str` - The name of the Feather icon
- `size: int [optional]` - The size of the icon image in pixels, square
(default: 24)

> Note: Sizes smaller than 24px are allowed but aren't recommended as the
icon will become blurred
>
> The minimum allowed `size` is 1, and the maximum allowed `size` is 1024

### Properties
- `Feather.icon` - an `ImageTk.PhotoImage` object for the given Feather
icon

### Class Methods
- `Feather.icons_available()` returns a list with the names of all
available Feather Icons

### Exceptions
- Passing a `size` value  outside the range of 1 to 1024 will raise a
`ValueError`
- Trying to use an icon that doesn't exist will raise a `FileNotFoundError`

### Example
You must maintain a reference to the Feather instance in a variable in
order to keep the image from being garbage-collected:

```python
# this works
feather = Feather('home')
label = tk.Label(parent, image=feather.icon)
label.pack()
```

If you don't maintain a reference to the image, it won't appear!

```python
# this doesn't work - the label will have no image
label = tk.Label(parent, image=Feather('home').icon)
label.pack()
```

### Installation

`pip install tkfeather`

### Packaged Dependencies

- PNG Icons
- Pillow >= 9.2.0

##

### Acknowledgements

Based on **Feather Icons** originally created by Cole Bemis

- https://feathericons.com
- https://github.com/feathericons/feather

Under MIT License

