Add content handlers and built-in SSE support

Content handlers are a chain of modules implementing callbacks
that receive the body of responses and may modify it (for example
for decompressing the content) or act upon it (like sending a
message to the owner process.

The gun_sse content handler module can be used to translate
text/event-stream events on the fly and deliver them to the
owner process as a {gun_sse...} message.

This feature is currently not documented and is only tested
against a public server. It requires an up to date Cowlib.

1 files changed, 33 insertions, 0 deletions

diff --git a/src/gun_data.erl b/src/gun_data.erl
new file mode 100644
index 0000000..e70c25e
--- /dev/null
+++ b/src/gun_data.erl
@@ -0,0 +1,33 @@
+%% Copyright (c) 2017, Loïc Hoguin <[email protected]>
+%%
+%% Permission to use, copy, modify, and/or distribute this software for any
+%% purpose with or without fee is hereby granted, provided that the above
+%% copyright notice and this permission notice appear in all copies.
+%%
+%% THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+%% WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+%% MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+%% ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+%% WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+%% ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+%% OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
+-module(gun_data).
+-behavior(gun_content_handler).
+
+-export([init/5]).
+-export([handle/3]).
+
+-record(state, {
+	reply_to :: pid(),
+	stream_ref :: reference()
+}).
+
+-spec init(pid(), reference(), _, _, _) -> {ok, #state{}}.
+init(ReplyTo, StreamRef, _, _, _) ->
+	{ok, #state{reply_to=ReplyTo, stream_ref=StreamRef}}.
+
+-spec handle(fin | nofin, binary(), State) -> {done, State} when State::#state{}.
+handle(IsFin, Data, State=#state{reply_to=ReplyTo, stream_ref=StreamRef}) ->
+	ReplyTo ! {gun_data, self(), StreamRef, IsFin, Data},
+	{done, State}.