Struct SourceBundleRequest 

pub struct SourceBundleRequest { /* private fields */ }

Local request used to select source for a snapshot.

Roots are local paths. Additional inputs are portable paths relative to the workspace and cannot escape it.

Implementations

impl SourceBundleRequest

pub fn new( workspace_root: impl Into<Utf8PathBuf>, project_root: impl Into<Utf8PathBuf>, ) -> Self

Create a request for one project contained by a workspace.

pub fn include_workspace_path(self, path: impl Into<Utf8PathBuf>) -> Self

Add an allowlisted workspace-relative file or directory.

pub fn exclude_workspace_path(self, path: impl Into<Utf8PathBuf>) -> Self

Exclude one portable workspace-relative path and all descendants.

Exclusions take precedence over the project root, built-in workspace inputs, explicit includes, and .ferryignore. The workspace root (.) is not a valid exclusion. Built-in sensitive exclusions remain non-overridable and are audited separately.

pub fn with_executable_mode( self, path: impl Into<Utf8PathBuf>, executable: bool, ) -> Self

Supply portable executable-mode metadata for one workspace-relative file.

The path must be selected into the final manifest. On non-Unix hosts the supplied value is authoritative because filesystem mode bits are not available. On Unix, a true value adds executable intent while a live filesystem executable bit remains authoritative and is never cleared.

pub fn with_max_traversal_entries(self, maximum: usize) -> Self

Apply a stricter combined traversal-entry limit than the defensive default.

Values above MAX_SOURCE_TRAVERSAL_ENTRIES are rejected during planning rather than weakening the global defensive ceiling. The one budget counts components in explicit request paths, filesystem directory entries read during selection, and components in final manifest paths.

pub fn with_limits(self, limits: SourceLimits) -> Self

Replace the default resource limits.

pub fn workspace_root(&self) -> &Utf8Path

Return the configured workspace root.

pub fn project_root(&self) -> &Utf8Path

Return the configured project root.

pub fn workspace_inputs(&self) -> &[Utf8PathBuf]

Return caller-selected workspace-relative inputs.

pub fn workspace_exclusions(&self) -> &[Utf8PathBuf]

Return caller-selected workspace-relative exclusions.

pub fn executable_modes(&self) -> &[(Utf8PathBuf, bool)]

Return caller-supplied portable executable-mode metadata.

pub fn max_traversal_entries(&self) -> usize

Return the configured combined traversal-entry limit.

The budget covers request path components, filesystem directory entries, and every component of every final manifest path.

pub fn limits(&self) -> SourceLimits

Return the configured resource limits.

Trait Implementations

impl Clone for SourceBundleRequest

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 SourceBundleRequest

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

Formats the value using the given formatter.

impl Eq for SourceBundleRequest

impl PartialEq for SourceBundleRequest

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for SourceBundleRequest