15 breaking releases

new 0.16.0 Jan 17, 2025
0.15.0 Nov 8, 2024
0.14.0 Oct 23, 2024
0.8.0 Jul 31, 2024
0.2.0 Nov 21, 2023

#1440 in WebAssembly

Download history 5037/week @ 2024-09-27 5198/week @ 2024-10-04 5177/week @ 2024-10-11 9137/week @ 2024-10-18 10259/week @ 2024-10-25 5570/week @ 2024-11-01 4715/week @ 2024-11-08 7092/week @ 2024-11-15 6504/week @ 2024-11-22 8461/week @ 2024-11-29 5827/week @ 2024-12-06 4687/week @ 2024-12-13 2877/week @ 2024-12-20 2885/week @ 2024-12-27 2730/week @ 2025-01-03 994/week @ 2025-01-10

10,503 downloads per month
Used in 10 crates (8 directly)

Apache-2.0

1.5MB
3.5K SLoC

wasmcloud-core

This repository contains the core data types, traits and reusable functionality to enable the wasmCloud ecosystem.

This crate provides:

  • Utilities for dealing with WIT types
  • Types used across wasmCloud Hosts
  • Types used in linking on wasmCloud lattices
  • Logging types
  • Utilities for interacting with NATS
  • ... and more

This crate is meant to be used by programs, utilities and infrastructure targeting the wasmCloud platform.

Installation

To use wasmcloud-core in your project, you can add it via cargo add:

cargo add wasmcloud-core

Or include the following in your Cargo.toml:

wasmcloud-core = "0.7.0"

Features

wasmcloud-core comes with the following features:

Feature Default? Description
hyper-rustls yes Enable hyper-rustls usage (see tls module)
oci yes Enable oci-client and oci-wasm usage (see tls module)
reqwest yes Enable [reqwest][request] extensions (see tls module)
rustls-native-certs yes Enable rustls-native-certs (see tls module)
webpki-roots yes Enable webpki-roots (see tls module)
otel no Enable OpenTelemetry module support

Using wasmcloud-core

wasmcloud-core does not provide a prelude, but instead exports types as needed under appropriate modules.

Import the needed types and traits as necessary from your project similarly to the following:

use wasmcloud_core::nats::convert_header_map_to_hashmap;
use wasmcloud_core::rpc::{health_subject, link_del_subject, link_put_subject, shutdown_subject};
use wasmcloud_core::{
    HealthCheckRequest, HealthCheckResponse, HostData, InterfaceLinkDefinition, LatticeTarget,
};

Contributing

Have a change that belongs be in wasmcloud-core? Please feel free to file an issue and/or join us on the wasmCloud slack!

Dependencies

~28–45MB
~796K SLoC