last_order 0.1.4

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

use std::{any::Any, net::ToSocketAddrs};

use crate::error::Error;

use super::config::ConfigSession;

/// Trait for network devices with vendor-specific behavior.
pub trait NetworkDevice {
    /// Connects to the device with the specified address and credentials.
    fn connect<A: ToSocketAddrs>(
        addr: A,
        username: Option<&str>,
        password: Option<&str>,
    ) -> Result<Self, Error>
    where
        Self: Sized;

    /// Converts the device into a dynamic trait object for storage in a collection.
    fn into_dyn(self) -> Box<dyn NetworkDevice>
    where
        Self: Sized + 'static,
    {
        Box::new(self)
    }

    /// Returns the device as an Any trait object for downcasting.
    fn as_any(&mut self) -> &mut dyn Any
    where
        Self: 'static;

    /// Executes a command on the device and returns the output.
    /// Used for both general commands and commands in configuration mode.
    fn execute(&mut self, command: &str) -> Result<String, Error>;

    fn enter_config(&mut self) -> Result<Box<dyn ConfigSession + '_>, Error>;

    fn exit(&mut self) -> Result<(), Error>;

    /// Retrieves the device version information.
    fn version(&mut self) -> Result<String, Error>;

    /// Retrieves the device log buffer.
    fn logbuffer(&mut self) -> Result<String, Error>;

    /// Performs a ping operation to the specified IP.
    fn ping(&mut self, ip: &str) -> Result<String, Error>;
}