Mailman 3 June 2008 - Python-checkins

r64561 - python/trunk/Doc/library/fractions.rst
by mark.dickinson 27 Jun '08

27 Jun '08

Author: mark.dickinson Date: Fri Jun 27 18:49:27 2008 New Revision: 64561 Log: Issue #3197: rework documentation for fractions module. Modified: python/trunk/Doc/library/fractions.rst Modified: python/trunk/Doc/library/fractions.rst ============================================================================== --- python/trunk/Doc/library/fractions.rst (original) +++ python/trunk/Doc/library/fractions.rst Fri Jun 27 18:49:27 2008 @@ -9,38 +9,74 @@ .. versionadded:: 2.6 -The :mod:`fractions` module defines an immutable, infinite-precision -Fraction number class. +The :mod:`fractions` module provides support for rational number arithmetic. +A Fraction instance can be constructed from a pair of integers, from +another rational number, or from a string. + .. class:: Fraction(numerator=0, denominator=1) Fraction(other_fraction) Fraction(string) The first version requires that *numerator* and *denominator* are instances of :class:`numbers.Integral` and returns a new - ``Fraction`` representing ``numerator/denominator``. If - *denominator* is :const:`0`, raises a :exc:`ZeroDivisionError`. The - second version requires that *other_fraction* is an instance of - :class:`numbers.Rational` and returns an instance of - :class:`Fraction` with the same value. The third version expects a - string of the form ``[-+]?[0-9]+(/[0-9]+)?``, optionally surrounded - by spaces. - - Implements all of the methods and operations from - :class:`numbers.Rational` and is immutable and hashable. + :class:`Fraction` instance with value ``numerator/denominator``. If + *denominator* is :const:`0`, it raises a + :exc:`ZeroDivisionError`. The second version requires that + *other_fraction* is an instance of :class:`numbers.Rational` and + returns an :class:`Fraction` instance with the same value. The + last version of the constructor expects a string or unicode + instance in one of two possible forms. The first form is:: + + [sign] numerator ['/' denominator] + + where the optional ``sign`` may be either '+' or '-' and + ``numerator`` and ``denominator`` (if present) are strings of + decimal digits. The second permitted form is that of a number + containing a decimal point:: + + [sign] integer '.' [fraction] | [sign] '.' fraction + + where ``integer`` and ``fraction`` are strings of digits. In + either form the input string may also have leading and/or trailing + whitespace. Here are some examples:: + + >>> from fractions import Fraction + >>> Fraction(16, -10) + Fraction(-8, 5) + >>> Fraction(123) + Fraction(123, 1) + >>> Fraction() + Fraction(0, 1) + >>> Fraction('3/7') + Fraction(3, 7) + [40794 refs] + >>> Fraction(' -3/7 ') + Fraction(-3, 7) + >>> Fraction('1.414213 \t\n') + Fraction(1414213, 1000000) + >>> Fraction('-.125') + Fraction(-1, 8) + + + The :class:`Fraction` class inherits from the abstract base class + :class:`numbers.Rational`, and implements all of the methods and + operations from that class. :class:`Fraction` instances are hashable, + and should be treated as immutable. In addition, + :class:`Fraction` has the following methods: .. method:: from_float(flt) - This classmethod constructs a :class:`Fraction` representing the exact + This class method constructs a :class:`Fraction` representing the exact value of *flt*, which must be a :class:`float`. Beware that ``Fraction.from_float(0.3)`` is not the same value as ``Fraction(3, 10)`` .. method:: from_decimal(dec) - This classmethod constructs a :class:`Fraction` representing the exact + This class method constructs a :class:`Fraction` representing the exact value of *dec*, which must be a :class:`decimal.Decimal`. @@ -52,34 +88,24 @@ >>> from fractions import Fraction >>> Fraction('3.1415926535897932').limit_denominator(1000) - Fraction(355L, 113L) + Fraction(355, 113) or for recovering a rational number that's represented as a float: >>> from math import pi, cos >>> Fraction.from_float(cos(pi/3)) - Fraction(4503599627370497L, 9007199254740992L) + Fraction(4503599627370497, 9007199254740992) >>> Fraction.from_float(cos(pi/3)).limit_denominator() - Fraction(1L, 2L) - - - .. method:: __floor__() - - Returns the greatest :class:`int` ``<= self``. - - - .. method:: __ceil__() - - Returns the least :class:`int` ``>= self``. + Fraction(1, 2) - .. method:: __round__() - __round__(ndigits) +.. function:: gcd(a, b) - The first version returns the nearest :class:`int` to ``self``, rounding - half to even. The second version rounds ``self`` to the nearest multiple - of ``Fraction(1, 10**ndigits)`` (logically, if ``ndigits`` is negative), - again rounding half toward even. + Return the greatest common divisor of the integers `a` and `b`. If + either `a` or `b` is nonzero, then the absolute value of `gcd(a, + b)` is the largest integer that divides both `a` and `b`. `gcd(a,b)` + has the same sign as `b` if `b` is nonzero; otherwise it takes the sign + of `a`. `gcd(0, 0)` returns `0`. .. seealso::

1 0

r64559 - doctools/trunk/sphinx/ext/autodoc.py
by armin.ronacher 27 Jun '08

27 Jun '08

Author: armin.ronacher Date: Fri Jun 27 14:07:30 2008 New Revision: 64559 Log: Constructors that are callables but not python functions fail silently now on documentation. Modified: doctools/trunk/sphinx/ext/autodoc.py Modified: doctools/trunk/sphinx/ext/autodoc.py ============================================================================== --- doctools/trunk/sphinx/ext/autodoc.py (original) +++ doctools/trunk/sphinx/ext/autodoc.py Fri Jun 27 14:07:30 2008 @@ -242,7 +242,8 @@ # for classes, the relevant signature is the __init__ method's obj = getattr(obj, '__init__', None) # classes without __init__ method? - if obj is None or obj is object.__init__: + if obj is None or obj is object.__init__ or not \ + (inspect.ismethod(obj) or inspect.isfunction(obj)): return '' argspec = inspect.getargspec(obj) if what in ('class', 'method') and argspec[0] and \

1 0

buildbot failure in x86 XP-3 trunk
by buildbot＠python.org 27 Jun '08

27 Jun '08

The Buildbot has detected a new failure of x86 XP-3 trunk. Full details are available at: http://www.python.org/dev/buildbot/all/x86%20XP-3%20trunk/builds/1652 Buildbot URL: http://www.python.org/dev/buildbot/all/ Buildslave for this Build: heller-windows Build Reason: Build Source Stamp: [branch trunk] HEAD Blamelist: mark.dickinson BUILD FAILED: failed svn sincerely, -The Buildbot

1 0

buildbot failure in g4 osx.4 trunk
by buildbot＠python.org 27 Jun '08

27 Jun '08

The Buildbot has detected a new failure of g4 osx.4 trunk. Full details are available at: http://www.python.org/dev/buildbot/all/g4%20osx.4%20trunk/builds/3630 Buildbot URL: http://www.python.org/dev/buildbot/all/ Buildslave for this Build: psf-g4 Build Reason: Build Source Stamp: [branch trunk] HEAD Blamelist: mark.dickinson BUILD FAILED: failed test Excerpt from the test logfile: 1 test failed: test_cmath make: *** [buildbottest] Error 1 sincerely, -The Buildbot

1 0

buildbot failure in AMD64 W2k8 trunk
by buildbot＠python.org 27 Jun '08

27 Jun '08

The Buildbot has detected a new failure of AMD64 W2k8 trunk. Full details are available at: http://www.python.org/dev/buildbot/all/AMD64%20W2k8%20trunk/builds/698 Buildbot URL: http://www.python.org/dev/buildbot/all/ Buildslave for this Build: nelson-win64 Build Reason: Build Source Stamp: [branch trunk] HEAD Blamelist: mark.dickinson BUILD FAILED: failed test Excerpt from the test logfile: 4 tests failed: test_bsddb3 test_subprocess test_sys test_wsgiref ====================================================================== FAIL: testEnviron (test.test_wsgiref.HandlerTests) ---------------------------------------------------------------------- Traceback (most recent call last): File "S:\buildbots\python.x64\trunk.nelson-win64\build\lib\test\test_wsgiref.py", line 437, in testEnviron self.checkOSEnviron(h) File "S:\buildbots\python.x64\trunk.nelson-win64\build\lib\test\test_wsgiref.py", line 429, in checkOSEnviron self.assertEqual(env[k],v) AssertionError: u'C:\\Program Files (x86)\\Microsoft Visual Studio 9.0\\VC\\BIN\\amd64;C:\\Windows\\Microsoft.NET\\Framework64\\v3.5;C:\\Windows\\Microsoft.NET\\Framework64\\v3.5\\Microsoft .NET Framework 3.5 (Pre-Release Version);C:\\Windows\\Microsoft.NET\\Framework64\\v2.0.50727;C:\\Program Files (x86)\\Microsoft Visual Studio 9.0\\VC\\VCPackages;C:\\Program Files (x86)\\Microsoft Visual Studio 9.0\\Common7\\IDE;C:\\Program Files (x86)\\Microsoft Visual Studio 9.0\\Common7\\Tools;C:\\Program Files (x86)\\Microsoft Visual Studio 9.0\\Common7\\Tools\\bin;C:\\Program Files\\Microsoft SDKs\\Windows\\v6.1\\bin\\x64;C:\\Program Files\\Microsoft SDKs\\Windows\\v6.1\\bin\\win64\\x64;C:\\Program Files\\Microsoft SDKs\\Windows\\v6.1\\bin;C:\\tools;C:\\Perl64\\site\\bin;C:\\Perl64\\bin;C:\\Python25;C:\\Python25\\Scripts;C:\\Windows\\system32;C:\\Windows;C:\\Windows\\System32\\Wbem;c:\\Program Files (x86)\\Microsoft SQL Server\\90\\Tools\\binn;C:\\Program Files (x86)\\Subversion\\bin;C:\\Windows\\System32\\WindowsPowerShell\\v1.0;C:\\Windows\\idmu\\common;.;..\\..\\tcltk64\\bin' != 'C:\\tools;C:\\Perl64\\site\\bin;C:\\Perl64\\bin;C:\\Python25\\;C:\\Python25\\Scripts;C:\\Windows\\system32;C:\\Windows;C:\\Windows\\System32\\Wbem;c:\\Program Files (x86)\\Microsoft SQL Server\\90\\Tools\\binn\\;C:\\Program Files (x86)\\Subversion\\bin;C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\;C:\\Windows\\idmu\\common;;..\\..\\tcltk64\\bin' ====================================================================== FAIL: test_simple_validation_error (test.test_wsgiref.IntegrationTests) ---------------------------------------------------------------------- Traceback (most recent call last): File "S:\buildbots\python.x64\trunk.nelson-win64\build\lib\test\test_wsgiref.py", line 157, in test_simple_validation_error "AssertionError: Headers (('Content-Type', 'text/plain')) must" AssertionError: "AssertionError: Environmental variable LIB is not a string: <type 'unicode'> (value: u'C:\\\\Program Files (x86)\\\\Microsoft Visual Studio 9.0\\\\VC\\\\ATLMFC\\\\LIB\\\\amd64;C:\\\\Program Files (x86)\\\\Microsoft Visual Studio 9.0\\\\VC\\\\LIB\\\\amd64;C:\\\\Program Files\\\\Microsoft SDKs\\\\Windows\\\\v6.1\\\\lib\\\\x64')" != "AssertionError: Headers (('Content-Type', 'text/plain')) must be of type list: <type 'tuple'>" ====================================================================== FAIL: test_validated_hello (test.test_wsgiref.IntegrationTests) ---------------------------------------------------------------------- Traceback (most recent call last): File "S:\buildbots\python.x64\trunk.nelson-win64\build\lib\test\test_wsgiref.py", line 145, in test_validated_hello self.check_hello(out, has_length=False) File "S:\buildbots\python.x64\trunk.nelson-win64\build\lib\test\test_wsgiref.py", line 134, in check_hello "\r\n" AssertionError: 'HTTP/1.0 500 Dude, this is whack!\r\nDate: Fri, 27 Jun 2008 11:01:12 GMT\r\nServer: WSGIServer/0.1 Python/2.6b1+\r\nContent-Type: text/plain\r\nContent-Length: 59\r\n\r\nA server error occurred. Please contact the administrator.' != 'HTTP/1.0 200 OK\r\nServer: WSGIServer/0.1 Python/2.6b1+\r\nContent-Type: text/plain\r\nDate: Mon, 05 Jun 2006 18:49:54 GMT\r\n\r\nHello, world!' sincerely, -The Buildbot

1 0

r64558 - python/trunk/Misc/ACKS
by mark.dickinson 27 Jun '08

27 Jun '08

Author: mark.dickinson Date: Fri Jun 27 13:03:21 2008 New Revision: 64558 Log: Add Jean Brouwers for his work on math.sum Modified: python/trunk/Misc/ACKS Modified: python/trunk/Misc/ACKS ============================================================================== --- python/trunk/Misc/ACKS (original) +++ python/trunk/Misc/ACKS Fri Jun 27 13:03:21 2008 @@ -88,6 +88,7 @@ Tom Bridgman Richard Brodie Daniel Brotsky +Jean Brouwers Gary S. Brown Oleg Broytmann Dave Brueck

1 0

buildbot failure in x86 osx.5 trunk
by buildbot＠python.org 27 Jun '08

27 Jun '08

The Buildbot has detected a new failure of x86 osx.5 trunk. Full details are available at: http://www.python.org/dev/buildbot/all/x86%20osx.5%20trunk/builds/541 Buildbot URL: http://www.python.org/dev/buildbot/all/ Buildslave for this Build: heller-x86-osx5 Build Reason: Build Source Stamp: [branch trunk] HEAD Blamelist: mark.dickinson BUILD FAILED: failed test Excerpt from the test logfile: sincerely, -The Buildbot

1 0

r64557 - in python/trunk/Lib: fractions.py test/test_fractions.py
by mark.dickinson 27 Jun '08

27 Jun '08

Author: mark.dickinson Date: Fri Jun 27 12:11:52 2008 New Revision: 64557 Log: Remove trailing 'L's from numerator and denominator in the repr() of a Fraction instance. Modified: python/trunk/Lib/fractions.py python/trunk/Lib/test/test_fractions.py Modified: python/trunk/Lib/fractions.py ============================================================================== --- python/trunk/Lib/fractions.py (original) +++ python/trunk/Lib/fractions.py Fri Jun 27 12:11:52 2008 @@ -203,7 +203,7 @@ def __repr__(self): """repr(self)""" - return ('Fraction(%r, %r)' % (self._numerator, self._denominator)) + return ('Fraction(%s, %s)' % (self._numerator, self._denominator)) def __str__(self): """str(self)""" Modified: python/trunk/Lib/test/test_fractions.py ============================================================================== --- python/trunk/Lib/test/test_fractions.py (original) +++ python/trunk/Lib/test/test_fractions.py Fri Jun 27 12:11:52 2008 @@ -351,6 +351,10 @@ def testStringification(self): self.assertEquals("Fraction(7, 3)", repr(F(7, 3))) + self.assertEquals("Fraction(6283185307, 2000000000)", + repr(F('3.1415926535'))) + self.assertEquals("Fraction(-1, 100000000000000000000)", + repr(F(1, -10**20))) self.assertEquals("7/3", str(F(7, 3))) self.assertEquals("7", str(F(7, 1)))

1 0

buildbot failure in g4 osx.4 3.0
by buildbot＠python.org 26 Jun '08

26 Jun '08

The Buildbot has detected a new failure of g4 osx.4 3.0. Full details are available at: http://www.python.org/dev/buildbot/all/g4%20osx.4%203.0/builds/1053 Buildbot URL: http://www.python.org/dev/buildbot/all/ Buildslave for this Build: psf-g4 Build Reason: Build Source Stamp: [branch branches/py3k] HEAD Blamelist: trent.nelson BUILD FAILED: failed test Excerpt from the test logfile: 1 test failed: test_urllib2 ====================================================================== ERROR: test_badly_named_methods (test.test_urllib2.OpenerDirectorTests) ---------------------------------------------------------------------- Traceback (most recent call last): File "/Users/buildslave/bb/3.0.psf-g4/build/Lib/test/test_urllib2.py", line 408, in test_badly_named_methods self.assertRaises(URLError, o.open, scheme+"://example.com/") File "/Users/buildslave/bb/3.0.psf-g4/build/Lib/unittest.py", line 311, in failUnlessRaises callableObj(*args, **kwargs) File "/Users/buildslave/bb/3.0.psf-g4/build/Lib/urllib/request.py", line 352, in open response = self._open(req, data) File "/Users/buildslave/bb/3.0.psf-g4/build/Lib/urllib/request.py", line 375, in _open 'unknown_open', req) File "/Users/buildslave/bb/3.0.psf-g4/build/Lib/urllib/request.py", line 330, in _call_chain result = func(*args) File "/Users/buildslave/bb/3.0.psf-g4/build/Lib/urllib/request.py", line 1100, in unknown_open raise urllib.error.URLError('unknown url type: %s' % type) urllib.error.URLError: <urlopen error unknown url type: do> make: *** [buildbottest] Error 1 sincerely, -The Buildbot

1 0

buildbot failure in S-390 Debian 3.0
by buildbot＠python.org 26 Jun '08

26 Jun '08

The Buildbot has detected a new failure of S-390 Debian 3.0. Full details are available at: http://www.python.org/dev/buildbot/all/S-390%20Debian%203.0/builds/550 Buildbot URL: http://www.python.org/dev/buildbot/all/ Buildslave for this Build: klose-debian-s390 Build Reason: Build Source Stamp: [branch branches/py3k] HEAD Blamelist: trent.nelson BUILD FAILED: failed test Excerpt from the test logfile: 1 test failed: test_funcattrs make: *** [buildbottest] Error 1 sincerely, -The Buildbot

1 0