omnisor 0.1.1

//! Omnisor is an asynchronous and easy-to-use high level SSH client library
//! for Rust with the tokio runtime. Powered by the Rust SSH implementation
//! [russh](https://github.com/warp-tech/russh).
//!
//! # Features
//!
//! * **Standard SSH Client** - Connect, authenticate, and execute commands on remote hosts
//! * **Network Device Sessions** - Interactive PTY sessions for routers, switches, and firewalls
//! * **Vendor Presets** - Built-in support for Cisco, Juniper, Arista, and more
//! * **Legacy Device Support** - Configurable SSH algorithms for older network equipment
//!
//! # Quick Start - Standard SSH
//!
//! For simple command execution on Linux/Unix servers:
//!
//! ```no_run
//! use omnisor::{Client, AuthMethod, ServerCheckMethod};
//!
//! #[tokio::main]
//! async fn main() -> Result<(), omnisor::Error> {
//!     let mut client = Client::connect(
//!         ("10.10.10.2", 22),
//!         "root",
//!         AuthMethod::with_password("password"),
//!         ServerCheckMethod::NoCheck,
//!     ).await?;
//!
//!     let result = client.execute("echo Hello SSH").await?;
//!     assert_eq!(result.stdout, "Hello SSH\n");
//!     assert_eq!(result.exit_status, 0);
//!
//!     Ok(())
//! }
//! ```
//!
//! # Quick Start - Network Devices
//!
//! For interactive sessions with network devices (routers, switches, firewalls):
//!
//! ```no_run
//! use omnisor::{DeviceSession, CiscoVariant};
//!
//! #[tokio::main]
//! async fn main() -> Result<(), omnisor::Error> {
//!     let mut session = DeviceSession::connect(
//!         ("192.168.1.1", 22),
//!         "admin",
//!         "password",
//!         CiscoVariant::Ios,
//!     ).await?;
//!
//!     let result = session.send_command("show version").await?;
//!     println!("{}", result.output);
//!
//!     let result = session.send_command("show ip route").await?;
//!     println!("{}", result.output);
//!
//!     session.close().await?;
//!     Ok(())
//! }
//! ```
//!
//! # Authentication Methods
//!
//! ```no_run
//! use omnisor::AuthMethod;
//!
//! // Password authentication
//! let auth = AuthMethod::with_password("secret");
//!
//! // Private key from file
//! let auth = AuthMethod::with_key_file("~/.ssh/id_rsa", None);
//!
//! // Private key with passphrase
//! let auth = AuthMethod::with_key_file("~/.ssh/id_rsa", Some("passphrase"));
//!
//! // SSH agent (Unix/Linux only)
//! #[cfg(not(target_os = "windows"))]
//! let auth = AuthMethod::with_agent();
//! ```
//!
//! # Device Session Builder
//!
//! For more control over device connections:
//!
//! ```no_run
//! use omnisor::{DeviceSession, CiscoVariant, SshAlgorithms, AuthMethod};
//! use std::time::Duration;
//!
//! #[tokio::main]
//! async fn main() -> Result<(), omnisor::Error> {
//!     let mut session = DeviceSession::builder()
//!         .address("192.168.1.1")
//!         .port(22)
//!         .username("admin")
//!         .auth(AuthMethod::with_key_file("~/.ssh/id_rsa", None))
//!         .vendor(CiscoVariant::NxOs)
//!         .command_timeout(Duration::from_secs(60))
//!         .connect()
//!         .await?;
//!
//!     let result = session.send_command("show version").await?;
//!     println!("{}", result.output);
//!
//!     session.close().await?;
//!     Ok(())
//! }
//! ```
//!
//! # Legacy Device Support
//!
//! For older devices requiring legacy SSH algorithms:
//!
//! ```no_run
//! use omnisor::{DeviceSession, CiscoVariant};
//!
//! #[tokio::main]
//! async fn main() -> Result<(), omnisor::Error> {
//!     // Use the IosLegacy variant for older Cisco devices
//!     let mut session = DeviceSession::connect(
//!         ("192.168.1.1", 22),
//!         "admin",
//!         "password",
//!         CiscoVariant::IosLegacy,
//!     ).await?;
//!
//!     let result = session.send_command("show version").await?;
//!     println!("{}", result.output);
//!
//!     session.close().await?;
//!     Ok(())
//! }
//! ```
//!
//! # Supported Vendors
//!
//! | Vendor | Variants |
//! |--------|----------|
//! | Cisco | `Ios`, `IosXe`, `IosXr`, `NxOs`, `Asa`, `Wlc`, `IosLegacy` |
//! | Juniper | `Junos`, `ScreenOs` |
//! | Arista | `AristaEos` |
//! | Linux | `Linux` (generic) |

pub mod client;
pub mod device;
pub mod error;
mod to_socket_addrs_with_hostname;

pub use client::{AuthMethod, Client, CommandExecutedResult, ServerCheckMethod};
pub use error::Error;
pub use to_socket_addrs_with_hostname::ToSocketAddrsWithHostname;

// Re-export commonly used device types at crate root for convenience
pub use device::{
    CiscoVariant, DeviceCommandResult, DeviceConfig, DeviceSession, DeviceSessionBuilder,
    DeviceVendor, JuniperVariant, SshAlgorithms,
};

// Re-export russh algorithm modules for direct use
pub use russh::cipher;
pub use russh::kex;
pub use russh::mac;