httpie

README

httpie-go

httpie-go (ht) is a user-friendly HTTP client CLI. Requests can be issued with fewer types compared to curl. Responses are displayed with syntax highlighting.

httpie-go is a clone of httpie. Since httpie-go is written in Go, it is a single binary and does not require a heavy runtime.

Examples

This example sends a GET request to http://httpbin.org/get.

$ ht GET httpbin.org/get

The second example sends a POST request with JSON body {"hello": "world", "foo": "bar"}.

$ ht POST httpbin.org/post hello=world foo=bar

You can see the request that is being sent with -v option.

$ ht -v POST httpbin.org/post hello=world foo=bar

Request HTTP headers can be specified in the form of key:value.

$ ht -v POST httpbin.org/post X-Foo:foobar

Disable TLS verification.

$ ht --verify=no https://httpbin.org/get

Download a file.

$ ht --download <any url you want>

Documents

Although httpie-go does not currently have documents, you can refer to the original httpie's documentation since httpie-go is a clone of httpie. Note that some minor options are yet to be implemented in httpie-go.

How to build

make

For non-standard Linux system like Android termux, use following method to avoid the DNS issue.

make build-termux

Documentation

Index

• func Main(options *Options) error
• type ExResponse
  • func Exchange(in *input.Input, exchangeOptions *exchange.Options, ...) (ExResponse, error)
  • func Lama2Entry(cmdArgs []string, stdinBody io.Reader) (ExResponse, error)
• type Options

Functions

func Main

func Main(options *Options) error

Types

type ExResponse

type ExResponse struct {
	StatusCode int
	Body       string
	Headers    map[string]string
}

func Exchange

func Exchange(in *input.Input, exchangeOptions *exchange.Options, outputOptions *output.Options) (ExResponse, error)

func Lama2Entry

func Lama2Entry(cmdArgs []string, stdinBody io.Reader) (ExResponse, error)

type Options

type Options struct {
	// Transport is applied to the underlying HTTP client. Use to mock or
	// intercept network traffic.  If nil, http.DefaultTransport will be cloned.
	Transport http.RoundTripper
}