Struct EnvironmentQuery 

pub struct EnvironmentQuery {
    pub resolution: Resolution,
    pub probe_services: bool,
    pub use_cache: bool,
    pub write_cache: bool,
}

What a caller wants resolved, and what it will pay for.

Fields

resolution: Resolution

How much may be read.

probe_services: bool

Whether a running server’s address may be contacted. A resolution that says no reports every service unknown, which is what it knows.

use_cache: bool

Whether the cache may supply the tiers this resolution cannot compute.

write_cache: bool

Whether what was computed is written back for the next fast resolution.

Implementations

impl EnvironmentQuery

pub fn fast() -> Self

What a shell prompt asks for: everything cheap, the cache for the rest, a bounded probe of the local address, and no write of tiers it did not compute.

pub fn full() -> Self

What a person waiting on a command asks for: everything, written back.

pub fn sealed(self) -> Self

The same, without touching anything outside this process: no probe, no cache read, no cache write. What a test and a hosted request use.

Trait Implementations

impl Clone for EnvironmentQuery

fn clone(&self) -> EnvironmentQuery

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for EnvironmentQuery

impl Debug for EnvironmentQuery

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

Formats the value using the given formatter.

impl Eq for EnvironmentQuery

impl PartialEq for EnvironmentQuery

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl StructuralPartialEq for EnvironmentQuery