Swiftpack.co - cats-oss/grpc-swift-client as Swift Package

Swiftpack.co is a collection of thousands of indexed Swift packages. Search packages.
See all packages published by cats-oss.
cats-oss/grpc-swift-client 1.0.0-alpha.8
:repeat: Client-side library that depends on SwiftGRPC which is a library of gRPC written in Swift.
⭐️ 49
🕓 10 weeks ago
iOS macOS watchOS tvOS
.package(url: "https://github.com/cats-oss/grpc-swift-client.git", from: "1.0.0-alpha.8")

Swift gRPC Client

Version License Platform

Client-side library that depends on SwiftGRPC which is a library of gRPC written in Swift. Basically it is used the function of Core part of SwiftGRPC, but it is made to make client implementation easier.

:warning: WARNING : If there is the breaking change in SwiftGRPC, this library may not be updatable.

The following two modules are included.


It is a plugin to use when running at runtime. Link to the application or framework.


It is a Protocol Buffer's plugin for creating the functions necessary to use SwiftGRPCClient. Use protoc to generate .swift from .proto.


If you use SwiftGRPC, you can do Unary connection using generated protocol or struct as follows.

let service = Echo_EchoServiceClient(address: "YOUR_SERVER_ADDRESS")
var requestMessage = Echo_EchoRequest()
requestMessage.text = "message"
_ = try? service.get(requestMessage) { responseMessage, callResult in

The get method above can get a message by sending arbitrary message, but with this method you can not get the information of the logged-in user. For example, if you want to get user information, you will need to prepare the following methods.

var requestUser = Example_UserRequest()
requestUser.id = "user_id"
_ = try? service.getUser(requestUser) { responseUser, callResult in

In this way, when connecting using a certain request, a special method is required to execute the request.

With SwiftGRPCClient, data is the only method to make a Unary request.

let session = Session(address: "YOUR_SERVER_ADDRESS")
session.stream(with: EchoUnaryRequest(text: "message"))
    .data { result in

It is possible to get the user's login information just by changing the request.

session.stream(with: GetUserRequest(id: "user_id"))
    .data { result in

See also SwiftGRPCClient document.


  • Swift 5.0
  • SwiftGRPC 0.9.1

How to Install


Add the following to your Podfile:

pod 'SwiftGRPCClient'


protoc-gen-swiftgrpc-client is a plugin for Protocol Buffers. It automatically defines requests, responses and methods used when connecting using SwiftGRPCClient.

See also protoc-gen-swiftgrpc-client document.


  • Swift 5.0
  • SwiftProtobuf 1.5.0

How to get plugin

Execute the following command.

$ make gen

Explain generated code

As an example, prepare the following .proto.

syntax = "proto3";

package echo;

service Echo {
    rpc Get(EchoRequest) returns (EchoResponse) {}

message EchoRequest {
    string text = 1;

message EchoResponse {
    string text = 1;

protoc creates .swift file.

// MARK: - Echo Request Method
enum Echo_EchoMethod: String, CallMethod {
    case get = "Get"

    static let service = "echo.Echo"

// MARK: - Echo_Echo Get Request
protocol _Echo_EchoGetRequest {
    typealias InputType = Echo_EchoRequest
    typealias OutputType = Echo_EchoResponse

protocol Echo_EchoGetRequest: _Echo_EchoGetRequest, UnaryRequest {}

extension Echo_EchoGetRequest {
    var method: CallMethod {
        return Echo_EchoMethod.get

Define the Request object using protocol in the generated .swift.

struct EchoGetRequest: Echo_EchoGetRequest {
    var request = Echo_EchoRequest()

    init(text: String) {
        request.text = text


Under the MIT license. See LICENSE file for details.


Stars: 49
Last commit: 10 weeks ago
Advertisement: IndiePitcher.com - Cold Email Software for Startups

Swiftpack is being maintained by Petr Pavlik | @ptrpavlik | @swiftpackco | API | Analytics