Struct Hostfile 

pub struct Hostfile {
    pub backend: String,
    pub hosts: Vec<String>,
}

Parsed hosts.json.

Fields

backend: String

Backend name; defaults to “tcp” when absent.

hosts: Vec<String>

ip:port per rank, in rank order.

Implementations

impl Hostfile

pub fn from_json_str(s: &str) -> Result<Self>

pub fn loopback(ports: &[u16], backend: TransportBackend) -> Self

Build a loopback hostfile: rank r listens on 127.0.0.1:ports[r]. This is the local-run analogue of hand-writing a hosts.json — used by crate::launch::LocalCluster.

pub fn to_json(&self) -> String

Serialize back to the hosts.json wire form.

pub fn write_temp(&self, tag: &str) -> Result<PathBuf>

Write this hostfile to a uniquely-named file in the temp dir and return its path. tag distinguishes concurrent runs.

pub fn from_path(path: impl AsRef<Path>) -> Result<Self>

pub fn world_size(&self) -> u32

pub fn backend(&self) -> Result<TransportBackend>

pub fn peers(&self) -> Result<Vec<SocketAddr>>

Resolve every hosts[r] entry to a single SocketAddr, in rank order.

Trait Implementations

impl Clone for Hostfile

fn clone(&self) -> Hostfile

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Hostfile

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Hostfile

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Hostfile

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.