web-faith 1.1.0

A browser-shaped HTTP client
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46

//! Requests and their builders.

// spec:REQ spec:ENC spec:CANCEL

mod builder;
mod parts;
mod send;
mod target;

pub use builder::{FetchBuilder, Priority, Request, RequestBuilder};
pub use target::Target;

// Compiled and used internally either way; `unstable-internals` decides whether they are nameable
// outside.
#[cfg(not(feature = "unstable-internals"))]
pub(crate) use parts::{RequestBody, RequestOptions};
#[cfg(feature = "unstable-internals")]
pub use {
	parts::{RequestBody, RequestOptions},
	send::send,
};

/// Whether a request carries its credentials.
#[derive(Clone, Copy, Debug, Default, PartialEq, Eq)]
pub enum Credentials {
	/// Strip credentials from the URL and send no cookies.
	Omit,
	/// Send them. Almost always what a server-side caller means.
	#[default]
	Include,
}

/// The methods the fetch standard normalises to upper case; any other method is sent as given.
// spec:REQ#method-and-headers
const NORMALISED_METHODS: [&str; 6] = ["DELETE", "GET", "HEAD", "OPTIONS", "POST", "PUT"];

/// The method whose query content rides in the body, and so must be described by a `Content-Type`.
///
/// `http` has no constant for it: `QUERY` is still a draft method, so it arrives as an extension
/// method and is compared by name.
// spec:REQ#body
pub(crate) const QUERY: &str = "QUERY";

/// The header a request's priority is expressed in.
// spec:REQ#request-priority
pub(crate) const PRIORITY: &str = "priority";