From e71f5a92911e7573d6e468cbc64c3655b7c75aef Mon Sep 17 00:00:00 2001
From: "psyc://psyced.org/~lynX" <@>
Date: Sat, 14 May 2011 18:18:54 +0200
Subject: [PATCH] first suggestions for a benchmark

---
 bench/benchmark.wiki | 53 ++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 53 insertions(+)
 create mode 100644 bench/benchmark.wiki

diff --git a/bench/benchmark.wiki b/bench/benchmark.wiki
new file mode 100644
index 0000000..c0a1228
--- /dev/null
+++ b/bench/benchmark.wiki
@@ -0,0 +1,53 @@
+= libpsyc Performance Benchmarks =
+
+In this document we present the results of performance benchmarks
+of libpsyc compared with libjson-glib and libxml2.
+
+== Procedure ==
+
+We'll use typical messages from the XMPP ("stanzas" in Jabber
+lingo) and compare them with equivalent PSYC packets and
+JSON encodings.
+
+In some cases we will additionally compare PSYC packets to
+a more efficient XML encoding based on PSYC methods, to have
+a more accurate comparison of the actual PSYC and XML
+syntaxes, rather than the protocol structures of PSYC and XMPP.
+
+== Caveats ==
+
+In every case we'll compare performance of parsing and re-rendering
+these messages, but consider also that the applicative processing
+of an XML DOM tree is more complicated than just accessing
+certain elements in a JSON data structure or PSYC variable
+mapping.
+
+For a speed check in real world conditions which also consider the
+complexity of processing incoming messages we should compare
+the performance of a chat client using the two protocols,
+for instance by using libpurple with XMPP and PSYC accounts.
+To this purpose we first need to integrate libpsyc into libpurple.
+
+== The Benchmarks ==
+
+=== A presence packet ===
+
+Since presence packets are by far the dominant messaging content
+in the XMPP network, we'll start with one of them.
+
+<pre>
+...
+</pre>
+
+and here's the same information in a JSON rendition:
+
+<pre>
+...
+</pre>
+
+=== An average chat message ===
+=== A social network activity ===
+=== A message with JSON-unfriendly characters ===
+=== A message with XML-unfriendly characters ===
+=== A packet containing a JPEG photograph ===
+