util/stanza.lua

   1 -- Prosody IM
   2 -- Copyright (C) 2008-2009 Matthew Wild
   3 -- Copyright (C) 2008-2009 Waqas Hussain
   4 --
   5 -- This project is MIT/X11 licensed. Please see the
   6 -- COPYING file in the source package for more information.
   7 --
   8
   9
  10 local t_insert      =  table.insert;
  11 local t_concat      =  table.concat;
  12 local t_remove      =  table.remove;
  13 local t_concat      =  table.concat;
  14 local s_format      = string.format;
  15 local s_match       =  string.match;
  16 local tostring      =      tostring;
  17 local setmetatable  =  setmetatable;
  18 local getmetatable  =  getmetatable;
  19 local pairs         =         pairs;
  20 local ipairs        =        ipairs;
  21 local type          =          type;
  22 local next          =          next;
  23 local print         =         print;
  24 local unpack        =        unpack;
  25 local s_gsub        =   string.gsub;
  26 local s_char        =   string.char;
  27 local s_find        =   string.find;
  28 local os            =            os;
  29
  30 local do_pretty_printing = not os.getenv("WINDIR");
  31 local getstyle, getstring;
  32 if do_pretty_printing then
  33         local ok, termcolours = pcall(require, "util.termcolours");
  34         if ok then
  35                 getstyle, getstring = termcolours.getstyle, termcolours.getstring;
  36         else
  37                 do_pretty_printing = nil;
  38         end
  39 end
  40
  41 module "stanza"
  42
  43 stanza_mt = { __type = "stanza" };
  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:reset()
  77         local last_add = self.last_add;
  78         for i = 1,#last_add do
  79                 last_add[i] = nil;
  80         end
  81         return self;
  82 end
  83
  84 function stanza_mt:add_direct_child(child)
  85         if type(child) == "table" then
  86                 t_insert(self.tags, child);
  87         end
  88         t_insert(self, child);
  89 end
  90
  91 function stanza_mt:add_child(child)
  92         (self.last_add[#self.last_add] or self):add_direct_child(child);
  93         return self;
  94 end
  95
  96 function stanza_mt:get_child(name, xmlns)
  97         for _, child in ipairs(self.tags) do
  98                 if (not name or child.name == name)
  99                         and ((not xmlns and self.attr.xmlns == child.attr.xmlns)
 100                                 or child.attr.xmlns == xmlns) then
 101
 102                         return child;
 103                 end
 104         end
 105 end
 106
 107 function stanza_mt:child_with_name(name)
 108         for _, child in ipairs(self.tags) do
 109                 if child.name == name then return child; end
 110         end
 111 end
 112
 113 function stanza_mt:child_with_ns(ns)
 114         for _, child in ipairs(self.tags) do
 115                 if child.attr.xmlns == ns then return child; end
 116         end
 117 end
 118
 119 function stanza_mt:children()
 120         local i = 0;
 121         return function (a)
 122                         i = i + 1
 123                         local v = a[i]
 124                         if v then return v; end
 125                 end, self, i;
 126 end
 127 function stanza_mt:childtags()
 128         local i = 0;
 129         return function (a)
 130                         i = i + 1
 131                         local v = self.tags[i]
 132                         if v then return v; end
 133                 end, self.tags[1], i;
 134 end
 135
 136 local xml_escape
 137 do
 138         local escape_table = { ["'"] = "&apos;", ["\""] = "&quot;", ["<"] = "&lt;", [">"] = "&gt;", ["&"] = "&amp;" };
 139         function xml_escape(str) return (s_gsub(str, "['&<>\"]", escape_table)); end
 140         _M.xml_escape = xml_escape;
 141 end
 142
 143 local function _dostring(t, buf, self, xml_escape, parentns)
 144         local nsid = 0;
 145         local name = t.name
 146         t_insert(buf, "<"..name);
 147         for k, v in pairs(t.attr) do
 148                 if s_find(k, "\1", 1, true) then
 149                         local ns, attrk = s_match(k, "^([^\1]*)\1?(.*)$");
 150                         nsid = nsid + 1;
 151                         t_insert(buf, " xmlns:ns"..nsid.."='"..xml_escape(ns).."' ".."ns"..nsid..":"..attrk.."='"..xml_escape(v).."'");
 152                 elseif not(k == "xmlns" and v == parentns) then
 153                         t_insert(buf, " "..k.."='"..xml_escape(v).."'");
 154                 end
 155         end
 156         local len = #t;
 157         if len == 0 then
 158                 t_insert(buf, "/>");
 159         else
 160                 t_insert(buf, ">");
 161                 for n=1,len do
 162                         local child = t[n];
 163                         if child.name then
 164                                 self(child, buf, self, xml_escape, t.attr.xmlns);
 165                         else
 166                                 t_insert(buf, xml_escape(child));
 167                         end
 168                 end
 169                 t_insert(buf, "</"..name..">");
 170         end
 171 end
 172 function stanza_mt.__tostring(t)
 173         local buf = {};
 174         _dostring(t, buf, _dostring, xml_escape, nil);
 175         return t_concat(buf);
 176 end
 177
 178 function stanza_mt.top_tag(t)
 179         local attr_string = "";
 180         if t.attr then
 181                 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
 182         end
 183         return s_format("<%s%s>", t.name, attr_string);
 184 end
 185
 186 function stanza_mt.get_text(t)
 187         if #t.tags == 0 then
 188                 return t_concat(t);
 189         end
 190 end
 191
 192 function stanza_mt.__add(s1, s2)
 193         return s1:add_direct_child(s2);
 194 end
 195
 196
 197 do
 198         local id = 0;
 199         function new_id()
 200                 id = id + 1;
 201                 return "lx"..id;
 202         end
 203 end
 204
 205 function preserialize(stanza)
 206         local s = { name = stanza.name, attr = stanza.attr };
 207         for _, child in ipairs(stanza) do
 208                 if type(child) == "table" then
 209                         t_insert(s, preserialize(child));
 210                 else
 211                         t_insert(s, child);
 212                 end
 213         end
 214         return s;
 215 end
 216
 217 function deserialize(stanza)
 218         -- Set metatable
 219         if stanza then
 220                 local attr = stanza.attr;
 221                 for i=1,#attr do attr[i] = nil; end
 222                 local attrx = {};
 223                 for att in pairs(attr) do
 224                         if s_find(att, "|", 1, true) and not s_find(k, "\1", 1, true) then
 225                                 local ns,na = s_match(k, "^([^|]+)|(.+)$");
 226                                 attrx[ns.."\1"..na] = attr[att];
 227                                 attr[att] = nil;
 228                         end
 229                 end
 230                 for a,v in pairs(attrx) do
 231                         attr[x] = v;
 232                 end
 233                 setmetatable(stanza, stanza_mt);
 234                 for _, child in ipairs(stanza) do
 235                         if type(child) == "table" then
 236                                 deserialize(child);
 237                         end
 238                 end
 239                 if not stanza.tags then
 240                         -- Rebuild tags
 241                         local tags = {};
 242                         for _, child in ipairs(stanza) do
 243                                 if type(child) == "table" then
 244                                         t_insert(tags, child);
 245                                 end
 246                         end
 247                         stanza.tags = tags;
 248                         if not stanza.last_add then
 249                                 stanza.last_add = {};
 250                         end
 251                 end
 252         end
 253
 254         return stanza;
 255 end
 256
 257 function clone(stanza)
 258         local lookup_table = {};
 259         local function _copy(object)
 260                 if type(object) ~= "table" then
 261                         return object;
 262                 elseif lookup_table[object] then
 263                         return lookup_table[object];
 264                 end
 265                 local new_table = {};
 266                 lookup_table[object] = new_table;
 267                 for index, value in pairs(object) do
 268                         new_table[_copy(index)] = _copy(value);
 269                 end
 270                 return setmetatable(new_table, getmetatable(object));
 271         end
 272
 273         return _copy(stanza)
 274 end
 275
 276 function message(attr, body)
 277         if not body then
 278                 return stanza("message", attr);
 279         else
 280                 return stanza("message", attr):tag("body"):text(body);
 281         end
 282 end
 283 function iq(attr)
 284         if attr and not attr.id then attr.id = new_id(); end
 285         return stanza("iq", attr or { id = new_id() });
 286 end
 287
 288 function reply(orig)
 289         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) });
 290 end
 291
 292 function error_reply(orig, type, condition, message)
 293         local t = reply(orig);
 294         t.attr.type = "error";
 295         t:tag("error", {type = type})
 296                 :tag(condition, {xmlns = "urn:ietf:params:xml:ns:xmpp-stanzas"}):up();
 297         if (message) then t:tag("text"):text(message):up(); end
 298         return t; -- stanza ready for adding app-specific errors
 299 end
 300
 301 function presence(attr)
 302         return stanza("presence", attr);
 303 end
 304
 305 if do_pretty_printing then
 306         local style_attrk = getstyle("yellow");
 307         local style_attrv = getstyle("red");
 308         local style_tagname = getstyle("red");
 309         local style_punc = getstyle("magenta");
 310
 311         local attr_format = " "..getstring(style_attrk, "%s")..getstring(style_punc, "=")..getstring(style_attrv, "'%s'");
 312         local top_tag_format = getstring(style_punc, "<")..getstring(style_tagname, "%s").."%s"..getstring(style_punc, ">");
 313         --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, ">");
 314         local tag_format = top_tag_format.."%s"..getstring(style_punc, "</")..getstring(style_tagname, "%s")..getstring(style_punc, ">");
 315         function stanza_mt.pretty_print(t)
 316                 local children_text = "";
 317                 for n, child in ipairs(t) do
 318                         if type(child) == "string" then
 319                                 children_text = children_text .. xml_escape(child);
 320                         else
 321                                 children_text = children_text .. child:pretty_print();
 322                         end
 323                 end
 324
 325                 local attr_string = "";
 326                 if t.attr then
 327                         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
 328                 end
 329                 return s_format(tag_format, t.name, attr_string, children_text, t.name);
 330         end
 331
 332         function stanza_mt.pretty_top_tag(t)
 333                 local attr_string = "";
 334                 if t.attr then
 335                         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
 336                 end
 337                 return s_format(top_tag_format, t.name, attr_string);
 338         end
 339 else
 340         -- Sorry, fresh out of colours for you guys ;)
 341         stanza_mt.pretty_print = stanza_mt.__tostring;
 342         stanza_mt.pretty_top_tag = stanza_mt.top_tag;
 343 end
 344
 345 return _M;