Deprecate FuzzyInteger in favor of pyint

docs/changelog.rst

@@ -45,6 +45,16 @@ ChangeLog
           - override :class:`~factory.django.DjangoModelFactory._after_postgeneration` to
             :meth:`~django.db.models.Model.save` the instance.
 
+    - :class:`~factory.fuzzy.FuzzyInteger` is deprecated. Use :meth:`~faker.providers.python.Provider.pyint` instead:
+
+      .. code-block:: python
+
+         class PersonFactory(factory.Factory):
+            age = factory.Faker('pyint', min_value=1, max_value=100, step=5)
+
+            class Meta:
+                model = Person
+
 *Removed:*
 
     - Drop support for Django 2.2

docs/conf.py

@@ -84,6 +84,10 @@
         'https://docs.djangoproject.com/en/dev/',
         'https://docs.djangoproject.com/en/dev/_objects/',
     ),
+    'faker': (
+        'https://faker.readthedocs.io/en/master/',
+        'https://faker.readthedocs.io/en/master/objects.inv',
+    ),
     'sqlalchemy': (
         'https://docs.sqlalchemy.org/en/latest/',
         'https://docs.sqlalchemy.org/en/latest/objects.inv',

docs/fuzzy.rst

@@ -92,6 +92,19 @@ FuzzyChoice
 FuzzyInteger
 ------------
 
+.. warning:: This attribute is deprecated.
+
+.. deprecated:: 3.3
+   Use :meth:`~faker.providers.python.Provider.pyint` instead:
+
+   .. code-block:: python
+
+      class PersonFactory(factory.Factory):
+         age = factory.Faker('pyint', min_value=1, max_value=100, step=5)
+
+         class Meta:
+             model = Person
+
 .. class:: FuzzyInteger(low[, high[, step]])
 
     The :class:`FuzzyInteger` fuzzer generates random integers within a given

factory/fuzzy.py

@@ -104,6 +104,11 @@ class FuzzyInteger(BaseFuzzyAttribute):
     """Random integer within a given range."""
 
     def __init__(self, low, high=None, step=1):
+        warnings.warn(
+            f"{self.__class__.__name__} will be removed in the next major version. "
+            "Use Faker.pyint() instead.",
+            DeprecationWarning,
+        )
         if high is None:
             high = low
             low = 0

tests/test_fuzzy.py

@@ -80,6 +80,11 @@ def test_getter(self):
 
 
 class FuzzyIntegerTestCase(unittest.TestCase):
+    def run(self, result=None):
+        with warnings.catch_warnings(record=False):
+            warnings.simplefilter("ignore")
+            return super().run(result=result)
+
     def test_definition(self):
         """Tests all ways of defining a FuzzyInteger."""
         fuzz = fuzzy.FuzzyInteger(2, 3)
@@ -122,6 +127,13 @@ def test_biased_with_step(self):
 
         self.assertEqual((5 + 8 + 1) * 3, res)
 
+    def test_warning(self):
+        with self.assertWarnsRegex(
+            DeprecationWarning,
+            r"^FuzzyInteger will be removed in the next major version. Use Faker.pyint\(\) instead\.$"
+        ):
+            fuzzy.FuzzyInteger(1, 5)
+
 
 class FuzzyDecimalTestCase(unittest.TestCase):
     def test_definition(self):
@@ -589,6 +601,11 @@ def options():
 
 
 class FuzzyRandomTestCase(unittest.TestCase):
+    def run(self, result=None):
+        with warnings.catch_warnings(record=False):
+            warnings.simplefilter("ignore")
+            return super().run(result=result)
+
     def test_seeding(self):
         fuzz = fuzzy.FuzzyInteger(1, 1000)