From 11bf44ab2ec6b7eb4a2209ee8f4b908868634c13 Mon Sep 17 00:00:00 2001
From: "psyc://psyced.org/~lynX" <@>
Date: Sat, 14 May 2011 19:22:24 +0200
Subject: [PATCH] two examples to start with
---
bench/benchmark.wiki | 105 +++++++++++++++++++++++++++++++++++++++----
1 file changed, 96 insertions(+), 9 deletions(-)
diff --git a/bench/benchmark.wiki b/bench/benchmark.wiki
index c0a1228..235ff7d 100644
--- a/bench/benchmark.wiki
+++ b/bench/benchmark.wiki
@@ -6,8 +6,8 @@ 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.
+lingo) and compare them with equivalent JSON encodings,
+verbose and compact PSYC formats.
In some cases we will additionally compare PSYC packets to
a more efficient XML encoding based on PSYC methods, to have
@@ -34,16 +34,43 @@ To this purpose we first need to integrate libpsyc into libpurple.
Since presence packets are by far the dominant messaging content
in the XMPP network, we'll start with one of them.
+Here's an example from paragraph 4.4.2 of RFC 6121.
-
-...
-
+{{{
+
+ away
+
-and here's the same information in a JSON rendition:
+}}}
-
-...
-
+And here's the same information in a JSON rendition:
+
+{{{
+...
+}}}
+
+Here's the equivalent PSYC packet in verbose form
+(since it is a multicast, the single recipients do not
+need to be mentioned):
+
+{{{
+:_context psyc://example.com/~juliet
+
+=_degree_availability 4
+_notice_presence
+|
+}}}
+
+And the same in compact form:
+
+{{{
+:c psyc://example.com/~juliet
+
+=da 4
+np
+|
+}}}
=== An average chat message ===
=== A social network activity ===
@@ -51,3 +78,63 @@ and here's the same information in a JSON rendition:
=== A message with XML-unfriendly characters ===
=== A packet containing a JPEG photograph ===
+=== A random data structure ===
+
+In this test we'll not consider XMPP at all and simply compare the
+efficiency of the three syntaxes at serializing a typical user data base
+storage information. We'll again start with XML:
+
+{{{
+
+ Silvio Berlusconi
+ Premier
+ I
+
+ Via del Colosseo, 1
+ 00100
+ Roma
+
+ http://example.org
+
+}}}
+
+In JSON this would look like this:
+
+{{{
+...
+}}}
+
+Here's a way to model this in PSYC:
+
+{{{
+:_name Silvio Berlusconi
+:_title_job Premier
+:_country I
+:_address_street Via del Colosseo, 1
+:_address_code_postal 00100
+:_address_city Roma
+:_page http://example.org
+_profile_user
+|
+}}}
+
+== Conclusions ==
+
+== Criticism ==
+
+Are we comparing apples and oranges? Yes and no, depends on what you
+need. XML is a syntax best suited for complex structured data in
+well-defined formats - especially good for text mark-up. JSON is a syntax
+intended to hold arbitrarily structured data suitable for immediate
+inclusion in javascript source codes. The PSYC syntax is an evolved
+derivate of RFC 822, the syntax used by HTTP and E-Mail, and is therefore
+limited in the kind and depth of data structures that can be represented
+with it, but in exchange it is highly performant at doing just that.
+
+So it is up to you to find out which of the three formats fulfils your
+requirements the best. We use PSYC for the majority of messaging where
+JSON and XMPP aren't efficient and opaque enough, but we employ XML and
+JSON as payloads within PSYC for data that doesn't fit the PSYC model.
+For some reason all three formats are being used for messaging, although
+only PSYC was actually designed for that purpose.
+