dbus-notification 2024.7.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- dbus_notification-2024.7.0/LICENSE.md +21 -0
- dbus_notification-2024.7.0/PKG-INFO +88 -0
- dbus_notification-2024.7.0/README.md +72 -0
- dbus_notification-2024.7.0/dbus_notification.egg-info/PKG-INFO +88 -0
- dbus_notification-2024.7.0/dbus_notification.egg-info/SOURCES.txt +9 -0
- dbus_notification-2024.7.0/dbus_notification.egg-info/dependency_links.txt +1 -0
- dbus_notification-2024.7.0/dbus_notification.egg-info/entry_points.txt +2 -0
- dbus_notification-2024.7.0/dbus_notification.egg-info/requires.txt +2 -0
- dbus_notification-2024.7.0/dbus_notification.egg-info/top_level.txt +1 -0
- dbus_notification-2024.7.0/pyproject.toml +33 -0
- dbus_notification-2024.7.0/setup.cfg +4 -0
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2024 Vasilis Koulis
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
Metadata-Version: 2.1
|
|
2
|
+
Name: dbus_notification
|
|
3
|
+
Version: 2024.7.0
|
|
4
|
+
Summary: Sends notifications using DBus
|
|
5
|
+
Author-email: bkbilly <bkbilly@hotmail.com>
|
|
6
|
+
Project-URL: Source Code, https://github.com/bkbilly/dbus_notification
|
|
7
|
+
Keywords: lnxlink
|
|
8
|
+
Classifier: Programming Language :: Python :: 3
|
|
9
|
+
Classifier: License :: OSI Approved :: MIT License
|
|
10
|
+
Classifier: Operating System :: Unix
|
|
11
|
+
Requires-Python: >=3.7.0
|
|
12
|
+
Description-Content-Type: text/markdown
|
|
13
|
+
License-File: LICENSE.md
|
|
14
|
+
Requires-Dist: dasbus>=1.7
|
|
15
|
+
Requires-Dist: PyGObject>=3.44.0
|
|
16
|
+
|
|
17
|
+
# DBus Notification
|
|
18
|
+
|
|
19
|
+
[](https://pypi.python.org/pypi/dbus-notification)
|
|
20
|
+

|
|
21
|
+

|
|
22
|
+
|
|
23
|
+
|
|
24
|
+
This library provides a simple interface for creating and displaying desktop notifications with custom buttons. Please note that some features might have varying levels of support across different Linux distributions.
|
|
25
|
+
|
|
26
|
+
|
|
27
|
+
## Features:
|
|
28
|
+
|
|
29
|
+
* Send notifications with custom titles, messages, and images
|
|
30
|
+
* Include clickable buttons for user interaction
|
|
31
|
+
* Control notification urgency, timeout, and sound
|
|
32
|
+
**Note:** Some features might have limited support depending on your desktop environment.
|
|
33
|
+
|
|
34
|
+
|
|
35
|
+
## Requirements
|
|
36
|
+
|
|
37
|
+
DBus Notification has minimal system dependencies:
|
|
38
|
+
* Python 3.7 or later
|
|
39
|
+
* `dasdbus` library
|
|
40
|
+
|
|
41
|
+
## Installation
|
|
42
|
+
|
|
43
|
+
Install the library using pip:
|
|
44
|
+
|
|
45
|
+
```bash
|
|
46
|
+
pip install dbus-notification
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
## Usage
|
|
50
|
+
|
|
51
|
+
This library offers two primary usage approaches:
|
|
52
|
+
|
|
53
|
+
### Command-Line Interaction
|
|
54
|
+
|
|
55
|
+
If you prefer a quick way to view information or control playback, you can potentially execute the dbus-notification script directly, though this doesn't support button actions. For more extensive programmatic control, I would recommend using the library within your Python code.
|
|
56
|
+
|
|
57
|
+
### Programmatic Control
|
|
58
|
+
|
|
59
|
+
Import the DBusNotification class from your Python code:
|
|
60
|
+
|
|
61
|
+
```python
|
|
62
|
+
def callback(notification_type, notification_id, reason):
|
|
63
|
+
if notification_type == "closed":
|
|
64
|
+
print(f"Notification {notification_id} has closed.")
|
|
65
|
+
elif notification_type == "button":
|
|
66
|
+
print(f"Notification {notification_id} has clicked on the button {reason}.")
|
|
67
|
+
|
|
68
|
+
DBusNotification(appname="dbus_notification", callback=callback).send(
|
|
69
|
+
title="test",
|
|
70
|
+
message="this is a test message",
|
|
71
|
+
logo="logo.png",
|
|
72
|
+
image="myimage.png",
|
|
73
|
+
sound="message-new-instant",
|
|
74
|
+
actions=["Test Button"],
|
|
75
|
+
urgency=1,
|
|
76
|
+
timeout=100,
|
|
77
|
+
)
|
|
78
|
+
|
|
79
|
+
# Keep the app running
|
|
80
|
+
while True:
|
|
81
|
+
time.sleep(1)
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
## Future Features
|
|
85
|
+
|
|
86
|
+
* Support for notification categories
|
|
87
|
+
* Resident or transient notification options
|
|
88
|
+
* Ability to specify notification position on the screen
|
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
# DBus Notification
|
|
2
|
+
|
|
3
|
+
[](https://pypi.python.org/pypi/dbus-notification)
|
|
4
|
+

|
|
5
|
+

|
|
6
|
+
|
|
7
|
+
|
|
8
|
+
This library provides a simple interface for creating and displaying desktop notifications with custom buttons. Please note that some features might have varying levels of support across different Linux distributions.
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
## Features:
|
|
12
|
+
|
|
13
|
+
* Send notifications with custom titles, messages, and images
|
|
14
|
+
* Include clickable buttons for user interaction
|
|
15
|
+
* Control notification urgency, timeout, and sound
|
|
16
|
+
**Note:** Some features might have limited support depending on your desktop environment.
|
|
17
|
+
|
|
18
|
+
|
|
19
|
+
## Requirements
|
|
20
|
+
|
|
21
|
+
DBus Notification has minimal system dependencies:
|
|
22
|
+
* Python 3.7 or later
|
|
23
|
+
* `dasdbus` library
|
|
24
|
+
|
|
25
|
+
## Installation
|
|
26
|
+
|
|
27
|
+
Install the library using pip:
|
|
28
|
+
|
|
29
|
+
```bash
|
|
30
|
+
pip install dbus-notification
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
## Usage
|
|
34
|
+
|
|
35
|
+
This library offers two primary usage approaches:
|
|
36
|
+
|
|
37
|
+
### Command-Line Interaction
|
|
38
|
+
|
|
39
|
+
If you prefer a quick way to view information or control playback, you can potentially execute the dbus-notification script directly, though this doesn't support button actions. For more extensive programmatic control, I would recommend using the library within your Python code.
|
|
40
|
+
|
|
41
|
+
### Programmatic Control
|
|
42
|
+
|
|
43
|
+
Import the DBusNotification class from your Python code:
|
|
44
|
+
|
|
45
|
+
```python
|
|
46
|
+
def callback(notification_type, notification_id, reason):
|
|
47
|
+
if notification_type == "closed":
|
|
48
|
+
print(f"Notification {notification_id} has closed.")
|
|
49
|
+
elif notification_type == "button":
|
|
50
|
+
print(f"Notification {notification_id} has clicked on the button {reason}.")
|
|
51
|
+
|
|
52
|
+
DBusNotification(appname="dbus_notification", callback=callback).send(
|
|
53
|
+
title="test",
|
|
54
|
+
message="this is a test message",
|
|
55
|
+
logo="logo.png",
|
|
56
|
+
image="myimage.png",
|
|
57
|
+
sound="message-new-instant",
|
|
58
|
+
actions=["Test Button"],
|
|
59
|
+
urgency=1,
|
|
60
|
+
timeout=100,
|
|
61
|
+
)
|
|
62
|
+
|
|
63
|
+
# Keep the app running
|
|
64
|
+
while True:
|
|
65
|
+
time.sleep(1)
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
## Future Features
|
|
69
|
+
|
|
70
|
+
* Support for notification categories
|
|
71
|
+
* Resident or transient notification options
|
|
72
|
+
* Ability to specify notification position on the screen
|
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
Metadata-Version: 2.1
|
|
2
|
+
Name: dbus_notification
|
|
3
|
+
Version: 2024.7.0
|
|
4
|
+
Summary: Sends notifications using DBus
|
|
5
|
+
Author-email: bkbilly <bkbilly@hotmail.com>
|
|
6
|
+
Project-URL: Source Code, https://github.com/bkbilly/dbus_notification
|
|
7
|
+
Keywords: lnxlink
|
|
8
|
+
Classifier: Programming Language :: Python :: 3
|
|
9
|
+
Classifier: License :: OSI Approved :: MIT License
|
|
10
|
+
Classifier: Operating System :: Unix
|
|
11
|
+
Requires-Python: >=3.7.0
|
|
12
|
+
Description-Content-Type: text/markdown
|
|
13
|
+
License-File: LICENSE.md
|
|
14
|
+
Requires-Dist: dasbus>=1.7
|
|
15
|
+
Requires-Dist: PyGObject>=3.44.0
|
|
16
|
+
|
|
17
|
+
# DBus Notification
|
|
18
|
+
|
|
19
|
+
[](https://pypi.python.org/pypi/dbus-notification)
|
|
20
|
+

|
|
21
|
+

|
|
22
|
+
|
|
23
|
+
|
|
24
|
+
This library provides a simple interface for creating and displaying desktop notifications with custom buttons. Please note that some features might have varying levels of support across different Linux distributions.
|
|
25
|
+
|
|
26
|
+
|
|
27
|
+
## Features:
|
|
28
|
+
|
|
29
|
+
* Send notifications with custom titles, messages, and images
|
|
30
|
+
* Include clickable buttons for user interaction
|
|
31
|
+
* Control notification urgency, timeout, and sound
|
|
32
|
+
**Note:** Some features might have limited support depending on your desktop environment.
|
|
33
|
+
|
|
34
|
+
|
|
35
|
+
## Requirements
|
|
36
|
+
|
|
37
|
+
DBus Notification has minimal system dependencies:
|
|
38
|
+
* Python 3.7 or later
|
|
39
|
+
* `dasdbus` library
|
|
40
|
+
|
|
41
|
+
## Installation
|
|
42
|
+
|
|
43
|
+
Install the library using pip:
|
|
44
|
+
|
|
45
|
+
```bash
|
|
46
|
+
pip install dbus-notification
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
## Usage
|
|
50
|
+
|
|
51
|
+
This library offers two primary usage approaches:
|
|
52
|
+
|
|
53
|
+
### Command-Line Interaction
|
|
54
|
+
|
|
55
|
+
If you prefer a quick way to view information or control playback, you can potentially execute the dbus-notification script directly, though this doesn't support button actions. For more extensive programmatic control, I would recommend using the library within your Python code.
|
|
56
|
+
|
|
57
|
+
### Programmatic Control
|
|
58
|
+
|
|
59
|
+
Import the DBusNotification class from your Python code:
|
|
60
|
+
|
|
61
|
+
```python
|
|
62
|
+
def callback(notification_type, notification_id, reason):
|
|
63
|
+
if notification_type == "closed":
|
|
64
|
+
print(f"Notification {notification_id} has closed.")
|
|
65
|
+
elif notification_type == "button":
|
|
66
|
+
print(f"Notification {notification_id} has clicked on the button {reason}.")
|
|
67
|
+
|
|
68
|
+
DBusNotification(appname="dbus_notification", callback=callback).send(
|
|
69
|
+
title="test",
|
|
70
|
+
message="this is a test message",
|
|
71
|
+
logo="logo.png",
|
|
72
|
+
image="myimage.png",
|
|
73
|
+
sound="message-new-instant",
|
|
74
|
+
actions=["Test Button"],
|
|
75
|
+
urgency=1,
|
|
76
|
+
timeout=100,
|
|
77
|
+
)
|
|
78
|
+
|
|
79
|
+
# Keep the app running
|
|
80
|
+
while True:
|
|
81
|
+
time.sleep(1)
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
## Future Features
|
|
85
|
+
|
|
86
|
+
* Support for notification categories
|
|
87
|
+
* Resident or transient notification options
|
|
88
|
+
* Ability to specify notification position on the screen
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
LICENSE.md
|
|
2
|
+
README.md
|
|
3
|
+
pyproject.toml
|
|
4
|
+
dbus_notification.egg-info/PKG-INFO
|
|
5
|
+
dbus_notification.egg-info/SOURCES.txt
|
|
6
|
+
dbus_notification.egg-info/dependency_links.txt
|
|
7
|
+
dbus_notification.egg-info/entry_points.txt
|
|
8
|
+
dbus_notification.egg-info/requires.txt
|
|
9
|
+
dbus_notification.egg-info/top_level.txt
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
[build-system]
|
|
2
|
+
requires = ["setuptools~=69.2.0", "wheel~=0.43.0"]
|
|
3
|
+
build-backend = "setuptools.build_meta"
|
|
4
|
+
|
|
5
|
+
[project]
|
|
6
|
+
name = "dbus_notification"
|
|
7
|
+
version = "2024.7.0"
|
|
8
|
+
description = "Sends notifications using DBus"
|
|
9
|
+
readme = "README.md"
|
|
10
|
+
keywords = ["lnxlink"]
|
|
11
|
+
requires-python = ">=3.7.0"
|
|
12
|
+
authors = [
|
|
13
|
+
{name="bkbilly", email="bkbilly@hotmail.com"}
|
|
14
|
+
]
|
|
15
|
+
classifiers = [
|
|
16
|
+
"Programming Language :: Python :: 3",
|
|
17
|
+
"License :: OSI Approved :: MIT License",
|
|
18
|
+
"Operating System :: Unix",
|
|
19
|
+
]
|
|
20
|
+
dependencies = [
|
|
21
|
+
"dasbus>=1.7",
|
|
22
|
+
"PyGObject>=3.44.0"
|
|
23
|
+
]
|
|
24
|
+
|
|
25
|
+
|
|
26
|
+
[project.urls]
|
|
27
|
+
"Source Code" = "https://github.com/bkbilly/dbus_notification"
|
|
28
|
+
|
|
29
|
+
[tool.setuptools.packages.find]
|
|
30
|
+
include = ["dbus_notification*"]
|
|
31
|
+
|
|
32
|
+
[project.scripts]
|
|
33
|
+
dbus-notification = "dbus_notification.__main__:main"
|