notifications

Documentation

Overview

Package notifications wraps a couple of Notifications's DBus API points: the org.freedesktop.Notifications.Notify call, and listening for the ActionInvoked signal.

Index

• Variables
• type RawActionReply
• type RawNotifications
  • func Raw(endp bus.Endpoint, log logger.Logger) *RawNotifications
  • func (raw *RawNotifications) Notify(app_name string, reuse_id uint32, icon, summary, body string, actions []string, ...) (uint32, error)
  • func (raw *RawNotifications) WatchActions() (<-chan RawActionReply, error)

Variables

var BusAddress bus.Address = bus.Address{
	Interface: "org.freedesktop.Notifications",
	Path:      "/org/freedesktop/Notifications",
	Name:      "org.freedesktop.Notifications",
}

Notifications lives on a well-knwon bus.Address

Types

type RawActionReply

type RawActionReply struct {
	NotificationId uint32
	ActionId       string
}

convenience type for the (uint32, string) ActionInvoked signal data

type RawNotifications

type RawNotifications struct {
	// contains filtered or unexported fields
}

a raw notification provides a low-level interface to the f.d.o. dbus notifications api

func Raw

func Raw(endp bus.Endpoint, log logger.Logger) *RawNotifications

Raw returns a new RawNotifications that'll use the provided bus.Endpoint

func (*RawNotifications) Notify

func (raw *RawNotifications) Notify(
	app_name string, reuse_id uint32,
	icon, summary, body string,
	actions []string, hints map[string]*dbus.Variant,
	timeout int32) (uint32, error)

Notify fires a notification

func (*RawNotifications) WatchActions

func (raw *RawNotifications) WatchActions() (<-chan RawActionReply, error)

WatchActions listens for ActionInvoked signals from the notification daemon and sends them over the channel provided