Struct ConfigService 

pub struct ConfigService<'a> { /* private fields */ }

SSH config file operations.

Implementations

impl<'a> ConfigService<'a>

pub fn new(paths: &'a SshPaths) -> Self

pub async fn load(&self) -> Result<ConfigAst>

Load and parse the SSH config into a lossless AST (cached); returns an empty AST when the file is missing.

Errors

Error::Io when the file is unreadable.

pub async fn save(&self, ast: &ConfigAst) -> Result<()>

Save the AST atomically with 0o600 permissions.

Errors

Error::ConfigWriteFailed (write/rename) or Error::Io (chmod).

pub async fn resolve_host(&self, host: &str) -> Result<ResolvedHost>

Resolve a host alias to a ResolvedHost, expanding Includes and tokens.

Errors

Error::ConfigIncludeCycle or Error::Io.

pub async fn parse_typed(&self) -> Result<SshConfig>

Parse the config into an ssh2_config_rs::SshConfig (supports .query(host)).

Errors

Error::ConfigParseFailed or Error::Io.

pub fn get_host_directive( ast: &ConfigAst, host: &str, key: &str, ) -> Option<String>

Get a directive value for a host from the AST; first match wins.

pub fn get_all_host_directives( ast: &ConfigAst, host: &str, ) -> Vec<(String, String)>

Get all directives for a host.

pub fn add_host( ast: &mut ConfigAst, name: &str, directives: Vec<(String, String)>, ) -> Result<()>

Add a new Host block.

Errors

Error::DuplicateHost if one with the given name already exists.

pub fn remove_host(ast: &mut ConfigAst, name: &str) -> Result<()>

Remove a Host block by name.

Errors

Error::HostNotFound if absent.

pub fn rename_host( ast: &mut ConfigAst, old_name: &str, new_name: &str, ) -> Result<()>

Rename a Host block.

Errors

Error::HostNotFound if old_name is absent, or Error::DuplicateHost if new_name exists.

pub fn upsert_managed_block( ast: &mut ConfigAst, name: &str, directives: Vec<(String, String)>, )

Add a managed block (or replace an existing one).

pub fn remove_managed_block(ast: &mut ConfigAst, name: &str) -> Result<()>

Remove a managed block by name.

Errors

Error::ManagedBlockNotFound if absent.

pub fn list_managed_blocks(ast: &ConfigAst) -> Vec<String>

List all managed block names.

pub async fn ensure_config_file(&self) -> Result<()>

Create ~/.ssh (0o700) and the config file (0o600) if missing.

Errors

Error::Io on failure.

pub fn config_path(&self) -> &Path

Get the path to the config file.

pub async fn edit<F>(&self, f: F) -> Result<()>

where F: FnOnce(&mut ConfigAst) -> Result<()>,

Load, mutate via f, then save.

Errors

From any step: ensure, load, f, or save.

pub async fn diagnose(&self) -> Result<Vec<Diagnostic>>

Diagnose the config: proxy conflicts, duplicate aliases, Host * placement, and missing or .pub IdentityFiles.

Errors

Error::Io.