Struct ChangeScope 

pub struct ChangeScope { /* private fields */ }

Engine-owned change scope of one run: a global changed-file set or the per-workspace Git baselines of workspaces.changedSince. The resolved change scope of one run.

Implementations

impl ChangeScope

pub fn resolve( request: ChangeScopeRequest<'_>, config: &ResolvedConfig, workspaces: &[WorkspaceInfo], ) -> Result<ChangeScope, PackageBaselineError>

Resolve the change scope of a run.

A changed-file set wins. A requested global ref without files, or a caller-owned scope, gives the full scope. Otherwise the configured package baselines apply, when the config has any. A mapped ref that Git cannot resolve stands the map down to the full scope.

Errors

Returns an error when the package map has a malformed key or Git ref, or when a workspace root cannot be read.

pub fn changed_files(files: &HashSet<PathBuf, FxBuildHasher>) -> ChangeScope

The scope of one global changed-file set.

pub const fn scope_reason(&self) -> Option<ScopeReason>

The scope_reasons channel that narrowed the run, when a change ref did: the package map, or a global ref. The saved-baseline comparison of check and finding-id queries read this: a finding outside the scope is hidden, not gone. dupes compares its baseline with the report before the package map narrows it, so it reads only the global ref.

pub const fn packages(&self) -> Option<&PackageChangeScope>

The applied package baselines, when the configured map scopes the run.

pub const fn request_outcome(&self) -> Option<&RequestOutcome>

The package-baselines request outcome, when the run read the map.

pub fn stand_down_message(&self) -> Option<&str>

The sentence to show when the package map stood down, or None when the map applied or the run did not read it.

pub fn package_baselines(&self) -> Vec<PackageBaselineStatus>

The package_baselines provenance rows of the run. Empty unless the configured map scopes the run.

pub fn contains(&self, path: &Path) -> bool

Whether a finding owned by path is in scope.

Trait Implementations

impl Clone for ChangeScope

fn clone(&self) -> ChangeScope

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ChangeScope

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

Formats the value using the given formatter.

impl Default for ChangeScope

fn default() -> ChangeScope

Returns the “default value” for a type.