Metadata-Version: 2.4
Name: winzy-visual-notify
Version: 0.0.4
Summary: Notify using visual artefacts like clippy and other things.
Author: Sukhbinder Singh
License: Apache-2.0
Project-URL: Homepage, https://github.com/sukhbinder/winzy-visual-notify
Project-URL: Changelog, https://github.com/sukhbinder/winzy-visual-notify/releases
Project-URL: Issues, https://github.com/sukhbinder/winzy-visual-notify/issues
Project-URL: CI, https://github.com/sukhbinder/winzy-visual-notify/actions
Classifier: License :: OSI Approved :: Apache Software License
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: winzy
Requires-Dist: pyside6
Provides-Extra: test
Requires-Dist: pytest; extra == "test"
Dynamic: license-file

# winzy-visual-notify

[![PyPI](https://img.shields.io/pypi/v/winzy-visual-notify.svg)](https://pypi.org/project/winzy-visual-notify/)
[![Changelog](https://img.shields.io/github/v/release/sukhbinder/winzy-visual-notify?include_prereleases&label=changelog)](https://github.com/sukhbinder/winzy-visual-notify/releases)
[![Tests](https://github.com/sukhbinder/winzy-visual-notify/workflows/Test/badge.svg)](https://github.com/sukhbinder/winzy-visual-notify/actions?query=workflow%3ATest)
[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](https://github.com/sukhbinder/winzy-visual-notify/blob/main/LICENSE)

Notify using visual artefacts like clippy and other things.

For a background on this project see [Look who is talking. a new winzy plugin](https://sukhbinder.wordpress.com/2024/12/05/look-who-is-talking-a-new-winzy-plugin/)

## Installation

First configure to install Winzy [to use Winzy](https://github.com/sukhbinder/winzy).

which means.

```bash
pip install winzy
```

Then install this plugin in the same environment as your Winzy application.
```bash
winzy install winzy-visual-notify
```
## Usage

```bash

usage: winzy tell [-h] [-t [TEXT ...]]
                  [-c {dog,dog2,watermellon,bee,ghost,hen,man,pear,purple,random}]
                  [-d DURATION]

Notify using visual artefacts like clippy and other things

optional arguments:
  -h, --help            show this help message and exit
  -t [TEXT ...], --text [TEXT ...]
                        Text to display
  -c {dog,dog2,watermellon,bee,ghost,hen,man,pear,purple,random}, --character {dog,dog2,watermellon,bee,ghost,hen,man,pear,purple,random}
                        Name of Character to display
  -d DURATION, --duration DURATION
                        Duration is seconds after which the notification is
                        closed. Default 5 mins. use -1 to not close


```

## Demo
![winzy tell ](https://raw.githubusercontent.com/sukhbinder/winzy-visual-notify/refs/heads/main/winzy-visual-notify-demo.gif)

## Development

To set up this plugin locally, first checkout the code. Then create a new virtual environment:
```bash
cd winzy-visual-notify
python -m venv venv
source venv/bin/activate
```
Now install the dependencies and test dependencies:
```bash
pip install -e '.[test]'
```
To run the tests:
```bash
python -m pytest
```
