appengine/monorail/api/api_service.py

# Copyright 2016 The Chromium Authors. All rights reserved.
# Use of this source code is govered by a BSD-style
# license that can be found in the LICENSE file or at
# https://developers.google.com/open-source/licenses/bsd

# This file implements a pRPC API for Monorail.
#
# See the pRPC spec here: https://godoc.org/github.com/luci/luci-go/grpc/prpc
#
# Each Servicer corresponds to a service defined in a .proto file in this
# directory. Each method on that Servicer corresponds to one of the rpcs
# defined on the service.
#
# All APIs are served under the /prpc/* path space. Each service gets its own
# namespace under that, and each method is an individual endpoints. For example,
#   POST https://bugs.chromium.org/prpc/monorail.Users/GetUser
# would be a call to the UsersServicer.GetUser method.
#
# Note that this is not a RESTful API, although it is CRUDy. All requests are
# POSTs, all methods take exactly one input, and all methods return exactly
# one output.
#
# TODO(agable): Actually integrate the rpcexplorer.
# You can use the API Explorer here: https://bugs.chromium.org/rpcexplorer


from api import features_servicer
from api import issues_servicer
from api import projects_servicer
from api import users_servicer
from components import prpc


def RegisterApiHandlers(registry, services):
  server = prpc.Server()
  server.add_service(features_servicer.FeaturesServicer(services))
  server.add_service(issues_servicer.IssuesServicer(services))
  server.add_service(projects_servicer.ProjectsServicer(services))
  server.add_service(users_servicer.UsersServicer(services))
  registry.routes.extend(server.get_routes())