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

wasm-pkg-client

Wasm package client

15 releases (4 breaking)

new 0.9.0 Dec 10, 2024
0.8.5 Nov 20, 2024
0.8.2 Oct 30, 2024
0.7.4 Oct 3, 2024
0.5.1 Sep 6, 2024

#156 in WebAssembly

Download history 442/week @ 2024-09-03 296/week @ 2024-09-10 201/week @ 2024-09-17 226/week @ 2024-09-24 642/week @ 2024-10-01 1497/week @ 2024-10-08 2333/week @ 2024-10-15 5997/week @ 2024-10-22 5211/week @ 2024-10-29 3609/week @ 2024-11-05 2578/week @ 2024-11-12 6786/week @ 2024-11-19 4748/week @ 2024-11-26 4639/week @ 2024-12-03

19,069 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

~33–53MB
~868K SLoC