#![deny(rust_2018_idioms)]
#![doc(
    html_logo_url = "https://storage.googleapis.com/fdo-gitlab-uploads/project/avatar/3213/zbus-logomark.png"
)]

//! A crate to interact with PolicyKit.
//!
//! [PolicyKit] is a toolkit for defining and handling authorizations. It is used for allowing
//! unprivileged processes to speak to privileged processes. As you can guess from the name, it is
//! based on [zbus].
//!
//! ```no_run
//! use zbus::Connection;
//! use zbus_polkit::policykit1::*;
//!
//! // Although we use `async-std` here, you can use any async runtime of choice.
//! #[async_std::main]
//! async fn main() -> Result<(), Box<dyn std::error::Error>> {
//!     let connection = Connection::system().await?;
//!     let proxy = AuthorityProxy::new(&connection).await?;
//!     let subject = Subject::new_for_owner(std::process::id(), None, None)?;
//!     let result = proxy.check_authorization(
//!         &subject,
//!         "org.zbus.BeAwesome",
//!         &std::collections::HashMap::new(),
//!         CheckAuthorizationFlags::AllowUserInteraction.into(),
//!         "",
//!     ).await?;
//!
//!     Ok(())
//! }
//! ```
//!
//! [PolicyKit]: https://gitlab.freedesktop.org/polkit/polkit/
//! [zbus]: https://crates.io/crates/zbus

mod error;
pub use error::*;

pub mod policykit1;

#[cfg(doctest)]
mod doctests {
    doc_comment::doctest!("../../README.md");
}