util/stanza.lua

   1 -- Prosody IM v0.1
   2 -- Copyright (C) 2008 Matthew Wild
   3 -- Copyright (C) 2008 Waqas Hussain
   4 --
   5 -- This program is free software; you can redistribute it and/or
   6 -- modify it under the terms of the GNU General Public License
   7 -- as published by the Free Software Foundation; either version 2
   8 -- of the License, or (at your option) any later version.
   9 --
  10 -- This program is distributed in the hope that it will be useful,
  11 -- but WITHOUT ANY WARRANTY; without even the implied warranty of
  12 -- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13 -- GNU General Public License for more details.
  14 --
  15 -- You should have received a copy of the GNU General Public License
  16 -- along with this program; if not, write to the Free Software
  17 -- Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  18 --
  19
  20
  21 local t_insert      =  table.insert;
  22 local t_concat      =  table.concat;
  23 local t_remove      =  table.remove;
  24 local s_format      = string.format;
  25 local tostring      =      tostring;
  26 local setmetatable  =  setmetatable;
  27 local pairs         =         pairs;
  28 local ipairs        =        ipairs;
  29 local type          =          type;
  30 local next          =          next;
  31 local print         =         print;
  32 local unpack        =        unpack;
  33 local s_gsub        =   string.gsub;
  34 local os = os;
  35
  36 local do_pretty_printing = not os.getenv("WINDIR");
  37 local getstyle, getstring = require "util.termcolours".getstyle, require "util.termcolours".getstring;
  38
  39 local log = require "util.logger".init("stanza");
  40
  41 module "stanza"
  42
  43 stanza_mt = {};
  44 stanza_mt.__index = stanza_mt;
  45
  46 function stanza(name, attr)
  47         local stanza = { name = name, attr = attr or {}, tags = {}, last_add = {}};
  48         return setmetatable(stanza, stanza_mt);
  49 end
  50
  51 function stanza_mt:query(xmlns)
  52         return self:tag("query", { xmlns = xmlns });
  53 end
  54
  55 function stanza_mt:body(text, attr)
  56         return self:tag("body", attr):text(text);
  57 end
  58
  59 function stanza_mt:tag(name, attrs)
  60         local s = stanza(name, attrs);
  61         (self.last_add[#self.last_add] or self):add_direct_child(s);
  62         t_insert(self.last_add, s);
  63         return self;
  64 end
  65
  66 function stanza_mt:text(text)
  67         (self.last_add[#self.last_add] or self):add_direct_child(text);
  68         return self;
  69 end
  70
  71 function stanza_mt:up()
  72         t_remove(self.last_add);
  73         return self;
  74 end
  75
  76 function stanza_mt:add_direct_child(child)
  77         if type(child) == "table" then
  78                 t_insert(self.tags, child);
  79         end
  80         t_insert(self, child);
  81 end
  82
  83 function stanza_mt:add_child(child)
  84         (self.last_add[#self.last_add] or self):add_direct_child(child);
  85         return self;
  86 end
  87
  88 function stanza_mt:child_with_name(name)
  89         for _, child in ipairs(self) do
  90                 if child.name == name then return child; end
  91         end
  92 end
  93
  94 function stanza_mt:children()
  95         local i = 0;
  96         return function (a)
  97                         i = i + 1
  98                         local v = a[i]
  99                         if v then return v; end
 100                 end, self, i;
 101
 102 end
 103 function stanza_mt:childtags()
 104         local i = 0;
 105         return function (a)
 106                         i = i + 1
 107                         local v = self.tags[i]
 108                         if v then return v; end
 109                 end, self.tags[1], i;
 110
 111 end
 112
 113 do
 114         local xml_entities = { ["'"] = "&apos;", ["\""] = "&quot;", ["<"] = "&lt;", [">"] = "&gt;", ["&"] = "&amp;" };
 115         function xml_escape(s) return s_gsub(s, "['&<>\"]", xml_entities); end
 116 end
 117
 118 local xml_escape = xml_escape;
 119
 120 local function dostring(t, buf, self)
 121         t_insert(buf, "<");
 122         t_insert(buf, t.name);
 123         if t.attr then
 124                 for k, v in pairs(t.attr) do if type(k) == "string" then
 125                         t_insert(buf, " ");
 126                         t_insert(buf, k);
 127                         t_insert(buf, "='");
 128                         t_insert(buf, (xml_escape(tostring(v))));
 129                         t_insert(buf, "'");
 130                 end end
 131         end
 132         t_insert(buf, ">");
 133         for n, child in ipairs(t) do
 134                 if child.name then
 135                         self(child, buf, self);
 136                 else
 137                         t_insert(buf, (xml_escape(child)));
 138                 end
 139         end
 140         t_insert(buf, "</");
 141         t_insert(buf, t.name);
 142         t_insert(buf, ">");
 143 end
 144
 145 function stanza_mt.__tostring(t)
 146         local buf = {};
 147         dostring(t, buf, dostring);
 148         return t_concat(buf);
 149 end
 150
 151 function stanza_mt.top_tag(t)
 152         local attr_string = "";
 153         if t.attr then
 154                 for k, v in pairs(t.attr) do if type(k) == "string" then attr_string = attr_string .. s_format(" %s='%s'", k, xml_escape(tostring(v))); end end
 155         end
 156         return s_format("<%s%s>", t.name, attr_string);
 157 end
 158
 159 function stanza_mt.__add(s1, s2)
 160         return s1:add_direct_child(s2);
 161 end
 162
 163
 164 do
 165         local id = 0;
 166         function new_id()
 167                 id = id + 1;
 168                 return "lx"..id;
 169         end
 170 end
 171
 172 function preserialize(stanza)
 173         local s = { name = stanza.name, attr = stanza.attr };
 174         for _, child in ipairs(stanza) do
 175                 if type(child) == "table" then
 176                         t_insert(s, preserialize(child));
 177                 else
 178                         t_insert(s, child);
 179                 end
 180         end
 181         return s;
 182 end
 183
 184 function deserialize(stanza)
 185         -- Set metatable
 186         if stanza then
 187                 setmetatable(stanza, stanza_mt);
 188                 for _, child in ipairs(stanza) do
 189                         if type(child) == "table" then
 190                                 deserialize(child);
 191                         end
 192                 end
 193                 if not stanza.tags then
 194                         -- Rebuild tags
 195                         local tags = {};
 196                         for _, child in ipairs(stanza) do
 197                                 if type(child) == "table" then
 198                                         t_insert(tags, child);
 199                                 end
 200                         end
 201                         stanza.tags = tags;
 202                 end
 203         end
 204
 205         return stanza;
 206 end
 207
 208 function message(attr, body)
 209         if not body then
 210                 return stanza("message", attr);
 211         else
 212                 return stanza("message", attr):tag("body"):text(body);
 213         end
 214 end
 215 function iq(attr)
 216         if attr and not attr.id then attr.id = new_id(); end
 217         return stanza("iq", attr or { id = new_id() });
 218 end
 219
 220 function reply(orig)
 221         return stanza(orig.name, orig.attr and { to = orig.attr.from, from = orig.attr.to, id = orig.attr.id, type = ((orig.name == "iq" and "result") or orig.attr.type) });
 222 end
 223
 224 function error_reply(orig, type, condition, message, clone)
 225         local t = reply(orig);
 226         t.attr.type = "error";
 227         -- TODO use clone
 228         t:tag("error", {type = type})
 229                 :tag(condition, {xmlns = "urn:ietf:params:xml:ns:xmpp-stanzas"}):up();
 230         if (message) then t:tag("text"):text(message):up(); end
 231         return t; -- stanza ready for adding app-specific errors
 232 end
 233
 234 function presence(attr)
 235         return stanza("presence", attr);
 236 end
 237
 238 if do_pretty_printing then
 239         local style_attrk = getstyle("yellow");
 240         local style_attrv = getstyle("red");
 241         local style_tagname = getstyle("red");
 242         local style_punc = getstyle("magenta");
 243
 244         local attr_format = " "..getstring(style_attrk, "%s")..getstring(style_punc, "=")..getstring(style_attrv, "'%s'");
 245         local top_tag_format = getstring(style_punc, "<")..getstring(style_tagname, "%s").."%s"..getstring(style_punc, ">");
 246         --local tag_format = getstring(style_punc, "<")..getstring(style_tagname, "%s").."%s"..getstring(style_punc, ">").."%s"..getstring(style_punc, "</")..getstring(style_tagname, "%s")..getstring(style_punc, ">");
 247         local tag_format = top_tag_format.."%s"..getstring(style_punc, "</")..getstring(style_tagname, "%s")..getstring(style_punc, ">");
 248         function stanza_mt.pretty_print(t)
 249                 local children_text = "";
 250                 for n, child in ipairs(t) do
 251                         if type(child) == "string" then
 252                                 children_text = children_text .. xml_escape(child);
 253                         else
 254                                 children_text = children_text .. child:pretty_print();
 255                         end
 256                 end
 257
 258                 local attr_string = "";
 259                 if t.attr then
 260                         for k, v in pairs(t.attr) do if type(k) == "string" then attr_string = attr_string .. s_format(attr_format, k, tostring(v)); end end
 261                 end
 262                 return s_format(tag_format, t.name, attr_string, children_text, t.name);
 263         end
 264
 265         function stanza_mt.pretty_top_tag(t)
 266                 local attr_string = "";
 267                 if t.attr then
 268                         for k, v in pairs(t.attr) do if type(k) == "string" then attr_string = attr_string .. s_format(attr_format, k, tostring(v)); end end
 269                 end
 270                 return s_format(top_tag_format, t.name, attr_string);
 271         end
 272 else
 273         -- Sorry, fresh out of colours for you guys ;)
 274         stanza_mt.pretty_print = stanza_mt.__tostring;
 275         stanza_mt.pretty_top_tag = stanza_mt.top_tag;
 276 end
 277
 278 return _M;