http

README

http

A small simplification of the standard library net/http in Go.

Usage

Use go get to download the dependency.

go get github.com/Laky-64/http@latest

Then, import it in your Go files:

import "github.com/Laky-64/http"

The library is designed to be simple and easy to use. Here's an example of a simple request:

Simple Request

res, err := http.ExecuteRequest(
    "https://httpbin.org/get",
)
if err != nil {
    panic(err)
}
fmt.Println(res)

Proxy Request

res, err := http.ExecuteRequest(
    "https://ipinfo.io",
    http.Proxy("socks5://127.0.0.1:9050"),
)
if err != nil {
    panic(err)
}
fmt.Println(res)

POST Request

res, err := http.ExecuteRequest(
    "https://httpbin.org/post",
    http.Method("POST"),
    http.Body([]byte("Hello, World!")),
)
if err != nil {
    panic(err)
}
fmt.Println(res)

MultiPart Request

res, err := http.ExecuteRequest(
   "https://httpbin.org/post", 
   http.Method("POST"), 
   http.MultiPartForm(
       map[string]string{
           "key": "value",
       }, 
       map[string]types.FileDescriptor{
           "file": {
               FileName: "file.txt", 
               Content:  []byte("Hello, World!"),
           },
       },
   ),
)
if err != nil {
   panic(err)
}
fmt.Println(res)

Documentation

Index

• func ExecuteRequest(uri string, options ...RequestOption) (*types.HTTPResult, error)
• type RequestOption
  • func BearerToken(method string) RequestOption
  • func Body(body []byte) RequestOption
  • func Cookies(cookies map[string]string) RequestOption
  • func Headers(headers map[string]string) RequestOption
  • func Method(method string) RequestOption
  • func MultiPartForm(data map[string]string, files map[string]types.FileDescriptor) RequestOption
  • func OverloadReader(reader overloadReader) RequestOption
  • func Proxy(url string) RequestOption
  • func Retries(count int) RequestOption
  • func Timeout(time time.Duration) RequestOption

Functions

func ExecuteRequest

func ExecuteRequest(uri string, options ...RequestOption) (*types.HTTPResult, error)

Types

type RequestOption

type RequestOption interface {
	Apply(o *types.RequestOptions)
}

func BearerToken

func BearerToken(method string) RequestOption

func Body

func Body(body []byte) RequestOption

func Cookies

func Cookies(cookies map[string]string) RequestOption

func Headers

func Headers(headers map[string]string) RequestOption

func Method

func Method(method string) RequestOption

func MultiPartForm

func MultiPartForm(data map[string]string, files map[string]types.FileDescriptor) RequestOption

func OverloadReader

func OverloadReader(reader overloadReader) RequestOption

func Proxy

func Proxy(url string) RequestOption

func Retries

func Retries(count int) RequestOption

func Timeout

func Timeout(time time.Duration) RequestOption