httpreplay

package
v0.31.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 23, 2018 License: Apache-2.0 Imports: 5 Imported by: 0

Documentation

Overview

Package httpreplay provides an API for recording and replaying traffic from HTTP-based Google API clients.

To record:

  1. Call NewRecorder to get a Recorder.
  2. Use its Client method to obtain an HTTP client to use when making API calls.
  3. Close the Recorder when you're done. That will save the log of interactions to the file you provided to NewRecorder.

To replay:

  1. Call NewReplayer with the same filename you used to record to get a Replayer.
  2. Call its Client method and use the client to make the same API calls. You will get back the recorded responses.
  3. Close the Replayer when you're done.

This package is EXPERIMENTAL and is subject to change or removal without notice. It requires Go version 1.8 or higher.

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func DebugHeaders added in v0.23.0

func DebugHeaders()

DebugHeaders helps to determine whether a header should be ignored. When true, if requests have the same method, URL and body but differ in a header, the first mismatched header is logged.

func Supported added in v0.25.0

func Supported() bool

Supported reports whether httpreplay is supported in the current version of Go. For Go 1.8 and above, the answer is true.

Types

type Recorder

type Recorder struct {
	// contains filtered or unexported fields
}

A Recorder records HTTP interactions.

func NewRecorder

func NewRecorder(filename string, initial []byte) (*Recorder, error)

NewRecorder creates a recorder that writes to filename. The file will also store initial state that can be retrieved to configure replay.

You must call Close on the Recorder to ensure that all data is written.

func (*Recorder) Client

func (r *Recorder) Client(ctx context.Context, opts ...option.ClientOption) (*http.Client, error)

Client returns an http.Client to be used for recording. Provide authentication options like option.WithTokenSource as you normally would, or omit them to use Application Default Credentials.

func (*Recorder) Close

func (r *Recorder) Close() error

Close closes the Recorder and saves the log file.

type Replayer

type Replayer struct {
	// contains filtered or unexported fields
}

A Replayer replays previously recorded HTTP interactions.

func NewReplayer

func NewReplayer(filename string) (*Replayer, error)

NewReplayer creates a replayer that reads from filename.

func (*Replayer) Client

func (r *Replayer) Client(ctx context.Context) (*http.Client, error)

Client returns an HTTP client for replaying. The client does not need to be configured with credentials for authenticating to a server, since it never contacts a real backend.

func (*Replayer) Close

func (r *Replayer) Close() error

Close closes the replayer.

func (*Replayer) IgnoreHeader added in v0.25.0

func (r *Replayer) IgnoreHeader(h string)

IgnoreHeader will not use h when matching requests.

func (*Replayer) Initial added in v0.23.0

func (r *Replayer) Initial() []byte

Initial returns the initial state saved by the Recorder.

Directories

Path Synopsis
cmd
internal
proxy
Package proxy provides a record/replay HTTP proxy.
Package proxy provides a record/replay HTTP proxy.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL