https://github.com/inancgumus/myhttp

Simplest HTTP GET requester for Go with timeout support
https://github.com/inancgumus/myhttp

Last synced: 3 months ago
JSON representation

Simplest HTTP GET requester for Go with timeout support

• Host: GitHub
• URL: https://github.com/inancgumus/myhttp
• Owner: inancgumus
• License: mit
• Archived: true
• Created: 2017-09-13T15:48:47.000Z (about 7 years ago)
• Default Branch: master
• Last Pushed: 2018-05-06T18:25:10.000Z (over 6 years ago)
• Last Synced: 2024-06-19T02:08:43.234Z (5 months ago)
• Language: Go
• Size: 123 KB
• Stars: 34
• Watchers: 2
• Forks: 14
• Open Issues: 1
• Metadata Files:
  • Readme: readme.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-go - myhttp - Simplest HTTP GET requester for Go with timeout support - ★ 27 (Utilities)
• awesome-go-extra - ARCHIVED - 09-13T15:48:47Z|2018-05-06T18:25:10Z| (Utilities / Fail injection)

README

        
# MyHttp

> Easy to use API to make timeout supported http GET requests in Go.

![Go Report Card](https://goreportcard.com/badge/github.com/inancgumus/myhttp) [![Coverage Status](https://coveralls.io/repos/github/inancgumus/myhttp/badge.svg?branch=master)](https://coveralls.io/github/inancgumus/myhttp?branch=master)

MyHttp is for coders who don't want to write timeout support logic and don't want to deal with heavy APIs, just to make http GET request in Go.

It's battle-tested in production and has tests which even verifies connection leaking issues.

I'd been dealing with this issue myself, I read many documents, and saw that there are no simple and lightweight APIs to do http GET request with timeout logic. So, I created MyHttp in one of my projects and wanted to move it here.

## Installation

```sh

go get github.com/inancgumus/myhttp

```

## Documentation

See [MyHttp GoDoc](https://godoc.org/github.com/inancgumus/myhttp) for the documentation.

## Usage example

### Get

`Get` simply gets the url and returns an `http.Response`.

```go

import (

	"time"

	"github.com/inancgumus/myhttp"

)

mh := myhttp.New(time.Second * 10) // timeout after 10 seconds

res, err := mh.Get("http://www.domain.com/foo")

if err != nil {

	panic(err)

}

// use res here...

```

### WrapGet

`WrapGet` accepts a function in its second argument and runs it after getting the `http.Response` from the url and automatically closes the http.Response.Body, in case you may forget to close it.

```go

import (

	"time"

	"github.com/inancgumus/myhttp"

)

mh := myhttp.New(time.Second * 10) // timeout after 10 seconds

err := mh.WrapGet("http://www.domain.com/foo", func(r *http.Response) error {

	// use res here...

	// MyHttp will automatically close http.Response.Body for you after this func ends.

})

if err != nil {

	panic(err)

}

```

## Author

Inanc Gumus – [@inancgumus](https://twitter.com/inancgumus)

Distributed under the MIT license. See ``LICENSE`` for more information.

## Contributing

1. Fork it ()

2. Create your feature branch (`git checkout -b feature/foo`)

3. Commit your changes (`git commit -am 'add: foo'`)

4. Push to the branch (`git push origin feature/foo`)

5. Create a new Pull Request