API
#net/httpHTTP/1.1 Client and Server, Header, Cookie. No TLS in this package.
struct Responsepub struct Response {
pub status_code int
pub status string
pub headers string
pub body string
pub sticky string
}Public struct `Response`.
status_code intstatus stringheaders stringbody stringsticky stringnew_responsepub fn new_response() ResponseConstruct response.
none
Response — a value of this type
(Response) status_codepub fn (r Response) status_code() intMethod on `Response`: status code.
r Responseint — a value of this type
(Response) statuspub fn (r Response) status() stringCall `status` on `Response`.
r Responsestring — result string
(Response) bodypub fn (r Response) body() stringCall `body` on `Response`.
r Responsestring — result string
(Response) headerpub fn (r Response) header(name string) stringCall `header` on `Response`.
r Responsename stringstring — result string
struct Requestpub struct Request {
pub method string
pub path string
pub headers string
pub body string
pub sticky string
}Public struct `Request`.
method stringpath stringheaders stringbody stringsticky stringnew_requestpub fn new_request() RequestConstruct request.
none
Request — a value of this type
(Request) methodpub fn (r Request) method() stringCall `method` on `Request`.
r Requeststring — result string
(Request) pathpub fn (r Request) path() stringCall `path` on `Request`.
r Requeststring — result string
(Request) bodypub fn (r Request) body() stringCall `body` on `Request`.
r Requeststring — result string
(Request) headerpub fn (r Request) header(name string) stringCall `header` on `Request`.
r Requestname stringstring — result string
(Request) user_agentpub fn (r Request) user_agent() stringMethod on `Request`: user agent.
r Requeststring — result string
(Request) hostpub fn (r Request) host() stringMethod on `Request`: host.
r Requeststring — result string
struct Serverpub struct Server {
pub lfd int
}Public struct `Server`.
lfd intnew_serverpub fn new_server() ServerConstruct server.
none
Server — a value of this type
(&mut Server) listenpub fn (s &mut Server) listen(addr string) intMethod on `&mut Server`: listen for connections. Throws on failure.
s &mut Serveraddr stringint — a value of this type
(Server) acceptpub fn (s Server) accept() intMethod on `Server`: accept one connection. Throws on failure.
s Serverint — a value of this type
(&mut Server) closepub fn (s &mut Server) close() intMethod on `&mut Server`: close the resource.
s &mut Serverint — a value of this type
status_textpub fn status_text(code int) stringStatus text.
code intstring — result string
(&mut Response) getpub fn (r &mut Response) get(url string) intCall `get` on `&mut Response`. Throws on failure.
r &mut Responseurl stringint — a value of this type
(&mut Response) postpub fn (r &mut Response) post(url string, body &string) intCall `post` on `&mut Response`. Throws on failure.
r &mut Responseurl stringbody &stringint — a value of this type
(Response) cookiespub fn (r Response) cookies() []CookieCall `cookies` on `Response`.
r Response[]Cookie — slice result
struct Clientpub struct Client {
pub jar cookiejar.Jar
pub jar_on int
pub timeout_ns int
pub max_redirects int
}Public struct `Client`.
jar cookiejar.Jarjar_on inttimeout_ns intmax_redirects intnew_clientpub fn new_client() ClientConstruct client.
none
Client — a value of this type
(&mut Client) set_jarpub fn (c &mut Client) set_jar(j cookiejar.Jar)Method on `&mut Client`: set jar.
c &mut Clientj cookiejar.Jar(&mut Client) set_timeoutpub fn (c &mut Client) set_timeout(ns int)Method on `&mut Client`: set timeout.
c &mut Clientns int(&mut Client) dopub fn (c &mut Client) do(method string, raw_url string, body &string) ResponseCall `do` on `&mut Client`. Throws on failure.
c &mut Clientmethod stringraw_url stringbody &stringResponse — a value of this type
(&mut Client) getpub fn (c &mut Client) get(raw_url string) ResponseCall `get` on `&mut Client`. Throws on failure.
c &mut Clientraw_url stringResponse — a value of this type
(&mut Client) postpub fn (c &mut Client) post(raw_url string, body &string) ResponseCall `post` on `&mut Client`. Throws on failure.
c &mut Clientraw_url stringbody &stringResponse — a value of this type
(&mut Request) readpub fn (req &mut Request) read(fd int) intMethod on `&mut Request`: read up to max bytes. Throws on failure.
req &mut Requestfd intint — a value of this type
write_responsepub fn write_response(fd int, status_code int, body &string) intWrite response. Throws on failure.
fd intstatus_code intbody &stringint — a value of this type
writepub fn write(fd int, status_code int, content_type string, body &string) intwrite is the typed-body form of a one-shot HTTP/1.1 response ( http.ResponseWriter WriteHeader+Write, Connection: close).
fd intstatus_code intcontent_type stringbody &stringint — bytes written
(&Client) has_idle_connectionpub fn (c &Client) has_idle_connection() boolMethod on `&Client`: whether it has idle connection.
c &Clientbool — true or false
struct Contextpub struct Context {
pub fd int
pub req Request
}Request context ( `http.Handler` / `HandlerFunc`). func hello(w http.ResponseWriter, r *http.Request) { fmt.Fprint(w, "ok") } http.ListenAndServe(":8080", http.HandlerFunc(hello)) Xu folds w+r into Context fn hello(c http.Context) { c.text(200, "ok") } http.listen_and_serve_handler("127.0.0.1:8080", hello)
fd intreq Request(Context) methodpub fn (c Context) method() stringCall `method` on `Context`.
c Contextstring — result string
(Context) raw_pathpub fn (c Context) raw_path() stringMethod on `Context`: raw path.
c Contextstring — result string
(Context) pathpub fn (c Context) path() stringCall `path` on `Context`.
c Contextstring — result string
(Context) querypub fn (c Context) query() stringCall `query` on `Context`.
c Contextstring — result string
(Context) headerpub fn (c Context) header(name string) stringCall `header` on `Context`.
c Contextname stringstring — result string
(Context) bodypub fn (c Context) body() stringCall `body` on `Context`.
c Contextstring — result string
(Context) textpub fn (c Context) text(status int, body string) intMethod on `Context`: return the current text. Throws on failure.
c Contextstatus intbody stringint — a value of this type
(Context) text_extrapub fn (c Context) text_extra(status int, extra string, body string) intMethod on `Context`: text extra. Throws on failure.
c Contextstatus intextra stringbody stringint — a value of this type
(Context) htmlpub fn (c Context) html(status int, body string) intCall `html` on `Context`. Throws on failure.
c Contextstatus intbody stringint — a value of this type
(Context) bytespub fn (c Context) bytes(status int, content_type string, body string) intMethod on `Context`: return the buffered bytes. Throws on failure.
c Contextstatus intcontent_type stringbody stringint — a value of this type
(Server) servepub fn (s Server) serve(handle fn(Context)) intserve is (*Server).Serve for an already-listening Server. close from another goroutine unblocks Accept and ends the loop.
s Serverhandle fn(Context)int — a value of this type
listen_and_serve_handlerpub fn listen_and_serve_handler(addr string, handle fn(Context)) intlisten_and_serve_handler is ListenAndServe(addr, HandlerFunc(fn)). Throws on failure.
addr stringhandle fn(Context)int — a value of this type
struct Cookiepub struct Cookie {
pub name string
pub value string
pub path string
pub domain string
pub expires string
pub max_age int
pub secure bool
pub http_only bool
pub same_site string
}Cookie / Set-Cookie subset (RFC 6265) aligned with `net/http` ParseCookie / ParseSetCookie / Cookie.String. Expires is kept as raw text (no time.Time). SameSite is a string: "", Lax, Strict, None.
name stringvalue stringpath stringdomain stringexpires stringmax_age intsecure boolhttp_only boolsame_site stringparse_cookiepub fn parse_cookie(line &string) []CookieParse as cookie. Throws on failure.
line &string[]Cookie — slice result
parse_set_cookiepub fn parse_set_cookie(line &string) CookieParse as set cookie. Throws on failure.
line &stringCookie — a value of this type
(Cookie) to_stringpub fn (c Cookie) to_string() stringMethod on `Cookie`: convert to string.
c Cookiestring — result string
cookie_headerpub fn cookie_header(cookies &[]Cookie) stringCookie header.
cookies &[]Cookiestring — result string
(Request) cookiespub fn (r Request) cookies() []CookieCall `cookies` on `Request`.
r Request[]Cookie — slice result
struct FileServerpub struct FileServer {
pub root string
}FileServer + ListenAndServe ( FileServer / FileServerFS). Open goes through os.DirFS + io/fs (ValidPath, no `..` escape). http.listen_and_serve("127.0.0.1:8080", ".") Serves GET/HEAD under `root`. Directories use index.html when present, otherwise a listing. Paths are cleaned so `..` cannot escape root.
root stringfile_serverpub fn file_server(root string) FileServerFile server.
root stringFileServer — a value of this type
listen_and_servepub fn listen_and_serve(addr string, root string) intListen and serve. Throws on failure.
addr stringroot stringint — a value of this type
(FileServer) servepub fn (fs FileServer) serve(fd int)Call `serve` on `FileServer`.
fs FileServerfd intserve_filepub fn serve_file(fd int, name string) intServe file. Throws on failure.
fd intname stringint — a value of this type
struct Headerpub struct Header {
pub keys []string
pub vals []string
}Header is a case-insensitive MIME header ( `http.Header` `textproto.MIMEHeader` subset). No map: parallel keys/vals; Add appends a second pair with the same canonical key.
keys []stringvals []stringnew_headerpub fn new_header() HeaderConstruct header.
none
Header — a value of this type
canonical_header_keypub fn canonical_header_key(s &string) stringCanonical header key.
s &stringstring — result string
(&mut Header) addpub fn (h &mut Header) add(key &string, value &string)Method on `&mut Header`: add.
h &mut Headerkey &stringvalue &string(&mut Header) delpub fn (h &mut Header) del(key &string)Call `del` on `&mut Header`.
h &mut Headerkey &string(&mut Header) setpub fn (h &mut Header) set(key &string, value &string)Call `set` on `&mut Header`.
h &mut Headerkey &stringvalue &string(Header) getpub fn (h Header) get(key &string) stringCall `get` on `Header`.
h Headerkey &stringstring — result string
(Header) valuespub fn (h Header) values(key &string) []stringCall `values` on `Header`.
h Headerkey &string[]string — slice result
(Header) clonepub fn (h Header) clone() HeaderMethod on `Header`: copy into a new independent string.
h HeaderHeader — a value of this type
(Header) lenpub fn (h Header) len() intMethod on `Header`: return the length.
h Headerint — a value of this type
(Header) writepub fn (h Header) write() stringMethod on `Header`: write data and return the byte count.
h Headerstring — result string
parse_headerpub fn parse_header(raw &string) HeaderParse as header.
raw &stringHeader — a value of this type
(Response) reusablepub fn (r Response) reusable(method string) boolCall only after read_response has validated and consumed the entire message.
r Responsemethod stringbool — true or false
read_responsepub fn read_response(fd int, method string) ResponseRead one response on a caller-owned socket. Serial keep-alive requests are supported; pipelined requests require a persistent buffered transport. Throws on failure.
fd intmethod stringResponse — a value of this type
detect_content_typepub fn detect_content_type(data &string) stringDetect content type.
data &stringstring — result string