Struct StoreState

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

The state of the Nix store at a given point in time

Implementations§

Source§

impl StoreState

Source

pub fn new(config: NixConfiguration) -> Self

Create a new, empty, StoreState with the specified Nix configuration

Source

pub fn add_path(&mut self, path: impl AsRef<Path>) -> Result<(), StoreError>

Add a path to the StoreState

§Errors

Will propagate an error if the prefix is impossible to strip due to misconfiguration

Source

pub fn paths(&self) -> impl Iterator<Item = PathBuf> + '_

Iterator over the paths in this StoreState

Source

pub fn diff(&self, other: &StoreState) -> Result<Self, StoreError>

Return all paths that are different between this StoreState and another StoreState

This returns elements that are in other, but not in self

§Errors

Will return an error if two stores with incompatible configuration are compared.

Source

pub fn path_count(&self) -> usize

Returns the number of unique paths in the store

Source

pub fn from_store_excluding( configuration: &NixConfiguration, excludes: &[Regex], ) -> Result<Self, StoreError>

Create a StoreState from the current status of the Nix store pointed to by the given NixConfiguration including installables as well as other paths matching the supplied regexes

§Errors

Will propagate any IO errors that occur trying to enumerate the Nix store

Source

pub fn from_store(configuration: &NixConfiguration) -> Result<Self, StoreError>

Create a StoreState from the current status of the Nix store pointed to by the given NixConfiguration

This is a wrapper around from_store_excluding with the default include filters implied.

The default filters will include:

  • Any installable (non-disableable)
  • Any nix-shell derivations
§Errors

Will propagate any IO errors that occur trying to enumerate the Nix store

Source

pub async fn filter_against_cache( self, cache_uri: &str, ) -> Result<Self, StoreError>

Filter this Store state against the given nix binary cache, removing any paths that are present in the cache. The provided cache uri is expected not to have a trailing slash

§Errors

Will propagate any network or nix store interaction errors that occur

Trait Implementations§

Source§

impl<'__de, __Context> BorrowDecode<'__de, __Context> for StoreState

Source§

fn borrow_decode<__D: BorrowDecoder<'__de, Context = __Context>>( decoder: &mut __D, ) -> Result<Self, DecodeError>

Attempt to decode this type with the given BorrowDecode.
Source§

impl Clone for StoreState

Source§

fn clone(&self) -> StoreState

Returns a duplicate 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 Debug for StoreState

Source§

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

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

impl<__Context> Decode<__Context> for StoreState

Source§

fn decode<__D: Decoder<Context = __Context>>( decoder: &mut __D, ) -> Result<Self, DecodeError>

Attempt to decode this type with the given Decode.
Source§

impl Default for StoreState

Source§

fn default() -> StoreState

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

impl Encode for StoreState

Source§

fn encode<__E: Encoder>(&self, encoder: &mut __E) -> Result<(), EncodeError>

Encode a given type.
Source§

impl PartialEq for StoreState

Source§

fn eq(&self, other: &StoreState) -> 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 Eq for StoreState

Source§

impl StructuralPartialEq for StoreState

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

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> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
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> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
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<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V

Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

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