René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"as_integer_ratio docstring's","articleBody":"For builtin/stdlib types we have\r\n\r\nint:\r\n```\r\n    Return integer ratio.\r\n\r\n    Return a pair of integers, whose ratio is exactly equal to the original int\r\n    and with a positive denominator.\r\n```\r\nFraction:\r\n```\r\nas_integer_ratio(self)\r\n    Return the integer ratio as a tuple.\r\n\r\n    Return a tuple of two integers, whose ratio is equal to the\r\n    Fraction and with a positive denominator.\r\n```\r\nfloat:\r\n```\r\n    Return integer ratio.\r\n\r\n    Return a pair of integers, whose ratio is exactly equal to the original float\r\n    and with a positive denominator.\r\n```\r\nDecimal:\r\n```\r\n    Return a pair of integers, whose ratio is exactly equal to the original\r\n    Decimal and with a positive denominator. The ratio is in lowest terms.\r\n    Raise OverflowError on infinities and a ValueError on NaNs.\r\n```\r\n\r\nAll methods actually return a pair, whose ratio is in lowest terms, but only the last docstring says this explicitly.  Shouldn't other methods do same?  (Taken from [this](https://github.com/python/cpython/pull/101780#issuecomment-1426699906).)\r\n\r\nEdit: Ditto for some sphinx docs, e.g. for the float.as_integer_ratio(): \"Return a pair of integers whose ratio is exactly equal to the original float and with a positive denominator. Raises OverflowError on infinities and a ValueError on NaNs.\"\n\n\u003c!-- gh-linked-prs --\u003e\n### Linked PRs\n* gh-101843\n\u003c!-- /gh-linked-prs --\u003e\n","author":{"url":"https://github.com/skirpichev","@type":"Person","name":"skirpichev"},"datePublished":"2023-02-11T11:28:01.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":1},"url":"https://github.com/101825/cpython/issues/101825"}