fetchurl-sdk 0.2.1

Protocol-level client SDK for fetchurl content-addressable cache servers
Documentation

fetchurl Rust SDK

Protocol-level client for fetchurl content-addressable cache servers.

This crate does not perform HTTP by itself. It provides a state machine (FetchSession) that drives protocol logic while you use any HTTP library for I/O.

Install

[dependencies]
fetchurl-sdk = "0.1"

Protocol

Normative behavior: fetchurl/spec (SPEC.md).

Reference server: fetchurl/fetchurl.

Usage

See crate docs and examples/get.rs. Clients must treat the server as untrusted and verify the hash (the session/verifier APIs are built for that).

Environment

Variable Meaning
FETCHURL_SERVER Server base URL(s) per the spec. Empty/absent disables server use.

Development

cargo test
cargo run --example get -- --help
# Integration (Docker + image):
# FETCHURL_TEST_IMAGE=fetchurl:local cargo test --test integration

Related

Repo Role
fetchurl/spec Protocol
fetchurl/fetchurl Go server
fetchurl/sdk-js JavaScript SDK
fetchurl/sdk-python Python SDK