gix_url

Enum ArgumentSafety

Source
pub enum ArgumentSafety<'a> {
    Absent,
    Usable(&'a str),
    Dangerous(&'a str),
}
Expand description

Classification of a portion of a URL by whether it is syntactically safe to pass as an argument to a command-line program.

Various parts of URLs can be specified to begin with -. If they are used as options to a command-line application such as an SSH client, they will be treated as options rather than as non-option arguments as the developer intended. This is a security risk, because URLs are not always trusted and can often be composed or influenced by an attacker. See https://secure.phabricator.com/T12961 for details.

§Security Warning

This type only expresses known syntactic risk. It does not cover other risks, such as passing a personal access token as a username rather than a password in an application that logs usernames.

Variants§

§

Absent

May be safe. There is nothing to pass, so there is nothing dangerous.

§

Usable(&'a str)

May be safe. The argument does not begin with a - and so will not be confused as an option.

§

Dangerous(&'a str)

Dangerous! Begins with - and could be treated as an option. Use the value in error messages only.

Trait Implementations§

Source§

impl<'a> Clone for ArgumentSafety<'a>

Source§

fn clone(&self) -> ArgumentSafety<'a>

Returns a copy of the value. Read more
1.0.0 · Source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
Source§

impl<'a> Debug for ArgumentSafety<'a>

Source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
Source§

impl<'a> PartialEq for ArgumentSafety<'a>

Source§

fn eq(&self, other: &ArgumentSafety<'a>) -> bool

Tests for self and other values to be equal, and is used by ==.
1.0.0 · Source§

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
Source§

impl<'a> Copy for ArgumentSafety<'a>

Source§

impl<'a> Eq for ArgumentSafety<'a>

Source§

impl<'a> StructuralPartialEq for ArgumentSafety<'a>

Auto Trait Implementations§

§

impl<'a> Freeze for ArgumentSafety<'a>

§

impl<'a> RefUnwindSafe for ArgumentSafety<'a>

§

impl<'a> Send for ArgumentSafety<'a>

§

impl<'a> Sync for ArgumentSafety<'a>

§

impl<'a> Unpin for ArgumentSafety<'a>

§

impl<'a> UnwindSafe for ArgumentSafety<'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> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dst: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dst. 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> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
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.
Source§

impl<T> ErasedDestructor for T
where T: 'static,

Source§

impl<T> MaybeSendSync for T