Skip to content
TheChatArchiveThe Chat Archive
gpt-3.5-turbo-0301· openaiHugging Face Suzhen/CodeChat

gRPC в python

  1. User

    gRPC в python

  2. Assistant

    gRPC (gRPC Remote Procedure Call) — это открытая технология для удаленных вызовов процедур (RPC), которая использует протокол бинарного кодирования protobuf для сериализации данных. В Python для работы с gRPC используется библиотека grpcio.

    Для создания gRPC-сервера в Python необходимо выполнить следующие шаги:

    1. Определить сервис и сообщения - создайте файл *.proto и определите в нем сервисы и сообщения в формате protobuf.
    2. Сгенерировать код на Python - с помощью утилиты protoc, скачав и установив плагин grpcio, можно сгенерировать код на Python.
    3. Написать сервер на Python - создайте сервер gRPC, определив контроллеры и логику работы сервиса.
    4. Запустить сервер - запустите gRPC-сервер и обработайте запросы.

    Пример сервера:

    import grpc
    import calculator_pb2
    import calculator_pb2_grpc
    
    class Calculator(calculator_pb2_grpc.CalculatorServicer):
        def Add(self, request, context):
            return calculator_pb2.Result(value=request.num1 + request.num2)
    
        def Subtract(self, request, context):
            return calculator_pb2.Result(value=request.num1 - request.num2)
    
    def serve():
        server = grpc.server(futures.ThreadPoolExecutor(max_workers=10))
        calculator_pb2_grpc.add_CalculatorServicer_to_server(Calculator(), server)
        server.add_insecure_port('[::]:50051')
        server.start()
        server.wait_for_termination()
    
    if __name__ == '__main__':
        serve()
    

    Здесь мы определяем класс Calculator, который реализует методы сервиса Add и Subtract. Методы принимают объект запроса, обрабатывают его и возвращают объект ответа.

    Метод serve запускает gRPC-сервер на порту 50051.

    Пример клиента:

    import grpc
    import calculator_pb2
    import calculator_pb2_grpc
    
    def run():
        with grpc.insecure_channel('localhost:50051') as channel:
            stub = calculator_pb2_grpc.CalculatorStub(channel)
            response = stub.Add(calculator_pb2.Request(num1=10, num2=20))
            print("Add: ", response.value)
            response = stub.Subtract(calculator_pb2.Request(num1=10, num2=20))
            print("Subtract: ", response.value)
    
    if __name__ == '__main__':
        run()
    

    Здесь мы создаем канал связи с сервером и получаем stub для вызова методов сервиса. Мы вызываем методы Add и Subtract, передавая объект запроса, и выводим результаты.

  3. User

    Откуда берется calculator_pb2_grpc ?

  4. Assistant

    calculator_pb2_grpc - это модуль, который был сгенерирован из файла *.proto с помощью утилиты protoc и плагина grpcio для генерации кода на Python.

    Когда вы определяете сервис и сообщения в файле *.proto, вы можете использовать утилиту protoc для сгенерирования кода на Python. Для включения поддержки gRPC в сгенерированный код необходимо использовать плагин grpcio. После генерации вы получите два модуля: модуль с сообщениями (например, calculator_pb2.py) и модуль с классом-сервисом и клиентами-стабами (например, calculator_pb2_grpc.py).

    Модуль calculator_pb2_grpc содержит класс-сервис (например, CalculatorServicer) и клиентские стабы (например, CalculatorStub), которые используются для вызова методов сервиса на удаленном gRPC-сервере.

    Обычно код, сгенерированный protoc, размещают в отдельной директории (например, proto) и импортируют его в основной код приложения (например, import proto.calculator_pb2_grpc).

  5. User

    Приведи пример файла .proto

  6. Assistant

    Вот пример простого файла *.proto, который определяет сервис калькулятора, который поддерживает операции сложения и вычитания. Обратите внимание, что файл *.proto должен содержать определения сообщений и сервисов.

    // Определяем сообщение для запроса (Request).
    message Request {
      int32 num1 = 1;
      int32 num2 = 2;
    }
    
    // Определяем сообщение для ответа (Result).
    message Result {
      int32 value = 1;
    }
    
    // Определяем сервис калькулятора.
    service Calculator {
      // Определяем метод Add для сложения двух чисел.
      rpc Add (Request) returns (Result) {}
    
      // Определяем метод Subtract для вычитания двух чисел.
      rpc Subtract (Request) returns (Result) {}
    }
    

    В этом примере мы определяем два сообщения: Request и Result, которые содержат поля num1 и num2, и value соответственно. Затем мы определяем сервис Calculator и два его метода - Add и Subtract. Оба метода принимают объект типа Request и возвращают объект типа Result. Ключевое слово rpc используется для определения удаленных процедур в сервисе.