Skip to main content

Module prebuilt

Module prebuilt 

Source
Expand description

prebuilt: downloads a cdylib plus manifest straight from GitHub Releases.

This is an accelerator path, not the default. It goes through GitHub, which bypasses the cargo registry or mirror the user has configured, so it may not be reachable:

  • the default stays build-host (cargo build, which naturally picks up the mirror configuration);
  • prebuilt is only used when build-host is explicitly turned off, or when the caller wants to try saving a few minutes first;
  • a None from any step means “no usable prebuilt”, and the caller must fall back to build-host.

§Artifact naming convention

A release carries two bare files (not archives, which saves three dependencies — tar/gzip/zip):

{crate}-{version}-{target}.{so|dylib|dll}   <-- the cdylib itself
{crate}-{version}-{target}.toml             <-- the manifest

Example: bmux-plugin-cargo-0.1.0-x86_64-pc-windows-msvc.dll

The repository URL comes from the crates.io repository field — at this point the plugin is not installed yet, so the registry is the only thing we can ask.

Functions§

parse_github_repo
Extracts (owner, repo) from a GitHub URL.
try_install
Tries to install a prebuilt.