Skip to content

Latest commit

 

History

History
40 lines (24 loc) · 1.85 KB

README.md

File metadata and controls

40 lines (24 loc) · 1.85 KB

logo

Lanquetta

A GUI application for testing gRPC services.

Getting started

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.

Calling your service

The add 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.

Sample

Options

The options button for a service opens a tab which controls default configuration for a service.

Sample

Authorization hook

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.