#client #wasm-pkg-client

wasm-pkg-client

Wasm package client

16 releases (5 breaking)

0.10.0 Jan 31, 2025
0.9.0 Dec 10, 2024
0.8.5 Nov 20, 2024
0.8.2 Oct 30, 2024
0.5.1 Sep 6, 2024

#803 in WebAssembly

Download history 1926/week @ 2024-12-25 987/week @ 2025-01-01 2768/week @ 2025-01-08 1453/week @ 2025-01-15 2283/week @ 2025-01-22 2222/week @ 2025-01-29 2146/week @ 2025-02-05 1874/week @ 2025-02-12 2175/week @ 2025-02-19 1312/week @ 2025-02-26 2547/week @ 2025-03-05 4267/week @ 2025-03-12 3307/week @ 2025-03-19 2474/week @ 2025-03-26 2521/week @ 2025-04-02 2247/week @ 2025-04-09

11,462 downloads per month
Used in 12 crates (8 directly)

Apache-2.0 WITH LLVM-exception

135KB
2.5K SLoC

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?;
}

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

Dependencies

~35–55MB
~1M SLoC