Struct HostEntry 

pub struct HostEntry {

    pub alias: String,
    pub hostname: String,
    pub user: String,
    pub port: u16,
    pub identity_file: String,
    pub proxy_jump: String,
    pub source_file: Option<PathBuf>,
    pub tags: Vec<String>,
    pub provider_tags: Vec<String>,
    pub has_provider_tags: bool,
    pub provider: Option<String>,
    pub tunnel_count: u16,
    pub askpass: Option<String>,
    pub vault_ssh: Option<String>,
    pub vault_addr: Option<String>,
    pub certificate_file: String,
    pub provider_meta: Vec<(String, String)>,
    pub stale: Option<u64>,
}

Convenience view for the TUI — extracted from a HostBlock.

Fields

alias: String

hostname: String

user: String

port: u16

identity_file: String

proxy_jump: String

source_file: Option<PathBuf>

If this host comes from an included file, the file path.

tags: Vec<String>

User-added tags from purple:tags comment.

provider_tags: Vec<String>

Provider-synced tags from purple:provider_tags comment.

has_provider_tags: bool

Whether a purple:provider_tags comment exists (distinguishes “never migrated” from “empty”).

provider: Option<String>

Cloud provider label from purple:provider comment (e.g. “do”, “vultr”).

tunnel_count: u16

Number of tunnel forwarding directives.

askpass: Option<String>

Password source from purple:askpass comment (e.g. “keychain”, “op://…”, “pass:…”).

vault_ssh: Option<String>

Vault SSH certificate signing role from purple:vault-ssh comment.

vault_addr: Option<String>

Optional Vault HTTP endpoint from purple:vault-addr comment. When set, purple passes it as VAULT_ADDR to the vault subprocess for this host’s signing, overriding the parent shell. Empty = inherit env.

certificate_file: String

CertificateFile directive value (e.g. “~/.ssh/my-cert.pub”).

provider_meta: Vec<(String, String)>

Provider metadata from purple:meta comment (region, plan, etc.).

stale: Option<u64>

Unix timestamp when the host was marked stale (disappeared from provider sync).

Implementations

impl HostEntry

pub fn ssh_command(&self, config_path: &Path) -> String

Build the SSH command string for this host. Includes -F <config_path> when the config is non-default so the alias resolves correctly when pasted into a terminal. Shell-quotes both the config path and alias to prevent injection.

Trait Implementations

impl Clone for HostEntry

fn clone(&self) -> HostEntry

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for HostEntry

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for HostEntry

fn default() -> Self

Returns the “default value” for a type.