apple / apple/swift-http-api-proposal

HTTP client protocol specification

Open
#67 2 comments 0 reactions 0 assignees View on GitHub
http-client
Dominant language
Swift
Stars
66
Forks
21
Avg merge
7h 39m
Merged PRs (30d)
2

Description

Similar to the fetch spec, we'll need not just the Swift shape of a protocol, but also a precise specification that describes the expected behavior of a compliant implementation.

It should go into the expected behavior while streaming, handling cookies, any buffering, and anything else considered "base" behavior (without any add-on feature options).

This would be accompanied by a compliance test suite (#66).

Most of the spec should use "MUST" and "MUST NOT", so that callers can rely on a predictable behavior.

And "SHOULD", "MAY" and similar should come with an explanation of how the caller detects the behavior, and how they should handle both cases (present and absent feature).

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.