Struct NetworkConfig 

#[non_exhaustive]
pub struct NetworkConfig {
    pub offline: bool,
}

Configuration for outbound network access (issue #483).

Defaults

• offline: false

Examples

use deps_core::policy_config::NetworkConfig;

let config = NetworkConfig::default();
assert!(!config.offline);

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

offline: bool

When true, blocks every new outbound registry/OSV/GitHub-tags request (deps_core::cache::HttpCache’s 4 send sites) instead of making it, serving already-cached data where available and returning deps_core::DepsError::Offline otherwise. Also forces cache.enabled semantics to true for the duration (see CacheConfig::enabled’s doc comment), so a warm entry keeps serving through an online→offline transition even if caching was explicitly disabled.

HttpCache::set_offline is a bare atomic store: a request already past its ensure_online check and awaiting a response completes normally, and toggling this flag never cancels in-flight requests.

Implementations

impl NetworkConfig

pub const fn new() -> Self

Builds the default configuration (mirrors Self::default).

Needed because Self is #[non_exhaustive]: a struct literal only works inside deps-core, so every other crate must chain the with_* setters onto this constructor instead.

Examples

use deps_core::policy_config::NetworkConfig;

let config = NetworkConfig::new();
assert!(!config.offline);

pub const fn with_offline(self, offline: bool) -> Self

Overrides Self::offline. See Self::new.

pub fn mode(&self) -> NetworkMode

Converts Self::offline into the typed crate::NetworkMode every network-reachability call site reads instead of the raw config flag.

Examples

use deps_core::NetworkMode;
use deps_core::policy_config::NetworkConfig;

let config = NetworkConfig::new().with_offline(true);
assert_eq!(config.mode(), NetworkMode::Offline);

Trait Implementations

impl Clone for NetworkConfig

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for NetworkConfig

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

Formats the value using the given formatter.

impl Default for NetworkConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for NetworkConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.