capricorn 2.0.8 → 2.0.9

data/erlang/lib/misultin/LICENSE.txt

@@ -0,0 +1,41 @@
+==========================================================================================================
+MISULTIN - An Erlang library for building fast lightweight HTTP servers.
+<http://code.google.com/p/misultin/>
+
+>-|-|-(°>
+
+Copyright (C) 2010, Roberto Ostinelli <roberto@ostinelli.net>, Joe Armstrong, Sean Hinde,
+                    Bob Ippolito <bob@mochimedia.com> for Mochi Media, Inc.
+
+All rights reserved.
+
+Code portions from Joe Armstrong have been originally taken under MIT license at the address:
+<http://armstrongonsoftware.blogspot.com/2009/12/comet-is-dead-long-live-websockets.html>
+
+Code portions from Sean Hinde have been originally taken under BSD license from Trapexit at the address:
+<http://www.trapexit.org/A_fast_web_server_demonstrating_some_undocumented_Erlang_features>
+
+Code portions from Bob Ippolito have been originally taken under MIT license from MOCHIWEB:
+<http://code.google.com/p/mochiweb/>
+==========================================================================================================
+
+BSD License
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided
+that the following conditions are met:
+
+ * Redistributions of source code must retain the above copyright notice, this list of conditions and the
+   following disclaimer.
+ * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and
+   the following disclaimer in the documentation and/or other materials provided with the distribution.
+ * Neither the name of the authors nor the names of its contributors may be used to endorse or promote
+   products derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED
+WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
+TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.

data/erlang/lib/misultin/Makefile

@@ -0,0 +1,26 @@
+EBIN_DIR := ebin
+SRC_DIR := src
+EXAMPLES_DIR := examples
+INCLUDE_DIR := include
+ERLC := erlc
+ERLC_FLAGS := -W -I $(INCLUDE_DIR) -o $(EBIN_DIR)
+
+all:
+	@mkdir -p $(EBIN_DIR)
+	$(ERLC) $(ERLC_FLAGS) $(SRC_DIR)/*.erl
+	@cp $(SRC_DIR)/misultin.app.src $(EBIN_DIR)/misultin.app
+	
+clean:
+	@rm -rf $(EBIN_DIR)/*
+	@rm -f erl_crash.dump
+	
+debug:
+	@mkdir -p $(EBIN_DIR)
+	$(ERLC) -D log_debug $(ERLC_FLAGS) $(SRC_DIR)/*.erl
+	@cp $(SRC_DIR)/misultin.app.src $(EBIN_DIR)/misultin.app
+
+example:
+	@mkdir -p $(EBIN_DIR)
+	$(ERLC) $(ERLC_FLAGS) $(SRC_DIR)/*.erl
+	@cp $(SRC_DIR)/misultin.app.src $(EBIN_DIR)/misultin.app
+	$(ERLC) $(ERLC_FLAGS) $(EXAMPLES_DIR)/*.erl

data/erlang/lib/misultin/README.txt

@@ -0,0 +1,120 @@
+==========================================================================================================
+MISULTIN - An Erlang library for building fast lightweight HTTP servers.
+<http://code.google.com/p/misultin/>
+
+>-|-|-(°>
+
+
+INSTALL INSTRUCTIONS
+==========================================================================================================
+
+1. Compile
+
+Run the appropriate script:
+
+    * OSX | Linux users:  make
+    * Windows users: make.bat. Note that Erlang bin directory (by default, C:\Program Files\erl5.7.2\bin\) must be in your path for the script to work.
+
+This script will compile the .erl files in the Misultin src directory and save the compiled files into the ebin directory.
+
+2. (Optional) Copy Misultin files
+
+This optional step will allow Misultin to be called from modules running from any directory on your file system.
+
+Locate the directory where Erlang is installed on your system. Under OSX and Linux, it should be something similar to /usr/local/lib/erlang/ or /usr/lib/erlang/. Under Windows, Erlang is installed by default in something similar to C:\Program Files\erl5.7.2\ (version changes may apply).
+
+Browse into the lib directory under this Erlang root and copy the root misultin-0.x directory into this directory. You should now have Misultin under something similar to:
+
+    * OSX | Linux users: /usr/local/lib/erlang/lib/misultin-0.x/
+    * Windows users: C:\Program Files\erl5.7.2\lib\misultin-0.x\ 
+
+3. Test
+
+If you did proceed with step 2, CD to the Misultin examples directory and start an Erlang shell.
+
+If you did not proceed with step 2, copy the file misultin_hello_world.erl from the Misultin examples directory to the directory where the .beam files compiled in step 1 are located, then CD to this directory and start an Erlang shell.
+
+In the shell, compile and run misultin_hello_world by issuing:
+
+(one@rob.loc)1>c(misultin_hello_world).
+{ok,misultin_hello_world}
+(one@rob.loc)2>misultin_hello_world:start(8080).
+{ok,<0.50.0>}
+
+Open your favourite browser and point it to http://localhost:8080/, you should read "Hello World." printed on your page.
+
+You may now stop the misultin_hello_world HTTP server:
+
+(one@rob.loc)3>misultin_hello_world:stop().
+
+4. Congratulations!
+
+You're ready to go.
+
+>-|-|-(°>
+
+
+DOCUMENTATION
+==========================================================================================================
+
+API Documentation is available online on the Misultin's wiki: http://code.google.com/p/misultin/wiki/
+
+
+CHANGELOG
+==========================================================================================================
+
+0.6.1: - added support to websocket protocol hixie draft 76 [thanks to sergio veiga]
+       - added support to multiple websocket draft protocols [for backwards compatibility]
+       - added ws_autoexit option which allows to get an event on websocket controlling processes [issue track #15, suggestion of esente]
+       - added headers also in misultin websockets [thanks to jlirochon]
+       - made it basho's rebar friendly [thanks to mrinalwadhwa]
+
+0.6:   - added HTTP compression option
+       - refactoring of the main server loop, so that it is now isolated from the HTTP functionality
+       - removed unnecessary compilation warnings
+       - replaced proplists:get_value with much faster utility function
+
+0.5:   - added SSL support
+       - refactoring of the acceptor loop
+
+0.4:   - added preliminary websocket support
+
+0.3.4: - added Req support to return the socket handling the request
+       - bug correction on Content-Length: 0 header causing timeout on POST requests [issue track #12,
+         thanks to gdamjan]
+
+0.3.3: - added echoing of the Connection header [issue track #7, thanks to thijsterlouw]
+       - bug correction on acceptor respawning [issue track #10, thanks to thijsterlouw]
+
+0.3.2: - optimized error handling [issue track #5, thanks to Max Lapshin]
+
+0.3.1: - added flow control using inet options {active, once} [issue track #4, thanks to Max Lapshin]
+       - added support to standard http headers response
+       - added http 400 bad request error in socket handling
+       - bug correction: removed erroneous sending of response timeout on listening open connections
+       - added stream_support optimization option
+
+0.3:   - reengineering of the listener process, using active instead of passive mode in request parsing,
+         except for BODY where passive is still used [thanks to Lev Walkin]
+       - added better support for request timeout
+
+0.2.2: - added .app file [thanks to Essien Ita Essien]
+       - simplified get_options [thanks to Essien Ita Essien]
+       - added ip address option [thanks to Essien Ita Essien]
+       - added ipv6 support
+       - added recv_timeout option
+       - bug correction: requests peer address and port are now not reset on open connections multiple
+         requests
+
+0.2.1: - added support for Content-Type that specifies charset in POST data [thanks to Tuncer Ayaz]
+       - added support for iolist in misultin_req:ok/1,2 and misultin_req:respond/2,3
+       - code optimized taking out unnecessary binary conversion and lists:flatten [thanks to Feng Yu]
+
+0.2:   - added trap exit for acceptor failure
+       - added backlog option
+       - added fallback if no connection header is present [issue track #1, thanks to Ciconia]
+       - added limit for parsing headers to avoid malicious attacks [thanks to Mazen Harake]
+       - minor bug corrections
+
+0.1:   - initial release.
+

data/erlang/lib/misultin/ebin/misultin.app

@@ -0,0 +1,9 @@
+{application, misultin,
+[
+	{description, "Lightweight HTTP(s) and Websockets Server Library"},
+	{vsn, "0.6.1"},
+	{modules, [misultin, misultin_req, misultin_socket, misultin_http, misultin_utility, misultin_websocket, misultin_ws]},
+	{registered, [misultin]},
+	{env, []},
+	{applications, [kernel, stdlib]}
+]}.

data/erlang/lib/misultin/examples/misultin_compress.erl

@@ -0,0 +1,43 @@
+% ==========================================================================================================
+% MISULTIN - Example: Hello World Compressed.
+%
+% >-|-|-(°>
+% 
+% Copyright (C) 2009, Roberto Ostinelli <roberto@ostinelli.net>
+% All rights reserved.
+%
+% BSD License
+% 
+% Redistribution and use in source and binary forms, with or without modification, are permitted provided
+% that the following conditions are met:
+%
+%  * Redistributions of source code must retain the above copyright notice, this list of conditions and the
+%    following disclaimer.
+%  * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and
+%    the following disclaimer in the documentation and/or other materials provided with the distribution.
+%  * Neither the name of the authors nor the names of its contributors may be used to endorse or promote
+%    products derived from this software without specific prior written permission.
+%
+% THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED
+% WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+% PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
+% ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
+% TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+% HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+% NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+% POSSIBILITY OF SUCH DAMAGE.
+% ==========================================================================================================
+-module(misultin_compress).
+-export([start/1, stop/0]).
+
+% start misultin http server
+start(Port) ->
+	misultin:start_link([{port, Port}, {compress, true}, {loop, fun(Req) -> handle_http(Req) end}]).
+
+% stop misultin
+stop() ->
+	misultin:stop().
+
+% callback on request received
+handle_http(Req) ->	
+	Req:ok("Hello World Compressed.").

data/erlang/lib/misultin/examples/misultin_echo.erl

@@ -0,0 +1,58 @@
+% ==========================================================================================================
+% MISULTIN - Example: Echoes inputted GET variables into an XML.
+%
+% >-|-|-(°>
+% 
+% Copyright (C) 2009, Roberto Ostinelli <roberto@ostinelli.net>
+% All rights reserved.
+%
+% BSD License
+% 
+% Redistribution and use in source and binary forms, with or without modification, are permitted provided
+% that the following conditions are met:
+%
+%  * Redistributions of source code must retain the above copyright notice, this list of conditions and the
+%    following disclaimer.
+%  * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and
+%    the following disclaimer in the documentation and/or other materials provided with the distribution.
+%  * Neither the name of the authors nor the names of its contributors may be used to endorse or promote
+%    products derived from this software without specific prior written permission.
+%
+% THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED
+% WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+% PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
+% ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
+% TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+% HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+% NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+% POSSIBILITY OF SUCH DAMAGE.
+% ==========================================================================================================
+-module(misultin_echo).
+-export([start/1, stop/0]).
+
+% start misultin http server
+start(Port) ->
+	misultin:start_link([{port, Port}, {loop, fun(Req) -> handle_http(Req) end}]).
+
+% stop misultin
+stop() ->
+	misultin:stop().
+
+% callback on request received
+handle_http(Req) ->	
+	% get params depending on method
+	Method = Req:get(method),
+	case Method of
+		'GET' ->
+			Args = Req:parse_qs();
+		'POST' ->
+			Args = Req:parse_post()
+	end,
+	% build an XML with all parameters and values
+	BuildXml = fun({Param, Value}, Acc) ->
+		[lists:flatten(io_lib:format("<param><name>~s</name><value>~s</value></param>", [Param, Value]))|Acc]
+	end,
+	Xml = lists:flatten(lists:reverse(lists:foldl(BuildXml, [], Args))),
+	% output
+	Req:ok([{"Content-Type", "text/xml"}], "<misultin_test><method>~s</method>~s</misultin_test>", [Method, Xml]).
+

data/erlang/lib/misultin/examples/misultin_file.erl

@@ -0,0 +1,43 @@
+% ==========================================================================================================
+% MISULTIN - Example: Sends file as attachment.
+%
+% >-|-|-(°>
+% 
+% Copyright (C) 2009, Roberto Ostinelli <roberto@ostinelli.net>
+% All rights reserved.
+%
+% BSD License
+% 
+% Redistribution and use in source and binary forms, with or without modification, are permitted provided
+% that the following conditions are met:
+%
+%  * Redistributions of source code must retain the above copyright notice, this list of conditions and the
+%    following disclaimer.
+%  * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and
+%    the following disclaimer in the documentation and/or other materials provided with the distribution.
+%  * Neither the name of the authors nor the names of its contributors may be used to endorse or promote
+%    products derived from this software without specific prior written permission.
+%
+% THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED
+% WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+% PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
+% ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
+% TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+% HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+% NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+% POSSIBILITY OF SUCH DAMAGE.
+% ==========================================================================================================
+-module(misultin_file).
+-export([start/1, stop/0]).
+
+% start misultin http server
+start(Port) ->
+	misultin:start_link([{port, Port}, {loop, fun(Req) -> handle_http(Req) end}]).
+
+% stop misultin
+stop() ->
+	misultin:stop().
+
+% callback on request received
+handle_http(Req) ->	
+	Req:file(attachment, "1.png").

data/erlang/lib/misultin/examples/misultin_gen_server.erl

@@ -0,0 +1,158 @@
+% ==========================================================================================================
+% MISULTIN - Example: Running Misultin from a gen_server.
+%
+% >-|-|-(°>
+% 
+% Copyright (C) 2009, Roberto Ostinelli <roberto@ostinelli.net>
+% All rights reserved.
+%
+% BSD License
+% 
+% Redistribution and use in source and binary forms, with or without modification, are permitted provided
+% that the following conditions are met:
+%
+%  * Redistributions of source code must retain the above copyright notice, this list of conditions and the
+%	 following disclaimer.
+%  * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and
+%	 the following disclaimer in the documentation and/or other materials provided with the distribution.
+%  * Neither the name of the authors nor the names of its contributors may be used to endorse or promote
+%	 products derived from this software without specific prior written permission.
+%
+% THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED
+% WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+% PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
+% ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
+% TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+% HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+% NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+% POSSIBILITY OF SUCH DAMAGE.
+% ==========================================================================================================
+-module(misultin_gen_server).
+-behaviour(gen_server).
+
+% gen_server callbacks
+-export([init/1, handle_call/3, handle_cast/2, handle_info/2, terminate/2, code_change/3]).
+
+% API
+-export([start_link/1, stop/0]).
+
+% records
+-record(state, {
+	port
+}).
+
+% macros
+-define(SERVER, ?MODULE).
+
+
+% ============================ \/ API ======================================================================
+
+% Function: {ok,Pid} | ignore | {error, Error}
+% Description: Starts the server.
+start_link(Port) ->
+	gen_server:start_link({local, ?SERVER}, ?MODULE, [Port], []).
+
+% Function: -> ok
+% Description: Manually stops the server.
+stop() ->
+	gen_server:cast(?SERVER, stop).
+
+% ============================ /\ API ======================================================================
+
+
+% ============================ \/ GEN_SERVER CALLBACKS =====================================================
+
+% ----------------------------------------------------------------------------------------------------------
+% Function: -> {ok, State} | {ok, State, Timeout} | ignore | {stop, Reason}
+% Description: Initiates the server.
+% ----------------------------------------------------------------------------------------------------------
+init([Port]) ->
+	% trap_exit -> this gen_server needs to be supervised
+	process_flag(trap_exit, true),
+	% start misultin & set monitor
+	misultin:start_link([{port, Port}, {loop, fun(Req) -> handle_http(Req) end}]),
+	erlang:monitor(process, misultin),
+	{ok, #state{port = Port}}.
+
+% ----------------------------------------------------------------------------------------------------------
+% Function: handle_call(Request, From, State) -> {reply, Reply, State} | {reply, Reply, State, Timeout} |
+%									   {noreply, State} | {noreply, State, Timeout} |
+%									   {stop, Reason, Reply, State} | {stop, Reason, State}
+% Description: Handling call messages.
+% ----------------------------------------------------------------------------------------------------------
+
+% handle_call generic fallback
+handle_call(_Request, _From, State) ->
+	{reply, undefined, State}.
+
+% ----------------------------------------------------------------------------------------------------------
+% Function: handle_cast(Msg, State) -> {noreply, State} | {noreply, State, Timeout} | {stop, Reason, State}
+% Description: Handling cast messages.
+% ----------------------------------------------------------------------------------------------------------
+
+% manual shutdown
+handle_cast(stop, State) ->
+	{stop, normal, State};
+
+% handle_cast generic fallback (ignore)
+handle_cast(_Msg, State) ->
+	{noreply, State}.
+
+% ----------------------------------------------------------------------------------------------------------
+% Function: handle_info(Info, State) -> {noreply, State} | {noreply, State, Timeout} | {stop, Reason, State}
+% Description: Handling all non call/cast messages.
+% ----------------------------------------------------------------------------------------------------------
+
+% handle info when misultin server goes down -> take down misultin_gen_server too [the supervisor will take everything up again]
+handle_info({'DOWN', _, _, {misultin, _}, _}, State) ->
+	{stop, normal, State};
+
+% handle_info generic fallback (ignore)
+handle_info(_Info, State) ->
+	{noreply, State}.
+
+% ----------------------------------------------------------------------------------------------------------
+% Function: terminate(Reason, State) -> void()
+% Description: This function is called by a gen_server when it is about to terminate. When it returns,
+% the gen_server terminates with Reason. The return value is ignored.
+% ----------------------------------------------------------------------------------------------------------
+terminate(_Reason, _State) ->
+	% stop misultin
+	misultin:stop(),
+	terminated.
+
+% ----------------------------------------------------------------------------------------------------------
+% Func: code_change(OldVsn, State, Extra) -> {ok, NewState}
+% Description: Convert process state when code is changed.
+% ----------------------------------------------------------------------------------------------------------
+code_change(_OldVsn, State, _Extra) ->
+	{ok, State}.
+
+% ============================ /\ GEN_SERVER CALLBACKS =====================================================
+
+
+% ============================ \/ INTERNAL FUNCTIONS =======================================================
+
+% ---------------------------- \/ misultin requests --------------------------------------------------------
+
+handle_http(Req) -> 
+	% get params depending on method
+	Method = Req:get(method),
+	case Method of
+		'GET' ->
+			Args = Req:parse_qs();
+		'POST' ->
+			Args = Req:parse_post()
+	end,
+	% build an XML with all parameters and values
+	BuildXml = fun({Param, Value}, Acc) ->
+		[lists:flatten(io_lib:format("<param><name>~s</name><value>~s</value></param>", [Param, Value]))|Acc]
+	end,
+	Xml = lists:flatten(lists:reverse(lists:foldl(BuildXml, [], Args))),
+	% output
+	Req:ok([{"Content-Type", "text/xml"}], "<misultin_test><method>~s</method>~s</misultin_test>", [Method, Xml]).
+
+% ---------------------------- /\ misultin requests --------------------------------------------------------
+
+% ============================ /\ INTERNAL FUNCTIONS =======================================================
+