Mailman 3 September 2016 - docs

[issue26511] Add link to id() built-in in comparison operator documentation for "is"
by Mike Vertolli 12 Sep '16

12 Sep '16

New submission from Mike Vertolli: Here's the doc: https://docs.python.org/2/reference/expressions.html#is It would be great if this line: "The operators is and is not test for object identity: x is y is true if and only if x and y are the same object. x is not y yields the inverse truth value.[7]" Could link to the id() builtin doc: https://docs.python.org/2/library/functions.html#id One way to rephrase this could be: "The operators is and is not test for object identity: x is y is true if and only if x and y are the same object or id(x) == id(y). x is not y yields the inverse truth value.[7]" And, the id's can be hyperlinks. It would also be nice if that reference linked to a page on integer caching in Python. ---------- assignee: docs@python components: Documentation messages: 261364 nosy: Mike Vertolli, docs@python priority: normal severity: normal status: open title: Add link to id() built-in in comparison operator documentation for "is" type: enhancement versions: Python 2.7 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue26511> _______________________________________

7 8

Python 3.5.2: object() takes no parameters
by Deon P Hugo 11 Sep '16

11 Sep '16

Good day, I am using Python 3.5.2. When I try to run the following program: class Robot(object): """represents a robot with a name""" population = 0 def _init_(self, name): self.name = name print("(Initializing {})".format(self.name)) Robot.population += 1 def die(self): print("{} is being destroyed!".format(self.name)) Robot.population -= 1 if Robot.population == 0: print("{} was the last one".format(self.name)) else: print("There are still {:d} robots working. ".format( Robot.population)) def say_hi(self): print("Greetings, my masters call me {} ".format(self.name)) @classmethod def how_many(cls): print("we have {:d} robots".format(cls.population)) droid1 = Robot("r2r4") droid1.say_hi() Robot.how_many() droid2 = Robot("C-3PO") droid2.say_hi() Robot.how_many() print("\nRobots can do some work here.\n") print("\nRobots have finished their work, so lets destroy them .\n") droid1.die() droid2.die() Robot.how_many() I get the following error message: Traceback (most recent call last): File "C:\Users\Deon\Bite Of Python\oop_Class)bj_var.py", line 30, in <module> droid1 = Robot("r2r4") TypeError: object() takes no parameters I have looked everywhere on the internet, however I could find no answer. Any help will be much appreciated. Regards, Deon. --- This email has been checked for viruses by Avast antivirus software. https://www.avast.com/antivirus

2 1

[issue23105] os.O_SHLOCK and os.O_EXLOCK are not available on Linux
by Roundup Robot 11 Sep '16

11 Sep '16

Roundup Robot added the comment: New changeset 5ca4c545dfe4 by Vinay Sajip in branch '2.7': Issue #23105: Updated documentation on open() flag constants. https://hg.python.org/cpython/rev/5ca4c545dfe4 New changeset f1427491a8a5 by Vinay Sajip in branch '3.5': Issue #23105: Updated documentation on open() flag constants. https://hg.python.org/cpython/rev/f1427491a8a5 New changeset 64610bcd326f by Vinay Sajip in branch 'default': Closes #23105: Merged update from 3.5. https://hg.python.org/cpython/rev/64610bcd326f ---------- nosy: +python-dev resolution: -> fixed stage: patch review -> resolved status: open -> closed _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue23105> _______________________________________

1 0

[issue27991] In the argparse howto there is a misleading sentence about store_true
by py.user 11 Sep '16

11 Sep '16

New submission from py.user: https://docs.python.org/3/howto/argparse.html#combining-positional-and-opti… "And, just like the “store_true” action, if you don’t specify the -v flag, that flag is considered to have None value." This sentence is misleading. It supposes that "store_true" action can save None value. But "store_true" action always saves True or False value. An example: This code was taken from the argparse howto. I've just added the -f option and printed args to the stdout. a.py #!/usr/bin/env python3 import argparse parser = argparse.ArgumentParser() parser.add_argument("square", type=int, help="display the square of a given number") parser.add_argument("-v", "--verbosity", action="count", help="increase output verbosity") parser.add_argument("-f", "--flag", action="store_true") args = parser.parse_args() print('args:', args) The output in the console: [guest@localhost bugs]$ ./a.py 1 args: Namespace(flag=False, square=1, verbosity=None) [guest@localhost bugs]$ In the output we see that the -f option have got the False value not None. Applied a patch to the issue that just removes words about analogy with store_true action. ---------- assignee: docs@python components: Documentation, Library (Lib) files: argparse_store_true.diff keywords: patch messages: 274725 nosy: docs@python, py.user priority: normal severity: normal status: open title: In the argparse howto there is a misleading sentence about store_true type: behavior versions: Python 3.6 Added file: http://bugs.python.org/file44419/argparse_store_true.diff _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue27991> _______________________________________

3 2

Re: [docs] UUID docs should say how to get "standard form" (issue 26267)
by berker.peksag＠gmail.com 11 Sep '16

11 Sep '16

https://bugs.python.org/review/26267/diff/18046/Doc/library/uuid.rst File Doc/library/uuid.rst (right): https://bugs.python.org/review/26267/diff/18046/Doc/library/uuid.rst#newcod… Doc/library/uuid.rst:56: .. describe:: uuid1 == uuid2 On 2016/08/06 05:20:17, ammar2 wrote: > On 2016/08/03 10:09:25, berkerpeksag wrote: > > Same as above. See datetime or decimal documentations for an example of how to > > document comparison operations. > > So datetime takes the approach of documenting operators in a table (presumably > because it has a lot of ops) > https://docs.python.org/3/library/datetime.html#datetime.date.day > > decimal seems to do it in this way > https://docs.python.org/3/library/decimal.html#decimal.Decimal.compare > > The style I used here is from > https://docs.python.org/3/library/stdtypes.html#set but now that I look at it, > within the stdtypes there's also the datetime style operator documentation for > numbers. > https://docs.python.org/3/library/stdtypes.html#numeric-types-int-float-com… > > Is there a preferred style for documenting operators? Which one should I use > here? > > (apparently I forgot to click the publish button on Rietveld, I wrote this day > before yesterday) Sorry, I wasn't very clear in my earlier message. I was referring to the following paragraph in datetime documentation: Comparisons of timedelta objects are supported with the timedelta object representing the smaller duration considered to be the smaller timedelta. In order to stop mixed-type comparisons from falling back to the default comparison by object address, when a timedelta object is compared to an object of a different type, TypeError is raised unless the comparison is == or !=. The latter cases return False or True, respectively. https://docs.python.org/3/library/datetime.html#timedelta-objects In other words, instead of using too much markup, it would be nice to document that it supports comparison operators in prose. https://bugs.python.org/review/26267/

1 0

[issue27680] Reduce Github pull request rate
by Steve Holden 11 Sep '16

11 Sep '16

New submission from Steve Holden: I have seen a relatively large number of pull requests via the Github mirror repository, because would-be contributors presumably just look on Github and, having found Python there, assume this is the place for contributions. The standard README file gives no clue that the Github repository should not be used as the basis for contributory pull requests, and neither should it. Fortunately Github will display a README.md file in preference to REAMDE when one is found. This patch adds a message, highly visible to Github users, that they are in the wrong place. For an indication of how the Github page will then look, visit https://github.com/holdenweb/python/tree/README where the patch is already installed. ---------- assignee: docs@python components: Documentation files: README.patch keywords: needs review, patch messages: 271958 nosy: docs@python, holdenweb priority: normal severity: normal stage: patch review status: open title: Reduce Github pull request rate type: enhancement Added file: http://bugs.python.org/file44004/README.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue27680> _______________________________________

3 7

[issue26141] typing module documentation incomplete
by Ben Darnell 11 Sep '16

11 Sep '16

New submission from Ben Darnell: The typing module docs at https://docs.python.org/3/library/typing.html do not include everything that is documented in the PEP (https://www.python.org/dev/peps/pep-0484/#the-typing-module). Specifically, `AnyStr` is mentioned but not defined, the `@overload` decorator is missing, and so are the new-to-3.5 types Awaitable, AsyncIterable, AsyncIterator. ---------- assignee: docs@python components: Documentation messages: 258475 nosy: Ben.Darnell, docs@python priority: normal severity: normal status: open title: typing module documentation incomplete versions: Python 3.5 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue26141> _______________________________________

5 8

[issue28073] Update documentation about None vs type(None) in typing
by Michael Lee 11 Sep '16

11 Sep '16

New submission from Michael Lee: For some reason, the section of the typing docs about Optional stated that Optional[T] was equivalent to Union[T, type(None)]. While this is true, it's somewhat inconsistent and potentially confusing since everywhere else in the docs, we just use None. This patch modifies that line to use Union[T, type(None)] instead, and moves the line explaining that None is special-cased to mean type(None) to the first usage of None as a type within the docs. ---------- assignee: docs@python components: Documentation files: update-none-vs-type-none.patch keywords: patch messages: 275718 nosy: docs@python, gvanrossum, michael0x2a priority: normal severity: normal status: open title: Update documentation about None vs type(None) in typing versions: Python 3.5, Python 3.6, Python 3.7 Added file: http://bugs.python.org/file44542/update-none-vs-type-none.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue28073> _______________________________________

3 2

reversing the meaning of shallow and deep copy??
by Mallika Bachan 10 Sep '16

10 Sep '16

“All slice operations return a new list containing the requested elements. This means that the following slice returns a new (shallow) copy of the list:” Ref: https://docs.python.org/2/tutorial/introduction.html Why say (shallow), a **new** list means it is a **deep** copy.

1 1

[issue10976] accept bytes in json.loads()
by Nick Coghlan 10 Sep '16

10 Sep '16

Nick Coghlan added the comment: As Martin noted, Serhiy has implemented the autodetection option for json.loads in #17909 so closing this one as out of date - UTF-8, UTF-16 and UTF-32 encoded JSON data will be deserialised automatically in 3.6, while other text encodings aren't officially supported by the JSON RFCs. ---------- resolution: -> out of date status: open -> closed superseder: -> Autodetecting JSON encoding _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue10976> _______________________________________

1 0