xmlbuilder-0.9/xmlbuilder.egg-info/PKG-INFO

   1 Metadata-Version: 1.1
   2 Name: xmlbuilder
   3 Version: 0.9
   4 Summary: Pythonic way to create xml files
   5 Home-page: http://pypi.python.org/pypi/xmlbuilder
   6 Author: koder
   7 Author-email: koder_dot_mail@gmail_dot_com
   8 License: MIT
   9 Download-URL: http://pypi.python.org/pypi/xmlbuilder
  10 Description: Example of usage:\r
  11         -----------------\r
  12         \r
  13         \r
  14         from __future__ import with_statement\r
  15         from xmlbuilder import XMLBuilder\r
  16         x = XMLBuilder(format=True)\r
  17         with x.root(a = 1):\r
  18             with x.data:\r
  19                 [x &lt;&lt; ('node',{'val':i}) for i in range(10)]\r
  20         \r
  21         print str(x)\r
  22         \r
  23         will print\r
  24         \r
  25         &lt;root a="1"&gt;\r
  26             &lt;data&gt;\r
  27                 &lt;node val="0" /&gt;\r
  28                 &lt;node val="1" /&gt;\r
  29                 &lt;node val="2" /&gt;\r
  30                 &lt;node val="3" /&gt;\r
  31                 &lt;node val="4" /&gt;\r
  32                 &lt;node val="5" /&gt;\r
  33                 &lt;node val="6" /&gt;\r
  34                 &lt;node val="7" /&gt;\r
  35                 &lt;node val="8" /&gt;\r
  36                 &lt;node val="9" /&gt;\r
  37             &lt;/data&gt;\r
  38         &lt;/root&gt;\r
  39         \r
  40         Mercurial repo:http://hg.assembla.com/MyPackages/\r
  41         \r
  42         Documentations\r
  43         --------------\r
  44         `XMLBuilder` is simple library build on top of `ElementTree.TreeBuilder` to\r
  45         simplify xml files creation as much as possible. Althow it can produce\r
  46         structured result with identated child tags. `XMLBuilder` use python `with`\r
  47         statement to define xml tag levels and `&lt;&lt;` operator for simple cases -\r
  48         text and tag without childs.\r
  49         \r
  50         First we need to create xmlbuilder\r
  51         \r
  52             from xmlbuilder import XMLBuilder\r
  53             # params - encoding = 'utf8',\r
  54             # builder = None, - ElementTree.TreeBuilder \r
  55             # tab_level = None, - current tab l;evel - for formatted output only\r
  56             # format = False, - create formatted output\r
  57             # tab_step = " " * 4 - indentation step\r
  58             xml = XMLBuilder()\r
  59         \r
  60         \r
  61         Use `with` statement to make document structure\r
  62             #create and open tag 'root_tag' with text 'text' and attributes\r
  63             with xml.root_tag(text,attr1=val1,attr2=val2):\r
  64                 #create and open tag 'sub_tag'\r
  65                 with xml.sub_tag(text,attr3=val3):\r
  66                     #create tag which are not valid python identificator\r
  67                     with xml('one-more-sub-tag',attr7=val37):\r
  68                         xml &lt;&lt; "Some textual data"\r
  69                     #here tag 'one-more-sub-tag' are closed\r
  70                                 #Tags without children can be created using `&lt;&lt;` operator\r
  71                     for val in range(15):\r
  72                         xml &lt;&lt; ('message',"python rocks!"[:i])\r
  73                     #create 15 child tag like &lt;message&gt; python r&lt;/message&gt;\r
  74             #all tags closed\r
  75             node = ~x # get etree.ElementTree object\r
  76             xml_data = str(x)\r
  77             unicode_xml_data = unicode(x)\r
  78
  79 Keywords: xml
  80 Platform: UNKNOWN