Metadata-Version: 2.4
Name: dash-favicon-plugin
Version: 0.1.0
Summary: Set favicon plugin for Dash applications using Dash Hooks.
Author-email: luojiaaoo <675925864@qq.com>
Project-URL: repository, https://github.com/luojiaaoo/dash-favicon-plugin
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: dash>=3.1.1
Requires-Dist: feffery-utils-components
Dynamic: license-file

# dash-favicon-plugin

[![GitHub](https://shields.io/badge/license-MIT-informational)](https://github.com/CNFeffery/dash-offline-detect-plugin/blob/main/LICENSE)
[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)

Set favicon plugin for Dash applications using Dash Hooks.

## Installation

```bash
pip install dash-favicon-plugin
```

## Usage

```python
from dash import Dash
# Import the favicon plugin
from dash_favicon_plugin import setup_favicon_plugin

# Enable the favicon plugin for the current app
setup_favicon_plugin(favicon=r"/assets/favicon.png")

app = dash.Dash(__name__)
# Rest of your app code...
```

## Example

Run the included example:

```bash
python example.py
```

<center><img src="./images/demo.gif" /></center>

## API Reference

### `setup_favicon_plugin()`

This function enables the favicon feature for your Dash application.

| Parameter | Type  | Default | Description                                                  |
| --------- | ----- | ------- | ------------------------------------------------------------ |
| `favicon` | `str` | `-`     | `pathname of favicon,  supporting svg, png, ico, gif formats.` |
