Metadata-Version: 2.4
Name: wc_toast
Version: 0.1.0
Summary: A polished macOS-style toast notification widget for PySide6
Project-URL: Homepage, https://github.com/weichao1221/wc_toast
Project-URL: Repository, https://github.com/weichao1221/wc_toast
Project-URL: Issues, https://github.com/weichao1221/wc_toast/issues
Author: weichao1221
License-Expression: MIT
License-File: LICENSE
Keywords: macos,notification,pyside6,qt,toast
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: MacOS X
Classifier: Environment :: X11 Applications :: Qt
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: User Interfaces
Requires-Python: >=3.10
Requires-Dist: pyside6>=6.5
Description-Content-Type: text/markdown

# wc_toast

一个独立、轻量的 PySide6 弱提示组件，视觉参考 macOS 通知中心。

## 特性

- 浅色半透明圆角通知卡片
- 成功、信息、警告、错误和默认主题
- 滑入、回弹、淡出动画
- 同一位置多条通知自动堆叠
- 支持操作按钮、关闭按钮和自动消失
- 不依赖 `pyqttoast`
- 支持七个预设位置

## 安装

```bash
pip install wc_toast
```

## 快速使用

```python
from PySide6.QtWidgets import QApplication
from wc_toast import Toast, ToastPosition

app = QApplication([])

Toast.success(
    "保存成功",
    "项目文件已经保存。",
    position=ToastPosition.TOP_RIGHT,
)

app.exec()
```

## 可用位置

```python
ToastPosition.TOP_LEFT       # 顶部靠左
ToastPosition.TOP_MIDDLE     # 顶部中间
ToastPosition.TOP_RIGHT      # 顶部靠右
ToastPosition.MIDDLE_LOWER   # 屏幕中间偏下
ToastPosition.BOTTOM_LEFT    # 底部靠左
ToastPosition.BOTTOM_MIDDLE  # 底部中间
ToastPosition.BOTTOM_RIGHT   # 底部靠右
```

## 完整配置

```python
from wc_toast import Toast, ToastPosition, ToastPreset

toast = Toast()
toast.setPreset(ToastPreset.INFORMATION)
toast.setTitle("处理完成")
toast.setText("文件已经导入，可以继续下一步。")
toast.setDuration(3000)
toast.setPosition(ToastPosition.MIDDLE_LOWER)
toast.setAction("查看详情", lambda: print("查看"))
toast.show()
```

`duration=0` 时通知不会自动关闭。

## 本地演示

```bash
python -m wc_toast.toast
```

## 许可证

MIT
