Mailman 3 November 2010 - docs

[issue10480] cgi.py should document the need for binary stdin/stdout
by Glenn Linderman Nov. 21, 2010

Nov. 21, 2010

Changes by Glenn Linderman <v+python(a)g.nevcal.com>: ---------- assignee: -> docs@python components: +Documentation nosy: +docs@python type: -> behavior _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue10480> _______________________________________

1 0

[issue9182] document “--” as a way to distinguish option w/ narg='+' from positional argument in argparse
by Steven Bethard Nov. 20, 2010

Nov. 20, 2010

Steven Bethard <steven.bethard(a)gmail.com> added the comment: Sorry, I think I confused you, please post that patch here. This issue is for documenting the workarounds, issue 9338 is for actually solving the problem. I glanced at your patch on that issue, and it looks basically okay, though I'd like to see a few more tests for the help messages to cover things like: -x X A # no -- -x [X [X ...]] -y Y [Y ...] # no -- -x [X] -- A B # needs -- -x X [X ...] # needs -- -x [X [X ...]] # needs -- It's possible the first two are already covered by the other tests, but at least the last three should all be tested for. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue9182> _______________________________________

1 0

[issue9746] All sequence types support .index and .count
by Daniel Stutzbach Nov. 20, 2010

Nov. 20, 2010

New submission from Daniel Stutzbach <daniel(a)stutzbachenterprises.com>: In the list of operations supported by all sequence types, the .index and .count methods should be included. They are defined by the collections.Sequence ABC that all sequences support. (except for range objects, but that will be fixed in Issue9213) ---------- assignee: docs@python components: Documentation messages: 115397 nosy: docs@python, stutzbach priority: normal severity: normal stage: needs patch status: open title: All sequence types support .index and .count type: behavior versions: Python 2.7, Python 3.1, Python 3.2 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue9746> _______________________________________

6 8

[issue8647] PyUnicode_GetMax is undocumented
by Daniel Stutzbach Nov. 20, 2010

Nov. 20, 2010

New submission from Daniel Stutzbach <daniel(a)stutzbachenterprises.com>: Here's the relevant signature: /* Get the maximum ordinal for a Unicode character. */ PyAPI_FUNC(Py_UNICODE) PyUnicode_GetMax(void); ---------- assignee: docs@python components: Documentation messages: 105206 nosy: docs@python, stutzbach priority: normal severity: normal stage: needs patch status: open title: PyUnicode_GetMax is undocumented versions: Python 2.7, Python 3.2 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8647> _______________________________________

5 6

[issue10043] UnboundLocalError with local variable set by setattr, caused by code run later
by Eric Smith Nov. 20, 2010

Nov. 20, 2010

Eric Smith <eric(a)trueblade.com> added the comment: Closing, as I don't think there's any action item here. ---------- resolution: -> invalid stage: needs patch -> committed/rejected status: open -> closed _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue10043> _______________________________________

1 0

[issue8645] PyUnicode_AsEncodedObject is undocumented
by Daniel Stutzbach Nov. 20, 2010

Nov. 20, 2010

New submission from Daniel Stutzbach <daniel(a)stutzbachenterprises.com>: PyUnicode_AsEncodedObject is undocumented. It has the same signature as PyUnicode_AsEncodedString, although they do slightly different things based on a brief source code inspection (I'm not clear on what that difference is though). ---------- assignee: docs@python components: Documentation messages: 105203 nosy: docs@python, stutzbach priority: normal severity: normal stage: needs patch status: open title: PyUnicode_AsEncodedObject is undocumented versions: Python 2.7, Python 3.2 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8645> _______________________________________

4 5

[issue10043] UnboundLocalError with local variable set by setattr, caused by code run later
by Cherniavsky Beni Nov. 20, 2010

Nov. 20, 2010

Cherniavsky Beni <cben(a)users.sf.net> added the comment: Hi Steven. Please confirm if we can mark the bug closed; if you need farther advice, posting your full code (not just the error case) on comp.lang.python or StackOverflow would be more effective. The documentation is indeed correct but hard to find (you're not the first to be surprised by UnboundLocalError); I'm working on making things more discoverable in issue 4246. See also http://docs.python.org/py3k/faq/programming.html#why-am-i-getting-an-unboun… First of all, it's important to understand that a Python function has a *fixed* set of local variables, frozen when the function is parsed. If you assign to it (e.g. ``name = None``), *all* appearances of the name in the function refer to a local variable; if not, they refer to the outer scope. Therefore, you can't achieve what you want with local variables. Generally, dynamically creating variables is a bad programming practice. A dictionary is the cleanest way to hold a set of names/values that is not fixed. Yes, you'll have to write ``cols['foo']`` instead of ``foo``; OTOH, setting them will not require any ugly magic... Note also that string formatting can use values from a dictionary with very conveniently: ``"... {foo} ...".format(**cols)``. The next best thing if ``cols['foo']`` is too verbose for you is ``cols.foo``: create an object which will contain the values as instance variables (that's a good use for setattr()). This is the most Pythonic solution if a dictionary doesn't suffice - it's what most object-relational mappers do. The third idea is to (ab)use a class statement. A class statement in Python creates a temporary namespace *during the class definition* (we'll not be defining any methods or using it object-oriented stuff). And the nice part is that you can put a class statement anywhere, even inside a function: def f(): cols = {'foo': 42} # however you fetch them... class temp_namespace: locals().update(cols) print(foo / 6) # prints 7.0 assert 'foo' not in locals() # no effect outside the class! This works both in CPython 2 and 3. I'm not 100% sure that being able to change locals() in a class is guaranteed in all other implementations. (Note again that locals() of a *function* are not a real dictionary and you *can't* change them - as I said these are fixed when the function is defined.) The fourth idea if you must have code that says just ``foo`` to access columns is to use the exec statement - you can pass it a dictionary that will serve as globals and/or locals. An upside is that the code will be a string and can be dynamic as well. (BTW, if the code is not dynamic, how come you don't know the names you're accessing? If you do, you could just set ``foo = cols['foo']`` etc. for every variable you need - tedious but no magic needed.) Lastly, as you discovered you can dynamically create global variables. (As Terry said, just use the dictionary returned by ``globals()``; no need for setattr). But this is a very last resort (changing globals for a single function is ugly), and somewhat dangerous - e.g. consider what happens if a column names changes and overwrites a function name you had... ---------- nosy: +cben _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue10043> _______________________________________

1 0

[issue4246] execution model - clear and complete example in documentation
by Éric Araujo Nov. 20, 2010

Nov. 20, 2010

Changes by Éric Araujo <merwok(a)netwok.org>: ---------- nosy: +docs@python -georg.brandl _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue4246> _______________________________________

1 0

[issue10471] include documentation in python docs and under python -h for other commandline options
by Dan L Nov. 20, 2010

Nov. 20, 2010

New submission from Dan L <choralreef(a)naver.com>: there are options such as 'python -tt -bb' that are undocumented at http://docs.python.org/using/cmdline and that don't show up when you type python -h. ( Doubling t and b turns tabs or bytes warnings into errors. ) I don't know if they show up or not when you type 'man python', but for windows devs, it'd be best if it were included in the '-h' text excerpt in addition to being in the online docs. It could also be nice to have an example for the W arg option, e.g. for Wd. ---------- assignee: docs@python components: Documentation, Interpreter Core messages: 121746 nosy: docs@python, jdan priority: normal severity: normal status: open title: include documentation in python docs and under python -h for other commandline options type: behavior versions: Python 2.5, Python 2.6, Python 2.7, Python 3.1, Python 3.2, Python 3.3 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue10471> _______________________________________

2 1

[issue5066] IDLE documentation for Unix obsolete/incorrect
by Ramiro Batista da Luz Nov. 20, 2010

Nov. 20, 2010

Ramiro Batista da Luz <ramiroluz(a)gmail.com> added the comment: I reviewed the texts, applied the patches, ran idle, edited Demo/classes/Dates.py run module inside Idle. Generated the docs inside Doc, with make html and reviewed the IDLE doc in ~/python/py3k/Doc/build/html/library/idle.html?highlight=idle Only in the 3.2 tree. ---------- nosy: +ramiroluz _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue5066> _______________________________________

1 0