Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/nathanborror/example-pages

📓 An example project using gRPC, Protocol Buffers, Swift and Go
https://github.com/nathanborror/example-pages

grpc http2 protobuf swift

Last synced: 3 months ago
JSON representation

📓 An example project using gRPC, Protocol Buffers, Swift and Go

Host: GitHub
URL: https://github.com/nathanborror/example-pages
Owner: nathanborror
Created: 2016-10-19T16:57:17.000Z (over 8 years ago)
Default Branch: master
Last Pushed: 2016-10-24T19:26:09.000Z (over 8 years ago)
Last Synced: 2023-04-13T13:26:05.945Z (almost 2 years ago)
Topics: grpc, http2, protobuf, swift
Language: Swift
Homepage:
Size: 433 KB
Stars: 10
Watchers: 3
Forks: 1
Open Issues: 0
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

README

        # Pages

An example of building a server/client relationship using [gRPC][1] and [protocol

buffers][2]. In this example the server is written in Go along with a very simple

command line client. The web client is written in [Elm][3] which uses the [gRPC

Gateway][4] interface. And finally the native client is written in Swift using

the new [swift-protobuf][5] library.

## Todos

- [x] Protobuf Server

- [x] JSON reverse-proxy

- [x] In-memory state

- [x] Persistent state

- [x] iOS client

- [x] Web client

- [ ] Command-line client

## Requirements

- Go 1.7

- Swift 3 / Xcode 8

- openssl

- At times you may need switch over to MASTER for github.com/apple/swift-protobuf

## Installation

    $ ./setup.sh

    $ make

### Run server & reverse-proxy

    $ cd server && go run main.go

Run with persistent sqlite backend:

    $ cd server && SERVER_STATE=sqlite go run main.go

### Run iOS client

    $ open clients/ios/Pages/Pages.xcodeproj

    Product > Run (⌘R)

### Run web client

    $ open clients/web/index.html

### Run command line client

    $ cd clients/cmd

    $ go run main.go

[1]:http://www.grpc.io

[2]:https://developers.google.com/protocol-buffers/

[3]:http://elm-lang.org

[4]:https://github.com/grpc-ecosystem/grpc-gateway

[5]:https://github.com/apple/swift-protobuf