README.md

Go Test Proxy

A Go proxy to plug between the frontend and the backend or between backend services for last-resort testing.

Why?

I only want to see the requests and responses, without the necessity to open a debugger.

Quick start

Build

make build

or if you don't have Make:

go build github.com/blazejsewera/go-test-proxy/cmd/gotestproxy

Run

./gotestproxy --target=https://example.com --port=8000

Point your client to the proxy

Depending on your project, you want to have something like this:

backendUrl: "http://localhost:8000"

Mocking certain endpoints

It is easy to quickly mock endpoints with Go Test Proxy, simply add a new handler function to the proxy builder.

Go to main.go and invoke builder.WithHandlerFunc("/mockedPath", customFunc). Then rebuild the project and run it.

Swapping the monitor implementations

Look at builder.WithMonitor and monitor.Combine functions. The former lets you set any monitor adhering to the proxy.Monitor interface. The latter lets you combine multiple monitors — they will be called one-by-one.

Install

To install gotestproxy binary, simply run make install, setting a PREFIX that is in your PATH.

PREFIX=<target_directory> make install

Uninstalling is also very simple:

PREFIX=<previously_set_prefix> make uninstall

Alternatively, you can simply remove the gotestproxy binary — it's self-contained, so it's the only file to remove.

Build for different targets

You can also build gotestproxy for different targets, like windows/amd64:

make build-windows-amd64