http

Blocking HTTP(S) over whatever client the platform already ships. No TLS, DNS or HTTP framing of our own — the platform ships all three.

One package on every platform. There is no http_android; the transport is a file inside this package, swapped by the resolver's _<platform> override.

A consumer names http once, plus the transitive dep of whichever transport it builds — the same flat-closure rule every package in this repo follows (cpc resolves imports and link archives against ONE set taken from the consuming manifest, not from a dependency's own):

[dependencies]
http   = "*"
stdlib = "*"

[macos.dependencies]
objc = "*"      # NSURLSession; brings -framework Foundation with it

[ios.dependencies]
objc = "*"

[android.dependencies]
jni  = "*"      # java.net.HttpURLConnection

Name only the platforms you build for. Miss one and the link says which symbol it wanted, naming the package.

import "http/http" as http;
import "stdlib/result" as result;
import "stdlib/status" as status;

Common case

match http::get("https://example.com/feed.json") {
    result::Result[http::Response, http::Error]::Ok(r) => {
        // A non-2xx status is DATA, not an error. 404 is an answer.
        if r.is_success() { parse(r.body.as_byte_view()); }
    }
    result::Result[http::Response, http::Error]::Err(e) => {
        // Transport only: offline, DNS failure, TLS failure, timeout.
        report(e.code, e.message);
    }
}

With a method, headers and a body:

var req: http::Request = http::Request::new("https://example.com/v1/items",
                                            method: http::Method::Post,
                                            timeout_seconds: 10.0);
let _a: status::Status = req.set_header("Content-Type", to: "application/json");
let _b: status::Status = req.set_body_text("{\"name\":\"widget\"}");
match http::send(req) { ... }

Blocking by design

Every verb blocks the calling thread. Call it off-main. In a facet app that means a service: produce off the UI thread, hop the result home with services::run_on_main before touching a view. There is no async tier in v1.

Docs

• docs/tutorial.md — fast path
• docs/guide.md — how / why / gotchas
• docs/ref.md — API manual

Remaining platform

ESP32 is not implemented. Its matching native client is esp_http_client; adding it requires an embedded transport that preserves the same blocking result and error contracts.

Tests

Unit tests live in src/http.cplus.

cd vendor/http && cpc test

The tests named net_* make real requests and need the internet; everything else runs offline, including the transport-error path (a malformed URL is rejected by NSURLSession locally, before any DNS).