A GUI application for testing gRPC services.
To get started, click "Add file" in the sidebar and select your .proto
file. The file will be automatically compiled and all the services added to the sidebar.
The include paths used to load proto files can be configured under "File > Import services > Compiler Options". It is also possible to load a file descriptor set generated by running protoc
with the --descriptor_set_out
argument.
The button for a service method opens a tab where you can call your gRPC service. The history of previous requests and responses is displayed in the bottom pane.
The button for a service opens a tab which controls default configuration for a service.
Instead of setting authorization in metadata manually, Lanquetta can load it from an "authorization hook". This avoids needing to refresh the metadata every time your token expires, and prevents your token from being saved to disk.
An authorization hook is a script called when the application makes a request. On success it should return an exit code of zero and output a JSON object to stdout with the following structure:
{
"metadata": {
"authorization": "Bearer eyJ0eXAiOiJKV1QiLA0KICJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJqb2UiLA0KICJleHAiOjEzMDA4MTkzODAsDQogImh0dHA6Ly9leGFtcGxlLmNvbS9pc19yb290Ijp0cnVlfQ.dBjftJeZ4CVP-mB92K27uhbUJU1p1r_wW1gFWFOEjXk"
},
"expiry": "2011-03-22T18:43:00Z"
}
metadata
is a map of key value pairs sent as metadata (HTTP headers) to your service. expiry
is an optional RFC3339 timestamp. If set, the metadata will be cached until the expiry time so that future calls don't need to invoke your authorization hook.