HelloZewo

Server Side Swift example using Zewo components

What's this?

This is an example of an web app using Zewo components and standard server-side tools like Docker I wrote this as an example to expose in a meetup here. These are the slies for the event.

This example is a TODO manager. It allows listing, adding and removing TODOs form a list. Each TODO consists of a "title" given by the user and an "id" that comes form the app.

All the logic is server-side, there is no JavaScript involved. There is one page for each action (list, remove, add) and each page has a corresponding mustache template in the /Templates directory. All requests are fired from the page using plain old <form/> tags with the corresponding method attribute set.

Setup

Install Swiftenv

swiftenv is a version manager for Swift.

In OSX using homebrew

$ brew install kylef/formulae/swiftenv

Setup your shell

$ echo 'if which swiftenv > /dev/null; then eval "$(swiftenv init -)"; fi' >> ~/.bash_profile

Change ~/.bash_profile for ~/.zshrc for ZSH

Install PostgreSQL drivers

This project uses the PostgreSQL Zewo package. For it to work we need to install the native Postgres drivers. We can do it with homebrew like this:

$ brew install postgresql

Install Docker

This project uses docker to run the databse server. Follow the installation steps for OSX here.

To check that you have a working docker installation you can run docker run hello-world. If that doesn't fail you are ready to continue. Once you have a working docker installation we need to get a Postgres image from DockerHub. This means we have to run:

$ docker pull postgres

This will download and setup a docker image for us. To start your local Postgres database inside Docker you can try:

$ docker run --name PSQL -p 5432:5432 posgres -d
$ psql -h PSQL -p 5432 -U postgres

The first line starts the Postgres server in docker and the second runs the native client psql from your machine and connects to the docker container. You can do many other things, see the docs here.

Clone this repo

Go to a safe place to store this nice example project and run:

$ git clone https://github.com/swift-montevideo/HelloZewo.git

Once it finishes, cd into it and run:

swiftenv install DEVELOPMENT-SNAPSHOT-2016-04-12-a

This will download the Swift beta form Swift.org. This repo is configured (via .swift-version) to use that snapshot. When the installation finishes check the correct version of swift is set:

$ swiftenv version
DEVELOPMENT-SNAPSHOT-2016-04-12-a (set by [path where you clone the repo]/.swift-version)

Build

Once you have the project setup the only thing you have to do is tell SPM to build this package. To do so we use:

$ swift build -Xcc -I/usr/local/include -Xlinker -L/usr/local/lib/

This build the package including the headers and library for Postgres

Run

To run this we first have to start the Postgres container. If you don't start the container before then you need to do it now:

$ docker run --name PSQL -p 5432:5432 posgres -d

Once the database server is running, start this awesome app with:

$ sudo .build/debug/hello

The sudo is needed because it's listen for incoming connections in a port under 1024 (80). As a homework, try to use another port :)

By happy.