This directory holds all the source for the Monorail API v2. This API is implemented using .proto files to describe a gRPC interface (services, methods, and request/response messages). It then uses a shim which converts the gRPC server (which doesn't work on AppEngine, due to lack of support for HTTP/2) into a pRPC server which supports communication over HTTP/1.1, as well as text and JSON IO.
In order to regenerate the python server and client stubs from the .proto files, follow these steps:
$ PATH=../../../luci/appengine/components/tools:$PATH ../../../cipd/protoc \ --python_out=. --prpc-python_out=. api_proto/*.proto
You can make anonymous requests to a server running locally like this:
$ curl -i -X POST localhost:8080/prpc/monorail.Users/GetUser \ -H "Content-Type: application/json" -H "Accept: application/json" \ --data '{"email": "test@example.com"}'