No Description

Tim Burks 8170253611 Replace CountDownLatch with DispatchSemaphore in generated code. 8 years ago
Assets 8013cc8423 Remove unused gRPC.xcodeproj (replaced by the generated SwiftGRPC.xcodeproj) 9 years ago
Docker f317d11f7b Add Dockerfile for a customized Swift gRPC image. 9 years ago
Examples 8170253611 Replace CountDownLatch with DispatchSemaphore in generated code. 8 years ago
Plugin 8170253611 Replace CountDownLatch with DispatchSemaphore in generated code. 8 years ago
Sources fa3c8fb9c8 Structural changes to better support Package Manager builds. 8 years ago
SwiftGRPC.xcodeproj 141dec29ae Introduce new CountDownLatch class and simplify unit test. 9 years ago
Tests 44903ec7e3 Convert examples to use CountDownLatch, update version to 0.1.6 9 years ago
third_party ddd1ddb430 Reorganize examples, make dependency on swift-proto 0.9.24 explicit in third_party/RUNME.sh 9 years ago
.gitignore 6a1e661e29 Swift Echo sample 9 years ago
.gitmodules 63c6acfa40 Move CgRPC, gRPC, and QuickProto to "Sources" directory and add new top-level Package.swift. 9 years ago
.swift-version b7dcb9e04c Add Travis build and test configuration. 9 years ago
.travis-install.sh a7927827eb Add missing dependencies to travis configuration. 9 years ago
.travis.yml a7927827eb Add missing dependencies to travis configuration. 9 years ago
CONTRIBUTING.md 98a8b64da5 Update README and CONTRIBUTING. 9 years ago
DOCKER.md 7a8dbb0371 Update Docker instructions to download a pre-built protoc. 9 years ago
LICENSE d983798ec5 Fix license date (thomasvl@) 9 years ago
LINUX.md cd67135c18 Fixed plugin for use on Linux. 9 years ago
Makefile d5591ca187 Makefile improvements. 8 years ago
OVERVIEW.md b0edcaedfa Add details to OVERVIEW document. 9 years ago
PATENTS 36f2bde28e Add PATENTS declaration 9 years ago
Package.swift 20e0cf1bb2 Reorganize vendored gRPC core code, moving it into CgRPC. 9 years ago
README.md cad400eb08 Add Docker instructions and update README. 9 years ago
SwiftGRPC-incomplete.podspec 82b3a928d5 Rename podspec to clarify its status. 9 years ago
vendor-boringssl.sh 220cc3fe29 Update vendoring scripts and build configuration for examples for new vendored gRPC Core. 9 years ago
vendor-grpc.sh 220cc3fe29 Update vendoring scripts and build configuration for examples for new vendored gRPC Core. 9 years ago

README.md

Build Status

Swift gRPC

This repository contains an experimental Swift gRPC API and code generator.

It is intended for use with Apple's swift-protobuf support for Protocol Buffers. Both projects contain code generation plugins for protoc, Google's Protocol Buffer compiler, and both contain libraries of supporting code that is needed to build and run the generated code.

APIs and generated code is provided for both gRPC clients and servers, and can be built either with Xcode or the Swift Package Manager. Support is provided for all four gRPC API styles (Unary, Server Streaming, Client Streaming, and Bidirectional Streaming) and connections can be made either over secure (TLS) or insecure channels.

The Echo example provides a comprehensive demonstration of currently-supported features.

Swift Package Manager builds may also be made on Linux systems. Please see DOCKER.md and LINUX.md for details.

gRPC dependencies are vendored

Swift gRPC now includes vendored copies of the gRPC core library and "BoringSSL", an OpenSSL fork that is used by the gRPC Core. These are built automatically in Swift Package Manager builds. The repository also includes SwiftGRPC.xcodeproj, an Xcode project which is automatically-generated by the Swift Package Manager.

Having build problems?

grpc-swift depends on Swift, Xcode, and swift-proto. We are currently testing with the following versions:

  • Xcode 8.2
  • Swift 3.0.2
  • swift-proto 0.9.24

License

grpc-swift is released under the same license as gRPC, repeated in LICENSE.

Contributing

Please get involved! See our guidelines for contributing.