Struct RegistrySlice 

#[non_exhaustive]
pub struct RegistrySlice {
    pub version: String,
    pub app: String,
    pub convention: i64,
    pub name: String,
    pub service_origin: Option<Declared<ServiceOrigin>>,
    pub description: Option<String>,
    pub subjects: Vec<SubjectDecl>,
    pub procedures: Vec<ProcedureDecl>,
    pub blob: Vec<BlobDecl>,
    pub media: Vec<MediaDecl>,
    pub deprecated: Vec<DeprecationDecl>,
}

What one build says it serves: the payload of an introspect reply. #[non_exhaustive]: every version of this type so far has been the previous one plus a field (encoding v1.5, blob v1.8, media v1.16), and each of those was a breaking change for anyone constructing one. It is a parse result, not a thing callers build — parse_slice is the constructor — so the attribute costs the intended use nothing and stops the next field being a break (#325).

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

version: String

[registry] version — the number a version-skew check compares.

app: String

convention: i64

The convention major version (1 for keyspace-v2 as ratified).

name: String

The producer or service base name (sysinfo, catalog, …).

service_origin: Option<Declared<ServiceOrigin>>

Some(origin) for a service (@catalog); None for a host producer, whose origin is the host it runs on and therefore not in the slice.

description: Option<String>

subjects: Vec<SubjectDecl>

procedures: Vec<ProcedureDecl>

blob: Vec<BlobDecl>

The @blob tiers this build serves (RFC 08 §2/§6, v1.8). Empty for every producer that serves no blobs, and for any slice written before v1.8 — the parser is forward- and backward-tolerant here, which is the same posture it takes to unknown keys.

media: Vec<MediaDecl>

The @media streams this build publishes (RFC 08 §2/§6, v1.16 — closing the asymmetry v1.8 recorded). Same tolerance as blob: empty for non-media producers and for every slice written earlier.

deprecated: Vec<DeprecationDecl>

Implementations

impl RegistrySlice

pub fn new( version: impl Into<String>, app: impl Into<String>, name: impl Into<String>, ) -> Self

An empty slice with its required header. convention is the keyspace-v2 major version, 1; the collections start empty and are assignable.

parse_slice is how a slice normally arrives — this is for the callers that build one to compare against.

pub fn subjects_in( &self, class: impl Into<Declared<Class>>, ) -> impl Iterator<Item = &SubjectDecl>

Subjects of one class.

Takes the vocabulary, not a &str: subjects_in("telementry") used to compile and answer “no subjects”, which is the same answer an honestly empty class gives. Class::State is the ordinary spelling; a Declared answers the same question about a class token only a newer fleet member knows.

pub fn serves_subject(&self, path: &str) -> bool

Does this slice serve a subject with exactly this pattern?

pub fn serves_procedure(&self, path: &str) -> bool

Does this slice serve this procedure?

pub fn serves_blob_tier(&self, tier: impl Into<Declared<BlobTier>>) -> bool

Does this slice serve this @blob tier (RFC 07 §2)?

BlobTier::Artifact is the ordinary spelling; a Declared asks the same question about a tier token only a newer fleet member knows, which is what diff needs to call skew.

pub fn blob_tiers(&self) -> impl Iterator<Item = &Declared<BlobTier>>

Every @blob tier this slice declares, recognised or not.

The Other tokens are the interesting ones: RFC 08 §6 makes a tier this build cannot name a finding about version skew, which is only possible because parse_slice carries it rather than dropping it.

pub fn serves_media(&self, path: &str) -> bool

Does this slice publish a @media stream with exactly this pattern (RFC 07 §1, in the slice since v1.16)?

Trait Implementations

impl Clone for RegistrySlice

fn clone(&self) -> RegistrySlice

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RegistrySlice

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

Formats the value using the given formatter.

impl Eq for RegistrySlice

impl PartialEq for RegistrySlice

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for RegistrySlice