Struct LogState

Source
pub struct LogState { /* private fields */ }
Expand description

Calculated state for a package log.

Implementations§

Source§

impl LogState

Source

pub fn new() -> Self

Create a new package log state.

Source

pub fn head(&self) -> &Option<Head>

Gets the current head of the state.

Returns None if no records have been validated yet.

Source

pub fn validate( self, record: &ProtoEnvelope<PackageRecord>, ) -> Result<Self, ValidationError>

Validates an individual package record.

It is expected that validate is called in order of the records in the log.

Note that on failure, the log state is consumed to prevent invalid state from being used in future validations.

Source

pub fn releases(&self) -> impl Iterator<Item = &Release>

Gets the releases known to the state.

The releases are returned in package log order.

Yanked releases are included.

Source

pub fn release(&self, version: &Version) -> Option<&Release>

Gets the release with the given version.

Returns None if a release with the given version does not exist.

Source

pub fn find_latest_release(&self, req: &VersionReq) -> Option<&Release>

Finds the latest release matching the given version requirement.

Releases that have been yanked are not considered.

Source

pub fn public_key(&self, key_id: &KeyID) -> Option<&PublicKey>

Gets the public key of the given key id.

Returns None if the key id is not recognized.

Source

pub fn key_permissions(&self, key_id: &KeyID) -> Option<&IndexSet<Permission>>

Gets the key permissions.

Returns None if the key id is not recognized.

Trait Implementations§

Source§

impl Clone for LogState

Source§

fn clone(&self) -> LogState

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

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

Performs copy-assignment from source. Read more
Source§

impl Debug for LogState

Source§

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

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

impl Default for LogState

Source§

fn default() -> LogState

Returns the “default value” for a type. Read more
Source§

impl<'de> Deserialize<'de> for LogState

Source§

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>
where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer. Read more
Source§

impl PartialEq for LogState

Source§

fn eq(&self, other: &LogState) -> bool

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

const 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 Serialize for LogState

Source§

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>
where __S: Serializer,

Serialize this value into the given Serde serializer. Read more
Source§

impl Validator for LogState

Source§

type Record = PackageRecord

The type of record being validated.
Source§

type Error = ValidationError

The type of error returned when validation fails.
Source§

fn validate( self, record: &ProtoEnvelope<Self::Record>, ) -> Result<Self, Self::Error>

Validates the given record.
Source§

impl Eq for LogState

Source§

impl StructuralPartialEq for LogState

Auto Trait Implementations§

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, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

Source§

fn equivalent(&self, key: &K) -> bool

Checks if this value is equivalent to the given key. Read more
Source§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

Source§

fn equivalent(&self, key: &K) -> bool

Compare self to key and return true if they are equal.
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> Same for T

Source§

type Output = T

Should always be Self
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> DeserializeOwned for T
where T: for<'de> Deserialize<'de>,