tiny.http.ClientOperation

1pub const ClientOperation = struct {2    /// Parses `url` and writes its host into `scratch.host` and its target into3    /// `scratch.target` without allocating, so the returned views are slices of4    /// those two buffers. The port comes from the URL, or from the scheme when the5    /// URL omits it: 443 for https and 80 for http. A scheme other than http or6    /// https returns `error.UnsupportedScheme` , and a URL with no host returns7    /// `error.MissingHost` . A host or target longer than its buffer returns a8    /// capacity error and writes no prepared operation, so a caller can enlarge9    /// that buffer and call again.10    pub fn prepare(scratch: Scratch, url: []const u8) Error!Prepared {11        const uri = std.Uri.parse(url) catch return error.InvalidUrl;12        const is_http = std.ascii.eqlIgnoreCase(uri.scheme, "http");13        const is_https = std.ascii.eqlIgnoreCase(uri.scheme, "https");14        if (!is_http and !is_https) return error.UnsupportedScheme;15        const host_component = uri.host orelse return error.MissingHost;16        const host = try componentInto(17            host_component,18            scratch.host,19            error.ClientHostCapacityExceeded,20        );21        const target = try targetInto(uri, scratch.target);22        std.debug.assert(host.len <= scratch.host.len);23        std.debug.assert(target.len <= scratch.target.len);24        std.debug.assert(host.ptr == scratch.host.ptr);25        std.debug.assert(target.ptr == scratch.target.ptr);26        const default_port: u16 = if (is_https) 443 else 80;27        return .{28            .host = host,29            .target = target,30            .port = uri.port orelse default_port,31            .is_tls = is_https,32        };33    }3435    pub fn validatePlain(scratch: Scratch) Error!void {36        if (scratch.plain_read.len == 0) {37            return error.ClientPlainReadCapacityExceeded;38        }39        if (scratch.plain_write.len == 0) {40            return error.ClientPlainWriteCapacityExceeded;41        }42        std.debug.assert(scratch.plain_read.len > 0);43        std.debug.assert(scratch.plain_write.len > 0);44    }4546    pub fn writeRequest(47        writer: *std.Io.Writer,48        method: []const u8,49        host: []const u8,50        target: []const u8,51        headers: []const response.Header,52        body: []const u8,53    ) std.Io.Writer.Error!void {54        return writeRequestConnection(55            writer,56            method,57            host,58            target,59            headers,60            body,61            "close",62        );63    }6465    pub fn writeReusableRequest(66        writer: *std.Io.Writer,67        method: []const u8,68        host: []const u8,69        target: []const u8,70        headers: []const response.Header,71        body: []const u8,72    ) std.Io.Writer.Error!void {73        return writeRequestConnection(74            writer,75            method,76            host,77            target,78            headers,79            body,80            "keep-alive",81        );82    }8384    fn writeRequestConnection(85        writer: *std.Io.Writer,86        method: []const u8,87        host: []const u8,88        target: []const u8,89        headers: []const response.Header,90        body: []const u8,91        connection: []const u8,92    ) std.Io.Writer.Error!void {93        std.debug.assert(method.len > 0);94        std.debug.assert(host.len > 0);95        std.debug.assert(target.len > 0);96        std.debug.assert(connection.len > 0);97        try writer.writeAll(method);98        try writer.writeByte(' ');99        try writer.writeAll(target);100        try writer.writeAll(" HTTP/1.1\r\nHost: ");101        try writer.writeAll(host);102        try writer.writeAll("\r\n");103        for (headers) |header| {104            try writer.writeAll(header.name);105            try writer.writeAll(": ");106            try writer.writeAll(header.value);107            try writer.writeAll("\r\n");108        }109        try writer.print("Content-Length: {d}\r\n", .{body.len});110        try writer.writeAll("Connection: ");111        try writer.writeAll(connection);112        try writer.writeAll("\r\n\r\n");113        try writer.writeAll(body);114    }115};

1pub const ClientOperation = client.ClientOperation;