Small rewrite:
* Use error-chain for errors and expose them * Don't use Context object, since the lifetimes get us in trouble when used with gtk-rs, which has callback closures with static lifetime. Instead we just expose notify_init()/notify_uninit() and panic when functions are called before notify_init().
This commit is contained in:
parent
172cbd5143
commit
fe4d803efe
@ -11,6 +11,7 @@ documentation = "http://crumblingstatue.github.io/doc/libnotify/libnotify/"
|
||||
keywords = ["libnotify", "notification"]
|
||||
|
||||
[dependencies]
|
||||
error-chain = "0.10.0"
|
||||
libnotify-sys = "^0.5.0"
|
||||
gdk-pixbuf = "^0.1.3"
|
||||
gdk-pixbuf-sys = "^0.3.4"
|
||||
|
@ -1,12 +1,18 @@
|
||||
extern crate libnotify;
|
||||
|
||||
fn main() {
|
||||
// Create a libnotify context
|
||||
let notify = libnotify::Context::new("myapp").unwrap();
|
||||
// Init libnotify
|
||||
libnotify::init("myapp").unwrap();
|
||||
// Create a new notification and show it
|
||||
let n = notify.new_notification("Summary", Some("Optional Body"), None)
|
||||
.unwrap();
|
||||
let n = libnotify::Notification::new_notification("Summary",
|
||||
Some("Optional Body"),
|
||||
None).unwrap();
|
||||
// Show the notification
|
||||
n.show().unwrap();
|
||||
// You can also use the .show() convenience method on the context
|
||||
notify.show("I am another notification", None, None).unwrap();
|
||||
n.update("I am another notification", None, None).unwrap();
|
||||
// Show the update notification
|
||||
n.show().unwrap();
|
||||
// We are done, deinit
|
||||
libnotify::uninit();
|
||||
}
|
||||
|
33
src/errors.rs
Normal file
33
src/errors.rs
Normal file
@ -0,0 +1,33 @@
|
||||
use std;
|
||||
|
||||
/// Error variants for Libnotify.
|
||||
error_chain! {
|
||||
foreign_links {
|
||||
Utf8(std::str::Utf8Error);
|
||||
Nul(std::ffi::NulError);
|
||||
}
|
||||
|
||||
errors {
|
||||
UnknownError {
|
||||
description("Unknown Error")
|
||||
display("Unknown Error")
|
||||
}
|
||||
InvalidParameter {
|
||||
description("Invalid parameter")
|
||||
display("Invalid parameter")
|
||||
}
|
||||
NotificationShowError(t: String) {
|
||||
description("Failed to show notification")
|
||||
display("Failed to show notification: {}", t)
|
||||
}
|
||||
NotifyAlreadyInitialized {
|
||||
description("Notify system already initialized")
|
||||
display("Notify system already initialized")
|
||||
}
|
||||
NotifyInitError {
|
||||
description("Notify system initialization error")
|
||||
display("Notify system initialization error")
|
||||
}
|
||||
}
|
||||
|
||||
}
|
311
src/lib.rs
311
src/lib.rs
@ -19,6 +19,8 @@
|
||||
|
||||
#![warn(missing_docs)]
|
||||
|
||||
#[macro_use]
|
||||
extern crate error_chain;
|
||||
extern crate gdk_pixbuf;
|
||||
extern crate gdk_pixbuf_sys;
|
||||
extern crate glib;
|
||||
@ -26,14 +28,24 @@ extern crate glib_sys;
|
||||
extern crate gtypes;
|
||||
extern crate libnotify_sys as sys;
|
||||
|
||||
pub mod errors;
|
||||
|
||||
use errors::*;
|
||||
use gdk_pixbuf_sys::GdkPixbuf;
|
||||
use glib::translate::*;
|
||||
use glib::translate::ToGlibPtr;
|
||||
use gtypes::{TRUE, FALSE};
|
||||
use std::error::Error;
|
||||
use std::ffi::{self, CStr, CString};
|
||||
use std::fmt;
|
||||
use std::marker::PhantomData;
|
||||
use std::ffi::{CStr, CString};
|
||||
use std::os::raw::c_int;
|
||||
use std::os::raw::c_char;
|
||||
|
||||
|
||||
macro_rules! init_panic {
|
||||
() => {
|
||||
if !is_initted() {
|
||||
panic!("Notify system not initialized, invalid call of function");
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
/// The urgency level of the notification.
|
||||
@ -67,94 +79,14 @@ impl From<Urgency> for sys::NotifyUrgency {
|
||||
}
|
||||
|
||||
|
||||
/// Error that can happen on context creation
|
||||
#[derive(Debug)]
|
||||
pub enum ContextCreationError {
|
||||
/// Context already exists.
|
||||
AlreadyExists,
|
||||
/// Failed to initialize libnotify.
|
||||
InitError,
|
||||
/// A nul byte was found in the provided string.
|
||||
NulError(ffi::NulError),
|
||||
|
||||
|
||||
/// A passive pop-up notification
|
||||
pub struct Notification {
|
||||
handle: *mut sys::NotifyNotification,
|
||||
}
|
||||
|
||||
impl fmt::Display for ContextCreationError {
|
||||
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
||||
use ContextCreationError::*;
|
||||
match *self {
|
||||
AlreadyExists => write!(f, "A Libnotify context already exists."),
|
||||
InitError => write!(f, "Failed to initialize libnotify."),
|
||||
NulError(ref e) => write!(f, "{}", e),
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
impl From<ffi::NulError> for ContextCreationError {
|
||||
fn from(src: ffi::NulError) -> Self {
|
||||
ContextCreationError::NulError(src)
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
#[derive(Debug)]
|
||||
/// An error that can happen when attempting to create a notification.
|
||||
pub enum NotificationCreationError {
|
||||
/// A nul byte was found in the provided string.
|
||||
NulError(ffi::NulError),
|
||||
/// An unknown error happened.
|
||||
Unknown,
|
||||
/// Invalid parameter passed to a glib function
|
||||
InvalidParameter,
|
||||
}
|
||||
|
||||
impl fmt::Display for NotificationCreationError {
|
||||
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
||||
use NotificationCreationError::*;
|
||||
match *self {
|
||||
NulError(ref e) => write!(f, "{}", e),
|
||||
Unknown => write!(f, "Unknown error"),
|
||||
InvalidParameter => write!(f, "An invalid parameter was passed"),
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
impl From<ffi::NulError> for NotificationCreationError {
|
||||
fn from(src: ffi::NulError) -> Self {
|
||||
NotificationCreationError::NulError(src)
|
||||
}
|
||||
}
|
||||
|
||||
impl Error for NotificationCreationError {
|
||||
fn description(&self) -> &str {
|
||||
"notification creation error"
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
/// The context which within libnotify operates.
|
||||
///
|
||||
/// Only one context can exist at a time.
|
||||
pub struct Context;
|
||||
|
||||
impl Context {
|
||||
/// Create a new context
|
||||
///
|
||||
/// Arguments:
|
||||
///
|
||||
/// - app_name: The name of the application using the context
|
||||
pub fn new(app_name: &str) -> Result<Context, ContextCreationError> {
|
||||
unsafe {
|
||||
if sys::notify_is_initted() == TRUE {
|
||||
return Err(ContextCreationError::AlreadyExists);
|
||||
}
|
||||
let app_name = try!(CString::new(app_name));
|
||||
if sys::notify_init(app_name.as_ptr()) == FALSE {
|
||||
return Err(ContextCreationError::InitError);
|
||||
}
|
||||
}
|
||||
Ok(Context)
|
||||
}
|
||||
|
||||
impl Notification {
|
||||
/// Creates a new Notification.
|
||||
///
|
||||
/// Arguments:
|
||||
@ -162,15 +94,14 @@ impl Context {
|
||||
/// - summary: Required summary text
|
||||
/// - body: Optional body text
|
||||
/// - icon: Optional icon theme icon name or filename
|
||||
pub fn new_notification
|
||||
(&self,
|
||||
summary: &str,
|
||||
body: Option<&str>,
|
||||
icon: Option<&str>)
|
||||
-> Result<Notification, NotificationCreationError> {
|
||||
let summary = try!(CString::new(summary));
|
||||
pub fn new_notification(summary: &str,
|
||||
body: Option<&str>,
|
||||
icon: Option<&str>)
|
||||
-> Result<Notification> {
|
||||
init_panic!();
|
||||
let summary = CString::new(summary)?;
|
||||
let body = match body {
|
||||
Some(body) => Some(try!(CString::new(body))),
|
||||
Some(body) => Some(CString::new(body)?),
|
||||
None => None,
|
||||
};
|
||||
let body_ptr = match body {
|
||||
@ -178,7 +109,7 @@ impl Context {
|
||||
None => std::ptr::null(),
|
||||
};
|
||||
let icon = match icon {
|
||||
Some(icon) => Some(try!(CString::new(icon))),
|
||||
Some(icon) => Some(CString::new(icon)?),
|
||||
None => None,
|
||||
};
|
||||
let icon_ptr = match icon {
|
||||
@ -191,61 +122,26 @@ impl Context {
|
||||
body_ptr,
|
||||
icon_ptr);
|
||||
if n.is_null() {
|
||||
return Err(NotificationCreationError::Unknown);
|
||||
bail!(ErrorKind::UnknownError);
|
||||
}
|
||||
|
||||
Ok(Notification {
|
||||
handle: n,
|
||||
_phantom: PhantomData,
|
||||
})
|
||||
Ok(Notification { handle: n })
|
||||
}
|
||||
}
|
||||
|
||||
/// Show a notification.
|
||||
///
|
||||
/// This is a convenience method that creates a new notification,
|
||||
/// and shows it in one step.
|
||||
pub fn show(&self,
|
||||
summary: &str,
|
||||
body: Option<&str>,
|
||||
icon: Option<&str>)
|
||||
-> Result<(), Box<Error>> {
|
||||
let notif = try!(self.new_notification(summary, body, icon));
|
||||
try!(notif.show());
|
||||
Ok(())
|
||||
}
|
||||
}
|
||||
|
||||
impl Drop for Context {
|
||||
fn drop(&mut self) {
|
||||
unsafe {
|
||||
sys::notify_uninit();
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
/// A passive pop-up notification
|
||||
pub struct Notification<'a> {
|
||||
handle: *mut sys::NotifyNotification,
|
||||
_phantom: PhantomData<&'a Context>,
|
||||
}
|
||||
|
||||
impl<'a> Notification<'a> {
|
||||
/// Tells the notification server to display the notification
|
||||
/// on the screen.
|
||||
pub fn show(&'a self) -> Result<(), NotificationShowError> {
|
||||
pub fn show(&self) -> Result<()> {
|
||||
init_panic!();
|
||||
unsafe {
|
||||
let mut err: *mut glib_sys::GError = std::ptr::null_mut();
|
||||
sys::notify_notification_show(self.handle, &mut err);
|
||||
if !err.is_null() {
|
||||
let result = Err(NotificationShowError {
|
||||
message: CStr::from_ptr((*err).message)
|
||||
.to_string_lossy()
|
||||
.into_owned(),
|
||||
});
|
||||
let msg = CStr::from_ptr((*err).message)
|
||||
.to_string_lossy()
|
||||
.into_owned();
|
||||
glib_sys::g_error_free(err);
|
||||
return result;
|
||||
bail!(ErrorKind::NotificationShowError(msg));
|
||||
}
|
||||
Ok(())
|
||||
}
|
||||
@ -253,7 +149,8 @@ impl<'a> Notification<'a> {
|
||||
|
||||
/// Set the notification timeout. Note that the server might ignore
|
||||
/// the timeout.
|
||||
pub fn set_notification_timeout(&'a self, timeout: i32) {
|
||||
pub fn set_notification_timeout(&self, timeout: i32) {
|
||||
init_panic!();
|
||||
let _timeout: c_int = From::from(timeout);
|
||||
|
||||
unsafe { sys::notify_notification_set_timeout(self.handle, _timeout) }
|
||||
@ -262,14 +159,15 @@ impl<'a> Notification<'a> {
|
||||
/// Updates the notification text and icon. This won't send the update
|
||||
/// out and display it on the screen. For that, you will need to
|
||||
/// call `.show()`.
|
||||
pub fn update(&'a self,
|
||||
pub fn update(&self,
|
||||
summary: &str,
|
||||
body: Option<&str>,
|
||||
icon: Option<&str>)
|
||||
-> Result<(), NotificationCreationError> {
|
||||
let summary = try!(CString::new(summary));
|
||||
-> Result<()> {
|
||||
init_panic!();
|
||||
let summary = CString::new(summary)?;
|
||||
let body = match body {
|
||||
Some(body) => Some(try!(CString::new(body))),
|
||||
Some(body) => Some(CString::new(body)?),
|
||||
None => None,
|
||||
};
|
||||
let body_ptr = match body {
|
||||
@ -277,7 +175,7 @@ impl<'a> Notification<'a> {
|
||||
None => std::ptr::null(),
|
||||
};
|
||||
let icon = match icon {
|
||||
Some(icon) => Some(try!(CString::new(icon))),
|
||||
Some(icon) => Some(CString::new(icon)?),
|
||||
None => None,
|
||||
};
|
||||
let icon_ptr = match icon {
|
||||
@ -291,7 +189,7 @@ impl<'a> Notification<'a> {
|
||||
body_ptr,
|
||||
icon_ptr);
|
||||
if b == FALSE {
|
||||
return Err(NotificationCreationError::InvalidParameter);
|
||||
bail!(ErrorKind::InvalidParameter);
|
||||
}
|
||||
}
|
||||
|
||||
@ -300,11 +198,12 @@ impl<'a> Notification<'a> {
|
||||
|
||||
/// Sets a hint for `key` with value `value`. If value is `None`,
|
||||
/// then key is unset.
|
||||
pub fn set_hint(&'a self,
|
||||
pub fn set_hint(&self,
|
||||
key: &str,
|
||||
value: Option<glib::variant::Variant>)
|
||||
-> Result<(), NotificationCreationError> {
|
||||
let key = try!(CString::new(key));
|
||||
-> Result<()> {
|
||||
init_panic!();
|
||||
let key = CString::new(key)?;
|
||||
|
||||
let gvalue: *mut glib_sys::GVariant = {
|
||||
match value {
|
||||
@ -322,38 +221,40 @@ impl<'a> Notification<'a> {
|
||||
|
||||
/// Sets the category of this notification. This can be used by the
|
||||
/// notification server to filter or display the data in a certain way.
|
||||
pub fn set_category(&'a self, category: &str) -> Result<(), NotificationCreationError> {
|
||||
let category = try!(CString::new(category));
|
||||
pub fn set_category(&self, category: &str) -> Result<()> {
|
||||
init_panic!();
|
||||
let category = CString::new(category)?;
|
||||
unsafe {
|
||||
sys::notify_notification_set_category(self.handle,
|
||||
category.as_ptr());
|
||||
category.as_ptr());
|
||||
}
|
||||
|
||||
return Ok(());
|
||||
}
|
||||
|
||||
/// Sets the urgency level of this notification.
|
||||
pub fn set_urgency(&'a self, urgency: Urgency) {
|
||||
pub fn set_urgency(&self, urgency: Urgency) {
|
||||
init_panic!();
|
||||
let urgency: sys::NotifyUrgency = From::from(urgency);
|
||||
|
||||
unsafe {
|
||||
sys::notify_notification_set_urgency(self.handle,
|
||||
urgency);
|
||||
sys::notify_notification_set_urgency(self.handle, urgency);
|
||||
}
|
||||
}
|
||||
|
||||
/// Sets the image in the notification from a Pixbuf.
|
||||
pub fn set_image_from_pixbuf(&'a self, pixbuf: &gdk_pixbuf::Pixbuf) {
|
||||
pub fn set_image_from_pixbuf(&self, pixbuf: &gdk_pixbuf::Pixbuf) {
|
||||
init_panic!();
|
||||
let pixbuf: *mut GdkPixbuf = pixbuf.to_glib_none().0;
|
||||
|
||||
unsafe {
|
||||
sys::notify_notification_set_image_from_pixbuf(self.handle,
|
||||
pixbuf);
|
||||
sys::notify_notification_set_image_from_pixbuf(self.handle, pixbuf);
|
||||
}
|
||||
}
|
||||
|
||||
/// Clears all hints from the notification.
|
||||
pub fn clear_hints(&'a self) {
|
||||
pub fn clear_hints(&self) {
|
||||
init_panic!();
|
||||
unsafe {
|
||||
sys::notify_notification_clear_hints(self.handle);
|
||||
}
|
||||
@ -361,20 +262,18 @@ impl<'a> Notification<'a> {
|
||||
|
||||
/// Synchronously tells the notification server to hide the
|
||||
/// notification on the screen.
|
||||
pub fn close(&'a self) -> Result<(), NotificationShowError> {
|
||||
pub fn close(&self) -> Result<()> {
|
||||
init_panic!();
|
||||
unsafe {
|
||||
let mut err: *mut glib_sys::GError = std::ptr::null_mut();
|
||||
sys::notify_notification_close(self.handle,
|
||||
&mut err);
|
||||
sys::notify_notification_close(self.handle, &mut err);
|
||||
|
||||
if !err.is_null() {
|
||||
let result = Err(NotificationShowError {
|
||||
message: CStr::from_ptr((*err).message)
|
||||
.to_string_lossy()
|
||||
.into_owned(),
|
||||
});
|
||||
let msg = CStr::from_ptr((*err).message)
|
||||
.to_string_lossy()
|
||||
.into_owned();
|
||||
glib_sys::g_error_free(err);
|
||||
return result;
|
||||
bail!(ErrorKind::NotificationShowError(msg));
|
||||
}
|
||||
}
|
||||
return Ok(());
|
||||
@ -382,20 +281,68 @@ impl<'a> Notification<'a> {
|
||||
}
|
||||
|
||||
|
||||
/// An error that can happen when attempting to show a notification.
|
||||
#[derive(Debug)]
|
||||
pub struct NotificationShowError {
|
||||
message: String,
|
||||
/// Initialized libnotify. This must be called before any other functions.
|
||||
pub fn init(app_name: &str) -> Result<()> {
|
||||
let app_name = CString::new(app_name)?;
|
||||
|
||||
unsafe {
|
||||
if sys::notify_is_initted() == TRUE {
|
||||
bail!(ErrorKind::NotifyAlreadyInitialized);
|
||||
}
|
||||
let app_name = CString::new(app_name)?;
|
||||
if sys::notify_init(app_name.as_ptr()) == FALSE {
|
||||
bail!(ErrorKind::NotifyInitError);
|
||||
}
|
||||
}
|
||||
|
||||
return Ok(());
|
||||
}
|
||||
|
||||
impl fmt::Display for NotificationShowError {
|
||||
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
||||
write!(f, "Error showing notification: {}", self.message)
|
||||
|
||||
/// Uninitialized libnotify.
|
||||
/// This should be called when the program no longer needs libnotify for
|
||||
/// the rest of its lifecycle, typically just before exitting.
|
||||
pub fn uninit() {
|
||||
init_panic!();
|
||||
unsafe {
|
||||
sys::notify_uninit();
|
||||
}
|
||||
}
|
||||
|
||||
impl Error for NotificationShowError {
|
||||
fn description(&self) -> &str {
|
||||
"notification show error"
|
||||
|
||||
/// Gets whether or not libnotify is initialized.
|
||||
pub fn is_initted() -> bool {
|
||||
unsafe {
|
||||
if sys::notify_is_initted() == TRUE {
|
||||
return true;
|
||||
} else {
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
}
|
||||
|
||||
|
||||
/// Sets the application name.
|
||||
pub fn set_app_name(app_name: &str) -> Result<()> {
|
||||
init_panic!();
|
||||
let app_name = CString::new(app_name)?;
|
||||
|
||||
unsafe {
|
||||
sys::notify_set_app_name(app_name.as_ptr());
|
||||
}
|
||||
|
||||
return Ok(());
|
||||
}
|
||||
|
||||
|
||||
/// Gets the application name registered.
|
||||
pub fn get_app_name() -> Result<String> {
|
||||
init_panic!();
|
||||
unsafe {
|
||||
let c_name: *const c_char = sys::notify_get_app_name();
|
||||
let c_str = CStr::from_ptr(c_name);
|
||||
let string = c_str.to_str()?;
|
||||
return Ok(String::from(string));
|
||||
}
|
||||
}
|
||||
|
Loading…
Reference in New Issue
Block a user