macos-notifications 0.1.4

Simple interactable Mac notifications with only pure-python dependencies

---

Documentation: https://jorricks.github.io/macos-notifications/

Source Code: https://github.com/Jorricks/macos-notifications

---

mac-notification is a Python library to make it as easy as possible to create interactable notifications.

Installation

To use macos-notifications, first install it using pip:

pip install macos-notifications

Features

• 🚀 Easy python interface. It's as simple as 'client.create_notification(title="Meeting starts now!", subtitle="Team Standup")'
• 💥 Ability to add action buttons with callbacks!
• 📝 Ability to reply to notifications!
• ⌚ Delayed notifications.
• ⏱️ Automatically time out the notification listener.
• 📦 Just pyobjc as a dependency.

Example

from functools import partial
from mac_notifications import client

client.create_notification(
    title="Meeting starts now!",
    subtitle="Team Standup",
    icon="/Users/jorrick/zoom.png",
    action_button_str="Join zoom meeting",
    action_callback=partial(join_zoom_meeting, conf_number=zoom_conf_number)
)

A simple example. Please look in the docs for more examples like this:

Why did you create this library?

I wanted a library that did not depend on any non-python tools (so you had to go around and install that). Instead, I wanted a library where you install the pip packages, and you are done. Later I realised how hard it was to integrate correctly with PyOBJC. Also, I had a hard time finding any examples on how to easily integrate this in a non-blocking fashion with my tool. Hence, I figured I should set it up to be as user-friendly as possible and share it with the world ;)!

Limitations

Although there are some limitations, there is no reason to not use it now :v:.

• You need to keep your application running while waiting for the callback to happen.
• Currently, we are only supporting the old deprecated user notifications. Soon we will also make the new implementation available.