Skip to main content

Module install

Module install 

Source
Expand description

rpi install — install a prebuilt or explicitly built Rust cdylib extension.

Cargo’s cargo install command is intended for binaries and does not copy dynamic-library targets. rpi extensions are cdylibs loaded by rpi-extensions. The default async path uses the prebuilt distribution protocol; the explicit source backend creates a tiny temporary Cargo workspace, resolves the requested crate through Cargo, builds the dependency in release mode, and copies its cdylib into the same global directory scanned during normal startup.

Structs§

InstalledNativePackage
A Rust-native extension installed through rpi install.

Enums§

NativePackageRegistry
The on-disk state of the Rust-native extension registry.

Functions§

active_global_native_package_artifacts
Resolve the active global native package libraries without scanning the extension directory. New records name the active files explicitly; older records had no artifact ledger, so they retain the historical crate-name scan as a compatibility fallback.
installed_native_packages
Read the registry for best-effort discovery and startup update notices.
print_help
read_native_package_registry
Read and validate the Rust-native extension registry without hiding errors.
run
Run rpi install .... This is intentionally synchronous: it is a short lived package operation and keeping Cargo’s build output attached to the user’s terminal makes failures actionable.
run_async
Default to the versioned prebuilt distribution protocol. Cargo builds are explicit (–build or –path) and run off the async worker.
uninstall
Remove a Rust-native extension installed by rpi install.
unregistered_global_native_package_artifacts
Resolve unmanaged legacy libraries from the global extension directory. Managed versioned artifacts are deliberately omitted: only the active artifact list above may be loaded for an installed native package.