[Python-checkins] bpo-37819: Add Fraction.as_integer_ratio() (GH-15212)
Raymond Hettinger
webhook-mailer at python.org
Sun Aug 11 17:41:03 EDT 2019
https://github.com/python/cpython/commit/f03b4c8a48f62134799d368b78da35301af466a3
commit: f03b4c8a48f62134799d368b78da35301af466a3
branch: master
author: Raymond Hettinger <rhettinger at users.noreply.github.com>
committer: GitHub <noreply at github.com>
date: 2019-08-11T14:40:59-07:00
summary:
bpo-37819: Add Fraction.as_integer_ratio() (GH-15212)
files:
A Misc/NEWS.d/next/Library/2019-08-11-10-34-19.bpo-37819.LVJls-.rst
M Doc/library/fractions.rst
M Lib/fractions.py
M Lib/test/test_fractions.py
diff --git a/Doc/library/fractions.rst b/Doc/library/fractions.rst
index b5a818e1cafa..58e7126b0bf2 100644
--- a/Doc/library/fractions.rst
+++ b/Doc/library/fractions.rst
@@ -94,6 +94,13 @@ another rational number, or from a string.
Denominator of the Fraction in lowest term.
+ .. method:: as_integer_ratio()
+
+ Return a tuple of two integers, whose ratio is equal
+ to the Fraction and with a positive denominator.
+
+ .. versionadded:: 3.8
+
.. method:: from_float(flt)
This class method constructs a :class:`Fraction` representing the exact
diff --git a/Lib/fractions.py b/Lib/fractions.py
index 7443bd3e0c6a..e774d58e4035 100644
--- a/Lib/fractions.py
+++ b/Lib/fractions.py
@@ -216,6 +216,14 @@ def from_decimal(cls, dec):
(cls.__name__, dec, type(dec).__name__))
return cls(*dec.as_integer_ratio())
+ def as_integer_ratio(self):
+ """Return the integer ratio as a tuple.
+
+ Return a tuple of two integers, whose ratio is equal to the
+ Fraction and with a positive denominator.
+ """
+ return (self._numerator, self._denominator)
+
def limit_denominator(self, max_denominator=1000000):
"""Closest Fraction to self with denominator at most max_denominator.
diff --git a/Lib/test/test_fractions.py b/Lib/test/test_fractions.py
index 277916220051..18ab28cfebe0 100644
--- a/Lib/test/test_fractions.py
+++ b/Lib/test/test_fractions.py
@@ -302,6 +302,12 @@ def testFromDecimal(self):
ValueError, "cannot convert NaN to integer ratio",
F.from_decimal, Decimal("snan"))
+ def test_as_integer_ratio(self):
+ self.assertEqual(F(4, 6).as_integer_ratio(), (2, 3))
+ self.assertEqual(F(-4, 6).as_integer_ratio(), (-2, 3))
+ self.assertEqual(F(4, -6).as_integer_ratio(), (-2, 3))
+ self.assertEqual(F(0, 6).as_integer_ratio(), (0, 1))
+
def testLimitDenominator(self):
rpi = F('3.1415926535897932')
self.assertEqual(rpi.limit_denominator(10000), F(355, 113))
diff --git a/Misc/NEWS.d/next/Library/2019-08-11-10-34-19.bpo-37819.LVJls-.rst b/Misc/NEWS.d/next/Library/2019-08-11-10-34-19.bpo-37819.LVJls-.rst
new file mode 100644
index 000000000000..cfc1f1afb4f7
--- /dev/null
+++ b/Misc/NEWS.d/next/Library/2019-08-11-10-34-19.bpo-37819.LVJls-.rst
@@ -0,0 +1,2 @@
+Add Fraction.as_integer_ratio() to match the corresponding methods in bool,
+int, float, and decimal.
More information about the Python-checkins
mailing list