last_order 0.1.2

A Rust library for managing network devices.
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

use std::net::ToSocketAddrs;

use anyhow::Result;
use regex::Regex;

use crate::generic::config::{Configurable, ConfigurationMode};
use crate::generic::connection::{Connection, SSHConnection};

pub type H3cSSH = H3cDevice<SSHConnection>;

pub struct H3cDevice<C: Connection> {
    connection: C,
    prompt_end: Regex,
}

impl<C: Connection<ConnectionHandler = C>> H3cDevice<C> {
    pub fn connect<A: ToSocketAddrs>(
        addr: A,
        username: Option<&str>,
        password: Option<&str>,
    ) -> Result<Self, Box<dyn std::error::Error>> {
        let mut device = Self {
            connection: C::connect(addr, username, password)?,
            prompt_end: Regex::new(r"<.*>")?,
        };

        let _ = device.connection.read(&device.prompt_end);

        device
            .connection
            .execute("screen-length disable", &device.prompt_end)?;

        Ok(device)
    }

    pub fn version(&mut self) -> Result<String> {
        self.connection.execute("display version", &self.prompt_end)
    }

    pub fn ping(&mut self, ip: &str) -> Result<String> {
        let command = format!("ping {}", ip);
        self.connection.execute(&command, &self.prompt_end)
    }
}

impl<C: Connection> Configurable for H3cDevice<C> {
    type SessionType = Self;

    fn enter_config(&mut self) -> Result<ConfigurationMode<Self>> {
        self.prompt_end = Regex::new(r"\[.*\]$")?;
        self.execute("system-view")?;

        Ok(ConfigurationMode::enter(self))
    }

    fn execute(&mut self, command: &str) -> Result<String> {
        self.connection.execute(command, &self.prompt_end)
    }

    fn exit(&mut self) -> Result<()> {
        self.prompt_end = Regex::new(r"<.*>")?;
        self.execute("quit")?;

        Ok(())
    }
}

#[test]
fn test() -> anyhow::Result<()> {
    env_logger::try_init().ok();

    let addr = format!("{}:22", "10.123.0.24");
    let user = Some("HBSpy");
    let pass = Some(std::env::var("LO_TESTPASS").expect("LO_TESTPASS not set"));

    let mut ssh = H3cSSH::connect(addr, user, pass.as_deref()).unwrap();

    let result = ssh.version()?;
    assert!(result.contains("H3C E528"), "{}", result);

    let result = ssh.ping("10.123.11.60")?;
    assert!(result.contains("0.00% packet loss"), "{}", result);

    {
        let mut config = ssh.enter_config()?;
        config.execute("interface GigabitEthernet 1/0/8")?;

        let result = config.execute("display this")?;
        assert!(result.contains("to-HPC"), "{}", result);

        config.execute("quit")?;
    }

    Ok(())
}