httpc

httpc

Utility module for abstraction and productivity-improvement on golang "net/http"

Install

Use go get command in your go-project.

$ go get github.com/unvurn/httpc

Usage

package main

import (
	"context"
	"fmt"
	
	"github.com/unvurn/httpc"
)

func main() {
	data, err := httpc.NewRequest[[]byte]().Get(context.TODO(), "https://example.com/") 
	// "data" is sequence of byte as result of downloading for "GET https://example.com/".
	// "err" indicates with its cause if downloading failed.
	if err != nil {
		panic(err)
	}
	
	// you can assume that "data" is not nil if "err" is nil
	fmt.Println(string(data))
}

you can assign "encoder" and "decoder" for each specific "content-type", like this:

type GetItemsResult struct {
	Code int `json:"code"`
	Message string `json:"message"`
	Items struct {
		ID int `json:"id"`
		Name string `json:"name"`
		Description string `json:"description"`
	} `json:"items"`
}

func jsonDecoder[T any](data []byte) (T, error) {
	var response T
	err := json.Unmarshal(data, &response)
	if err != nil {
		var zero T
		return zero, err
	}
	return response, nil
}

func main() {
	result, err := httpc.NewRequest[GetItemsResult]().Decoder(
		"application/json",
		jsonDecoder[GetItemsResult],
	).Get(context.TODO(), "https://api.example.com/v1/items") 
	// "result" is a instance of GetItemsResult decoded from json response of "GET https://api.example.com/v1/items".
	// "err" indicates with its cause if downloading failed.
	if err != nil {
		panic(err)
	}
	
	// you can assume that "result" is not nil if "err" is nil
	for i, item := range result.Items {
		fmt.Printf("%d) Item %d: %s\n", i, item.ID, item.Name)
	}
}