Skip to main content

AuthRequest

Struct AuthRequest 

Source
#[non_exhaustive]
pub struct AuthRequest<'a> { /* private fields */ }
Available on crate feature auth only.
Expand description

The context passed to the auth hook: which command is being authorized.

Marked #[non_exhaustive] so future context (roles, the parsed arguments, …) can be added without a breaking change.

§Examples

use cli_forge::{App, Command};

let mut app = App::new("demo").auth(|req| {
    // Only authorize `publish` when some session check passes.
    req.command() != "publish" || session_is_valid()
});
app.register(Command::new("publish").requires_auth(true).run(|_| { /* ... */ }));

fn session_is_valid() -> bool { true }

Implementations§

Source§

impl<'a> AuthRequest<'a>

Source

pub fn command(&self) -> &str

The name of the command being authorized (the last element of the path).

Source

pub fn path(&self) -> &[&str]

The full command-name chain from the app root to this command, e.g. ["remote", "add"].

Auto Trait Implementations§

§

impl<'a> Freeze for AuthRequest<'a>

§

impl<'a> RefUnwindSafe for AuthRequest<'a>

§

impl<'a> Send for AuthRequest<'a>

§

impl<'a> Sync for AuthRequest<'a>

§

impl<'a> Unpin for AuthRequest<'a>

§

impl<'a> UnsafeUnpin for AuthRequest<'a>

§

impl<'a> UnwindSafe for AuthRequest<'a>

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.