Add a Chunked Hello World example

examples/chunked_hello_world/README.md

@@ -0,0 +1,16 @@
+Cowboy Hello World
+==================
+
+To compile this example you need rebar in your PATH.
+
+Type the following command:
+```
+$ rebar get-deps compile
+```
+
+You can then start the Erlang node with the following command:
+```
+./start.sh
+```
+
+Then run the given command or point your browser to the indicated URL.

examples/chunked_hello_world/rebar.config

@@ -0,0 +1,4 @@
+{deps, [
+	{cowboy, ".*",
+		{git, "git://github.com/extend/cowboy.git", "master"}}
+]}.

examples/chunked_hello_world/src/chunked_hello_world.app.src

@@ -0,0 +1,15 @@
+%% Feel free to use, reuse and abuse the code in this file.
+
+{application, chunked_hello_world, [
+	{description, "Cowboy Chunked Hello World example."},
+	{vsn, "1"},
+	{modules, []},
+	{registered, []},
+	{applications, [
+		kernel,
+		stdlib,
+		cowboy
+	]},
+	{mod, {chunked_hello_world_app, []}},
+	{env, []}
+]}.

examples/chunked_hello_world/src/chunked_hello_world.erl

@@ -0,0 +1,12 @@
+%% Feel free to use, reuse and abuse the code in this file.
+
+-module(chunked_hello_world).
+
+%% API.
+-export([start/0]).
+
+%% API.
+
+start() ->
+	ok = application:start(cowboy),
+	ok = application:start(chunked_hello_world).

examples/chunked_hello_world/src/chunked_hello_world_app.erl

@@ -0,0 +1,26 @@
+%% Feel free to use, reuse and abuse the code in this file.
+
+%% @private
+-module(chunked_hello_world_app).
+-behaviour(application).
+
+%% API.
+-export([start/2]).
+-export([stop/1]).
+
+%% API.
+
+start(_Type, _Args) ->
+	Dispatch = [
+		{'_', [
+			{[], toppage_handler, []}
+		]}
+	],
+	{ok, _} = cowboy:start_listener(http, 100,
+		cowboy_tcp_transport, [{port, 8080}],
+		cowboy_http_protocol, [{dispatch, Dispatch}]
+	),
+	chunked_hello_world_sup:start_link().
+
+stop(_State) ->
+	ok.

examples/chunked_hello_world/src/chunked_hello_world_sup.erl

@@ -0,0 +1,23 @@
+%% Feel free to use, reuse and abuse the code in this file.
+
+%% @private
+-module(chunked_hello_world_sup).
+-behaviour(supervisor).
+
+%% API.
+-export([start_link/0]).
+
+%% supervisor.
+-export([init/1]).
+
+%% API.
+
+-spec start_link() -> {ok, pid()}.
+start_link() ->
+	supervisor:start_link({local, ?MODULE}, ?MODULE, []).
+
+%% supervisor.
+
+init([]) ->
+	Procs = [],
+	{ok, {{one_for_one, 10, 10}, Procs}}.

examples/chunked_hello_world/src/toppage_handler.erl

@@ -0,0 +1,23 @@
+%% Feel free to use, reuse and abuse the code in this file.
+
+%% @doc Chunked hello world handler.
+-module(toppage_handler).
+
+-export([init/3]).
+-export([handle/2]).
+-export([terminate/2]).
+
+init(_Transport, Req, []) ->
+	{ok, Req, undefined}.
+
+handle(Req, State) ->
+	{ok, Req2} = cowboy_http_req:chunked_reply(200, Req),
+	ok = cowboy_http_req:chunk("Hello\r\n", Req2),
+	ok = timer:sleep(1000),
+	ok = cowboy_http_req:chunk("World\r\n", Req2),
+	ok = timer:sleep(1000),
+	ok = cowboy_http_req:chunk("Chunked!\r\n", Req2),
+	{ok, Req2, State}.
+
+terminate(_Req, _State) ->
+	ok.

examples/chunked_hello_world/start.sh

@@ -0,0 +1,3 @@
+#!/bin/sh
+erl -pa ebin deps/*/ebin -s chunked_hello_world \
+	-eval "io:format(\"Run: curl -i http://localhost:8080~n\")."