Struct DistributionTable 

pub struct DistributionTable { /* private fields */ }

Everything wsl --list --verbose reported, and everything it reported that could not be read.

Implementations

impl DistributionTable

pub fn parse(text: &str) -> Self

Parses the decoded table.

pub fn from_console_output(bytes: &[u8]) -> Self

Parses raw console bytes, choosing the encoding.

pub fn entries(&self) -> &[InstalledDistribution]

Every row that parsed.

pub fn unreadable(&self) -> &[String]

Rows that looked like rows and whose name did not survive decoding.

Reported rather than dropped: an operator whose distribution is missing from wsl list deserves to be told that a row was unreadable, not that nothing is installed.

pub fn is_empty(&self) -> bool

Whether nothing at all parsed.

pub fn default_distribution(&self) -> Option<&InstalledDistribution>

The row WSL marked with *, if any.

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

The names that parsed, in order, for an error that has to list them.

pub fn exactly(&self, name: &str) -> Result<&InstalledDistribution, WslError>

The one row whose name is exactly name.

Exact and case-sensitive. WSL’s own --distribution is case-sensitive, so accepting ubuntu for Ubuntu here would produce a provider record and a task naming a distribution that wsl.exe then cannot select.

Errors

WslError::InvalidName when the name is not usable at all; WslError::NotInstalled when nothing matches, listing what is there; WslError::AmbiguousName when two rows carry it, which means the table is not something to act on.

Trait Implementations

impl Clone for DistributionTable

fn clone(&self) -> DistributionTable

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DistributionTable

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

Formats the value using the given formatter.

impl Default for DistributionTable

fn default() -> DistributionTable

Returns the “default value” for a type.

impl Eq for DistributionTable

impl PartialEq for DistributionTable

fn eq(&self, other: &DistributionTable) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for DistributionTable