Struct ConnectionOptions 

#[non_exhaustive]
pub struct ConnectionOptions {
    pub autoconnect: bool,
    pub autoconnect_priority: Option<i32>,
    pub autoconnect_retries: Option<i32>,
}

Connection options for saved NetworkManager connections.

Controls how NetworkManager handles saved connection profiles, including automatic connection behavior.

Examples

use nmrs::ConnectionOptions;

// Basic auto-connect (using defaults)
let opts = ConnectionOptions::default();

// High-priority connection with retry limit
let opts_priority = ConnectionOptions::new(true)
    .with_priority(10)  // Higher = more preferred
    .with_retries(3);   // Retry up to 3 times

// Manual connection only
let opts_manual = ConnectionOptions::new(false);

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.

autoconnect: bool

Whether to automatically connect when available

autoconnect_priority: Option<i32>

Priority for auto-connection (higher = more preferred)

autoconnect_retries: Option<i32>

Maximum number of auto-connect retry attempts

Implementations

impl ConnectionOptions

pub fn new(autoconnect: bool) -> Self

Creates new ConnectionOptions with the specified autoconnect setting.

Examples

use nmrs::ConnectionOptions;

let opts = ConnectionOptions::new(true);

pub fn with_priority(self, priority: i32) -> Self

Sets the auto-connection priority.

pub fn with_retries(self, retries: i32) -> Self

Sets the maximum number of auto-connect retry attempts.

Trait Implementations

impl Clone for ConnectionOptions

fn clone(&self) -> ConnectionOptions

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ConnectionOptions

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

Formats the value using the given formatter.

impl Default for ConnectionOptions

fn default() -> Self

Returns the default connection options.

Defaults:

• autoconnect: true
• autoconnect_priority: None (uses NetworkManager’s default of 0)
• autoconnect_retries: None (unlimited retries)