Metadata-Version: 2.4
Name: dbus-notifier
Version: 1.0.2
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.7.0
Requires-Dist: astroid==3.3.10
Requires-Dist: attrs==25.3.0
Requires-Dist: bleach==6.2.0
Requires-Dist: build==1.2.2.post1
Requires-Dist: bump2version==1.0.2
Requires-Dist: bumpversion==0.6.0
Requires-Dist: certifi==2025.6.15
Requires-Dist: cffi==1.17.1
Requires-Dist: charset-normalizer==3.4.2
Requires-Dist: check-wheel-contents==0.6.2
Requires-Dist: click==8.2.1
Requires-Dist: cryptography==45.0.4
Requires-Dist: dbus-next==0.2.3
Requires-Dist: dbus-python==1.4.0
Requires-Dist: dbusnotify==0.0.2
Requires-Dist: dill==0.4.0
Requires-Dist: docutils==0.21.2
Requires-Dist: dotenv==0.9.9
Requires-Dist: id==1.5.0
Requires-Dist: idna==3.10
Requires-Dist: importlib-metadata==8.7.0
Requires-Dist: isort==6.0.1
Requires-Dist: jaraco-classes==3.4.0
Requires-Dist: jaraco-context==6.0.1
Requires-Dist: jaraco-functools==4.1.0
Requires-Dist: jeepney==0.9.0
Requires-Dist: keyring==25.6.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==10.7.0
Requires-Dist: nh3==0.2.21
Requires-Dist: packaging==25.0
Requires-Dist: pkginfo==1.12.1.2
Requires-Dist: platformdirs==4.3.8
Requires-Dist: pycodestyle==2.13.0
Requires-Dist: pycparser==2.22
Requires-Dist: pydantic==2.11.7
Requires-Dist: pydantic-core==2.33.2
Requires-Dist: pyflakes==3.3.2
Requires-Dist: pygments==2.19.1
Requires-Dist: pylint==3.3.7
Requires-Dist: pyproject-hooks==1.2.0
Requires-Dist: python-dotenv==1.1.0
Requires-Dist: readme-renderer==44.0
Requires-Dist: requests==2.32.4
Requires-Dist: requests-toolbelt==1.0.0
Requires-Dist: rfc3986==2.0.0
Requires-Dist: rich==14.0.0
Requires-Dist: secretstorage==3.3.3
Requires-Dist: setuptools==80.9.0
Requires-Dist: six==1.17.0
Requires-Dist: tomli==2.2.1
Requires-Dist: tomlkit==0.13.3
Requires-Dist: twine==6.1.0
Requires-Dist: typing-extensions==4.14.0
Requires-Dist: typing-inspection==0.4.1
Requires-Dist: urllib3==2.4.0
Requires-Dist: webencodings==0.5.1
Requires-Dist: wheel-filename==1.4.2
Requires-Dist: zipp==3.23.0
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.
Apr 2025 release.

## 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.
