headers

README

gentleman/headers

gentleman's plugin to easily manage HTTP headers.

Installation

go get -u gopkg.in/h2non/gentleman.v1/plugins/headers

API

See godoc reference.

Example

package main

import (
  "fmt"
  "gopkg.in/h2non/gentleman.v1"
  "gopkg.in/h2non/gentleman.v1/plugins/headers"
)

func main() {
  // Create a new client
  cli := gentleman.New()

  // Define a custom header
  cli.Use(headers.Set("API-Token", "s3cr3t"))

  // Remove a header
  cli.Use(headers.Del("User-Agent"))

  // Perform the request
  res, err := cli.Request().URL("http://httpbin.org/headers").Send()
  if err != nil {
    fmt.Printf("Request error: %s\n", err)
    return
  }
  if !res.Ok {
    fmt.Printf("Invalid server response: %d\n", res.StatusCode)
    return
  }

  fmt.Printf("Status: %d\n", res.StatusCode)
  fmt.Printf("Body: %s", res.String())
}

License

MIT - Tomas Aparicio

Documentation

Index

• func Add(key, value string) p.Plugin
• func Del(key string) p.Plugin
• func Set(key, value string) p.Plugin
• func SetMap(headers map[string]string) p.Plugin

Functions

func Add

func Add(key, value string) p.Plugin

Add adds the key, value pair to the header. It appends to any existing values associated with key.

func Del

func Del(key string) p.Plugin

Del deletes the header fields associated with key.

func Set

func Set(key, value string) p.Plugin

Set sets the header entries associated with key to the single element value. It replaces any existing values associated with key.

func SetMap

func SetMap(headers map[string]string) p.Plugin

SetMap sets a map of headers represented by key-value pair.