Valkey Components

A WASM component client for Valkey (and Redis).

• Build
• Run
  • Samples
• Community
  • Code of Conduct
  • Communication
  • Contributing
• Acknowledgements
• License

Build

Prereqs:

• a rust toolchain with wasm32-unknown-unknown and wasm32-wasip2 targets (rustup target add wasm32-unknown-unknown and rustup target add wasm32-wasip2)
• cargo component
• wac
• wkg

make components

Run

Prereqs:

• build the components (see above)
• a wasi:cli/command compatible runtime (like wasmtime)
• access to a running Valkey server

wasmtime run -Sinherit-network -Sallow-ip-name-lookup lib/cli.wasm keys '*'

• use --host to specify a host other than 127.0.0.1
• use --port to specify a port other than 6379
• -Sallow-ip-name-lookup is only required if a hostname is used for the connection instead of an IP address.

To aid incremental development a make target is available to rebuild and run the CLI:

make run cmd="hello"

Samples

• http-incrementor

Community

Code of Conduct

The Componentized project follow the Contributor Covenant Code of Conduct. In short, be kind and treat others with respect.

Communication

General discussion and questions about the project can occur in the project's GitHub discussions.

Contributing

The Componentized project team welcomes contributions from the community. A contributor license agreement (CLA) is not required. You own full rights to your contribution and agree to license the work to the community under the Apache License v2.0, via a Developer Certificate of Origin (DCO). For more detailed information, refer to CONTRIBUTING.md.

Acknowledgements

This project was conceived in discussion between Mark Fisher and Scott Andrews.

License

Apache License v2.0: see LICENSE for details.