Mailman 3 October 2010 - Python-checkins

r85987 - python/branches/py3k/Lib/test/test_os.py
by brian.curtin Nov. 4, 2010

Nov. 4, 2010

Author: brian.curtin Date: Sat Oct 30 23:24:21 2010 New Revision: 85987 Log: Fix #10257. Clear resource warnings by using os.popen's context manager. Modified: python/branches/py3k/Lib/test/test_os.py Modified: python/branches/py3k/Lib/test/test_os.py ============================================================================== --- python/branches/py3k/Lib/test/test_os.py (original) +++ python/branches/py3k/Lib/test/test_os.py Sat Oct 30 23:24:21 2010 @@ -406,17 +406,19 @@ os.environ.clear() if os.path.exists("/bin/sh"): os.environ.update(HELLO="World") - value = os.popen("/bin/sh -c 'echo $HELLO'").read().strip() - self.assertEquals(value, "World") + with os.popen("/bin/sh -c 'echo $HELLO'") as popen: + value = popen.read().strip() + self.assertEquals(value, "World") def test_os_popen_iter(self): if os.path.exists("/bin/sh"): - popen = os.popen("/bin/sh -c 'echo \"line1\nline2\nline3\"'") - it = iter(popen) - self.assertEquals(next(it), "line1\n") - self.assertEquals(next(it), "line2\n") - self.assertEquals(next(it), "line3\n") - self.assertRaises(StopIteration, next, it) + with os.popen( + "/bin/sh -c 'echo \"line1\nline2\nline3\"'") as popen: + it = iter(popen) + self.assertEquals(next(it), "line1\n") + self.assertEquals(next(it), "line2\n") + self.assertEquals(next(it), "line3\n") + self.assertRaises(StopIteration, next, it) # Verify environ keys and values from the OS are of the # correct str type.

3 3

r86074 - python/branches/release31-maint/Doc/glossary.rst
by raymond.hettinger Oct. 31, 2010

Oct. 31, 2010

Author: raymond.hettinger Date: Sun Oct 31 23:39:33 2010 New Revision: 86074 Log: Issue #9886: Add a key-function entry to the glossary. Modified: python/branches/release31-maint/Doc/glossary.rst Modified: python/branches/release31-maint/Doc/glossary.rst ============================================================================== --- python/branches/release31-maint/Doc/glossary.rst (original) +++ python/branches/release31-maint/Doc/glossary.rst Sun Oct 31 23:39:33 2010 @@ -283,6 +283,26 @@ instances of user-defined classes are hashable by default; they all compare unequal, and their hash value is their :func:`id`. + key function + A key function or collation function is a callable that returns a value + used for sorting or ordering. For example, :func:`locale.strxfrm` is + used to produce a sort key that is aware of locale specific sort + conventions. + + A number of tools in Python accept key functions to control how elements + are ordered or grouped. They include :func:`min`, :func:`max`, + :func:`sorted`, :meth:`list.sort`, :func:`heapq.nsmallest`, + :func:`heapq.nlargest`, and :func:`itertools.groupby`. + + There are several ways to create a key function. For example. the + :meth:`str.lower` method can serve as a key function for case insensitive + sorts. Alternatively, an ad-hoc key function can be built from a + :keyword:`lambda` expression such as ``lambda r: (r[0], r[2])``. Also, + the :mod:`operator` module provides three key function constuctors: + :func:`~operator.attrgetter`, :func:`~operator.itemgetter`, and + :func:`~operator.methodcaller`. See the :ref:`Sorting HOW TO` for + examples of how to create and use key functions. + IDLE An Integrated Development Environment for Python. IDLE is a basic editor and interpreter environment which ships with the standard distribution of

1 0

r86073 - python/branches/py3k/Doc/glossary.rst
by raymond.hettinger Oct. 31, 2010

Oct. 31, 2010

Author: raymond.hettinger Date: Sun Oct 31 23:36:06 2010 New Revision: 86073 Log: Issue #9886: Add a key-function entry to the glossary. Modified: python/branches/py3k/Doc/glossary.rst Modified: python/branches/py3k/Doc/glossary.rst ============================================================================== --- python/branches/py3k/Doc/glossary.rst (original) +++ python/branches/py3k/Doc/glossary.rst Sun Oct 31 23:36:06 2010 @@ -288,6 +288,26 @@ instances of user-defined classes are hashable by default; they all compare unequal, and their hash value is their :func:`id`. + key function + A key function or collation function is a callable that returns a value + used for sorting or ordering. For example, :func:`locale.strxfrm` is + used to produce a sort key that is aware of locale specific sort + conventions. + + A number of tools in Python accept key functions to control how elements + are ordered or grouped. They include :func:`min`, :func:`max`, + :func:`sorted`, :meth:`list.sort`, :func:`heapq.nsmallest`, + :func:`heapq.nlargest`, and :func:`itertools.groupby`. + + There are several ways to create a key function. For example. the + :meth:`str.lower` method can serve as a key function for case insensitive + sorts. Alternatively, an ad-hoc key function can be built from a + :keyword:`lambda` expression such as ``lambda r: (r[0], r[2])``. Also, + the :mod:`operator` module provides three key function constuctors: + :func:`~operator.attrgetter`, :func:`~operator.itemgetter`, and + :func:`~operator.methodcaller`. See the :ref:`Sorting HOW TO` for + examples of how to create and use key functions. + IDLE An Integrated Development Environment for Python. IDLE is a basic editor and interpreter environment which ships with the standard distribution of

1 0

r86072 - python/branches/release31-maint/Doc/howto/doanddont.rst
by raymond.hettinger Oct. 31, 2010

Oct. 31, 2010

Author: raymond.hettinger Date: Sun Oct 31 23:01:57 2010 New Revision: 86072 Log: Issue 7402: Improve reduce() example in the python idioms how-to. Modified: python/branches/release31-maint/Doc/howto/doanddont.rst Modified: python/branches/release31-maint/Doc/howto/doanddont.rst ============================================================================== --- python/branches/release31-maint/Doc/howto/doanddont.rst (original) +++ python/branches/release31-maint/Doc/howto/doanddont.rst Sun Oct 31 23:01:57 2010 @@ -244,24 +244,22 @@ More useful functions in :mod:`os.path`: :func:`basename`, :func:`dirname` and :func:`splitext`. -There are also many useful built-in functions people seem not to be aware of for -some reason: :func:`min` and :func:`max` can find the minimum/maximum of any -sequence with comparable semantics, for example, yet many people write their own -:func:`max`/:func:`min`. Another highly useful function is -:func:`functools.reduce`. A classical use of :func:`reduce` is something like -:: - - import sys, operator, functools - nums = list(map(float, sys.argv[1:])) - print(functools.reduce(operator.add, nums) / len(nums)) - -This cute little script prints the average of all numbers given on the command -line. The :func:`reduce` adds up all the numbers, and the rest is just some -pre- and postprocessing. - -On the same note, note that :func:`float` and :func:`int` accept arguments of -type string, and so are suited to parsing --- assuming you are ready to deal -with the :exc:`ValueError` they raise. +There are also many useful built-in functions people seem not to be aware of +for some reason: :func:`min` and :func:`max` can find the minimum/maximum of +any sequence with comparable semantics, for example, yet many people write +their own :func:`max`/:func:`min`. Another highly useful function is +:func:`functools.reduce` which can be used to repeatly apply a binary +operation to a sequence, reducing it to a single value. For example, compute +a factorial with a series of multiply operations:: + + >>> n = 4 + >>> import operator, functools + >>> functools.reduce(operator.mul, range(1, n+1)) + 24 + +When it comes to parsing numbers, note that :func:`float`, :func:`int` and +:func:`long` all accept string arguments and will reject ill-formed strings +by raising an :exc:`ValueError`. Using Backslash to Continue Statements

1 0

r86071 - python/branches/py3k/Doc/howto/doanddont.rst
by raymond.hettinger Oct. 31, 2010

Oct. 31, 2010

Author: raymond.hettinger Date: Sun Oct 31 23:00:50 2010 New Revision: 86071 Log: Issue 7402: Improve reduce() example in the python idioms how-to. Modified: python/branches/py3k/Doc/howto/doanddont.rst Modified: python/branches/py3k/Doc/howto/doanddont.rst ============================================================================== --- python/branches/py3k/Doc/howto/doanddont.rst (original) +++ python/branches/py3k/Doc/howto/doanddont.rst Sun Oct 31 23:00:50 2010 @@ -244,24 +244,22 @@ More useful functions in :mod:`os.path`: :func:`basename`, :func:`dirname` and :func:`splitext`. -There are also many useful built-in functions people seem not to be aware of for -some reason: :func:`min` and :func:`max` can find the minimum/maximum of any -sequence with comparable semantics, for example, yet many people write their own -:func:`max`/:func:`min`. Another highly useful function is -:func:`functools.reduce`. A classical use of :func:`reduce` is something like -:: - - import sys, operator, functools - nums = list(map(float, sys.argv[1:])) - print(functools.reduce(operator.add, nums) / len(nums)) - -This cute little script prints the average of all numbers given on the command -line. The :func:`reduce` adds up all the numbers, and the rest is just some -pre- and postprocessing. - -On the same note, note that :func:`float` and :func:`int` accept arguments of -type string, and so are suited to parsing --- assuming you are ready to deal -with the :exc:`ValueError` they raise. +There are also many useful built-in functions people seem not to be aware of +for some reason: :func:`min` and :func:`max` can find the minimum/maximum of +any sequence with comparable semantics, for example, yet many people write +their own :func:`max`/:func:`min`. Another highly useful function is +:func:`functools.reduce` which can be used to repeatly apply a binary +operation to a sequence, reducing it to a single value. For example, compute +a factorial with a series of multiply operations:: + + >>> n = 4 + >>> import operator, functools + >>> functools.reduce(operator.mul, range(1, n+1)) + 24 + +When it comes to parsing numbers, note that :func:`float`, :func:`int` and +:func:`long` all accept string arguments and will reject ill-formed strings +by raising an :exc:`ValueError`. Using Backslash to Continue Statements

1 0

r86070 - python/branches/release27-maint/Doc/howto/doanddont.rst
by raymond.hettinger Oct. 31, 2010

Oct. 31, 2010

Author: raymond.hettinger Date: Sun Oct 31 23:00:27 2010 New Revision: 86070 Log: Issue 7402: Improve reduce() example in the python idioms how-to. Modified: python/branches/release27-maint/Doc/howto/doanddont.rst Modified: python/branches/release27-maint/Doc/howto/doanddont.rst ============================================================================== --- python/branches/release27-maint/Doc/howto/doanddont.rst (original) +++ python/branches/release27-maint/Doc/howto/doanddont.rst Sun Oct 31 23:00:27 2010 @@ -281,23 +281,22 @@ More useful functions in :mod:`os.path`: :func:`basename`, :func:`dirname` and :func:`splitext`. -There are also many useful built-in functions people seem not to be aware of for -some reason: :func:`min` and :func:`max` can find the minimum/maximum of any -sequence with comparable semantics, for example, yet many people write their own -:func:`max`/:func:`min`. Another highly useful function is :func:`reduce`. A -classical use of :func:`reduce` is something like :: - - import sys, operator - nums = map(float, sys.argv[1:]) - print reduce(operator.add, nums)/len(nums) - -This cute little script prints the average of all numbers given on the command -line. The :func:`reduce` adds up all the numbers, and the rest is just some -pre- and postprocessing. - -On the same note, note that :func:`float`, :func:`int` and :func:`long` all -accept arguments of type string, and so are suited to parsing --- assuming you -are ready to deal with the :exc:`ValueError` they raise. +There are also many useful built-in functions people seem not to be aware of +for some reason: :func:`min` and :func:`max` can find the minimum/maximum of +any sequence with comparable semantics, for example, yet many people write +their own :func:`max`/:func:`min`. Another highly useful function is +:func:`reduce` which can be used to repeatly apply a binary operation to a +sequence, reducing it to a single value. For example, compute a factorial +with a series of multiply operations:: + + >>> n = 4 + >>> import operator + >>> reduce(operator.mul, range(1, n+1)) + 24 + +When it comes to parsing numbers, note that :func:`float`, :func:`int` and +:func:`long` all accept string arguments and will reject ill-formed strings +by raising an :exc:`ValueError`. Using Backslash to Continue Statements

1 0

r86066 - python/branches/py3k/Doc/library/functions.rst
by raymond.hettinger Oct. 31, 2010

Oct. 31, 2010

Author: raymond.hettinger Date: Sun Oct 31 22:23:24 2010 New Revision: 86066 Log: Issue 7447: Improve docs for sum(). Modified: python/branches/py3k/Doc/library/functions.rst Modified: python/branches/py3k/Doc/library/functions.rst ============================================================================== --- python/branches/py3k/Doc/library/functions.rst (original) +++ python/branches/py3k/Doc/library/functions.rst Sun Oct 31 22:23:24 2010 @@ -1115,10 +1115,13 @@ Sums *start* and the items of an *iterable* from left to right and returns the total. *start* defaults to ``0``. The *iterable*'s items are normally numbers, - and are not allowed to be strings. The fast, correct way to concatenate a - sequence of strings is by calling ``''.join(sequence)``. To add floating - point values with extended precision, see :func:`math.fsum`\. + and the start value is not allowed to be a string. + For some use cases, there a good alternatives to :func:`sum`. + The preferred, fast way to concatenate a sequence of strings is by calling + ``''.join(sequence)``. To add floating point values with extended precision, + see :func:`math.fsum`\. To concatenate a series of iterables, consider using + :func:`itertools.chain`. .. function:: super([type[, object-or-type]])

2 1

r86069 - python/branches/release27-maint/Doc/library/functions.rst
by raymond.hettinger Oct. 31, 2010

Oct. 31, 2010

Author: raymond.hettinger Date: Sun Oct 31 22:28:53 2010 New Revision: 86069 Log: Issue 7447: Improve docs for sum(). Modified: python/branches/release27-maint/Doc/library/functions.rst Modified: python/branches/release27-maint/Doc/library/functions.rst ============================================================================== --- python/branches/release27-maint/Doc/library/functions.rst (original) +++ python/branches/release27-maint/Doc/library/functions.rst Sun Oct 31 22:28:53 2010 @@ -1227,10 +1227,13 @@ Sums *start* and the items of an *iterable* from left to right and returns the total. *start* defaults to ``0``. The *iterable*'s items are normally numbers, - and are not allowed to be strings. The fast, correct way to concatenate a - sequence of strings is by calling ``''.join(sequence)``. Note that - ``sum(range(n), m)`` is equivalent to ``reduce(operator.add, range(n), m)`` - To add floating point values with extended precision, see :func:`math.fsum`\. + and the start value is not allowed to be a string. + + For some use cases, there a good alternatives to :func:`sum`. + The preferred, fast way to concatenate a sequence of strings is by calling + ``''.join(sequence)``. To add floating point values with extended precision, + see :func:`math.fsum`\. To concatenate a series of iterables, consider using + :func:`itertools.chain`. .. versionadded:: 2.3

1 0

r86068 - python/branches/release31-maint/Doc/library/functions.rst
by raymond.hettinger Oct. 31, 2010

Oct. 31, 2010

Author: raymond.hettinger Date: Sun Oct 31 22:27:50 2010 New Revision: 86068 Log: Issue 7447: Improve docs for sum(). Modified: python/branches/release31-maint/Doc/library/functions.rst Modified: python/branches/release31-maint/Doc/library/functions.rst ============================================================================== --- python/branches/release31-maint/Doc/library/functions.rst (original) +++ python/branches/release31-maint/Doc/library/functions.rst Sun Oct 31 22:27:50 2010 @@ -1100,10 +1100,13 @@ Sums *start* and the items of an *iterable* from left to right and returns the total. *start* defaults to ``0``. The *iterable*'s items are normally numbers, - and are not allowed to be strings. The fast, correct way to concatenate a - sequence of strings is by calling ``''.join(sequence)``. To add floating - point values with extended precision, see :func:`math.fsum`\. + and the start value is not allowed to be a string. + For some use cases, there a good alternatives to :func:`sum`. + The preferred, fast way to concatenate a sequence of strings is by calling + ``''.join(sequence)``. To add floating point values with extended precision, + see :func:`math.fsum`\. To concatenate a series of iterables, consider using + :func:`itertools.chain`. .. function:: super([type[, object-or-type]])

1 0

r86067 - in python/branches/py3k: Lib/sunau.py Misc/NEWS
by antoine.pitrou Oct. 31, 2010

Oct. 31, 2010

Author: antoine.pitrou Date: Sun Oct 31 22:27:04 2010 New Revision: 86067 Log: Issue #10265: Close file objects explicitly in sunau. Patch by Brian Brazil. Modified: python/branches/py3k/Lib/sunau.py python/branches/py3k/Misc/NEWS Modified: python/branches/py3k/Lib/sunau.py ============================================================================== --- python/branches/py3k/Lib/sunau.py (original) +++ python/branches/py3k/Lib/sunau.py Sun Oct 31 22:27:04 2010 @@ -154,6 +154,9 @@ if type(f) == type(''): import builtins f = builtins.open(f, 'rb') + self._opened = True + else: + self._opened = False self.initfp(f) def __del__(self): @@ -275,6 +278,8 @@ self._soundpos = pos def close(self): + if self._opened and self._file: + self._file.close() self._file = None class Au_write: @@ -283,11 +288,15 @@ if type(f) == type(''): import builtins f = builtins.open(f, 'wb') + self._opened = True + else: + self._opened = False self.initfp(f) def __del__(self): if self._file: self.close() + self._file = None def initfp(self, file): self._file = file @@ -401,6 +410,8 @@ self._datalength != self._datawritten: self._patchheader() self._file.flush() + if self._opened and self._file: + self._file.close() self._file = None # Modified: python/branches/py3k/Misc/NEWS ============================================================================== --- python/branches/py3k/Misc/NEWS (original) +++ python/branches/py3k/Misc/NEWS Sun Oct 31 22:27:04 2010 @@ -59,6 +59,8 @@ Library ------- +- Issue #10265: Close file objects explicitly in sunau. Patch by Brian Brazil. + - Issue #10266: uu.decode didn't close in_file explicitly when it was given as a filename. Patch by Brian Brazil.

1 0