gRPC в python
- User
gRPC в python
- Assistant
gRPC (gRPC Remote Procedure Call) — это открытая технология для удаленных вызовов процедур (RPC), которая использует протокол бинарного кодирования protobuf для сериализации данных. В Python для работы с gRPC используется библиотека grpcio.
Для создания gRPC-сервера в Python необходимо выполнить следующие шаги:
- Определить сервис и сообщения - создайте файл *.proto и определите в нем сервисы и сообщения в формате protobuf.
- Сгенерировать код на Python - с помощью утилиты protoc, скачав и установив плагин grpcio, можно сгенерировать код на Python.
- Написать сервер на Python - создайте сервер gRPC, определив контроллеры и логику работы сервиса.
- Запустить сервер - запустите 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, передавая объект запроса, и выводим результаты.
- User
Откуда берется calculator_pb2_grpc ?
- 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).
- User
Приведи пример файла .proto
- 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 используется для определения удаленных процедур в сервисе.