Struct SpannedExpose 

pub struct SpannedExpose {

    pub service: Option<OneOrMany<Name>>,
    pub protocol: Option<OneOrMany<Name>>,
    pub directory: Option<OneOrMany<Name>>,
    pub runner: Option<OneOrMany<Name>>,
    pub resolver: Option<OneOrMany<Name>>,
    pub dictionary: Option<OneOrMany<Name>>,
    pub config: Option<OneOrMany<Name>>,
    pub from: Spanned<OneOrMany<ExposeFromRef>>,
    pub as: Option<Spanned<Name>>,
    pub to: Option<Spanned<ExposeToRef>>,
    pub rights: Option<Spanned<Rights>>,
    pub subdir: Option<Spanned<RelativePath>>,
    pub event_stream: Option<Spanned<OneOrMany<Name>>>,
    pub scope: Option<OneOrMany<EventScope>>,
    pub availability: Option<Availability>,
    pub source_availability: Option<SourceAvailability>,
}

Fields

service: Option<OneOrMany<Name>>

When routing a service, the name of a [service capability][doc-service].

protocol: Option<OneOrMany<Name>>

When routing a protocol, the name of a [protocol capability][doc-protocol].

directory: Option<OneOrMany<Name>>

When routing a directory, the name of a [directory capability][doc-directory].

runner: Option<OneOrMany<Name>>

When routing a runner, the name of a [runner capability][doc-runners].

resolver: Option<OneOrMany<Name>>

When routing a resolver, the name of a [resolver capability][doc-resolvers].

dictionary: Option<OneOrMany<Name>>

When routing a dictionary, the name of a [dictionary capability][doc-dictionaries].

config: Option<OneOrMany<Name>>

When routing a config, the name of a configuration capability.

from: Spanned<OneOrMany<ExposeFromRef>>

from: The source of the capability, one of:

• self: This component. Requires a corresponding capability declaration.
• framework: The Component Framework runtime.
• #<child-name>: A reference to a child component instance.

as: Option<Spanned<Name>>

The name for the capability as it will be known by the target. If omitted, defaults to the original name. as cannot be used when an array of multiple capability names is provided.

to: Option<Spanned<ExposeToRef>>

The capability target. Either parent or framework. Defaults to parent.

rights: Option<Spanned<Rights>>

(directory only) the maximum [directory rights][doc-directory-rights] to apply to the exposed directory capability.

subdir: Option<Spanned<RelativePath>>

(directory only) the relative path of a subdirectory within the source directory capability to route.

event_stream: Option<Spanned<OneOrMany<Name>>>

(event_stream only) the name(s) of the event streams being exposed.

scope: Option<OneOrMany<EventScope>>

(event_stream only) the scope(s) of the event streams being exposed. This is used to downscope the range of components to which an event stream refers and make it refer only to the components defined in the scope.

availability: Option<Availability>

availability (optional): The expectations around this capability’s availability. Affects build-time and runtime route validation. One of:

• required (default): a required dependency, the source must exist and provide it. Use this when the target of this expose requires this capability to function properly.
• optional: an optional dependency. Use this when the target of the expose can function with or without this capability. The target must not have a required dependency on the capability. The ultimate source of this expose must be void or an actual component.
• same_as_target: the availability expectations of this capability will match the target’s. If the target requires the capability, then this field is set to required. If the target has an optional dependency on the capability, then the field is set to optional.
• transitional: like optional, but will tolerate a missing source. Use this only to avoid validation errors during transitional periods of multi-step code changes.

For more information, see the availability documentation.

source_availability: Option<SourceAvailability>

Whether or not the source of this offer must exist. One of:

• required (default): the source (from) must be defined in this manifest.
• unknown: the source of this offer will be rewritten to void if its source (from) is not defined in this manifest after includes are processed.

Trait Implementations

impl AsClause for SpannedExpose

fn as(&self) -> Option<&BorrowedName>

impl Clone for SpannedExpose

fn clone(&self) -> SpannedExpose

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SpannedExpose

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SpannedExpose

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for SpannedExpose

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl SpannedCapabilityClause for SpannedExpose

fn service(&self) -> Option<OneOrMany<&BorrowedName>>

fn protocol(&self) -> Option<OneOrMany<&BorrowedName>>

fn directory(&self) -> Option<OneOrMany<&BorrowedName>>

fn storage(&self) -> Option<OneOrMany<&BorrowedName>>

fn runner(&self) -> Option<OneOrMany<&BorrowedName>>

fn resolver(&self) -> Option<OneOrMany<&BorrowedName>>

fn event_stream(&self) -> Option<OneOrMany<&BorrowedName>>

fn dictionary(&self) -> Option<OneOrMany<&BorrowedName>>

fn config(&self) -> Option<OneOrMany<&BorrowedName>>

fn decl_type(&self) -> &'static str

fn supported(&self) -> &[&'static str]

fn capability_type(&self) -> Result<&'static str, Error>

Returns the name of the capability for display purposes. If service() returns Some, the capability name must be “service”, etc.

impl StructuralPartialEq for SpannedExpose