{"id":18251772,"url":"https://github.com/hiroakis/go-requests","last_synced_at":"2025-04-08T20:46:52.418Z","repository":{"id":57486570,"uuid":"97551622","full_name":"hiroakis/go-requests","owner":"hiroakis","description":"A HTTP library for Go, inspired by requests module written in Python. The usage is similer to Python requests.","archived":false,"fork":false,"pushed_at":"2017-07-19T06:16:39.000Z","size":174,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-14T16:39:46.319Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hiroakis.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-07-18T04:11:20.000Z","updated_at":"2021-09-30T09:10:49.000Z","dependencies_parsed_at":"2022-09-01T22:31:56.711Z","dependency_job_id":null,"html_url":"https://github.com/hiroakis/go-requests","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hiroakis%2Fgo-requests","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hiroakis%2Fgo-requests/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hiroakis%2Fgo-requests/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hiroakis%2Fgo-requests/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hiroakis","download_url":"https://codeload.github.com/hiroakis/go-requests/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247927089,"owners_count":21019504,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-05T09:48:27.453Z","updated_at":"2025-04-08T20:46:52.391Z","avatar_url":"https://github.com/hiroakis.png","language":"Go","readme":"# go-requests\n\nA HTTP library for Go, inspired by [requests module written in Python](http://docs.python-requests.org/en/master/). The usage is similer to Python requests.\n\n# Installation\n\n```\ngo get github.com/hiroakis/go-requests\n```\n\n# Feature\n\n* Supports GET, POST, PUT, PATCH, DELETE, HEAD and OPTIONS.\n* Asynchronous method\n* Basic/Digest Authentication\n* Connection/Read Timeouts\n* Cookie\n* Redirection controll\n\n## TODO\n\n* File uploading\n* Client certificate authentication\n* Proxy support\n\n# Usage\n\nBasic usage\n\n```\nresp, err := requests.\u003cMethod\u003e(urlStr, // URL string\n    nil, // *url.Values QueryString\n    nil) // *requests.RequestParams\n```\n\n Followings are simple usage.\n\n```\n# GET\nresp, err := requests.Get(\"https://httpbin.org/\", nil, nil)\n\n# POST\npostData := \u0026bytes.Buffer{}\npostData.WriteString(\"postdata\")\nresp, err := requests.Post(\"https://httpbin.org/\", nil, \u0026requests.RequestParams{\n    Data:    postData,\n})\n\n# PUT\nresp, err := requests.Put(\"https://httpbin.org/\", nil, nil)\n\n# PATCH\nresp, err := requests.Patch(\"https://httpbin.org/\", nil, nil)\n\n# DELETE\nresp, err := requests.Delete(\"https://httpbin.org/\", nil, nil)\n\n# HEAD\nresp, err := requests.Head(\"https://httpbin.org/\", nil, nil)\n\n# OPTIONS\nresp, err := requests.Options(\"https://httpbin.org/\", nil, nil)\n```\n\n## Get\n\n```\npackage main\n\nimport (\n\t\"fmt\"\n\n\trequests \"github.com/hiroakis/go-requests\"\n)\n\nfunc main() {\n\n\tresp, err := requests.Get(\"https://httpbin.org/\", nil, nil)\n\n\tif err != nil {\n\t\tfmt.Println(err)\n\t\treturn\n\t}\n\t// Response body\n\tfmt.Println(resp.Text())\n\t// status code\n\tfmt.Printf(\"Code: %d\\n\", resp.StatusCode())\n\tfor k, v := range resp.Headers() {\n\t\t// Response Headers\n\t\tfmt.Printf(\"%s: %s\\n\", k, v)\n\t}\n}\n```\n\n## Get with QueryString\n\n```\npackage main\n\nimport (\n\t\"fmt\"\n\t\"net/url\"\n\n\trequests \"github.com/hiroakis/go-requests\"\n)\n\nfunc main() {\n\tqs := \u0026url.Values{}\n\tqs.Add(\"param1\", \"value1\")\n\tqs.Add(\"param2\", \"value2\")\n\tresp, err := requests.Get(\"https://httpbin.org/get\", qs, nil)\n\tif err != nil {\n\t\tfmt.Println(err)\n\t\treturn\n\t}\n\tfmt.Println(resp.Text())\n}\n```\n\n## Get cookie\n\n```\npackage main\n\nimport (\n\t\"fmt\"\n\t\"net/url\"\n\n\trequests \"github.com/hiroakis/go-requests\"\n)\n\nfunc main() {\n\tparam := \u0026url.Values{}\n\tparam.Add(\"k1\", \"v1\")\n\tparam.Add(\"k2\", \"v2\")\n\tresp, err := requests.Get(\"https://httpbin.org/cookies/set\", param, nil)\n\tif err != nil {\n\t\tfmt.Println(err)\n\t\treturn\n\t}\n\tfor k, v := range resp.Cookies() {\n\t\tfmt.Printf(\"------ Cookie %d ------\\n\", k)\n\t\tfmt.Printf(\"Name: %s\\n\", v.Name)\n\t\tfmt.Printf(\"Value: %s\\n\", v.Value)\n\t\tfmt.Printf(\"Path: %s\\n\", v.Path)\n\t}\n}\n```\n\n## Post\n\n```\npackage main\n\nimport (\n\t\"bytes\"\n\t\"fmt\"\n\n\trequests \"github.com/hiroakis/go-requests\"\n)\n\nfunc main() {\n\n\tpostData := \u0026bytes.Buffer{}\n\tpostData.WriteString(\"postdata\")\n\n\tresp, err := requests.Post(\"https://httpbin.org/post\", nil, \u0026requests.RequestParams{\n\t\tData: postData,\n\t})\n\n\tif err != nil {\n\t\tfmt.Println(err)\n\t\treturn\n\t}\n\n\tfmt.Println(resp.Text())\n}\n```\n\n## Post JSON\n\n```\npackage main\n\nimport (\n\t\"fmt\"\n\t\"net/http\"\n\t\"time\"\n\n\trequests \"github.com/hiroakis/go-requests\"\n)\n\nfunc main() {\n\n\tjsonData := struct {\n\t\tID        int               `json:\"id\"`\n\t\tName      string            `json:\"name\"`\n\t\tCreatedAt time.Time         `json:\"created_at\"`\n\t\tInfo      map[string]string `json:\"info\"`\n\t}{\n\t\tID:        1,\n\t\tName:      \"hiroakis\",\n\t\tCreatedAt: time.Now(),\n\t\tInfo: map[string]string{\n\t\t\t\"info1\": \"xxxx\",\n\t\t\t\"info2\": \"yyyy\",\n\t\t},\n\t}\n\n\th := make(http.Header)\n\th.Add(\"Content-Type\", \"application/json\")\n\n\tresp, err := requests.Post(\"https://httpbin.org/post\", nil, \u0026requests.RequestParams{\n\t\tJson:    jsonData,\n\t\tHeaders: h,\n\t})\n\n\tif err != nil {\n\t\tfmt.Println(err)\n\t\treturn\n\t}\n\n\tfmt.Println(resp.Text())\n}\n```\n\n## More complicated POST requests\n\n```\npackage main\n\nimport (\n\t\"fmt\"\n\t\"net/http\"\n\t\"net/http/cookiejar\"\n\t\"net/url\"\n\n\t\"time\"\n\n\t\"bytes\"\n\n\trequests \"github.com/hiroakis/go-requests\"\n)\n\nfunc main() {\n\t// make http headers\n\tvar headers http.Header\n\theaders = make(http.Header)\n\theaders.Add(\"X-requests\", \"i-am-go-requests\")\n\theaders.Add(\"Content-Type\", \"application/x-www-form-urlencoded\")\n\n\t// make post data\n\tpostData := \u0026bytes.Buffer{}\n\tpostData.WriteString(\"postdata=valvalval\")\n\n\t// make cookie\n\tcookieJar, _ := cookiejar.New(nil)\n\tu, _ := url.Parse(\"https://httpbin.org/post\")\n\tvar cookies []*http.Cookie\n\tcookies = append(cookies, \u0026http.Cookie{\n\t\tName:     \"cookie\",\n\t\tValue:    \"value\",\n\t\tPath:     \"/\",\n\t\tHttpOnly: true,\n\t})\n\tcookieJar.SetCookies(u, cookies)\n\n\tresp, err := requests.Post(\"https://httpbin.org/post\", nil, \u0026requests.RequestParams{\n\t\tData:    postData,\n\t\tHeaders: headers,\n\t\tAuth: \u0026requests.Auth{\n\t\t\tUsername: \"hiroakis\",\n\t\t\tPassword: \"password\",\n\t\t},\n\t\tTimeout: \u0026requests.Timeout{\n\t\t\tConnect: 5 * time.Second,\n\t\t\tRead:    10 * time.Second,\n\t\t},\n\t\tCookies:        cookieJar,\n\t\tAllowRedirects: requests.Redirect().NotAllow(),\n\t})\n\n\tif err != nil {\n\t\tfmt.Println(err)\n\t\treturn\n\t}\n\n\tfmt.Println(resp.Text())\n}\n```\n\n## Async API\n\nIt has also asynchronous API.\n\n```\npackage main\n\nimport (\n\t\"fmt\"\n\n\trequests \"github.com/hiroakis/go-requests\"\n)\n\nfunc main() {\n\trespCh, errCh := requests.GetAsync(\"https://httpbin.org/get\", nil, nil)\n\n\tdoneCh := make(chan struct{})\n\tvar respBody string\n\tgo func() {\n\t\tselect {\n\t\tcase resp := \u003c-respCh:\n\t\t\trespBody = resp.Text()\n\t\tcase err := \u003c-errCh:\n\t\t\tif err != nil {\n\t\t\t\tfmt.Println(err)\n\t\t\t}\n\t\t}\n\t\tdoneCh \u003c- struct{}{}\n\t}()\n\n\tfmt.Println(\"do something while waiting for the response\")\n\t\u003c-doneCh\n\n\tfmt.Println(respBody)\n}\n```\n\n## Bindata\n\n```\npackage main\n\nimport (\n\t\"bufio\"\n\t\"fmt\"\n\t\"io\"\n\t\"os\"\n\n\trequests \"github.com/hiroakis/go-requests\"\n)\n\nfunc main() {\n\tresp, err := requests.Get(\"https://httpbin.org/image/png\", nil, nil)\n\tif err != nil {\n\t\tfmt.Println(err)\n\t\treturn\n\t}\n\timg := resp.Raw()\n\n\tout, err := os.Create(\"image.png\")\n\tif err != nil {\n\t\tfmt.Println(err)\n\t\treturn\n\t}\n\tdefer out.Close()\n\n\tio.Copy(out, bufio.NewReader(img))\n}\n```\n\n# License\n\nMIT","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhiroakis%2Fgo-requests","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhiroakis%2Fgo-requests","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhiroakis%2Fgo-requests/lists"}