https://github.com/tomnomnom/rawhttp
A Go library for making HTTP requests with complete control
https://github.com/tomnomnom/rawhttp
Last synced: 29 days ago
JSON representation
A Go library for making HTTP requests with complete control
- Host: GitHub
- URL: https://github.com/tomnomnom/rawhttp
- Owner: tomnomnom
- License: mit
- Created: 2017-09-02T10:19:16.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2022-06-11T22:55:54.000Z (almost 3 years ago)
- Last Synced: 2025-04-02T11:03:51.126Z (about 1 month ago)
- Language: Go
- Size: 16.6 KB
- Stars: 125
- Watchers: 6
- Forks: 23
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# rawhttp
[](https://travis-ci.org/tomnomnom/rawhttp)
[](https://godoc.org/github.com/tomnomnom/rawhttp)
rawhttp is a [Go](https://golang.org/) package for making HTTP requests.
It intends to fill a niche that [https://golang.org/pkg/net/http/](net/http) does not cover:
having *complete* control over the requests being sent to the server.
rawhttp purposefully does as little validation as possible, and you can override just about
anything about the request; even the line endings.
**Warning:** This is a work in progress. The API isn't fixed yet.
Full documentation can be found on [GoDoc](https://godoc.org/github.com/tomnomnom/rawhttp).
## Example
```go
req, err := rawhttp.FromURL("POST", "https://httpbin.org")
if err != nil {
log.Fatal(err)
}
// automatically set the host header
req.AutoSetHost()
req.Method = "PUT"
req.Hostname = "httpbin.org"
req.Port = "443"
req.Path = "/anything"
req.Query = "one=1&two=2"
req.Fragment = "anchor"
req.Proto = "HTTP/1.1"
req.EOL = "\r\n"
req.AddHeader("Content-Type: application/x-www-form-urlencoded")
req.Body = "username=AzureDiamond&password=hunter2"
// automatically set the Content-Length header
req.AutoSetContentLength()
fmt.Printf("%s\n\n", req.String())
resp, err := rawhttp.Do(req)
if err != nil {
log.Fatal(err)
}
fmt.Printf("< %s\n", resp.StatusLine())
for _, h := range resp.Headers() {
fmt.Printf("< %s\n", h)
}
fmt.Printf("\n%s\n", resp.Body())
```
```
PUT /anything?one=1&two=2#anchor HTTP/1.1
Host: httpbin.org
Content-Type: application/x-www-form-urlencoded
Content-Length: 38
username=AzureDiamond&password=hunter2
< HTTP/1.1 200 OK
< Connection: keep-alive
< Server: meinheld/0.6.1
< Date: Sat, 02 Sep 2017 13:22:06 GMT
< Content-Type: application/json
< Access-Control-Allow-Origin: *
< Access-Control-Allow-Credentials: true
< X-Powered-By: Flask
< X-Processed-Time: 0.000869989395142
< Content-Length: 443
< Via: 1.1 vegur
{
"args": {
"one": "1",
"two": "2"
},
"data": "",
"files": {},
"form": {
"password": "hunter2",
"username": "AzureDiamond"
},
"headers": {
"Connection": "close",
"Content-Length": "38",
"Content-Type": "application/x-www-form-urlencoded",
"Host": "httpbin.org"
},
"json": null,
"method": "PUT",
"origin": "123.123.123.123",
"url": "https://httpbin.org/anything?one=1&two=2"
}
```