Enum BypassReason 

#[non_exhaustive]
pub enum BypassReason {
    NonUtf8Argument {
        index: usize,
    },
    ResponseFile(String),
    UnknownFlag(String),
    UnknownCodegenOption(String),
    MissingValue(String),
    CompilerQuery,
    StandardInput,
    MissingInput,
    MultipleInputs,
    Incremental,
    UnsupportedCrateType(String),
    UnsupportedEmit(String),
    NoCacheableOutput,
    NoDepInfo,
    SplitOutputDirectories,
    InvalidOutputPath(PathBuf),
    ImplicitEmitWithOutputFile(PathBuf),
    NativeLibrary,
    UnsupportedSearchPath(String),
    UnresolvedExtern(String),
    UnmappedAbsolutePath(PathBuf),
    NonUtf8Path(PathBuf),
    RelativeWorkingDirectory(PathBuf),
    RelativePathMapping(PathBuf),
    InvalidPathPlaceholder(String),
    MissingRequiredInput(String),
    InvalidInputDigest(String),
    ConflictingInput(String),
    MalformedDepInfo(String),
    DepInfoRead {
        path: PathBuf,
        message: String,
    },
    RelativeDepInfoPath(PathBuf),
    UnsafeDepInfoPath(PathBuf),
    InputRead {
        path: PathBuf,
        message: String,
    },
    InputChanged(PathBuf),
    InputModifiedDuringCompilation(PathBuf),
    DiscoveryWorkingDirectory,
    ConflictingEnvironment(String),
    Serialization(String),
    UnsupportedPrediction,
    InvalidPredictedInput(String),
}

Reason an invocation cannot safely use the action cache.

A bypass is an expected conservative outcome, not necessarily a compiler error. Variants carry diagnostic context while BypassReason::kind provides a stable aggregation key.

This set exists to shrink: every invocation the adapter learns to model retires a variant, and every construct it learns to reject adds one. Match on BypassReason::kind for aggregation rather than on the variants.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

NonUtf8Argument

An argument cannot be represented in the canonical UTF-8 key.

Fields

index: usize

Zero-based index in the argument slice.

ResponseFile(String)

A rustc response file could not be read or parsed exactly.

UnknownFlag(String)

A compiler flag is not modeled by this adapter version.

UnknownCodegenOption(String)

A -C option is not modeled by this adapter version.

MissingValue(String)

A recognized flag was not followed by its required value.

CompilerQuery

The invocation queries compiler information instead of compiling.

StandardInput

Source would be read from standard input and cannot be rediscovered.

MissingInput

No Rust source input was supplied.

MultipleInputs

More than one source input was supplied.

Incremental

Incremental state makes the outputs unsuitable for action caching.

UnsupportedCrateType(String)

The requested crate type is outside the supported cacheability tier.

UnsupportedEmit(String)

The requested emit kind is outside the supported cacheability tier.

NoCacheableOutput

The invocation emits no artifact in the supported cacheability tier.

NoDepInfo

The invocation does not emit the dep-info needed for input discovery.

SplitOutputDirectories

Outputs cannot be represented as one cache directory.

InvalidOutputPath(PathBuf)

An output path does not name a file.

ImplicitEmitWithOutputFile(PathBuf)

-o leaves the name of an implicit emit ambiguous.

NativeLibrary

Native-library lookup is not modeled as a precise input.

UnsupportedSearchPath(String)

A library search-path kind is not modeled.

UnresolvedExtern(String)

An extern name does not resolve to a concrete input artifact.

UnmappedAbsolutePath(PathBuf)

An absolute path has no stable placeholder mapping.

NonUtf8Path(PathBuf)

A path cannot be represented in a canonical UTF-8 action key.

RelativeWorkingDirectory(PathBuf)

The action working directory is not absolute.

RelativePathMapping(PathBuf)

A path-mapping root is not absolute.

InvalidPathPlaceholder(String)

A mapping placeholder is empty or contains unsafe characters.

MissingRequiredInput(String)

An input referenced by compiler arguments is missing from the context.

InvalidInputDigest(String)

A supplied compiler-input digest is malformed.

ConflictingInput(String)

One normalized input path has multiple distinct digests.

MalformedDepInfo(String)

rustc dep-info does not follow the supported format.

DepInfoRead

A dep-info file could not be read as UTF-8 text.

Fields

path: PathBuf

Dep-info file path.

message: String

Underlying I/O or decoding error.

RelativeDepInfoPath(PathBuf)

The requested dep-info output path is not absolute.

UnsafeDepInfoPath(PathBuf)

A dep-info output path contains a comma and cannot be safely rendered.

InputRead

A discovered compiler input could not be read or was not a file.

Fields

path: PathBuf

Compiler-input path.

message: String

Underlying filesystem error.

InputChanged(PathBuf)

Input contents changed after they were hashed.

InputModifiedDuringCompilation(PathBuf)

An input’s modification time overlaps the compiler execution.

DiscoveryWorkingDirectory

Discovered inputs and the action use different working directories.

ConflictingEnvironment(String)

One observed environment input has conflicting values.

Serialization(String)

Canonical action serialization failed.

UnsupportedPrediction

The stored prediction uses an unsupported version or exceeds limits.

InvalidPredictedInput(String)

A normalized predicted path cannot be mapped back to the host.

Implementations

impl BypassReason

pub fn kind(&self) -> &'static str

A stable, low-cardinality name for this reason.

Many variants carry a path or a flag, so Display text cannot be aggregated; statistics group by this instead.

Trait Implementations

impl Clone for BypassReason

fn clone(&self) -> BypassReason

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BypassReason

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

Formats the value using the given formatter.

impl Display for BypassReason

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

Formats the value using the given formatter.

impl Eq for BypassReason

impl Error for BypassReason

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl<'_derivative_strum> From<&'_derivative_strum BypassReason> for &'static str

fn from(x: &'_derivative_strum BypassReason) -> &'static str

Converts to this type from the input type.

impl From<BypassReason> for &'static str

fn from(x: BypassReason) -> &'static str

Converts to this type from the input type.

impl PartialEq for BypassReason

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for BypassReason