Struct Gate 

pub struct Gate { /* private fields */ }

The decision procedure for “may this server offer this tool”.

Implementations

impl Gate

pub fn new( toolsets: BTreeSet<Toolset>, max_tier: Tier, unavailable: BTreeSet<Surface>, all_tools: &[ToolMeta], ) -> Result<Self, ConfigError>

Build a gate, refusing a configuration that would offer nothing.

all_tools is the full metadata table; the emptiness check is made against it rather than against the toolset set, because a selection can be non-empty and still yield no tools once the tier is applied.

pub fn unchecked( toolsets: BTreeSet<Toolset>, max_tier: Tier, unavailable: BTreeSet<Surface>, ) -> Self

A gate for tests and for the tools subcommand, which must be able to describe an empty selection rather than refuse to.

pub fn permits(&self, tool: &ToolMeta) -> bool

pub fn needs(&self, tool: &ToolMeta) -> String

Why a tool was not offered, phrased as the flag that would offer it. Used to build the hint on not_permitted.

pub fn toolsets(&self) -> &BTreeSet<Toolset>

pub fn offers(&self, surface: Surface) -> bool

Whether this session offers any tool on surface.

Both halves matter and neither alone is the answer: a surface whose toolsets nobody selected offers nothing, and so does one that was selected but is not there — no binary, no credential, or an operator switch. permits asks the same two questions of one tool; this asks them of a whole surface, for the instructions, which have to describe what a session can actually do rather than what it was asked for.

pub fn offered_toolsets(&self) -> impl Iterator<Item = Toolset> + '_

The selected toolsets that this session can actually serve from.

toolsets is what was asked for; this is what came of it. Anything shown to a caller wants this one — naming a toolset whose surface is missing tells a model that tailnet-devices is there, in a session where every call to it is refused. That was written twice before it was written once: the startup note and the instructions each listed the selection, and each contradicted a sentence beside it.

pub fn max_tier(&self) -> Tier

Trait Implementations

impl Clone for Gate

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Gate

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

Formats the value using the given formatter.