README

gentleman/query Build Status GoDoc Go Report Card

gentleman's plugin to easily manage HTTP query params.

Installation

go get -u gopkg.in/h2non/gentleman.v2/plugins/query

API

See godoc reference.

Example

package main

import (
  "fmt"
  "gopkg.in/h2non/gentleman.v2"
  "gopkg.in/h2non/gentleman.v2/plugins/query"
  "gopkg.in/h2non/gentleman.v2/plugins/url"
)

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

  // Define the base URL to use
  cli.Use(url.BaseURL("http://httpbin.org"))
  cli.Use(url.Path("/get"))

  // Define a custom query param
  cli.Use(query.Set("foo", "bar"))

  // Remove a query param
  cli.Use(query.Del("bar"))

  // Perform the request
  res, err := cli.Request().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

Constants

This section is empty.

Variables

This section is empty.

Functions

func Add

func Add(key, value string) p.Plugin

    Add adds the query param value to key. It appends to any existing values associated with key.

    func Del

    func Del(key string) p.Plugin

      Del deletes the query param values associated with key.

      func DelAll

      func DelAll() p.Plugin

        DelAll deletes all the query params.

        func Set

        func Set(key, value string) p.Plugin

          Set sets the query param key and value. It replaces any existing values.

          func SetMap

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

            SetMap sets a map of query params by key-value pair.

            Types

            This section is empty.

            Source Files