mozilla-central/third_party/rust/dbus/src/stdintf.rs

Source code

Revision control

Copy as Markdown

Other Tools

//! This module contains some standard interfaces and an easy way to call them.
//!
//! See the [D-Bus specification](https://dbus.freedesktop.org/doc/dbus-specification.html#standard-interfaces) for more information about these standard interfaces.
//!
//! The code here was originally created by dbus-codegen.
//!
//! # Example
//! ```
//! use dbus::{Connection, BusType};
//! use dbus::stdintf::org_freedesktop_dbus::Introspectable;
//! let c = Connection::get_private(BusType::Session).unwrap();
//! let p = c.with_path("org.freedesktop.DBus", "/", 10000);
//! println!("Introspection XML: {}", p.introspect().unwrap());
//! ```
//!
#![allow(missing_docs)]
pub use self::org_freedesktop_dbus::Peer as OrgFreedesktopDBusPeer;
pub use self::org_freedesktop_dbus::Introspectable as OrgFreedesktopDBusIntrospectable;
pub use self::org_freedesktop_dbus::Properties as OrgFreedesktopDBusProperties;
pub use self::org_freedesktop_dbus::ObjectManager as OrgFreedesktopDBusObjectManager;
pub mod org_freedesktop_dbus {
use arg;
/// Method of the [org.freedesktop.DBus.Introspectable](https://dbus.freedesktop.org/doc/dbus-specification.html#standard-interfaces-introspectable) interface.
pub trait Introspectable {
type Err;
fn introspect(&self) -> Result<String, Self::Err>;
}
impl<'a, C: ::std::ops::Deref<Target=::Connection>> Introspectable for ::ConnPath<'a, C> {
type Err = ::Error;
fn introspect(&self) -> Result<String, Self::Err> {
let mut m = try!(self.method_call_with_args(&"org.freedesktop.DBus.Introspectable".into(), &"Introspect".into(), |_| {
}));
try!(m.as_result());
let mut i = m.iter_init();
let xml: String = try!(i.read());
Ok(xml)
}
}
/// Methods of the [org.freedesktop.DBus.Properties](https://dbus.freedesktop.org/doc/dbus-specification.html#standard-interfaces-properties) interface.
pub trait Properties {
type Err;
fn get<R0: for<'b> arg::Get<'b>>(&self, interface_name: &str, property_name: &str) -> Result<R0, Self::Err>;
fn get_all(&self, interface_name: &str) -> Result<::std::collections::HashMap<String, arg::Variant<Box<arg::RefArg>>>, Self::Err>;
fn set<I2: arg::Arg + arg::Append>(&self, interface_name: &str, property_name: &str, value: I2) -> Result<(), Self::Err>;
}
impl<'a, C: ::std::ops::Deref<Target=::Connection>> Properties for ::ConnPath<'a, C> {
type Err = ::Error;
fn get<R0: for<'b> arg::Get<'b>>(&self, interface_name: &str, property_name: &str) -> Result<R0, Self::Err> {
let mut m = try!(self.method_call_with_args(&"org.freedesktop.DBus.Properties".into(), &"Get".into(), |msg| {
let mut i = arg::IterAppend::new(msg);
i.append(interface_name);
i.append(property_name);
}));
try!(m.as_result());
let mut i = m.iter_init();
let value: arg::Variant<R0> = try!(i.read());
Ok(value.0)
}
fn get_all(&self, interface_name: &str) -> Result<::std::collections::HashMap<String, arg::Variant<Box<arg::RefArg>>>, Self::Err> {
let mut m = try!(self.method_call_with_args(&"org.freedesktop.DBus.Properties".into(), &"GetAll".into(), |msg| {
let mut i = arg::IterAppend::new(msg);
i.append(interface_name);
}));
try!(m.as_result());
let mut i = m.iter_init();
let properties: ::std::collections::HashMap<String, arg::Variant<Box<arg::RefArg>>> = try!(i.read());
Ok(properties)
}
fn set<I2: arg::Arg + arg::Append>(&self, interface_name: &str, property_name: &str, value: I2) -> Result<(), Self::Err> {
let mut m = try!(self.method_call_with_args(&"org.freedesktop.DBus.Properties".into(), &"Set".into(), |msg| {
let mut i = arg::IterAppend::new(msg);
i.append(interface_name);
i.append(property_name);
i.append(arg::Variant(value));
}));
try!(m.as_result());
Ok(())
}
}
#[derive(Debug, Default)]
/// Struct to send/receive the PropertiesChanged signal of the
pub struct PropertiesPropertiesChanged {
pub interface_name: String,
pub changed_properties: ::std::collections::HashMap<String, arg::Variant<Box<arg::RefArg>>>,
pub invalidated_properties: Vec<String>,
}
impl ::SignalArgs for PropertiesPropertiesChanged {
const NAME: &'static str = "PropertiesChanged";
const INTERFACE: &'static str = "org.freedesktop.DBus.Properties";
fn append(&self, i: &mut arg::IterAppend) {
(&self.interface_name as &arg::RefArg).append(i);
(&self.changed_properties as &arg::RefArg).append(i);
(&self.invalidated_properties as &arg::RefArg).append(i);
}
fn get(&mut self, i: &mut arg::Iter) -> Result<(), arg::TypeMismatchError> {
self.interface_name = try!(i.read());
self.changed_properties = try!(i.read());
self.invalidated_properties = try!(i.read());
Ok(())
}
}
/// Method of the [org.freedesktop.DBus.ObjectManager](https://dbus.freedesktop.org/doc/dbus-specification.html#standard-interfaces-objectmanager) interface.
pub trait ObjectManager {
type Err;
fn get_managed_objects(&self) -> Result<::std::collections::HashMap<::Path<'static>, ::std::collections::HashMap<String, ::std::collections::HashMap<String, arg::Variant<Box<arg::RefArg>>>>>, Self::Err>;
}
impl<'a, C: ::std::ops::Deref<Target=::Connection>> ObjectManager for ::ConnPath<'a, C> {
type Err = ::Error;
fn get_managed_objects(&self) -> Result<::std::collections::HashMap<::Path<'static>, ::std::collections::HashMap<String, ::std::collections::HashMap<String, arg::Variant<Box<arg::RefArg>>>>>, Self::Err> {
let mut m = try!(self.method_call_with_args(&"org.freedesktop.DBus.ObjectManager".into(), &"GetManagedObjects".into(), |_| {
}));
try!(m.as_result());
let mut i = m.iter_init();
let objects: ::std::collections::HashMap<::Path<'static>, ::std::collections::HashMap<String, ::std::collections::HashMap<String, arg::Variant<Box<arg::RefArg>>>>> = try!(i.read());
Ok(objects)
}
}
#[derive(Debug, Default)]
/// Struct to send/receive the InterfacesAdded signal of the
pub struct ObjectManagerInterfacesAdded {
pub object: ::Path<'static>,
pub interfaces: ::std::collections::HashMap<String, ::std::collections::HashMap<String, arg::Variant<Box<arg::RefArg>>>>,
}
impl ::SignalArgs for ObjectManagerInterfacesAdded {
const NAME: &'static str = "InterfacesAdded";
const INTERFACE: &'static str = "org.freedesktop.DBus.ObjectManager";
fn append(&self, i: &mut arg::IterAppend) {
(&self.object as &arg::RefArg).append(i);
(&self.interfaces as &arg::RefArg).append(i);
}
fn get(&mut self, i: &mut arg::Iter) -> Result<(), arg::TypeMismatchError> {
self.object = try!(i.read());
self.interfaces = try!(i.read());
Ok(())
}
}
#[derive(Debug, Default)]
/// Struct to send/receive the InterfacesRemoved signal of the
pub struct ObjectManagerInterfacesRemoved {
pub object: ::Path<'static>,
pub interfaces: Vec<String>,
}
impl ::SignalArgs for ObjectManagerInterfacesRemoved {
const NAME: &'static str = "InterfacesRemoved";
const INTERFACE: &'static str = "org.freedesktop.DBus.ObjectManager";
fn append(&self, i: &mut arg::IterAppend) {
(&self.object as &arg::RefArg).append(i);
(&self.interfaces as &arg::RefArg).append(i);
}
fn get(&mut self, i: &mut arg::Iter) -> Result<(), arg::TypeMismatchError> {
self.object = try!(i.read());
self.interfaces = try!(i.read());
Ok(())
}
}
/// Methods of the [org.freedesktop.DBus.Peer](https://dbus.freedesktop.org/doc/dbus-specification.html#standard-interfaces-peer) interface.
pub trait Peer {
type Err;
fn ping(&self) -> Result<(), Self::Err>;
fn get_machine_id(&self) -> Result<String, Self::Err>;
}
impl<'a, C: ::std::ops::Deref<Target=::Connection>> Peer for ::ConnPath<'a, C> {
type Err = ::Error;
fn ping(&self) -> Result<(), Self::Err> {
let mut m = try!(self.method_call_with_args(&"org.freedesktop.DBus.Peer".into(), &"Ping".into(), |_| {
}));
try!(m.as_result());
Ok(())
}
fn get_machine_id(&self) -> Result<String, Self::Err> {
let mut m = try!(self.method_call_with_args(&"org.freedesktop.DBus.Peer".into(), &"GetMachineId".into(), |_| {
}));
try!(m.as_result());
let mut i = m.iter_init();
let machine_uuid: String = try!(i.read());
Ok(machine_uuid)
}
}
}