is_IntegerModRing: Deprecate

sagemath · Oct 1, 2021 · af06e5b · af06e5b
1 parent f596395
commit af06e5b
Showing 1 changed file with 10 additions and 0 deletions.
diff --git a/src/sage/rings/finite_rings/integer_mod_ring.py b/src/sage/rings/finite_rings/integer_mod_ring.py
@@ -244,11 +244,18 @@ def is_IntegerModRing(x):
     """
     Return ``True`` if ``x`` is an integer modulo ring.
 
+    This function is deprecated.  Use :func:`isinstance` with
+    :class:`sage.rings.abc.IntegerModRing` instead.
+
     EXAMPLES::
 
         sage: from sage.rings.finite_rings.integer_mod_ring import is_IntegerModRing
         sage: R = IntegerModRing(17)
         sage: is_IntegerModRing(R)
+        doctest:warning...
+        DeprecationWarning: the function is_IntegerModRing is deprecated.
+        Use isinstance(..., sage.rings.abc.IntegerModRing) instead.
+        See https://trac.sagemath.org/32606 for details.
         True
         sage: is_IntegerModRing(GF(13))
         True
@@ -259,6 +266,9 @@ def is_IntegerModRing(x):
         sage: is_IntegerModRing(ZZ)
         False
     """
+    from sage.misc.superseded import deprecation
+    deprecation(32606, "the function is_IntegerModRing is deprecated. "
+                "Use isinstance(..., sage.rings.abc.IntegerModRing) instead.")
     return isinstance(x, IntegerModRing_generic)