#wasm-client #distribution #registry #package #oci #cargo #back-end

wasm-pkg-client

Wasm package client

14 unstable releases (3 breaking)

new 0.8.5 Nov 20, 2024
0.8.4 Nov 20, 2024
0.8.2 Oct 30, 2024
0.7.4 Oct 3, 2024
0.5.1 Sep 6, 2024

#239 in WebAssembly

Download history 481/week @ 2024-09-04 299/week @ 2024-09-11 182/week @ 2024-09-18 317/week @ 2024-09-25 575/week @ 2024-10-02 1869/week @ 2024-10-09 2394/week @ 2024-10-16 6929/week @ 2024-10-23 4699/week @ 2024-10-30 3599/week @ 2024-11-06 2335/week @ 2024-11-13

18,048 downloads per month
Used in 8 crates (7 directly)

Apache-2.0 WITH LLVM-exception

135KB
2.5K SLoC

Wasm Package Client

A minimal Package Registry interface for multiple registry backends.

Running Tests

The e2e tests require an OCI Distribution Spec-compliant registry to be running at localhost:5000. An ephemeral registry can be run with:

$ docker run --rm -p 5000:5000 distribution/distribution:edge

The e2e tests themselves are in the separate tests/e2e crate:

$ cd tests/e2e
$ cargo run

lib.rs:

Wasm Package Client

Client implements a unified interface for loading package content from multiple kinds of package registries.

Example

// Initialize client from global configuration.
let mut client = wasm_pkg_client::Client::with_global_defaults().await?;

// Get a specific package release version.
let pkg = "example:pkg".parse()?;
let version = "1.0.0".parse()?;
let release = client.get_release(&pkg, &version).await?;

// Stream release content to a file.
let mut stream = client.stream_content(&pkg, &release).await?;
let mut file = tokio::fs::File::create("output.wasm").await?;
use futures_util::TryStreamExt;
use tokio::io::AsyncWriteExt;
while let Some(chunk) = stream.try_next().await? {
    file.write_all(&chunk).await?;
}

Dependencies

~35–53MB
~873K SLoC