{"id":11257,"date":"2020-12-05T21:08:52","date_gmt":"2020-12-05T21:08:52","guid":{"rendered":"https:\/\/www.askpython.com\/?p=11257"},"modified":"2020-12-09T19:07:21","modified_gmt":"2020-12-09T19:07:21","slug":"xmltodict-module","status":"publish","type":"post","link":"https:\/\/www.askpython.com\/python-modules\/xmltodict-module","title":{"rendered":"xmltodict Module in Python: A Practical Reference"},"content":{"rendered":"\n

In this tutorial, we will see how to install the xmltodict module and use it in our Python programs to work easily with XML files. We will see how to convert XML to Python dictionaries<\/a> and to JSON format and vice-versa.<\/p>\n\n\n\n

Install the xmltodict module using pip<\/h2>\n\n\n\n

For Python 3 or above we can use the pip3 command<\/a> to install xmltodict using the terminal.<\/p>\n\n\n

\npip3  install xmltodict\n<\/pre><\/div>\n\n\n
For older versions of Python we can use the following command to install xmltodict.<\/p>\n\n\n
\npip install xmltodict\n<\/pre><\/div>\n\n\n
What is an XML file?<\/h2>\n\n\n\n
XML stands for extensible markup language and it was designed primarily for storing and transporting data. <\/p>\n\n\n\n
It’s a descriptive language that supports writing structured data and we have to use other software to store, send, receive, or display XML data. <\/p>\n\n\n\n
The following XML file has data for an airplane such as the year, make, model and color.<\/p>\n\n\n
\n<?xml version = "1.0" encoding = "utf-8"?>\n<!-- xslplane.1.xml -->\n<?xml-stylesheet type = "text\/xsl"  href = "xslplane.1.xsl" ?>\n<plane>\n   <year> 1977 <\/year>\n   <make> Cessna <\/make>\n   <model> Skyhawk <\/model>\n   <color> Light blue and white <\/color>\n<\/plane>\n<\/pre><\/div>\n\n\n
Now, in the following sections, we will play with this airplane data and see how to convert it into Python dictionary and JSON and convert them back to XML format using the xmltodict module.<\/p>\n\n\n\n
How to read XML data into a Python dictionary?<\/h2>\n\n\n\n
We can convert XML files to a Python dictionary using the xmltodict.parse()<\/code> method in the xmltodict module. <\/p>\n\n\n\n
xmltodict.parse() <\/code>method takes an XML file as input and changes it to Ordered Dictionary. <\/p>\n\n\n\n
We can then extract the dictionary data from Ordered Dictionary using dict constructor for Python dictionaries. <\/p>\n\n\n
\n#import module\nimport xmltodict\n\n#open the file\nfileptr = open("\/home\/aditya1117\/askpython\/plane.xml","r")\n\n#read xml content from the file\nxml_content= fileptr.read()\nprint("XML content is:")\nprint(xml_content)\n\n#change xml format to ordered dict\nmy_ordered_dict=xmltodict.parse(xml_content)\nprint("Ordered Dictionary is:")\nprint(my_ordered_dict)\nprint("Year of plane is:")\nprint(my_ordered_dict['plane']['year'])\n\n#Use contents of ordered dict to make python dictionary\nmy_plane= dict(my_ordered_dict['plane'])\nprint("Created dictionary data is:")\nprint(my_plane)\nprint("Year of plane is")\nprint(my_plane['year'])\n<\/pre><\/div>\n\n\n
Output:<\/p>\n\n\n
\nXML content is:\n<?xml version = "1.0" encoding = "utf-8"?>\n<!-- xslplane.1.xml -->\n<?xml-stylesheet type = "text\/xsl"  href = "xslplane.1.xsl" ?>\n<plane>\n   <year> 1977 <\/year>\n   <make> Cessna <\/make>\n   <model> Skyhawk <\/model>\n   <color> Light blue and white <\/color>\n<\/plane>\n\nOrdered Dictionary is:\nOrderedDict([('plane', OrderedDict([('year', '1977'), ('make', 'Cessna'), ('model', 'Skyhawk'), ('color', 'Light blue and white')]))])\nYear of plane is:\n1977\nCreated dictionary data is:\n{'year': '1977', 'make': 'Cessna', 'model': 'Skyhawk', 'color': 'Light blue and white'}\nYear of plane is\n1977\n<\/pre><\/div>\n\n\n
In the above example, we have successfully extracted our airplane data from XML format using xmltodict.parse()<\/code><\/strong> method and printed the data both in the form of Ordered Dictionary and dictionary.<\/p>\n\n\n\n
How to convert a Python dictionary to XML?<\/h2>\n\n\n\n
We can convert a python dictionary into the XML format using xmltodict.unparse()<\/code><\/strong> method of xmltodict module. <\/p>\n\n\n\n
This method accepts the dictionary object as input as returns an XML format data as output. <\/p>\n\n\n\n
The only restriction here is that the dictionary should have single root <\/strong>so that XML data can be formatted easily. Otherwise it will cause ValueError<\/code><\/strong> .<\/p>\n\n\n
\n#import module\nimport xmltodict\n\n#define dictionary with all the attributes\nmydict={'plane':{'year': '1977', 'make': 'Cessna', 'model': 'Skyhawk', 'color':'Light blue and white'}}\nprint("Original Dictionary of plane data is:")\nprint(mydict)\n\n#create xml format\nxml_format= xmltodict.unparse(my_ordered_dict,pretty=True)\nprint("XML format data is:")\nprint(xml_format)\n<\/pre><\/div>\n\n\n
Output:<\/p>\n\n\n
\nOriginal Dictionary of plane data is:\n{'plane': {'year': '1977', 'make': 'Cessna', 'model': 'Skyhawk', 'color': 'Light blue and white'}}\nXML format data is:\n<?xml version="1.0" encoding="utf-8"?>\n<plane>\n        <year>1977<\/year>\n        <make>Cessna<\/make>\n        <model>Skyhawk<\/model>\n        <color>Light blue and white<\/color>\n<\/plane>\n<\/pre><\/div>\n\n\n
In the above example, we have created airplane data in XML format  from simple python dictionary data. Now we will see how to convert XML data into JSON format.<\/p>\n\n\n\n
How to convert XML to JSON?<\/h2>\n\n\n\n
We can convert XML data into JSON format using the xmltodict<\/strong> module and the json<\/strong> module in python<\/a>. In this process, we first create an ordered dictionary from XML format using xmltodict.parse()<\/code><\/strong> method. <\/p>\n\n\n\n
Then we convert the ordered dictionary into JSON format using json.dumps()<\/code><\/strong> method which takes ordered dictionary as an argument and converts it into JSON string.<\/p>\n\n\n
\n#import module\nimport xmltodict\nimport json\n\n#open the file\nfileptr = open("\/home\/aditya1117\/askpython\/plane.xml","r")\n\n#read xml content from the file\nxml_content= fileptr.read()\nprint("XML content is:")\nprint(xml_content)\n\n#change xml format to ordered dict\nmy_ordered_dict=xmltodict.parse(xml_content)\nprint("Ordered Dictionary is:")\nprint(my_ordered_dict)\njson_data= json.dumps(my_ordered_dict)\nprint("JSON data is:")\nprint(json_data)\nx= open("plane.json","w")\nx.write(json_data)\nx.close()\n<\/pre><\/div>\n\n\n
Output:<\/p>\n\n\n
\nXML content is:\n<?xml version = "1.0" encoding = "utf-8"?>\n<!-- xslplane.1.xml -->\n<?xml-stylesheet type = "text\/xsl"  href = "xslplane.1.xsl" ?>\n<plane>\n   <year> 1977 <\/year>\n   <make> Cessna <\/make>\n   <model> Skyhawk <\/model>\n   <color> Light blue and white <\/color>\n<\/plane>\n\nOrdered Dictionary is:\nOrderedDict([('plane', OrderedDict([('year', '1977'), ('make', 'Cessna'), ('model', 'Skyhawk'), ('color', 'Light blue and white')]))])\nJSON data is:\n{"plane": {"year": "1977", "make": "Cessna", "model": "Skyhawk", "color": "Light blue and white"}}\n<\/pre><\/div>\n\n\n
In the above example, we have read XML data into xml_content<\/code><\/strong> and then xmltodict.parse() <\/code><\/strong>creates an ordered dictionary my_ordered_dict<\/code><\/strong> and then JSON data is created using json.dumps()<\/code><\/strong> method from ordered dictionary.<\/p>\n\n\n\n
How to convert JSON data to XML?<\/h2>\n\n\n\n
Now, let’s convert JSON data into the XML format using the xmltodict module by first converting the JSON data to Python dictionary using json.load()<\/code><\/strong> method and then converting the dictionary to XML using xmltodict.unparse()<\/code><\/strong>. <\/p>\n\n\n\n
Again, here restriction is that JSON data should have a single root<\/strong> otherwise it will cause ValueError<\/code><\/strong>.<\/p>\n\n\n
\n#import module\nimport xmltodict\nimport json\n\n#define dictionary with all the attributes\nfileptr = open("\/home\/aditya1117\/askpython\/plane.json","r")\njson_data=json.load(fileptr)\nprint("JSON data is:")\nprint(json_data)\n\n#create xml format\nxml_format= xmltodict.unparse(json_data,pretty=True)\nprint("XML format data is:")\nprint(xml_format)\n<\/pre><\/div>\n\n\n
Output:<\/p>\n\n\n
\nJSON data is:\n{'plane': {'year': '1977', 'make': 'Cessna', 'model': 'Skyhawk', 'color': 'Light blue and white'}}\nXML format data is:\n<?xml version="1.0" encoding="utf-8"?>\n<plane>\n        <year>1977<\/year>\n        <make>Cessna<\/make>\n        <model>Skyhawk<\/model>\n        <color>Light blue and white<\/color>\n<\/plane>\n<\/pre><\/div>\n\n\n
In the above example, json.load()<\/code><\/strong> accepts the file object as argument and parses the data thereby creating a Python dictionary which is stored in json_data<\/code><\/strong> . Then we convert the dictionary into XML file using xmltodict.unparse()<\/code><\/strong> method.<\/p>\n\n\n\n
Conclusion<\/h2>\n\n\n\n
In this article, we have used the xmltodict module to process XML data. We have seen how to convert XML data to Python dictionary and JSON format and also converted them back into XML format. Happy Learning!<\/p>\n","protected":false},"excerpt":{"rendered":"
In this tutorial, we will see how to install the xmltodict module and use it in our Python programs to work easily with XML files. We will see how to convert XML to Python dictionaries and to JSON format and vice-versa. Install the xmltodict module using pip For Python 3 or above we can use […]<\/p>\n","protected":false},"author":20,"featured_media":11327,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2,9],"tags":[],"class_list":["post-11257","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-python-modules","category-examples"],"blocksy_meta":[],"_links":{"self":[{"href":"https:\/\/www.askpython.com\/wp-json\/wp\/v2\/posts\/11257","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.askpython.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.askpython.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.askpython.com\/wp-json\/wp\/v2\/users\/20"}],"replies":[{"embeddable":true,"href":"https:\/\/www.askpython.com\/wp-json\/wp\/v2\/comments?post=11257"}],"version-history":[{"count":0,"href":"https:\/\/www.askpython.com\/wp-json\/wp\/v2\/posts\/11257\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.askpython.com\/wp-json\/wp\/v2\/media\/11327"}],"wp:attachment":[{"href":"https:\/\/www.askpython.com\/wp-json\/wp\/v2\/media?parent=11257"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.askpython.com\/wp-json\/wp\/v2\/categories?post=11257"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.askpython.com\/wp-json\/wp\/v2\/tags?post=11257"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}