Mailman 3 November 2013 - docs

[issue19672] Listing of all exceptions for every function
by Sworddragon Nov. 20, 2013

Nov. 20, 2013

New submission from Sworddragon: Currently the documentation does sometimes say about specific exceptions but most times not. As I'm often catching exceptions to ensure a high stability this gets a little difficult. For example print() can trigger a BrokenPipeError and the most file functions like flush() can trigger other related IOError's. So I would like to see something like a listing on every function which contains all exceptions that may appear. Also there are some special cases like close(). For example it can trigger an IOError too if there are pending write operations due to an implicit call of flush(). But if the file object is opened in read-only mode or there are no write operations this can't happen. Maybe such additional information can be added too. ---------- assignee: docs@python components: Documentation messages: 203535 nosy: Sworddragon, docs@python priority: normal severity: normal status: open title: Listing of all exceptions for every function type: enhancement versions: Python 2.7, Python 3.3 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue19672> _______________________________________

2 4

[issue18032] set methods should specify whether they consume iterators "lazily"
by Abafei Nov. 19, 2013

Nov. 19, 2013

New submission from Abafei: It says here (http://docs.python.org/2/library/stdtypes.html#set-types-set-frozenset) that some of the set methods take iterables as a parameter. Usually, the expected behavior is for a iterator consumer to consume only as much data as it needs. For example, for the code `any(itertools.repeat(True))`, the code will complete speedily, in contrast to when all() is used instead of any(), in which case the code will go forever. A least some of the set methods have semantics such that they can consume only some of the input; for example, "issubset" only needs to make sure that all of the items in the set are in the iterable, and once this is the case, it can return "True". However in such a case, the methods will *still* go forever. The docs should specify that this is the case, to disambiguate the semantics. (Tested on Python 3.2.3 and 2.7.3). ---------- assignee: docs@python components: Documentation messages: 189806 nosy: Abafei, docs@python priority: normal severity: normal status: open title: set methods should specify whether they consume iterators "lazily" type: behavior versions: Python 2.7, Python 3.2 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue18032> _______________________________________

5 5

Bug in tutorial
by OCuanachain, Oisin (Oisin) Nov. 18, 2013

Nov. 18, 2013

Hi, There appears to an error in the section http://docs.python.org/2/tutorial/errors.html#handling-exceptions of the tutorial. It states: If an exception occurs which does not match the exception named in the except clause, it is passed on to outer try<http://docs.python.org/2/reference/compound_stmts.html#try> statements; if no handler is found, it is an unhandled exception and execution stops with a message as shown above. The problem I see is with the final clause, 'with a message as shown above'. It is not clear to me that there is any such message, what does this refer to ? The hypothetical message that would ensue should the user run the preceding code snippet with a particular input maybe ? Or something else ? As I say, this is far from clear, to me at any rate. Oisín

1 0

Spelling error in tutorial
by Marek Rudnicki Nov. 18, 2013

Nov. 18, 2013

Hello, On page http://docs.python.org/2/tutorial/introduction.html in section 3.1.3 it says "This lead to very much confusion". It should say "This led to very much confusion" instead. Please see http://www.grammar-monster.com/easily_confused/lead_led.htm if you have any doubts. Kind regards, Marek Rudnicki

1 0

[issue8402] Add a function to escape metacharacters in glob/fnmatch
by Serhiy Storchaka Nov. 18, 2013

Nov. 18, 2013

Serhiy Storchaka added the comment: Thank you Ezio and Eric for your reviews. ---------- assignee: -> serhiy.storchaka resolution: -> fixed stage: patch review -> committed/rejected status: open -> closed _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8402> _______________________________________

1 0

[issue8402] Add a function to escape metacharacters in glob/fnmatch
by Roundup Robot Nov. 18, 2013

Nov. 18, 2013

Roundup Robot added the comment: New changeset 5fda36bff39d by Serhiy Storchaka in branch 'default': Issue #8402: Added the escape() function to the glob module. http://hg.python.org/cpython/rev/5fda36bff39d ---------- nosy: +python-dev _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8402> _______________________________________

1 0

[issue8402] Add a function to escape metacharacters in glob/fnmatch
by Eric V. Smith Nov. 18, 2013

Nov. 18, 2013

Eric V. Smith added the comment: Looks good to me. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8402> _______________________________________

1 0

[issue8402] Add a function to escape metacharacters in glob/fnmatch
by Serhiy Storchaka Nov. 18, 2013

Nov. 18, 2013

Serhiy Storchaka added the comment: Updated patch addresses Eric's comment. ---------- Added file: http://bugs.python.org/file32687/glob_escape_3.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8402> _______________________________________

1 0

[issue8402] Add a function to escape metacharacters in glob/fnmatch
by Serhiy Storchaka Nov. 17, 2013

Nov. 17, 2013

Serhiy Storchaka added the comment: Updated patch addresses Ezio's and Eric's comments. ---------- Added file: http://bugs.python.org/file32673/glob_escape_2.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8402> _______________________________________

1 0

[issue8402] Add a function to escape metacharacters in glob/fnmatch
by Michele Orrù Nov. 17, 2013

Nov. 17, 2013

Changes by Michele Orrù <maker.py(a)gmail.com>: ---------- nosy: -maker _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8402> _______________________________________

1 0