Add xml provider

Co-authored-by: Flavio Curella <89607+fcurella@users.noreply.github.com>
Co-authored-by: elihaybe <elihay@minutemedia.com>

faker/providers/misc/__init__.py

@@ -14,6 +14,7 @@
 from faker.exceptions import UnsupportedFeature
 
 from .. import BaseProvider
+from ..python import TypesSpec
 
 localized = True
 
@@ -613,6 +614,35 @@ def create_json_structure(data_columns: Union[Dict, List]) -> dict:
         data = [create_json_structure(data_columns) for _ in range(num_rows)]
         return json.dumps(data, indent=indent, cls=cls)
 
+    def xml(
+        self,
+        nb_elements: int = 10,
+        variable_nb_elements: bool = True,
+        value_types: Optional[TypesSpec] = None,
+        allowed_types: Optional[TypesSpec] = None,
+    ) -> str:
+        """
+        Returns some XML.
+
+        :nb_elements: number of elements for dictionary
+        :variable_nb_elements: is use variable number of elements for dictionary
+        :value_types: type of dictionary values
+
+        Note: this provider required xmltodict library installed
+        """
+        try:
+            import xmltodict
+        except ImportError:
+            raise UnsupportedFeature("`xml` requires the `xmltodict` Python library.", "xml")
+        _dict = self.generator.pydict(
+            nb_elements=nb_elements,
+            variable_nb_elements=variable_nb_elements,
+            value_types=value_types,
+            allowed_types=allowed_types,
+        )
+        _dict = {self.generator.word(): _dict}
+        return xmltodict.unparse(_dict)
+
     def fixed_width(self, data_columns: Optional[list] = None, num_rows: int = 10, align: str = "left") -> str:
         """
         Generate random fixed width values.

tests/providers/test_misc.py

@@ -7,13 +7,19 @@
 import tarfile
 import unittest
 import uuid
+import xml
 import zipfile
 
 try:
     import PIL.Image
 except ImportError:
     PIL = None
 
+try:
+    import xmltodict
+except ImportError:
+    xmltodict = None
+
 from typing import Pattern
 from unittest.mock import patch
 
@@ -455,6 +461,20 @@ def test_dsv_csvwriter_kwargs(self, faker):
             for args, kwargs in mock_writer.call_args_list:
                 assert kwargs == test_kwargs
 
+    @unittest.skipUnless(xmltodict, "requires the Python xmltodict Library")
+    def test_xml(self, faker):
+        try:
+            xml.etree.ElementTree.fromstring(faker.xml())
+        except xml.etree.ElementTree.ParseError:
+            raise AssertionError("The XML format is invalid.")
+
+    def test_xml_no_xmltodict(self, faker):
+        with patch.dict("sys.modules", {"xmltodict": None}):
+            with pytest.raises(exceptions.UnsupportedFeature) as excinfo:
+                faker.xml()
+
+            assert excinfo.value.name == "xml"
+
     def test_csv_helper_method(self, faker):
         kwargs = {
             "header": ["Column 1", "Column 2"],

tox.ini

@@ -11,6 +11,7 @@ deps =
     validators>=0.13.0
     sphinx>=2.4,<3.0
     Pillow
+    xmltodict
 commands =
     coverage run --source=faker -m pytest {posargs}
     coverage run --source=faker -a -m pytest --exclusive-faker-session tests/pytest/session_overrides {posargs}