feat: add e164 parameter to phone_number for E.164 format output

Author: rodrigo.nogueira

mimesis/providers/person.py

@@ -480,23 +480,33 @@ def language(self) -> str:
         languages: list[str] = self._extract(["language"])
         return self.random.choice(languages)
 
-    def phone_number(self, mask: str = "", placeholder: str = "#") -> str:
+    def phone_number(
+        self,
+        mask: str = "",
+        placeholder: str = "#",
+        e164: bool = False,
+    ) -> str:
         """Generates a random phone number.
 
         :param mask: Mask for formatting number.
         :param placeholder: A placeholder for a mask (default is #).
+        :param e164: If True, returns phone number in E.164 format (e.g., +14155552671).
         :return: Phone number.
 
         :Example:
-            +7-(963)-409-11-22.
+            Default: +7-(963)-409-11-22
+            E.164: +79634091122
         """
         if not mask:
             code = self.random.choice(CALLING_CODES)
             default = f"{code}-(###)-###-####"
             masks = self._extract(["telephone_fmt"], default=[default])
             mask = self.random.choice(masks)
 
-        return self.random.generate_string_by_mask(mask=mask, digit=placeholder)
+        result = self.random.generate_string_by_mask(mask=mask, digit=placeholder)
+        if e164:
+            return "+" + "".join(c for c in result if c.isdigit())
+        return result
 
     def telephone(self, *args: t.Any, **kwargs: t.Any) -> str:
         """An alias for :meth:`~.phone_number`."""

tests/test_providers/test_localized/test_person.py

@@ -206,6 +206,27 @@ def test_telephone(self, person):
         head = result.split(" ")[0]
         assert head == "+5"
 
+    def test_telephone_e164(self, _person):
+        result = _person.telephone(e164=True)
+        assert re.match(
+            r"^\+\d+$", result
+        ), f"E.164 format should be +digits, got: {result}"
+        assert len(result) >= 8, "E.164 number should have at least 7 digits plus +"
+
+        mask = "+1 (555)-123-4567"
+        result = _person.telephone(mask=mask, e164=True)
+        assert result == "+15551234567"
+
+        mask_with_separators = "+1-(###)-###-####"
+        result_e164 = _person.telephone(mask=mask_with_separators, e164=True)
+        assert re.match(
+            r"^\+\d+$", result_e164
+        ), f"Should be E.164 format, got: {result_e164}"
+        result_default = _person.telephone(mask=mask_with_separators, e164=False)
+        assert (
+            "-" in result_default or "(" in result_default
+        ), f"Default should have separators: {result_default}"
+
     @pytest.mark.parametrize(
         "gender",
         [
@@ -407,6 +428,7 @@ def test_telephone(self, p1, p2):
         assert p1.telephone(mask="(x)-xx-xxx", placeholder="x") == p2.telephone(
             mask="(x)-xx-xxx", placeholder="x"
         )
+        assert p1.telephone(e164=True) == p2.telephone(e164=True)
 
     def test_surname(self, p1, p2):
         assert p1.surname() == p2.surname()