Struct ScanViewOptions 

pub struct ScanViewOptions {
    pub roots: Vec<PathBuf>,
    pub scan_args: Vec<String>,
    pub max_files: Option<usize>,
}

What a scan walks.

Fields

roots: Vec<PathBuf>

AF.2: the paths to scan — each a FILE or a DIRECTORY. A directory is walked; a file is taken as given, without asking whether any source claimed its extension, because naming a file IS the claim.

Empty means “not resolved yet”, not “scan nothing”. The scan then asks every live source for its own roots and falls back to the project root if none answers. It cannot be resolved here, because a source’s answer comes from the guest and the opener runs on the dispatch path.

That is why Default is now empty where it used to be the project root: the fallback moved to the one place that can see every source’s answer, rather than being baked in before any of them was asked.

scan_args: Vec<String>

OA.11a: the view’s own scan arguments, handed to every source’s begin uninterpreted. The host routes these; it never reads them.

Separate from roots because they have separate owners. The host must understand a root — it does the walk — and must not need to understand this: it is the source’s own vocabulary (org’s agenda dispatcher names which custom command to run). Folding the two together means a command key gets taken for a directory path and the scan silently covers nothing.

Sticky across a refresh exactly as roots is, and for the same reason: gr re-enters through this path, so an agenda opened for one command must not quietly revert to the default one. Replaced only when a new open supplies its own.

max_files: Option<usize>

Cap on files offered to a source (not files walked). None = unlimited. A bound exists because the walk is unattended: a user who runs the agenda from $HOME should get a slow answer, not a hung one.

Applies to the UNION across roots, not per root — a cap that reset for each configured path would not be a bound.

Trait Implementations

impl Clone for ScanViewOptions

fn clone(&self) -> ScanViewOptions

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ScanViewOptions

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

Formats the value using the given formatter.

impl Default for ScanViewOptions

fn default() -> ScanViewOptions

Returns the “default value” for a type.