# v6.2.0

## Changed:

* On Windows, the app icon is now also displayed in the upper-left corner of the
  noticication.

## Added:

* Support for notification reply fields on Linux. Note that this seems to only be
  supported by KNotifications.

# v6.1.1

## Fixed:

* Fixes the incorrect appearance of a "default" button on Xfce desktop environments and
  correctly reflect in capabilities that they don't support an ON_CLICKED action. 

# v6.1.0

## Changed:

* Compatibility with pywinrt 3.0. This release also pins the pywinrt dependency to
  >= 3.0, < 4.0 to prevent breakages from API changes.
* Updated rubicon-objc dependency to >=0.5 and cleaned up now obsolete manual memory
  managed in the macOS / iOS backend.

# v6.0.0

## Added:

* You can now set interaction callbacks at the `DesktopNotifier` level which will be
  called on interactions with any notifications from the running app. Callbacks set on
  an individual notification take precedence if set. 

## Changed:

* `send` methods now return the notification ID instead of the notification instance.
* Notification objects are fully immutable.

## Fixed:

* Callbacks on notification dismissal not being called on macOS.

## Deprecated:

* Setting `notification_limit` will be ignored and logs a deprecation warning.

## Removed:

* Deprecated APIs from v5.0.0.

# v5.0.1

## Fixed:

* Fixed compatibility of type annotations with Python 3.8.

# v5.0.0

## Added:

* Support for custom notification sounds on all backends.
* Allow specifying sounds and icons either by name (for existing system sounds) or as a
  referenced by a URI or path.
* Allow specifying  attachments either by URI or path.
* Add a `get_capabilities()` API that returns which features are supported by a 
  platform.
* Compatibility with Ubuntu 20.04 and other older Dbus notification servers which do not
  conform to the current desktop notification API spec.
* A dedicated class `DesktopNotifierSync` with a blocking API instead of the async API 
  of `DesktopNotifier`.

## Changed:

* Removed code signing requirement for macOS binaries. Instead of preventing
  notification requests, only log a warning that notifications may fail. It is not
  documented which code signature checks an app must pass to send notifications and this
  allows apps that fail some of the checks and still send notifications.

## Fixed:

* Fixed a segfault on macOS when passing an attachment path that does not refer to an
  actual file.

## Deprecated:

* Deprecated specifying icons as strings. Use the `base.Icon` class instead.
* Deprecated specifying attachments as URI strings. Use the `base.Attachement` class
  instead.
* Deprecated specifying notification sounds as boolean (`True` = default sound,
  `False` = no sound). Use `base.DEFAULT_SOUND` for the system default and `None` for no
  sound instead. Use the `base.Sound` class for custom sounds.

## Removed:

* Removed the synchronous `DesktopNotifier.send_sync()` API. Use `DesktopNotifierSync`
  instead.

# v4.0.0

* Require winrt>=2.0, the first stable release of the Python to WinRT bridge.
* Fail gracefully when call for authorization fails on Windows with an OSError.
* Added type checking to Windows backend.
* Removed support for NSUserNotificationCenter. This means that macOS 10.13 and older
  are no longer supported.

# v3.5.6

* Remove importlib_resources dependency in favour of stdlib importlib.resources. This
  also fixes a breakage due to API changes in importlib_resources>=6.0.

# v3.5.4

* Fixes an issue with the `on_clicked` callback being shown as a button with label
  "default" on Xfce desktop environments.

# v3.5.3

* Adds a new API DesktopNotifier.send_notification(notification) which directly takes a
  notification instance as argument.
* Fixes an issue on macOS where type hints for ObjC classes where incorrectly
  interpreted due to the use of deferred type hint evaluation.

# v3.5.2

* Fixes missing default app icon.
* Fixes callbacks for interactions with grouped notifications on Windows.

# v3.5.0

* This release introduces proper Windows support after the windows backend has been in
  pre-release for some time.

# v3.4.3
 
* Handle gracefully if we cannot detect the App ID on Windows.

# v3.4.2

* Introduce support for notification timeouts, currently on Linux only.
* Improve error handling and detection in Windows implementation when asking for
  permission to send notifications and run background tasks.
* Update winsdk to v1.0.0b7 and make API adjustments.

# v3.4.1

Fixes an issue where passing `icon = ''` to `DesktopNotifier.send()` would always
default to using the app icon. This should only be the case when passing `icon = None`
which is the default value.

# v3.4.0

* Experimental support for Windows Toast notifications.

# v3.3.5

* Fixes callbacks not being called when pressing the button with index 0 when using the
  Dbus backend.

# v3.3.1

* Updated type hints and marked package as py.typed.

# v3.3.0

* Added support for notification urgencies in macOS 12 and iOS 15.
* Fixed a segfault when running from a non-framework build of Python on macOS 10.14 and
  higher.