Metadata-Version: 2.4
Name: dbus-notifier
Version: 1.0.0
Summary: A small dbus notifier package
Author: Adam Bukolt
Author-email: Adam Bukolt <abukolt@gmx.com>
Project-URL: Homepage, https://github.com/adambmarsh/dbusnotify
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: annotated-types>=0.6.0
Requires-Dist: astroid>=3.1.0
Requires-Dist: attrs>=23.2.0
Requires-Dist: bleach>=6.1.0
Requires-Dist: build>=1.1.1
Requires-Dist: certifi>=2024.2.2
Requires-Dist: cffi>=1.16.0
Requires-Dist: charset-normalizer>=3.3.2
Requires-Dist: check-wheel-contents>=0.6.0
Requires-Dist: click>=8.1.7
Requires-Dist: cryptography>=42.0.5
Requires-Dist: dbus-next>=0.2.3
Requires-Dist: dbus-python>=1.3.2
Requires-Dist: dbusnotify>=0.0.2
Requires-Dist: dill>=0.3.8
Requires-Dist: docutils>=0.20.1
Requires-Dist: idna>=3.6
Requires-Dist: importlib-metadata>=7.1.0
Requires-Dist: isort>=5.13.2
Requires-Dist: jaraco-classes>=3.3.1
Requires-Dist: jaraco-context>=4.3.0
Requires-Dist: jaraco-functools>=4.0.0
Requires-Dist: jeepney>=0.8.0
Requires-Dist: keyring>=25.0.0
Requires-Dist: markdown-it-py>=3.0.0
Requires-Dist: mccabe>=0.7.0
Requires-Dist: mdurl>=0.1.2
Requires-Dist: more-itertools>=11.0.0
Requires-Dist: nh3>=1.0.07
Requires-Dist: packaging>=24.0
Requires-Dist: pkginfo>=1.10.0
Requires-Dist: platformdirs>=4.2.0
Requires-Dist: pycodestyle>=2.11.1
Requires-Dist: pycparser>=2.21
Requires-Dist: pydantic>=2.6.4
Requires-Dist: pydantic-core>=2.17.0
Requires-Dist: pyflakes>=3.2.0
Requires-Dist: pygments>=2.17.2
Requires-Dist: pylint>=3.1.0
Requires-Dist: pyproject-hooks>=1.0.0
Requires-Dist: python-dotenv>=1.0.1
Requires-Dist: readme-renderer>=43.0
Requires-Dist: requests>=2.31.0
Requires-Dist: requests-toolbelt>=1.0.0
Requires-Dist: rfc3986>=2.0.0
Requires-Dist: rich>=13.7.1
Requires-Dist: secretstorage>=3.3.3
Requires-Dist: setuptools>=80.9.0
Requires-Dist: six>=1.16.0
Requires-Dist: tomli>=2.0.1
Requires-Dist: tomlkit>=0.12.4
Requires-Dist: twine>=5.0.0
Requires-Dist: typing-extensions>=4.10.0
Requires-Dist: urllib3>=2.2.1
Requires-Dist: webencodings>=0.5.1
Requires-Dist: wheel-filename>=1.4.1
Requires-Dist: zipp>=3.18.1
Dynamic: author
Dynamic: license-file
Dynamic: requires-python

# dbus-notifier #

This library offers a simple means of generating dbus notifications on Linux. 

## Installation and Usage

Make sure at least Python 3.* is installed on the target Linux system. 

Install virtualenv in which to install `dbus-notifier`.

In the virtual environment, run `pip3 install dbus-notifier`

In the Python code to use dbus-notifier:

```commandline
from dbusnotifier.dbusnotifier import NotifySender

```
The simplest code instantiating NotifySender and sending a dbus notification is this:

```commandline
    sender = NotifySender(title="My notifier")
    ...
    sender.notify(message="Hi!")
```
The above code results in a single message "Hi!" being posting in the notification area.

A more complex scenario supported by dbus-notifier is to create a dictionary with a selection of messages, where each
key identifies a message. The code below illustrates this case:

```
    sender = NotifySender(title="My notifier", messages={'0': "Success", '1': "Failed"})
    
    sender.notify(select_key='0')
```


## Dependencies

Please see `pyproject.toml`.

## Status

Mar 2023 First draft, tested locally on Manjaro Linux.

## Copyright

Copyright Adam Bukolt

Note that the copyright refers to the code and scripts in this repository and
expressly not to any third-party dependencies.

## License

MIT

Icons included with this program were created by and are the sole property of the copyright holder.

Note that separate licenses apply to third-party dependencies.
