goish 0.15.0

Write Rust using Go idioms — a Go-flavored standard library for Rust
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
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61

// http: Go's net/http package — server + client, Go-shaped call sites.
//
//   Go                                      goish
//   ───────────────────────────────────────  ──────────────────────────────────
//   http.HandleFunc("/", h)                  http::HandleFunc("/", h);
//   http.ListenAndServe(":8080", nil)        http::ListenAndServe(":8080", nil);
//   resp, err := http.Get(url)               let (resp, err) = http::Get(url);
//   resp.Body.Close()                        resp.Body.Close();
//   resp.StatusCode                          resp.StatusCode
//   body, _ := io.ReadAll(resp.Body)         let (body, _) = io::ReadAll(&mut resp.Body);
//
// Backed by hyper 1.x + tokio. The user-facing API is sync (Go's HTTP is
// sync from the caller's perspective); the server drives hyper inside
// the goish tokio runtime, and each request handler is invoked on a
// blocking task so user code can look like straight-line Go.

mod body;
mod client;
mod cookie;
mod request;
mod response;
mod server;
mod status;

pub use body::Body;
pub use client::{Client, DefaultClient, Do, Get, Head, NewRequest, NewRequestWithContext, Post, PostForm};
pub use cookie::{Cookie, ParseCookie, ParseSetCookie, SameSite,
                 SameSiteDefaultMode, SameSiteLaxMode, SameSiteNoneMode, SameSiteStrictMode};
pub use request::{Header, IntoReqBody, ParseHTTPVersion, Request};
pub use response::{Response, ResponseWriter};
pub use server::{HandleFunc, Handler, HandlerFunc, IntoMux, ListenAndServe, Server, ServeMux};
pub use status::*;

// Common method strings, matching Go's `http.MethodGet` etc.
pub const MethodGet: &str = "GET";
pub const MethodPost: &str = "POST";
pub const MethodPut: &str = "PUT";
pub const MethodDelete: &str = "DELETE";
pub const MethodHead: &str = "HEAD";
pub const MethodPatch: &str = "PATCH";
pub const MethodOptions: &str = "OPTIONS";

/// Shared tokio runtime used by every http server/client call. Reuses the
/// same runtime as `go!{}` so spawning a goroutine from inside a handler
/// keeps working.
pub(crate) fn rt() -> &'static tokio::runtime::Runtime {
    crate::goroutine::runtime()
}

/// Run an async block to completion from a sync caller. Uses `block_on`
/// if no tokio context exists, or `block_in_place` + `Handle::block_on`
/// if we're already inside one (e.g. a handler that calls `http::Get`).
pub(crate) fn block_on<F, T>(fut: F) -> T
where
    F: std::future::Future<Output = T>,
{
    match tokio::runtime::Handle::try_current() {
        Ok(h) => tokio::task::block_in_place(|| h.block_on(fut)),
        Err(_) => rt().block_on(fut),
    }
}