bpo-33073: Adding as_integer_ratio to ints.

Doc/library/stdtypes.rst

@@ -539,6 +539,14 @@ class`. In addition, it provides a few more methods:
 
     .. versionadded:: 3.2
 
+.. method:: int.as_integer_ratio()
+
+   Return a pair of integers whose ratio is exactly equal to the original
+   integer and with a positive denominator. The integer ratio of integers
+   (whole numbers) is always the integer as the numerator and 1 as the
+   denominator.
+
+   .. versionadded:: 3.8
 
 Additional Methods on Float
 ---------------------------
@@ -4734,4 +4742,3 @@ types, where they are relevant.  Some of these are not reported by the
 
 .. [5] To format only a tuple you should therefore provide a singleton tuple whose only
    element is the tuple to be formatted.
-

Doc/whatsnew/3.8.rst

@@ -94,6 +94,10 @@ Other Language Changes
 * Added support of ``\N{name}`` escapes in :mod:`regular expressions <re>`.
   (Contributed by Jonathan Eunice and Serhiy Storchaka in :issue:`30688`.)
 
+* The ``int`` type now has a new ``as_integer_ratio`` method compatible
+  with the existing ``float.as_integer_ratio`` method.
+  (Contributed by Lisa Roach in :issue:`33073`.)
+
 
 New Modules
 ===========

Lib/test/test_doctest.py

@@ -665,7 +665,7 @@ def non_Python_modules(): r"""
     True
     >>> real_tests = [t for t in tests if len(t.examples) > 0]
     >>> len(real_tests) # objects that actually have doctests
-    8
+    9
     >>> for t in real_tests:
     ...     print('{}  {}'.format(len(t.examples), t.name))
     ...
@@ -675,6 +675,7 @@ def non_Python_modules(): r"""
     2  builtins.float.hex
     1  builtins.hex
     1  builtins.int
+    4  builtins.int.as_integer_ratio
     2  builtins.int.bit_length
     1  builtins.oct
 

Lib/test/test_long.py

@@ -1349,6 +1349,11 @@ def test_shift_bool(self):
                 self.assertEqual(type(value << shift), int)
                 self.assertEqual(type(value >> shift), int)
 
+    def test_as_integer_ratio(self):
+        tests = [10, 0, -10, 1, 3]
+        for value in tests:
+            self.assertEqual(value.as_integer_ratio(), (value, 1))
+
 
 if __name__ == "__main__":
     unittest.main()

Misc/ACKS

@@ -1347,6 +1347,7 @@ Juan M. Bello Rivas
 Mohd Sanad Zaki Rizvi
 Davide Rizzo
 Anthony Roach
+Lisa Roach
 Carl Robben
 Ben Roberts
 Mark Roberts

Misc/NEWS.d/next/Core and Builtins/2018-08-12-16-03-58.bpo-33073.XWu1Jh.rst

@@ -0,0 +1 @@
+Added as_integer_ratio to ints to make them more interoperable with floats.

Objects/longobject.c

@@ -5260,6 +5260,31 @@ long_is_finite(PyObject *v)
 }
 #endif
 
+/*[clinic input]
+int.as_integer_ratio
+
+Return integer ratio.
+
+Return a pair of integers, whose ratio is exactly equal to the original int
+and with a positive denominator.
+
+>>> (10).as_integer_ratio()
+(10, 1)
+>>> (0).as_integer_ratio()
+(0, 1)
+>>> (11).as_integer_ratio()
+(11, 1)
+>>> (-10).as_integer_ratio()
+(-10, 1)
+[clinic start generated code]*/
+
+static PyObject *
+int_as_integer_ratio_impl(PyObject *self)
+/*[clinic end generated code: output=e60803ae1cc8621a input=c1aea0aa6fb85c28]*/
+{
+    return PyTuple_Pack(2, self, _PyLong_One);
+}
+
 /*[clinic input]
 int.to_bytes
 
@@ -5392,6 +5417,7 @@ static PyMethodDef long_methods[] = {
 #endif
     INT_TO_BYTES_METHODDEF
     INT_FROM_BYTES_METHODDEF
+    INT_AS_INTEGER_RATIO_METHODDEF
     {"__trunc__",       long_long_meth, METH_NOARGS,
      "Truncating an Integral returns itself."},
     {"__floor__",       long_long_meth, METH_NOARGS,