package testing

Get desktop application:
View/edit binary Protocol Buffers messages

A simple service to test the various types of RPCs and experiment with performance with various types of payload.

• rpc EmptyCall (Empty, Empty)

  test.proto:143

  One empty request followed by one empty response.

• rpc UnaryCall (SimpleRequest, SimpleResponse)

  test.proto:147

  One request followed by one response. The server returns the client payload as-is.

  message SimpleRequest

  test.proto:55

  Unary request.

  • PayloadType response_type = 1

    Desired payload type in the response from the server. If response_type is RANDOM, server randomly chooses one from other formats.

  • int32 response_size = 2

    Desired payload size in the response from the server. If response_type is COMPRESSABLE, this denotes the size before compression.

  • optional Payload payload = 3

    Optional input payload sent along with the request.

  • bool fill_username = 4

    Whether SimpleResponse should include username.

  • bool fill_oauth_scope = 5

    Whether SimpleResponse should include OAuth scope.

  • optional EchoStatus response_status = 7

    Whether server should return a given status

  message SimpleResponse

  test.proto:78

  Unary response, as configured by the request.

  • optional Payload payload = 1

    Payload to increase message size.

  • string username = 2

    The user the request came from, for verifying authentication was successful when the client expected it.

  • string oauth_scope = 3

    OAuth scope.

• rpc StreamingOutputCall (StreamingOutputCallRequest, stream StreamingOutputCallResponse)

  test.proto:151

  One request followed by a sequence of responses (streamed download). The server returns the payload with client desired type and sizes.

• rpc StreamingInputCall (stream StreamingInputCallRequest, StreamingInputCallResponse)

  test.proto:156

  A sequence of requests followed by one response (streamed upload). The server returns the aggregated size of client payload as the result.

  message StreamingInputCallRequest

  test.proto:91

  Client-streaming request.

  • optional Payload payload = 1

    Optional input payload sent along with the request.

  message StreamingInputCallResponse

  test.proto:99

  Client-streaming response.

  • int32 aggregated_payload_size = 1

    Aggregated size of payloads received from the client.

• rpc FullDuplexCall (stream StreamingOutputCallRequest, stream StreamingOutputCallResponse)

  test.proto:162

  A sequence of requests with each request served by the server immediately. As one request could lead to multiple responses, this interface demonstrates the idea of full duplexing.

• rpc HalfDuplexCall (stream StreamingOutputCallRequest, stream StreamingOutputCallResponse)

  test.proto:169

  A sequence of requests followed by a sequence of responses. The server buffers all the client requests and then serves them in order. A stream of responses are returned to the client when the server starts with first request.

A simple service NOT implemented at servers so clients can test for that case.

• rpc UnimplementedCall (Empty, Empty)

  test.proto:177

  A call that no server should implement

A protobuf representation for grpc status. This is used by test clients to specify a status that the server should attempt to return.

Used in: SimpleRequest, StreamingOutputCallRequest

• int32 code = 1

• string message = 2

Used as request type in: TestService.EmptyCall, UnimplementedService.UnimplementedCall

Used as response type in: TestService.EmptyCall, UnimplementedService.UnimplementedCall

(message has no fields)

A block of data, to simply increase gRPC message size.

Used in: SimpleRequest, SimpleResponse, StreamingInputCallRequest, StreamingOutputCallRequest, StreamingOutputCallResponse

• PayloadType type = 1

  The type of data in body.

• bytes body = 2

  Primary contents of payload.

The type of payload that should be returned.

Used in: Payload, SimpleRequest, StreamingOutputCallRequest

• COMPRESSABLE = 0

  Compressable text format.

• UNCOMPRESSABLE = 1

  Uncompressable binary format.

• RANDOM = 2

  Randomly chosen from all other formats defined in this enum.

Configuration for a particular response.

Used in: StreamingOutputCallRequest

• int32 size = 1

  Desired payload sizes in responses from the server. If response_type is COMPRESSABLE, this denotes the size before compression.

• int32 interval_us = 2

  Desired interval between consecutive responses in the response stream in microseconds.

Server-streaming request.

Used as request type in: TestService.FullDuplexCall, TestService.HalfDuplexCall, TestService.StreamingOutputCall

• PayloadType response_type = 1

  Desired payload type in the response from the server. If response_type is RANDOM, the payload from each response in the stream might be of different types. This is to simulate a mixed type of payload stream.

• repeated ResponseParameters response_parameters = 2

  Configuration for each expected response message.

• optional Payload payload = 3

  Optional input payload sent along with the request.

• optional EchoStatus response_status = 7

  Whether server should return a given status

Server-streaming response, as configured by the request and parameters.

Used as response type in: TestService.FullDuplexCall, TestService.HalfDuplexCall, TestService.StreamingOutputCall

• optional Payload payload = 1

  Payload to increase response size.