added: output xml with $.xml() [@Maciek416]

Readme.md

@@ -505,7 +505,7 @@ $('ul').text()
 ```
 
 ### Rendering
-When you're ready to render the document, you can use `html` utility function:
+When you're ready to render the document, you can use the `html` utility function:
 
 ```js
 $.html()
@@ -523,6 +523,20 @@ $.html('.pear')
 //=> <li class="pear">Pear</li>
 ```
 
+By default, `html` will leave some tags open. Sometimes you may instead want to render a valid XML document. For example, you might parse the following XML snippet:
+
+```xml
+$ = cheerio.load('<media:thumbnail url="http://www.foo.com/keyframe.jpg" width="75" height="50" time="12:05:01.123"/>');
+```
+
+... and later want to render to XML. To do this, you can use the 'xml' utility function:
+
+```js
+$.xml()
+//=>  <media:thumbnail url="http://www.foo.com/keyframe.jpg" width="75" height="50" time="12:05:01.123"/>
+```
+
+
 ### Miscellaneous
 DOM element methods that don't fit anywhere else
 

lib/render.js

@@ -75,7 +75,7 @@ var render = module.exports = function(dom, opts) {
     var pushVal;
 
     if (tagType[elem.type])
-      pushVal = renderTag(elem);
+      pushVal = renderTag(elem, xmlMode);
     else if (elem.type === 'directive')
       pushVal = renderDirective(elem);
     else if (elem.type === 'comment')
@@ -89,19 +89,30 @@ var render = module.exports = function(dom, opts) {
     if (elem.children)
       output.push(render(elem.children, opts));
 
-    if ((!singleTag[elem.name] || xmlMode) && tagType[elem.type])
-      output.push('</' + elem.name + '>');
+    if ((!singleTag[elem.name] || xmlMode) && tagType[elem.type]) {
+      if (!isClosedTag(elem, xmlMode)) {
+        output.push('</' + elem.name + '>');
+      }
+    }
   });
 
   return output.join('');
 };
 
-var renderTag = function(elem) {
+var isClosedTag = function(elem, xmlMode){
+  return (xmlMode && (!elem.children || elem.children.length === 0));
+}
+
+var renderTag = function(elem, xmlMode) {
   var tag = '<' + elem.name;
 
   if (elem.attribs && _.size(elem.attribs)) {
     tag += ' ' + formatAttrs(elem.attribs);
   }
+
+  if (isClosedTag(elem, xmlMode)) {
+    tag += '/';
+  }
 
   return tag + '>';
 };

lib/static.js

@@ -43,6 +43,21 @@ var html = exports.html = function(dom) {
   }
 };
 
+/**
+ * $.xml([selector | dom])
+ */
+
+var xml = exports.xml = function(dom) {
+  if (dom) {
+    dom = (typeof dom === 'string') ? select(dom, this._root) : dom;
+    return render(dom, { xmlMode: true });
+  } else if (this._root && this._root.children) {
+    return render(this._root.children, { xmlMode: true });
+  } else {
+    return '';
+  }
+};
+
 /**
  * $.text(dom)
  */

test/xml.js

@@ -0,0 +1,29 @@
+var expect = require('expect.js'),
+    _ = require('underscore'),
+    cheerio = require('../lib/cheerio');
+
+var xml = function(str, options) {
+  options = _.extend({ xmlMode: true }, options);
+  var dom = cheerio.load(str, options);
+  return dom.xml();
+};
+
+describe('render', function() {
+
+  describe('(xml)', function() {
+
+    it('should render <media:thumbnail /> tags correctly', function(done) {
+      var str = '<media:thumbnail url="http://www.foo.com/keyframe.jpg" width="75" height="50" time="12:05:01.123" />';
+      expect(xml(str)).to.equal('<media:thumbnail url="http://www.foo.com/keyframe.jpg" width="75" height="50" time="12:05:01.123"/>');
+      done();
+    });
+
+    it('should render <link /> tags (RSS) correctly', function(done) {
+      var str = '<link>http://www.github.com/</link>';
+      expect(xml(str)).to.equal('<link>http://www.github.com/</link>');
+      done();
+    });
+
+  });
+
+});