bgpfu-netconf 0.1.0

A toolset for working with IRR data
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125

use std::{io::Write, sync::Arc};

use quick_xml::{events::BytesText, Writer};

use crate::{
    capabilities::{Capability, Requirements},
    message::{
        rpc::{
            operation::{self, params::Required},
            Operation,
        },
        WriteError, WriteXml,
    },
    session::Context,
};

use super::BareReply;

/// Create a private copy of the candidate configuration or open the default instance or a
/// user-defined instance of the ephemeral configuration database.
///
/// See [Juniper documentation][junos-docs].
///
/// [junos-docs]: https://www.juniper.net/documentation/us/en/software/junos/netconf/junos-xml-protocol/topics/ref/tag/junos-xml-protocol-open-configuration.html
#[derive(Debug, Clone)]
pub struct OpenConfiguration {
    target: Target,
}

impl Operation for OpenConfiguration {
    const NAME: &'static str = "open-configuration";
    const REQUIRED_CAPABILITIES: Requirements =
        Requirements::One(Capability::JunosXmlManagementProtocol);
    type Builder<'a> = Builder<'a>;
    type Reply = BareReply;
}

#[derive(Debug, Clone)]
enum Target {
    Private,
    Ephemeral(Ephemeral),
}

#[derive(Debug, Default, Clone)]
enum Ephemeral {
    #[default]
    Default,
    Named(Arc<str>),
}

impl WriteXml for OpenConfiguration {
    fn write_xml<W: Write>(&self, writer: &mut Writer<W>) -> Result<(), WriteError> {
        _ = writer
            .create_element(Self::NAME)
            .write_inner_content(|writer| self.target.write_xml(writer))?;
        Ok(())
    }
}

impl WriteXml for Target {
    fn write_xml<W: Write>(&self, writer: &mut Writer<W>) -> Result<(), WriteError> {
        match self {
            Self::Private => {
                _ = writer.create_element("private").write_empty()?;
                Ok(())
            }
            Self::Ephemeral(ephemeral) => ephemeral.write_xml(writer),
        }
    }
}

impl WriteXml for Ephemeral {
    fn write_xml<W: Write>(&self, writer: &mut Writer<W>) -> Result<(), WriteError> {
        _ = match self {
            Self::Default => writer.create_element("ephemeral").write_empty()?,
            Self::Named(name) => writer
                .create_element("ephemeral-instance")
                .write_text_content(BytesText::new(name))?,
        };
        Ok(())
    }
}

#[derive(Debug, Clone)]
#[must_use]
pub struct Builder<'a> {
    _ctx: &'a Context,
    target: Required<Target>,
}

impl Builder<'_> {
    fn target(mut self, target: Target) -> Self {
        self.target.set(target);
        self
    }

    pub fn private(self) -> Self {
        self.target(Target::Private)
    }

    pub fn ephemeral<S: AsRef<str>>(self, name: Option<S>) -> Self {
        #[allow(clippy::option_if_let_else)]
        let ephemeral = if let Some(name) = name {
            Ephemeral::Named(name.as_ref().into())
        } else {
            Ephemeral::Default
        };
        self.target(Target::Ephemeral(ephemeral))
    }
}

impl<'a> operation::Builder<'a, OpenConfiguration> for Builder<'a> {
    fn new(ctx: &'a Context) -> Self {
        Self {
            _ctx: ctx,
            target: Required::init(),
        }
    }

    fn finish(self) -> Result<OpenConfiguration, crate::Error> {
        Ok(OpenConfiguration {
            target: self.target.require::<OpenConfiguration>("target")?,
        })
    }
}