Skip to main content

Crate kache_shims

Crate kache_shims 

Source
Expand description

Upgrade-safe paths to an installed binary (select, detect) and the compiler-name shim farms that point at it (farm).

Re-exports§

pub use farm::install;
pub use farm::InstallError;
pub use farm::Installed;
pub use farm::Status;

Modules§

farm
Toolchain shims (cargo, cc, gcc, clang, …) ahead of the real programs on PATH.

Structs§

Env
Everything selection reads from the process.
FrontendImage
Frontend image captured before entering the engine.
InodeId
Filesystem-unique file identity.
Layout
Where the version managers keep their installs and dispatchers.
RealFs
Selection
The path to record, and why.

Enums§

Elevation
HOME and PATH may belong to another account.
Error
Why no path could be selected.
Kind
The installer that placed the running binary, judged from its resolved path.
Stability
Whether the selected path is expected to keep working after an upgrade.

Traits§

Fs

Functions§

compiler_driver
compiler_launcher_driver
Native launchers for callers that require one executable in CC/CXX. Unlike target-prefixed compiler names, these aliases select a different executable basename on PATH.
detect
select for the running process.
detect_frontend
Select the frontend installed beside the running engine. Validate the running image before using its companion’s identity for alias selection.
engine_beside
The companion beside an already selected frontend path, retaining stable installer aliases such as Homebrew’s opt directory.
engine_for
Follow a compiler-name shim to its installation before finding the engine.
frontend_for
The frontend beside a named engine; other executables keep their identity. This also preserves unit-test executables and pinned build-script engines.
is_cc_compiler_name
A C-family name recognized without executing a compiler probe.
is_compiler_shim_name
Compiler-name shims have priority over CLI-looking compiler arguments.
is_executable_file
A regular file with an execute bit (any regular file off Unix).
resolve_program_on_path_with
running_identity
Identity of the running image. On Linux /proc/self/exe reaches it even after the path was replaced; elsewhere this re-reads current_exe(), a present-time check.
select
The path to record for env.exe.
select_frontend
Select a captured frontend while validating the running engine’s image.