Struct UpcallGroupSource 

pub struct UpcallGroupSource { /* private fields */ }

Shell-based group source that runs commands for lookups.

Commands can use %s as a placeholder for the group name.

The optional mapall upcall returns all group-to-nodes mappings in a single call (upstream commit 68e5df9). Its output is a list of group: nodes lines and is used to serve both map and list queries from the cache. When a group is missing from the mapall output, resolution falls back to the per-group map upcall if one is defined; otherwise the group resolves to an empty node set.

Implementations

impl UpcallGroupSource

pub fn new( map_upcall: Option<String>, all_upcall: Option<String>, list_upcall: Option<String>, reverse_upcall: Option<String>, ) -> Self

Create a new UpcallGroupSource with the given command templates.

Command templates can use %s as a placeholder for the group name.

pub fn with_mapall_upcall(self, mapall_upcall: Option<String>) -> Self

Set the optional mapall upcall command template, returning all group-to-nodes mappings as group: nodes lines in one call.

pub fn with_cache_time(self, cache_time: f64) -> Self

Set the upcall cache lifetime in seconds (0 disables caching).

pub fn clear_cache(&self)

Remove all previously cached upcall results whatever their lifetime is (mirrors Python UpcallGroupSource.clear_cache()).

Trait Implementations

impl GroupSource for UpcallGroupSource

fn resolve_map(&self, group: &str) -> Result<String>

Resolve a group name to a node pattern string.

fn resolve_all(&self) -> Result<String>

Get all nodes from all groups.

fn resolve_list(&self) -> Result<Vec<String>>

List all available group names.

fn resolve_reverse(&self, node: &str) -> Result<Vec<String>>

Find all groups that contain a given node.

fn has_reverse(&self) -> bool

Returns true if this source supports reverse lookups.

fn cache_time(&self) -> Option<f64>

Returns the cache time in seconds, if any.