Struct tor_config::list_builder::VecBuilder

pub struct VecBuilder<T>
where
    T: Clone,
{ /* private fields */ }

List of T, a straightforward type, being built as part of the configuration

The default is the empty list.

Example

use derive_builder::Builder;
use serde::{Deserialize, Serialize};
use tor_config::ConfigBuildError;
use tor_config::{define_list_builder_accessors, list_builder::VecBuilder};
use std::net::SocketAddr;

#[derive(Debug, Clone, Builder)]
#[builder(build_fn(error = "ConfigBuildError"))]
#[builder(derive(Debug, Serialize, Deserialize))]
pub struct FallbackDir {
    #[builder(sub_builder(fn_name = "build"), setter(custom))]
    orports: Vec<SocketAddr>,
}

define_list_builder_accessors! {
    struct FallbackDirBuilder {
        pub orports: [SocketAddr],
    }
}

let mut bld = FallbackDirBuilder::default();
bld.orports().push("[2001:db8:0::42]:12".parse().unwrap());
assert_eq!( bld.build().unwrap().orports[0].to_string(),
            "[2001:db8::42]:12" );

Wrapper struct to help derive_builder find the right types and methods

This struct is not part of the configuration API. Refer to the containing structures for information on how to build the config.

Implementations

impl<T> VecBuilder<T>

where T: Clone,

pub fn build(&self) -> Result<Vec<T>, ConfigBuildError>

Resolve this list to a list of built items.

If the value is still the Default, a built-in default list will be built and returned; otherwise each applicable item will be built, and the results collected into a single built list.

pub fn access(&mut self) -> &mut Vec<T>

Resolve the list to the default if necessary and then return &mut Vec

pub fn access_opt(&self) -> &Option<Vec<T>>

Resolve the list to the default if necessary and then return &mut Vec

pub fn access_opt_mut(&mut self) -> &mut Option<Vec<T>>

Resolve the list to the default if necessary and then return &mut Vec

Trait Implementations

impl<T> Clone for VecBuilder<T>

where T: Clone + Clone,

fn clone(&self) -> VecBuilder<T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T> Debug for VecBuilder<T>

where T: Clone + Debug,

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

Formats the value using the given formatter.

impl<T> Default for VecBuilder<T>

where T: Clone,

fn default() -> Self

Returns the “default value” for a type.

impl<'de, T> Deserialize<'de> for VecBuilder<T>

where T: Clone + Deserialize<'de>,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<T> Serialize for VecBuilder<T>

where T: Clone + Serialize,

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

where __S: Serializer,

Serialize this value into the given Serde serializer.