Struct HostBlock 

pub struct HostBlock {
    pub host_pattern: String,
    pub raw_host_line: String,
    pub directives: Vec<Directive>,
}

A parsed Host block with its directives.

Fields

host_pattern: String

The host alias/pattern (the value after “Host”).

raw_host_line: String

The original raw “Host …” line for faithful reproduction.

directives: Vec<Directive>

Parsed directives inside this block.

Implementations

impl HostBlock

pub fn tags(&self) -> Vec<String>

Extract tags from purple:tags comment in directives.

pub fn provider_tags(&self) -> Vec<String>

Extract provider-synced tags from purple:provider_tags comment.

pub fn has_provider_tags_comment(&self) -> bool

Check if a purple:provider_tags comment exists (even if empty). Used to distinguish “never migrated” from “migrated with no tags”.

pub fn provider(&self) -> Option<(String, String)>

Extract provider info from purple:provider comment in directives. Returns (provider_name, server_id), e.g. (“digitalocean”, “412345678”).

pub fn set_provider(&mut self, provider_name: &str, server_id: &str)

Set provider on a host block. Replaces existing purple:provider comment or adds one.

pub fn askpass(&self) -> Option<String>

Extract askpass source from purple:askpass comment in directives.

pub fn set_askpass(&mut self, source: &str)

Set askpass source on a host block. Replaces existing purple:askpass comment or adds one. Pass an empty string to remove the comment.

pub fn meta(&self) -> Vec<(String, String)>

Extract provider metadata from purple:meta comment in directives. Format: # purple:meta key=value,key=value

pub fn set_meta(&mut self, meta: &[(String, String)])

Set provider metadata on a host block. Replaces existing purple:meta comment or adds one. Pass an empty slice to remove the comment.

pub fn stale(&self) -> Option<u64>

Extract stale timestamp from purple:stale comment in directives. Returns None if absent or malformed.

pub fn set_stale(&mut self, timestamp: u64)

Mark a host block as stale with a unix timestamp. Replaces existing purple:stale comment or adds one.

pub fn clear_stale(&mut self)

Remove stale marking from a host block.

pub fn set_tags(&mut self, tags: &[String])

Set user tags on a host block. Replaces existing purple:tags comment or adds one.

pub fn set_provider_tags(&mut self, tags: &[String])

Set provider-synced tags. Replaces existing purple:provider_tags comment. Always writes the comment (even when empty) as a migration sentinel.

pub fn to_host_entry(&self) -> HostEntry

Extract a convenience HostEntry view from this block.

pub fn tunnel_count(&self) -> u16

Count forwarding directives (LocalForward, RemoteForward, DynamicForward).

pub fn has_tunnels(&self) -> bool

Check if this block has any tunnel forwarding directives.

pub fn tunnel_directives(&self) -> Vec<TunnelRule>

Extract tunnel rules from forwarding directives.

Trait Implementations

impl Clone for HostBlock

fn clone(&self) -> HostBlock

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HostBlock

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

Formats the value using the given formatter.