Struct wasmer_wasix::runtime::resolver::WebSource

pub struct WebSource {
    cache_dir: PathBuf,
    client: Arc<dyn HttpClient + Send + Sync>,
    retry_period: Duration,
}

A Source which can query arbitrary packages on the internet.

Implementation Notes

Unlike other Source implementations, this will need to download a package if it is a PackageSource::Url. Optionally, these downloaded packages can be cached in a local directory.

After a certain period (WebSource::with_retry_period()), the WebSource will re-check the uploaded source to make sure the cached package is still valid. This checking is done using the ETag header, if available.

Fields

cache_dir: PathBuf

client: Arc<dyn HttpClient + Send + Sync>

retry_period: Duration

Implementations

impl WebSource

pub const DEFAULT_RETRY_PERIOD: Duration = _

pub fn new( cache_dir: impl Into<PathBuf>, client: Arc<dyn HttpClient + Send + Sync>, ) -> Self

pub fn with_retry_period(self, retry_period: Duration) -> Self

Set the period after which an item should be marked as “possibly dirty” in the cache.

async fn get_locally_cached_file(&self, url: &Url) -> Result<PathBuf, Error>

Download a package and cache it locally.

async fn atomically_save_file( &self, path: impl AsRef<Path>, data: &[u8], ) -> Result<(), Error>

async fn get_etag(&self, url: &Url) -> Result<String, Error>

async fn fetch(&self, url: &Url) -> Result<(Vec<u8>, Option<String>), Error>

async fn load_url(&self, url: &Url) -> Result<Vec<PackageSummary>, Error>

Trait Implementations

impl Clone for WebSource

fn clone(&self) -> WebSource

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for WebSource

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

Formats the value using the given formatter.

impl Source for WebSource

fn query<'life0, 'life1, 'async_trait>( &'life0 self, package: &'life1 PackageSource, ) -> Pin<Box<dyn Future<Output = Result<Vec<PackageSummary>, QueryError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Ask this source which packages would satisfy a particular Dependency constraint.

fn latest<'life0, 'life1, 'async_trait>( &'life0 self, pkg: &'life1 PackageSource, ) -> Pin<Box<dyn Future<Output = Result<PackageSummary, QueryError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Run Source::query() and get the PackageSummary for the latest version.