# Swift gRPC Samples

Follow these steps to build and run Swift gRPC on Linux.

## Prerequisites

These instructions are for running in the Docker container manager,
but can be directly used on any Ubuntu 16.04 image.

## Start Docker

Start a docker instance with the following command:

`docker run -i -t --privileged=true ubuntu:16.04 /bin/bash`

## Install Dependencies

    # update package list
    apt-get update
    # install download tools
    apt-get install -y git wget
    # install a few useful utilities
    apt-get install -y vim sudo
    # install grpc build dependencies
    apt-get install -y build-essential autoconf libtool
    # install swift dependencies
    apt-get install -y clang libicu-dev libedit-dev python-dev libxml2-dev
    # install networking dependencies
    apt-get install -y libcurl4-openssl-dev

## Install Swift

    # go to /root
    cd
    # download and unpack swift
    wget https://swift.org/builds/swift-3.0.2-release/ubuntu1604/swift-3.0.2-RELEASE/swift-3.0.2-RELEASE-ubuntu16.04.tar.gz
    tar xzf swift-3.0.2-RELEASE-ubuntu16.04.tar.gz
    ln -s swift-3.0.2-RELEASE-ubuntu16.04 swift

## Add Swift to your path
    # add swift to your path by adding this to your .bashrc
    export PATH=/root/swift/usr/bin:$PATH

    # Then run this to update your path
    source ~/.bashrc

## Configure git

    git config --global user.email <your email address>
    git config --global user.name "<your name>"

## Fetch and build grpc
    git clone https://github.com/grpc/grpc-swift
    cd grpc-swift
    cd third_party
    sh RUNME.sh
    cd grpc
    git submodule update --init
    make
    make install

## Build the Echo sample
    cd
    cd grpc-swift/Examples/Echo/Swift/SwiftPM
    make

## Run the test client and server 
    # start the server
    .build/debug/Echo serve &
    # run the client to test each Echo API
    .build/debug/Echo get
    .build/debug/Echo expand
    .build/debug/Echo collect
    .build/debug/Echo update
	

## To test the plugin
    # build and install protoc
    cd
    cd grpc-swift/third_party/grpc/third_party/protobuf 
    make install
    # build and test the plugin
    cd
    cd grpc-swift/Plugin
    make test