# Swift gRPC Packages

This directory contains the Swift gRPC API and related components
in the form of buildable Swift packages.

Follow these steps to build and run them 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.1-release/ubuntu1604/swift-3.0.1-RELEASE/swift-3.0.1-RELEASE-ubuntu16.04.tar.gz
    tar xzf swift-3.0.1-RELEASE-ubuntu16.04.tar.gz
    ln -s swift-3.0.1-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
    git submodule update --init
    cd third_party/grpc
    git submodule update --init
    make
    make install

## Build the gRPC packages
    cd
    cd grpc-swift/Packages
    cd CgRPC; make; cd ..
    cd gRPC; make; cd ..
    cd Server; make; make install; cd ..
    cd Client; make; make install; cd ..

It may be necessary to run `make` multiple times in the Server and Client directories.
If you see an error like the following, please retry running `make`.

    root@4d5bef530019:~/grpc/src/swift/Packages/Client# make
    swift build
    Cloning /root/grpc/src/swift/Packages/gRPC
    /usr/bin/git clone --recursive --depth 10 /root/grpc/src/swift/Packages/gRPC /root/grpc/src/swift/Packages/Client/Packages/gRPC
    warning: --depth is ignored in local clones; use file:// instead.
    Cloning into '/root/grpc/src/swift/Packages/Client/Packages/gRPC'...
    done.
    No submodule mapping found in .gitmodules for path 'Packages/CgRPC-1.0.0'
    error: Git 2.0 or higher is required. Please update git and retry.
    make: *** [all] Error 1

## Run the test client and server from the grpc/src/swift/Packages directory:
    Server/Server &
    Client/Client