Struct ListDirOptions 

pub struct ListDirOptions { /* private fields */ }

Shared directory traversal policy for collection and paged visiting. Defaults to immediate children only. Collection retains native batching; visiting delivers owned directory pages incrementally through callbacks. Unspecified budgets inherit the client’s resource limits.

Implementations

impl ListDirOptions

pub const fn unlimited() -> ListDirOptions

Explicitly disable entry, path-byte and depth limits. This can permit unbounded collection or traversal; prefer finite application budgets.

pub const fn new() -> ListDirOptions

pub const fn recursive(self, value: bool) -> ListDirOptions

Descend into directories, without following entry symlinks.

pub const fn max_entries(self, value: usize) -> ListDirOptions

Shared entry budget across every input root.

pub const fn max_path_bytes(self, value: usize) -> ListDirOptions

Shared path-byte budget. Recursive visiting also charges root paths.

pub const fn max_depth(self, value: usize) -> ListDirOptions

Root listing is depth 0; depth 1 also lists immediate subdirectories. In recursive mode, encountering a directory beyond this limit is an error unless truncate_at_max_depth(true) is selected. Shallow mode ignores depth settings and intentionally visits only immediate children. Finite depths range from 0 through 200; any larger value disables the depth limit. Entry and path-byte budgets remain in effect.

pub const fn truncate_at_max_depth(self, value: bool) -> ListDirOptions

Intentionally stop descending at the depth limit instead of failing.

pub const fn fields(self, value: AttrMask) -> ListDirOptions

Select metadata returned with directory pages, without per-entry stat calls. Defaults to common stat fields. MODE is always requested for traversal; backends may return additional fields or omit unsupported ones.

pub const fn is_recursive(self) -> bool

pub fn attributes(self) -> AttrMask

pub fn walk_options(self, limits: ResourceLimits) -> WalkOptions

Resolve recursive traversal limits against the client’s defaults.

pub fn directory_options(self, limits: ResourceLimits) -> ReadDirOptions

Resolve shallow listing limits against the client’s defaults.

Trait Implementations

impl Clone for ListDirOptions

fn clone(&self) -> ListDirOptions

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ListDirOptions

impl Debug for ListDirOptions

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

Formats the value using the given formatter.

impl Default for ListDirOptions

fn default() -> ListDirOptions

Returns the “default value” for a type.

impl Eq for ListDirOptions

impl From<ReadDirOptions> for ListDirOptions

fn from(options: ReadDirOptions) -> ListDirOptions

Converts to this type from the input type.

impl From<WalkOptions> for ListDirOptions

fn from(options: WalkOptions) -> ListDirOptions

Converts to this type from the input type.

impl PartialEq for ListDirOptions

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ListDirOptions