README
¶
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
Directories