Enum MeshLookup 

pub enum MeshLookup {
    Url,
    Host,
    Port,
    UrlNamed {
        name: String,
    },
    PortNamed {
        name: String,
    },
}

Which aspect of a mesh peer’s address to inject.

Which port, when the peer has several (R844-B22)

Self::Url and Self::Port used to mean “the first entry in the peer’s expose.mesh.ports”. That was a positional guess — the same one kamaji::name_anonymous_ports refuses to make and that R844-F15 removed from the service-record fanout — and it could hand a dependent workload a metrics listener’s number in its environment while looking entirely successful. It survived only because, before R844-F17, a manifest had no way to name a port, so “first” was the only selector that existed.

They now resolve by the same rule everything else in this workspace uses: one port resolves to that port; several resolve to the one named http; several with no http is an error, not a pick. The error is the feature — it sends the author back to the manifest to say which listener they meant, instead of handing a dependent a plausible wrong number.

Self::UrlNamed / Self::PortNamed say it outright and are the spelling to prefer for any peer with more than one listener.

The named variants are appended rather than added as fields on the existing ones: MeshLookup rides EnvValue::FromMesh inside a WorkloadSpec across the postcard kamaji UDS, where an enum is encoded by variant index, so appending leaves every existing encoding byte-identical while adding a field to Url would not.

Variants

Url

Full URL, e.g. "http://noisetable-db.pdx:5432". See the type docs for which port this picks when the peer has several.

Host

Hostname only, e.g. "noisetable-db.pdx".

Port

Port only, e.g. "5432". See the type docs for which port this picks when the peer has several.

UrlNamed

Full URL at the peer’s port called name, e.g. "http://api.pdx:8443" for name = "wss". Errors when the peer has no port by that name.

Fields

name: String

PortNamed

The peer’s port called name, stringified. Errors when the peer has no port by that name.

Fields

name: String

Implementations

impl MeshLookup

pub fn port_name(&self) -> Option<&str>

The port name this lookup selects, or None when it takes the default (see the type docs) or needs no port at all.

pub fn needs_port(&self) -> bool

Whether this lookup needs a port at all — Host is the one that does not, and it must keep resolving for a portless peer.

Trait Implementations

impl Clone for MeshLookup

fn clone(&self) -> MeshLookup

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MeshLookup

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for MeshLookup

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for MeshLookup

impl PartialEq for MeshLookup

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for MeshLookup

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for MeshLookup

impl TS for MeshLookup

type WithoutGenerics = MeshLookup

If this type does not have generic parameters, then WithoutGenerics should just be Self. If the type does have generic parameters, then all generic parameters must be replaced with a dummy type, e.g ts_rs::Dummy or ().
The only requirement for these dummy types is that EXPORT_TO must be None.

type OptionInnerType = MeshLookup

If the implementing type is std::option::Option<T>, then this associated type is set to T. All other implementations of TS should set this type to Self instead.

fn ident(cfg: &Config) -> String

Identifier of this type, excluding generic parameters.

fn docs() -> Option<String>

JSDoc comment to describe this type in TypeScript - when TS is derived, docs are automatically read from your doc comments or #[doc = ".."] attributes

fn name(cfg: &Config) -> String

Name of this type in TypeScript, including generic parameters

fn decl_concrete(cfg: &Config) -> String

Declaration of this type using the supplied generic arguments. The resulting TypeScript definition will not be generic. For that, see TS::decl(). If this type is not generic, then this function is equivalent to TS::decl().

fn decl(cfg: &Config) -> String

Declaration of this type, e.g. type User = { user_id: number, ... }. This function will panic if the type has no declaration.

fn inline(cfg: &Config) -> String

Formats this types definition in TypeScript, e.g { user_id: number }. This function will panic if the type cannot be inlined.

fn inline_flattened(cfg: &Config) -> String

Flatten a type declaration. This function will panic if the type cannot be flattened.

fn visit_generics(v: &mut impl TypeVisitor)

where Self: 'static,

Iterates over all type parameters of this type.

fn output_path() -> Option<PathBuf>

Returns the output path to where T should be exported, relative to the output directory. The returned path does not include any base directory.

fn visit_dependencies(v: &mut impl TypeVisitor)

where Self: 'static,

Iterates over all dependency of this type.

fn dependencies(cfg: &Config) -> Vec<Dependency>

where Self: 'static,

Resolves all dependencies of this type recursively.

fn export(cfg: &Config) -> Result<(), ExportError>

where Self: 'static,

Manually export this type to the filesystem. To export this type together with all of its dependencies, use TS::export_all.

fn export_all(cfg: &Config) -> Result<(), ExportError>

where Self: 'static,

Manually export this type to the filesystem, together with all of its dependencies. To export only this type, without its dependencies, use TS::export.

fn export_to_string(cfg: &Config) -> Result<String, ExportError>

where Self: 'static,

Manually generate bindings for this type, returning a String. This function does not format the output, even if the format feature is enabled.