From report at bugs.python.org  Mon Jan  1 00:47:34 2018
From: report at bugs.python.org (Yahya Abou Imran)
Date: Mon, 01 Jan 2018 05:47:34 +0000
Subject: [docs] [issue32471] Add an UML class diagram to the collections.abc
 module documentation
Message-ID: <1514785654.69.0.467229070634.issue32471@psf.upfronthosting.co.za>


New submission from Yahya Abou Imran <yahya-abou-imran at protonmail.com>:

>From python-ideas: https://mail.python.org/pipermail/python-ideas/2017-December/048492.html

In this page of the documentation:
https://docs.python.org/3/library/collections.abc.html

The table could be difficult to understand, a diagram help visualize things.

I'm joining the last version of my work, and the .puml I used to generate it.

Opinions about details (fonts, displaying...) are being discussed on the mailist right now.

----------
assignee: docs at python
components: Documentation
files: base.png
messages: 309318
nosy: docs at python, yahya-abou-imran
priority: normal
severity: normal
status: open
title: Add an UML class diagram to the collections.abc module documentation
type: enhancement
versions: Python 3.6, Python 3.7
Added file: https://bugs.python.org/file47357/base.png

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32471>
_______________________________________

From report at bugs.python.org  Mon Jan  1 00:55:05 2018
From: report at bugs.python.org (Yahya Abou Imran)
Date: Mon, 01 Jan 2018 05:55:05 +0000
Subject: [docs] [issue32471] Add an UML class diagram to the collections.abc
 module documentation
In-Reply-To: <1514785654.69.0.467229070634.issue32471@psf.upfronthosting.co.za>
Message-ID: <1514786105.46.0.467229070634.issue32471@psf.upfronthosting.co.za>


Yahya Abou Imran <yahya-abou-imran at protonmail.com> added the comment:

Here is the .puml

----------
Added file: https://bugs.python.org/file47358/base.puml

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32471>
_______________________________________

From report at bugs.python.org  Mon Jan  1 01:06:41 2018
From: report at bugs.python.org (Yahya Abou Imran)
Date: Mon, 01 Jan 2018 06:06:41 +0000
Subject: [docs] [issue32472] Mention of __await__ missing in Coroutine
 Abstract Methods
Message-ID: <1514786801.71.0.467229070634.issue32472@psf.upfronthosting.co.za>


New submission from Yahya Abou Imran <yahya-abou-imran at protonmail.com>:

In the collections.abc documentation:

https://docs.python.org/3/library/collections.abc.html

__await__() doesn't appear in the abstract methods of Coroutine, we see only send() and throw().

But since Coroutine inherit from Awaitable, it's required:


from collections.abc import Coroutine

class MyCoroutine(Coroutine):
    def send(self, value):
        raise StopIteration
    def throw(self, err):
        raise err

mc = MyCoroutine()

Traceback (most recent call last):
  File "_tmp.py", line 9, in <module>
    mc = MyCoroutine()
TypeError: Can't instantiate abstract class MyCoroutine with abstract methods __await__


To be consistent with the rest of the document, this method should appear here to show all the abstract methods, even the inherited ones.

----------
assignee: docs at python
components: Documentation
messages: 309320
nosy: docs at python, yahya-abou-imran
priority: normal
severity: normal
status: open
title: Mention of __await__ missing in Coroutine Abstract Methods
type: enhancement
versions: Python 3.6, Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32472>
_______________________________________

From report at bugs.python.org  Mon Jan  1 18:59:21 2018
From: report at bugs.python.org (Emily Morehouse)
Date: Mon, 01 Jan 2018 23:59:21 +0000
Subject: [docs] [issue32452] Brackets and Parentheses used in an ambiguous
 way
In-Reply-To: <1514610716.34.0.213398074469.issue32452@psf.upfronthosting.co.za>
Message-ID: <1514851161.94.0.714561066657.issue32452@psf.upfronthosting.co.za>


Change by Emily Morehouse <emily at cuttlesoft.com>:


----------
keywords: +patch
pull_requests: +4954
stage:  -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32452>
_______________________________________

From report at bugs.python.org  Mon Jan  1 19:03:34 2018
From: report at bugs.python.org (Emily Morehouse)
Date: Tue, 02 Jan 2018 00:03:34 +0000
Subject: [docs] [issue32452] Brackets and Parentheses used in an ambiguous
 way
In-Reply-To: <1514610716.34.0.213398074469.issue32452@psf.upfronthosting.co.za>
Message-ID: <1514851414.14.0.714561066657.issue32452@psf.upfronthosting.co.za>


Change by Emily Morehouse <emily at cuttlesoft.com>:


----------
nosy: +emilyemorehouse

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32452>
_______________________________________

From report at bugs.python.org  Mon Jan  1 20:34:57 2018
From: report at bugs.python.org (R. David Murray)
Date: Tue, 02 Jan 2018 01:34:57 +0000
Subject: [docs] [issue32452] Brackets and Parentheses used in an ambiguous
 way
In-Reply-To: <1514610716.34.0.213398074469.issue32452@psf.upfronthosting.co.za>
Message-ID: <1514856897.27.0.467229070634.issue32452@psf.upfronthosting.co.za>


R. David Murray <rdmurray at bitdance.com> added the comment:


New changeset f190eb59e60e2ae7a7cbd396458389a7a076e0d3 by R. David Murray (Emily Morehouse) in branch 'master':
bpo-32452: clarify term 'brackets' in generator tutorial (#5079)
https://github.com/python/cpython/commit/f190eb59e60e2ae7a7cbd396458389a7a076e0d3


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32452>
_______________________________________

From report at bugs.python.org  Mon Jan  1 20:36:07 2018
From: report at bugs.python.org (Roundup Robot)
Date: Tue, 02 Jan 2018 01:36:07 +0000
Subject: [docs] [issue32452] Brackets and Parentheses used in an ambiguous
 way
In-Reply-To: <1514610716.34.0.213398074469.issue32452@psf.upfronthosting.co.za>
Message-ID: <1514856967.53.0.714561066657.issue32452@psf.upfronthosting.co.za>


Change by Roundup Robot <devnull at psf.upfronthosting.co.za>:


----------
pull_requests: +4956

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32452>
_______________________________________

From report at bugs.python.org  Mon Jan  1 20:37:07 2018
From: report at bugs.python.org (Roundup Robot)
Date: Tue, 02 Jan 2018 01:37:07 +0000
Subject: [docs] [issue32452] Brackets and Parentheses used in an ambiguous
 way
In-Reply-To: <1514610716.34.0.213398074469.issue32452@psf.upfronthosting.co.za>
Message-ID: <1514857027.83.0.714561066657.issue32452@psf.upfronthosting.co.za>


Change by Roundup Robot <devnull at psf.upfronthosting.co.za>:


----------
pull_requests: +4957

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32452>
_______________________________________

From report at bugs.python.org  Tue Jan  2 02:21:53 2018
From: report at bugs.python.org (Nick Coghlan)
Date: Tue, 02 Jan 2018 07:21:53 +0000
Subject: [docs] [issue32145] Wrong ExitStack Callback recipe
In-Reply-To: <1511771653.67.0.213398074469.issue32145@psf.upfronthosting.co.za>
Message-ID: <1514877713.35.0.467229070634.issue32145@psf.upfronthosting.co.za>


Nick Coghlan <ncoghlan at gmail.com> added the comment:

As per the comment at https://bugs.python.org/issue32445#msg309356, there's a bug in my suggested changes to `ExitStack.pop_all()`: the right method to call is ExitStack.push(), *not* ExitStack.callback() (the latter adds a wrapper function to make the signatures match, but our stored callbacks all already have the right signature).

I'm not too fussy about the details of the docstring, but we need to be careful about the guarantees we make to ExitStack subclasses: if the docstring implies that "target.push()" will always be called, then we need to limit the stack stealing behaviour to actual ExitStack instances (which may be a good idea anyway).

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32145>
_______________________________________

From report at bugs.python.org  Tue Jan  2 04:18:02 2018
From: report at bugs.python.org (Andrew Svetlov)
Date: Tue, 02 Jan 2018 09:18:02 +0000
Subject: [docs] [issue32472] Mention of __await__ missing in Coroutine
 Abstract Methods
In-Reply-To: <1514786801.71.0.467229070634.issue32472@psf.upfronthosting.co.za>
Message-ID: <1514884682.38.0.467229070634.issue32472@psf.upfronthosting.co.za>


Andrew Svetlov <andrew.svetlov at gmail.com> added the comment:

`Coroutine` is inherited from `Awaitable`, that's why inherited abstract `__await__` method is present.

It **is** consistent with the rest of the document: e.g. Mapping has no `__len__` method but inherits it from Collection which in turn is inherited from Sized

----------
nosy: +asvetlov
resolution:  -> not a bug
stage:  -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32472>
_______________________________________

From report at bugs.python.org  Tue Jan  2 08:36:12 2018
From: report at bugs.python.org (R. David Murray)
Date: Tue, 02 Jan 2018 13:36:12 +0000
Subject: [docs] [issue32452] Brackets and Parentheses used in an ambiguous
 way
In-Reply-To: <1514610716.34.0.213398074469.issue32452@psf.upfronthosting.co.za>
Message-ID: <1514900172.62.0.467229070634.issue32452@psf.upfronthosting.co.za>


R. David Murray <rdmurray at bitdance.com> added the comment:


New changeset f24c1857a8a1ba3efb3f957d43371bc9499e3c86 by R. David Murray (Miss Islington (bot)) in branch '3.6':
bpo-32452: clarify term 'brackets' in generator tutorial (GH-5079) (#5081)
https://github.com/python/cpython/commit/f24c1857a8a1ba3efb3f957d43371bc9499e3c86


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32452>
_______________________________________

From report at bugs.python.org  Tue Jan  2 08:40:08 2018
From: report at bugs.python.org (R. David Murray)
Date: Tue, 02 Jan 2018 13:40:08 +0000
Subject: [docs] [issue32452] Brackets and Parentheses used in an ambiguous
 way
In-Reply-To: <1514610716.34.0.213398074469.issue32452@psf.upfronthosting.co.za>
Message-ID: <1514900408.81.0.467229070634.issue32452@psf.upfronthosting.co.za>


R. David Murray <rdmurray at bitdance.com> added the comment:

It looks like the docs job hung on the 2.7 backport, but I don't see how to restart it.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32452>
_______________________________________

From report at bugs.python.org  Tue Jan  2 10:23:11 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 02 Jan 2018 15:23:11 +0000
Subject: [docs] [issue32452] Brackets and Parentheses used in an ambiguous
 way
In-Reply-To: <1514610716.34.0.213398074469.issue32452@psf.upfronthosting.co.za>
Message-ID: <1514906591.34.0.467229070634.issue32452@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:

I clicked the "Details" link and restarted the build from there.
Closing and reopening the PR will also restart the build.

----------
nosy: +Mariatta

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32452>
_______________________________________

From report at bugs.python.org  Tue Jan  2 10:42:18 2018
From: report at bugs.python.org (R. David Murray)
Date: Tue, 02 Jan 2018 15:42:18 +0000
Subject: [docs] [issue32452] Brackets and Parentheses used in an ambiguous
 way
In-Reply-To: <1514610716.34.0.213398074469.issue32452@psf.upfronthosting.co.za>
Message-ID: <1514907737.98.0.467229070634.issue32452@psf.upfronthosting.co.za>


R. David Murray <rdmurray at bitdance.com> added the comment:


New changeset 0e0d1017a4c8ad6f77ee42d7b640463058037f62 by R. David Murray (Miss Islington (bot)) in branch '2.7':
bpo-32452: clarify term 'brackets' in generator tutorial (GH-5079) (#5082)
https://github.com/python/cpython/commit/0e0d1017a4c8ad6f77ee42d7b640463058037f62


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32452>
_______________________________________

From report at bugs.python.org  Tue Jan  2 10:52:28 2018
From: report at bugs.python.org (R. David Murray)
Date: Tue, 02 Jan 2018 15:52:28 +0000
Subject: [docs] [issue32452] Brackets and Parentheses used in an ambiguous
 way
In-Reply-To: <1514610716.34.0.213398074469.issue32452@psf.upfronthosting.co.za>
Message-ID: <1514908348.23.0.467229070634.issue32452@psf.upfronthosting.co.za>


R. David Murray <rdmurray at bitdance.com> added the comment:

Thanks, Mariatta.  I did click on the details link, so either the restart link isn't obvious or I don't have the correct permissions to do a restart :)

And thanks Emily for doing the PR.

----------
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32452>
_______________________________________

From report at bugs.python.org  Tue Jan  2 14:37:13 2018
From: report at bugs.python.org (Martin Panter)
Date: Tue, 02 Jan 2018 19:37:13 +0000
Subject: [docs] [issue32413] Document that locals() may return globals()
In-Reply-To: <1514008362.41.0.213398074469.issue32413@psf.upfronthosting.co.za>
Message-ID: <1514921833.74.0.467229070634.issue32413@psf.upfronthosting.co.za>


Martin Panter <vadmium+py at gmail.com> added the comment:

FWIW a few years ago I wrote a patch for Issue 17546 that documents three personalities of ?locals?, including:

* At the module level, the dictionary returned is the global symbol table, also returned by :func:`globals`.

----------
nosy: +martin.panter

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32413>
_______________________________________

From report at bugs.python.org  Tue Jan  2 14:59:39 2018
From: report at bugs.python.org (Brett Cannon)
Date: Tue, 02 Jan 2018 19:59:39 +0000
Subject: [docs] [issue32471] Add an UML class diagram to the collections.abc
 module documentation
In-Reply-To: <1514785654.69.0.467229070634.issue32471@psf.upfronthosting.co.za>
Message-ID: <1514923179.24.0.467229070634.issue32471@psf.upfronthosting.co.za>


Brett Cannon <brett at python.org> added the comment:

I brought this up on python-ideas, but I think discussing it here may be better: I think we may need to use a data file format that has an open source implementation. The tool Yahya used (plantuml) doesn't appear to be open source, which is a problem for the long-term maintainability of the diagram. If I'm wrong about open source tools for reading .puml files to generate SVG files then my worries are alleviated, but if there aren't any then something like a dot file may be better long-term.

----------
nosy: +brett.cannon

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32471>
_______________________________________

From report at bugs.python.org  Wed Jan  3 14:17:18 2018
From: report at bugs.python.org (Brett Cannon)
Date: Wed, 03 Jan 2018 19:17:18 +0000
Subject: [docs] [issue32471] Add an UML class diagram to the collections.abc
 module documentation
In-Reply-To: <1514785654.69.0.467229070634.issue32471@psf.upfronthosting.co.za>
Message-ID: <1515007038.64.0.467229070634.issue32471@psf.upfronthosting.co.za>


Brett Cannon <brett at python.org> added the comment:

I should mention that over on python-ideas people found the open source code to plantuml, so I think the format is acceptable for use in the docs.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32471>
_______________________________________

From report at bugs.python.org  Wed Jan  3 15:50:56 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Wed, 03 Jan 2018 20:50:56 +0000
Subject: [docs] [issue32471] Add an UML class diagram to the collections.abc
 module documentation
In-Reply-To: <1514785654.69.0.467229070634.issue32471@psf.upfronthosting.co.za>
Message-ID: <1515012656.54.0.467229070634.issue32471@psf.upfronthosting.co.za>


Raymond Hettinger <raymond.hettinger at gmail.com> added the comment:

This is a nice looking diagram.  Nice work.  The existing table is great when you care about knowing what a particular ABC does, but the diagram nicely gives an overview of whole ecosystem all at once.

If the collections.abc module continues its unabated growth, the diagram will become a spaghetti bowl.  But for now, it reads nicely.

----------
nosy: +rhettinger

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32471>
_______________________________________

From report at bugs.python.org  Thu Jan  4 02:51:34 2018
From: report at bugs.python.org (Paul Rudin)
Date: Thu, 04 Jan 2018 07:51:34 +0000
Subject: [docs] [issue17972] inspect module docs omits many functions
In-Reply-To: <1368501068.91.0.677640111487.issue17972@psf.upfronthosting.co.za>
Message-ID: <1515052293.6.0.467229070634.issue17972@psf.upfronthosting.co.za>


Paul Rudin <paul at rudin.co.uk> added the comment:

If some are to be considered private then the questions are: which ones and how to fix. Presumably renaming to start with "_" might break existing code, so maybe adding an __all__, and just including the public objects is better? That could break code existing relying on * imports I suppose. Deprecation is another possibility, although feels a little odd for things never documented.

formatannotation and formatannotationrelativeto look like a helper functions for formatargspec and are probably not intended as part of the public interface.

Similarly walktree looks like a helper for getclasstree (and its docstring describes it as such).

----------
nosy: +PaulRudin

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue17972>
_______________________________________

From report at bugs.python.org  Thu Jan  4 04:08:26 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Thu, 04 Jan 2018 09:08:26 +0000
Subject: [docs] [issue32211] Document the bug in re.findall() and
 re.finditer() in 2.7 and 3.6
In-Reply-To: <1512382086.34.0.213398074469.issue32211@psf.upfronthosting.co.za>
Message-ID: <1515056906.71.0.467229070634.issue32211@psf.upfronthosting.co.za>


Serhiy Storchaka <storchaka+cpython at gmail.com> added the comment:


New changeset 1e6d8525f9dd3dcdc83adb93b164082c8b95d17a by Serhiy Storchaka in branch '3.6':
bpo-32211: Document the existing bug in re.findall() and re.finditer(). (#4695)
https://github.com/python/cpython/commit/1e6d8525f9dd3dcdc83adb93b164082c8b95d17a


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32211>
_______________________________________

From report at bugs.python.org  Thu Jan  4 04:15:46 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Thu, 04 Jan 2018 09:15:46 +0000
Subject: [docs] [issue31778] ast.literal_eval supports non-literals in
 Python 3
In-Reply-To: <1507847478.46.0.213398074469.issue31778@psf.upfronthosting.co.za>
Message-ID: <1515057346.58.0.467229070634.issue31778@psf.upfronthosting.co.za>


Serhiy Storchaka <storchaka+cpython at gmail.com> added the comment:


New changeset d8ac4d1d5ac256ebf3d8d38c226049abec82a2a0 by Serhiy Storchaka in branch 'master':
bpo-31778: Make ast.literal_eval() more strict. (#4035)
https://github.com/python/cpython/commit/d8ac4d1d5ac256ebf3d8d38c226049abec82a2a0


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue31778>
_______________________________________

From report at bugs.python.org  Thu Jan  4 04:27:28 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Thu, 04 Jan 2018 09:27:28 +0000
Subject: [docs] [issue31778] ast.literal_eval supports non-literals in
 Python 3
In-Reply-To: <1507847478.46.0.213398074469.issue31778@psf.upfronthosting.co.za>
Message-ID: <1515058048.82.0.714561066657.issue31778@psf.upfronthosting.co.za>


Change by Serhiy Storchaka <storchaka+cpython at gmail.com>:


----------
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue31778>
_______________________________________

From report at bugs.python.org  Thu Jan  4 04:32:12 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Thu, 04 Jan 2018 09:32:12 +0000
Subject: [docs] [issue32211] Document the bug in re.findall() and
 re.finditer() in 2.7 and 3.6
In-Reply-To: <1512382086.34.0.213398074469.issue32211@psf.upfronthosting.co.za>
Message-ID: <1515058332.38.0.714561066657.issue32211@psf.upfronthosting.co.za>


Change by Serhiy Storchaka <storchaka+cpython at gmail.com>:


----------
pull_requests: +4965

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32211>
_______________________________________

From report at bugs.python.org  Thu Jan  4 04:34:08 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Thu, 04 Jan 2018 09:34:08 +0000
Subject: [docs] [issue32211] Document the bug in re.findall() and
 re.finditer() in 2.7 and 3.6
In-Reply-To: <1512382086.34.0.213398074469.issue32211@psf.upfronthosting.co.za>
Message-ID: <1515058448.63.0.714561066657.issue32211@psf.upfronthosting.co.za>


Change by Serhiy Storchaka <storchaka+cpython at gmail.com>:


----------
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32211>
_______________________________________

From report at bugs.python.org  Thu Jan  4 07:08:33 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Thu, 04 Jan 2018 12:08:33 +0000
Subject: [docs] [issue32211] Document the bug in re.findall() and
 re.finditer() in 2.7 and 3.6
In-Reply-To: <1512382086.34.0.213398074469.issue32211@psf.upfronthosting.co.za>
Message-ID: <1515067713.78.0.467229070634.issue32211@psf.upfronthosting.co.za>


Serhiy Storchaka <storchaka+cpython at gmail.com> added the comment:


New changeset ca54740f257086393106d242644d450485180b96 by Serhiy Storchaka in branch '2.7':
[2.7] bpo-32211: Document the existing bug in re.findall() and re.finditer(). (GH-4695). (#5096)
https://github.com/python/cpython/commit/ca54740f257086393106d242644d450485180b96


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32211>
_______________________________________

From report at bugs.python.org  Thu Jan  4 09:09:33 2018
From: report at bugs.python.org (R. David Murray)
Date: Thu, 04 Jan 2018 14:09:33 +0000
Subject: [docs] [issue17972] inspect module docs omits many functions
In-Reply-To: <1368501068.91.0.677640111487.issue17972@psf.upfronthosting.co.za>
Message-ID: <1515074973.3.0.467229070634.issue17972@psf.upfronthosting.co.za>


R. David Murray <rdmurray at bitdance.com> added the comment:

I think adding an __all__ in 3.7 would be reasonable.  You are right that we can't simply rename them for backward compatibility reasons.  We could rename them, and leave a stub function (that calls the renamed function) but issues a deprecation warning.  We've done that for other old internal APIs that we wanted to mark as private elsewhere in the stdlib.  The question is, is it worth the trouble to do it?

----------
nosy: +r.david.murray

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue17972>
_______________________________________

From report at bugs.python.org  Thu Jan  4 16:03:34 2018
From: report at bugs.python.org (Greg)
Date: Thu, 04 Jan 2018 21:03:34 +0000
Subject: [docs] [issue12706] timeout sentinel in ftplib and poplib
 documentation
In-Reply-To: <1514573747.85.0.213398074469.issue12706@psf.upfronthosting.co.za>
Message-ID: <CA+S+hTA-pdbao0ptPwdeEBVP8qJAy5vG16tX7a3JuMX8CLQ1aw@mail.gmail.com>


Greg <elorian.mestec at gmail.com> added the comment:

Completely forgot about this, please take my patch and submit a pr

On Fri, Dec 29, 2017 at 10:55 AM, Marcel Widjaja <report at bugs.python.org>
wrote:

>
> Marcel Widjaja <mwidj at yahoo.com> added the comment:
>
> Greg, I wonder if you are planning to submit a PR for your patch? If not,
> I'm plan to take your patch, make some minor adjustment and submit a PR.
>
> ----------
> nosy: +mawidjaj
>
> _______________________________________
> Python tracker <report at bugs.python.org>
> <https://bugs.python.org/issue12706>
> _______________________________________
>

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue12706>
_______________________________________

From report at bugs.python.org  Fri Jan  5 04:50:48 2018
From: report at bugs.python.org (Paul Rudin)
Date: Fri, 05 Jan 2018 09:50:48 +0000
Subject: [docs] [issue17972] inspect module docs omits many functions
In-Reply-To: <1368501068.91.0.677640111487.issue17972@psf.upfronthosting.co.za>
Message-ID: <1515145848.68.0.467229070634.issue17972@psf.upfronthosting.co.za>


Paul Rudin <paul at rudin.co.uk> added the comment:

Documenting and generating a deprecation warning also makes them part of the documented public api. Or are you suggesting just the warning without including in the documentation?

Incidentally, there are also the classes BlockFinder and EndOfBlock, which are helpers for getblock and presumably not intended for public consumption.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue17972>
_______________________________________

From report at bugs.python.org  Fri Jan  5 09:24:19 2018
From: report at bugs.python.org (R. David Murray)
Date: Fri, 05 Jan 2018 14:24:19 +0000
Subject: [docs] [issue17972] inspect module docs omits many functions
In-Reply-To: <1368501068.91.0.677640111487.issue17972@psf.upfronthosting.co.za>
Message-ID: <1515162259.41.0.467229070634.issue17972@psf.upfronthosting.co.za>


R. David Murray <rdmurray at bitdance.com> added the comment:

Just warnings, no docs.  We've done this before for other helper functions, but it is always a judgement call whether it is worth the churn.  I defer to those people who have actually done work on the module for the answer to that question.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue17972>
_______________________________________

From monkeylil970 at gmail.com  Tue Jan  2 10:57:58 2018
From: monkeylil970 at gmail.com (Untamed Guerilla)
Date: Tue, 2 Jan 2018 09:57:58 -0600
Subject: [docs] Help Install
Message-ID: <CADvK7CqGqXZqTqrdzUg=5D9c-GTkNcApi3HRvKGozfeMxJ4vfA@mail.gmail.com>

Help With Installation, Please.....Thanks.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20180102/7d1ea509/attachment-0001.html>

From monkeylil970 at gmail.com  Tue Jan  2 21:35:40 2018
From: monkeylil970 at gmail.com (Untamed Guerilla)
Date: Tue, 2 Jan 2018 20:35:40 -0600
Subject: [docs] Need Help...
Message-ID: <CADvK7Co3R_i1M=dFfBLG1uLwiJE8WD2DVjYWZP_gXOGOVgyyGQ@mail.gmail.com>

What Text Do I Need For Installation????
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20180102/7a784938/attachment-0001.html>

From monkeylil970 at gmail.com  Wed Jan  3 06:17:55 2018
From: monkeylil970 at gmail.com (Untamed Guerilla)
Date: Wed, 3 Jan 2018 05:17:55 -0600
Subject: [docs] (no subject)
Message-ID: <CADvK7CoViRFVrppbqtESnvVyg7OoEMuKKq6KC=q4Dz19exaDxA@mail.gmail.com>


-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20180103/9cb13e46/attachment-0001.html>

From lalwaniabhishek010 at gmail.com  Thu Jan  4 04:29:35 2018
From: lalwaniabhishek010 at gmail.com (Abhishek Lalwani)
Date: Thu, 4 Jan 2018 14:59:35 +0530
Subject: [docs] Unable to install python
Message-ID: <CALZq+Xiueivpf5oeyBLgYJ=yuA5TbtHZJ+Gr7s4A_BrPqNz-sA@mail.gmail.com>

I am unable to install python 2.7.14 on my windows 8, 32 bit system.
When I select install (for all users) it displays an error... the error is
mentioned below.

an error occurred during the installation of
assembly'Microsoft.VC90.CRT,version="9.0.30729.1",publicKeyToken="1fc8b3b9a1e18e3b",processorArchitecture="x86",type="win32"'

I even tried with the older versions,  2.7.13 but the same error occurred.

Please help me out.

Regards.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20180104/b0951311/attachment-0001.html>

From lalwaniabhishek010 at gmail.com  Thu Jan  4 04:45:25 2018
From: lalwaniabhishek010 at gmail.com (Abhishek Lalwani)
Date: Thu, 4 Jan 2018 15:15:25 +0530
Subject: [docs] Unable to install python
In-Reply-To: <CALZq+Xiueivpf5oeyBLgYJ=yuA5TbtHZJ+Gr7s4A_BrPqNz-sA@mail.gmail.com>
References: <CALZq+Xiueivpf5oeyBLgYJ=yuA5TbtHZJ+Gr7s4A_BrPqNz-sA@mail.gmail.com>
Message-ID: <CALZq+Xhow5-HoVmfUqdzGMEfwn1cypDWQyveYAoa7-akYLXS9Q@mail.gmail.com>

This is the snap shot of what error I'm encountering.....

Please find me a sloution.

Regards.

On 4 January 2018 at 14:59, Abhishek Lalwani <lalwaniabhishek010 at gmail.com>
wrote:

> I am unable to install python 2.7.14 on my windows 8, 32 bit system.
> When I select install (for all users) it displays an error... the error is
> mentioned below.
>
> an error occurred during the installation of assembly'Microsoft.VC90.CRT,
> version="9.0.30729.1",publicKeyToken="1fc8b3b9a1e18e3b",
> processorArchitecture="x86",type="win32"'
>
> I even tried with the older versions,  2.7.13 but the same error occurred.
>
> Please help me out.
>
> Regards.
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20180104/4ac38d57/attachment-0001.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: Screenshot (227).png
Type: image/png
Size: 198768 bytes
Desc: not available
URL: <http://mail.python.org/pipermail/docs/attachments/20180104/4ac38d57/attachment-0001.png>

From trencyclopedia at gmail.com  Fri Jan  5 10:55:16 2018
From: trencyclopedia at gmail.com (eric R)
Date: Fri, 5 Jan 2018 16:55:16 +0100
Subject: [docs] propose a Chinese version of Python documents
Message-ID: <CACGVJARmkH3APtzUahZoAHN_YsELkKgLr=+hP7CYXCAt70HofA@mail.gmail.com>

Hello Guys,
I am Donghui, a Chinese currently studying in Europe as a Ph.D. student.
Since last year, I have started using Python for my projects, and I found
Python documents very helpful for me to learn this programming language.
Thank you all for the wonderful work!

Meanwhile I noticed there are  Japanese and French versions of the document
available beside the English version, but Chinese version doesn't exist
yet. I am wondering whether you'd consider incorporating a Chinese
translation of the document on the offical website. I hope this knowledge
base can be accessed by more broad people from China where most pepole
still have difficulity reading techincal stuff in English.

 I am not sure whether you already received same proposal from other
Chinese people. If so, I will be very glad to work in a team to do this
kind of translation. As this work is going to need quite broad of
background knowledge, it will be very difficult , if not possible, for one
person to accomplish this work.

Thanks in advanve!

*Best Regards?*
*--??*
*?Donghui?(*
*?Eric )?*
*? **Zhai *
*PhD Candidate*
*Email: ?donghui.zhai at student.kulenven.be
<donghui.zhai at student.kulenven.be>*
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20180105/fa4f9283/attachment.html>

From bgailer at gmail.com  Fri Jan  5 11:18:00 2018
From: bgailer at gmail.com (Bob Gailer)
Date: Fri, 5 Jan 2018 11:18:00 -0500
Subject: [docs] Help Install
In-Reply-To: <CADvK7CqGqXZqTqrdzUg=5D9c-GTkNcApi3HRvKGozfeMxJ4vfA@mail.gmail.com>
References: <CADvK7CqGqXZqTqrdzUg=5D9c-GTkNcApi3HRvKGozfeMxJ4vfA@mail.gmail.com>
Message-ID: <CAP1rxO5SEQfS--GOUD4Ub-Eaqvg6f4BA6Q8j3EwoiCAnOgQ5Mg@mail.gmail.com>

On Jan 5, 2018 11:00 AM, "Untamed Guerilla" <monkeylil970 at gmail.com> wrote:
>
> Help With Installation, Please.....Thanks.

We need more information. What operating system are you using?

What Have you tried? What problems have you encountered?

The normal procedure for installing python is to download the installer for
your operating system and then run that installer.

Each operating system has its own quirks and peculiarities, which is why we
asked which one you're using.

We eagerly expect your reply.
>
> _______________________________________________
> docs mailing list
> docs at python.org
> https://mail.python.org/mailman/listinfo/docs
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20180105/e9b9a2d8/attachment.html>

From bgailer at gmail.com  Fri Jan  5 11:20:08 2018
From: bgailer at gmail.com (Bob Gailer)
Date: Fri, 5 Jan 2018 11:20:08 -0500
Subject: [docs] Help Install
In-Reply-To: <CAP1rxO5SEQfS--GOUD4Ub-Eaqvg6f4BA6Q8j3EwoiCAnOgQ5Mg@mail.gmail.com>
References: <CADvK7CqGqXZqTqrdzUg=5D9c-GTkNcApi3HRvKGozfeMxJ4vfA@mail.gmail.com>
 <CAP1rxO5SEQfS--GOUD4Ub-Eaqvg6f4BA6Q8j3EwoiCAnOgQ5Mg@mail.gmail.com>
Message-ID: <CAP1rxO5xna-RY+0Y1hkaxvbmUWAj3a70r26i240B7pCeZUQMOg@mail.gmail.com>

By the way docks at python.org is not the proper list for this kind of
question.

I suggest you send your reply and future questions to help at python.org.

I'm dictating this hence the odd spelling.

On Jan 5, 2018 11:18 AM, "Bob Gailer" <bgailer at gmail.com> wrote:

> On Jan 5, 2018 11:00 AM, "Untamed Guerilla" <monkeylil970 at gmail.com>
> wrote:
> >
> > Help With Installation, Please.....Thanks.
>
> We need more information. What operating system are you using?
>
> What Have you tried? What problems have you encountered?
>
> The normal procedure for installing python is to download the installer
> for your operating system and then run that installer.
>
> Each operating system has its own quirks and peculiarities, which is why
> we asked which one you're using.
>
> We eagerly expect your reply.
> >
> > _______________________________________________
> > docs mailing list
> > docs at python.org
> > https://mail.python.org/mailman/listinfo/docs
> >
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20180105/2b340e75/attachment.html>

From bgailer at gmail.com  Fri Jan  5 11:39:14 2018
From: bgailer at gmail.com (Bob Gailer)
Date: Fri, 5 Jan 2018 11:39:14 -0500
Subject: [docs] Bug in python tutorial
In-Reply-To: <29B035D9-425C-4046-BDE5-941B805C93FF@gmail.com>
References: <29B035D9-425C-4046-BDE5-941B805C93FF@gmail.com>
Message-ID: <CAP1rxO4CXy78FaAnHxCk5oXtrWL=N-qf__Ngf5jDyYxusf8aQw@mail.gmail.com>

On Jan 5, 2018 11:00 AM, "Rian van Kampen" <rianvankampen at gmail.com> wrote:
>
> Hi,
>
> Im trying to learn python and i can not get the example of 4.1. If
statements to work.

You might want to take a look at section 2. 1 of the tutorial under using
the python interpreter if you are using any other method for program entry
you might get different results.
>
> Every time i fill out x and the first if statement i go to the elif
statement. As i put in the colon and hit enter to go to the next line to
write the print it executes the lines and gives me a syntax error. The elif
statement doesnt come on the same level als the first if statement. I cant
find the answer online so could you please help me out? And correct the
example of 4.1.?
>
> Kind regards,
>
> Rian
> _______________________________________________
> docs mailing list
> docs at python.org
> https://mail.python.org/mailman/listinfo/docs
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20180105/f31a5b4a/attachment.html>

From report at bugs.python.org  Fri Jan  5 11:57:08 2018
From: report at bugs.python.org (Ivan Levkivskyi)
Date: Fri, 05 Jan 2018 16:57:08 +0000
Subject: [docs] [issue32471] Add an UML class diagram to the collections.abc
 module documentation
In-Reply-To: <1514785654.69.0.467229070634.issue32471@psf.upfronthosting.co.za>
Message-ID: <1515171428.24.0.714561066657.issue32471@psf.upfronthosting.co.za>


Change by Ivan Levkivskyi <levkivskyi at gmail.com>:


----------
nosy: +levkivskyi

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32471>
_______________________________________

From bgailer at gmail.com  Fri Jan  5 11:28:59 2018
From: bgailer at gmail.com (Bob Gailer)
Date: Fri, 5 Jan 2018 11:28:59 -0500
Subject: [docs] Bug in python tutorial
In-Reply-To: <29B035D9-425C-4046-BDE5-941B805C93FF@gmail.com>
References: <29B035D9-425C-4046-BDE5-941B805C93FF@gmail.com>
Message-ID: <CAP1rxO5CCQ0af7u5hMHByabi7JR9_BKb7oC_Tm2YSKEPtOi6Jw@mail.gmail.com>

On Jan 5, 2018 11:00 AM, "Rian van Kampen" <rianvankampen at gmail.com> wrote:
>
> Hi,
>
> Im trying to learn python and i can not get the example of 4.1. If
statements to work.

We need more information.

What operating system are you using?

What version of python?

provide a link to the particular section of the tutorial you're trying.

What are you using to enter your program?

Copy and paste into your reply exactly what you entered in what you got.

Armed with this information we are much more able to help.

Keep in mind that most tutorials have been pretty thoroughly tested and it
is unlikely that the tutorial has a bug.
>
> Every time i fill out x and the first if statement i go to the elif
statement. As i put in the colon and hit enter to go to the next line to
write the print it executes the lines and gives me a syntax error. The elif
statement doesnt come on the same level als the first if statement. I cant
find the answer online so could you please help me out? And correct the
example of 4.1.?
>
> Kind regards,
>
> Rian
> _______________________________________________
> docs mailing list
> docs at python.org
> https://mail.python.org/mailman/listinfo/docs
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20180105/3e4200bb/attachment.html>

From mariatta.wijaya at gmail.com  Fri Jan  5 13:42:50 2018
From: mariatta.wijaya at gmail.com (Mariatta Wijaya)
Date: Fri, 5 Jan 2018 10:42:50 -0800
Subject: [docs] propose a Chinese version of Python documents
In-Reply-To: <CACGVJARmkH3APtzUahZoAHN_YsELkKgLr=+hP7CYXCAt70HofA@mail.gmail.com>
References: <CACGVJARmkH3APtzUahZoAHN_YsELkKgLr=+hP7CYXCAt70HofA@mail.gmail.com>
Message-ID: <CAGbohnYBd+1jEMoKxabPA4EJdgbNyhQP5wWUc+rLqjNmc_YrDQ@mail.gmail.com>

Hello,

The effort and process of translating Python documentation can be read in
PEP 545 [1].

One of the first steps is subscribing to doc-sig mailing list [2],
introduce yourself there.
They can further guide you with the process.

[1] https://www.python.org/dev/peps/pep-0545/
[2] https://mail.python.org/mailman/listinfo/doc-sig



Mariatta Wijaya

On Fri, Jan 5, 2018 at 7:55 AM, eric R <trencyclopedia at gmail.com> wrote:

> Hello Guys,
> I am Donghui, a Chinese currently studying in Europe as a Ph.D. student.
> Since last year, I have started using Python for my projects, and I found
> Python documents very helpful for me to learn this programming language.
> Thank you all for the wonderful work!
>
> Meanwhile I noticed there are  Japanese and French versions of the
> document available beside the English version, but Chinese version doesn't
> exist yet. I am wondering whether you'd consider incorporating a Chinese
> translation of the document on the offical website. I hope this knowledge
> base can be accessed by more broad people from China where most pepole
> still have difficulity reading techincal stuff in English.
>
>  I am not sure whether you already received same proposal from other
> Chinese people. If so, I will be very glad to work in a team to do this
> kind of translation. As this work is going to need quite broad of
> background knowledge, it will be very difficult , if not possible, for one
> person to accomplish this work.
>
> Thanks in advanve!
>
> *Best Regards?*
> *--??*
> *?Donghui?(*
> *?Eric )?*
> *? **Zhai *
> *PhD Candidate*
> *Email: ?donghui.zhai at student.kulenven.be
> <donghui.zhai at student.kulenven.be>*
>
>
> _______________________________________________
> docs mailing list
> docs at python.org
> https://mail.python.org/mailman/listinfo/docs
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20180105/30f1fc9b/attachment.html>

From mariatta.wijaya at gmail.com  Fri Jan  5 13:48:34 2018
From: mariatta.wijaya at gmail.com (Mariatta Wijaya)
Date: Fri, 5 Jan 2018 10:48:34 -0800
Subject: [docs] About docs
In-Reply-To: <tencent_F80A7A3243A03ADF96D3AB607476B7728106@qq.com>
References: <tencent_F80A7A3243A03ADF96D3AB607476B7728106@qq.com>
Message-ID: <CAGbohnaT5zVcr8a8SvqK-Hr-+zSOL9h+=BjudaL=SdtmRsbybg@mail.gmail.com>

The effort of translating Python documentation to other languages such as
Chinese is volunteer based.
Read PEP 545 [1] for more details.

Currently we have groups working on translating Python to Japanese, and
French.
It all depends on interested people willing to contribute and help do the
translation :)

[1] https://www.python.org/dev/peps/pep-0545/


Mariatta Wijaya

On Fri, Dec 22, 2017 at 10:27 PM, Winter Is Coming <xukela at qq.com> wrote:

> When will Chinese documents appear?
> _______________________________________________
> docs mailing list
> docs at python.org
> https://mail.python.org/mailman/listinfo/docs
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20180105/5e000c94/attachment.html>

From mariatta.wijaya at gmail.com  Fri Jan  5 13:51:49 2018
From: mariatta.wijaya at gmail.com (Mariatta Wijaya)
Date: Fri, 5 Jan 2018 10:51:49 -0800
Subject: [docs] =?utf-8?b?UHl0aG9uIDMuNS4yIOaWh+ahoyDml6Dms5XkuIvovb0=?=
In-Reply-To: <DM5PR11MB17693699E3C65804A19ACF84D32C0@DM5PR11MB1769.namprd11.prod.outlook.com>
References: <DM5PR11MB17693699E3C65804A19ACF84D32C0@DM5PR11MB1769.namprd11.prod.outlook.com>
Message-ID: <CAGbohnYokFpoGXc0Gkfz2RtGejhdSm_sbMh6FJvsVSqZjgM8uQ@mail.gmail.com>

Thank you for the message.
That does not seem to be an official Python documentation website, so we
don't support it.

Translating Python documentation to other languages such as Chinese, is
work done by volunteers.
PEP 545 [1] has more details of the process.

Currently we have groups working on translating Python to Japanese, and
French.
It depends on interested people willing to contribute and help do the
translation :)

[1] https://www.python.org/dev/peps/pep-0545/


Mariatta Wijaya

On Sat, Nov 18, 2017 at 6:48 AM, ? ? <zlneed at hotmail.com> wrote:

> Hello!
>
> I am a beginner for Python?I need the Python Document very much.
>
> But the Python 3.5.2 Document Chinese Version can?t download from
> http://python.usyiyi.cn/translate/python_352/download.html .
>
> It?s inconvenient to me for English version.If you could give me the
> Chinese version.I will really tankfull..
>
> GOOD NIGHT
>
> _______________________________________________
> docs mailing list
> docs at python.org
> https://mail.python.org/mailman/listinfo/docs
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20180105/4c6fd8e5/attachment-0001.html>

From report at bugs.python.org  Fri Jan  5 22:14:34 2018
From: report at bugs.python.org (Jay Crotts)
Date: Sat, 06 Jan 2018 03:14:34 +0000
Subject: [docs] [issue8243] curses writing to window's bottom right position
 raises: `_curses.error: addstr() returned ERR'
In-Reply-To: <1352121880.55.0.191535515397.issue8243@psf.upfronthosting.co.za>
Message-ID: <1515208473.77.0.467229070634.issue8243@psf.upfronthosting.co.za>


Jay Crotts <crotts.jay at gmail.com> added the comment:

I can create a documentation patch and PR if this still needs doing.

----------
nosy: +jcrotts

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue8243>
_______________________________________

From report at bugs.python.org  Sat Jan  6 03:54:03 2018
From: report at bugs.python.org (Vladislavs Burakovs)
Date: Sat, 06 Jan 2018 08:54:03 +0000
Subject: [docs] [issue32501] Documentation for dir([object])
Message-ID: <1515228843.27.0.467229070634.issue32501@psf.upfronthosting.co.za>


New submission from Vladislavs Burakovs <solomonchild at gmail.com>:

Documentation page [1]  says "If the object has a method named __dir__(), this method will be called and must return the list of attributes.". 

It seems that on Python 3.6 it only works if the *class* has a method named __dir__. Should the documentation be changed?

Microsoft Windows [Version 10.0.16299.192]
(c) 2017 Microsoft Corporation. All rights reserved.

D:\Users\wlad>python
Python 3.6.4 (v3.6.4:d48eceb, Dec 19 2017, 06:04:45) [MSC v.1900 32 bit (Intel)] on win32
Type "help", "copyright", "credits" or "license" for more information.
>>> class C: pass
...
>>> x = C()
>>> import types
>>> x.__dir__ = types.MethodType(lambda _:[], x)
>>> dir(x)
['__class__', '__delattr__', '__dict__', '__dir__', '__doc__', '__eq__', '__format__', '__ge__', '__getattribute__', '__gt__', '__hash__', '__init__', '__init_subclass__', '__le__', '__lt__', '__module__', '__ne__', '__new__', '__reduce__', '__reduce_ex__', '__repr__', '__setattr__', '__sizeof__', '__str__', '__subclasshook__', '__weakref__']
>>> C.__dir__ = types.MethodType(lambda _:[], x)
>>> dir(x)
[]

[1] https://docs.python.org/3/library/functions.html

----------
assignee: docs at python
components: Documentation
messages: 309544
nosy: Vladislavs Burakovs, docs at python
priority: normal
severity: normal
status: open
title: Documentation for dir([object])
type: enhancement
versions: Python 3.6

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32501>
_______________________________________

From report at bugs.python.org  Sat Jan  6 04:49:48 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sat, 06 Jan 2018 09:49:48 +0000
Subject: [docs] [issue32500] PySequence_Length() raises TypeError on dict
 type
In-Reply-To: <1515199107.36.0.467229070634.issue32500@psf.upfronthosting.co.za>
Message-ID: <1515232188.57.0.467229070634.issue32500@psf.upfronthosting.co.za>


Serhiy Storchaka <storchaka+cpython at gmail.com> added the comment:

Agreed, it looks either mistaken or confusing. This wording is used from the first versions of the C API documentation. I don't know what is meant here.

----------
assignee:  -> docs at python
components: +Documentation -Extension Modules
nosy: +docs at python, gvanrossum
versions: +Python 3.7 -Python 3.4, Python 3.5

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32500>
_______________________________________

From report at bugs.python.org  Sat Jan  6 06:12:28 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sat, 06 Jan 2018 11:12:28 +0000
Subject: [docs] [issue29086] Document C API that is not part of the limited
 API
In-Reply-To: <1482865319.03.0.627052322458.issue29086@psf.upfronthosting.co.za>
Message-ID: <1515237148.94.0.467229070634.issue29086@psf.upfronthosting.co.za>


Serhiy Storchaka <storchaka+cpython at gmail.com> added the comment:

I have found that there is an option :stableabi: for C API elements. But it is not used in the documentation. Shouldn't we start to use it?

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue29086>
_______________________________________

From report at bugs.python.org  Sat Jan  6 10:16:27 2018
From: report at bugs.python.org (R. David Murray)
Date: Sat, 06 Jan 2018 15:16:27 +0000
Subject: [docs] [issue32501] Documentation for dir([object])
In-Reply-To: <1515228843.27.0.467229070634.issue32501@psf.upfronthosting.co.za>
Message-ID: <1515251787.73.0.467229070634.issue32501@psf.upfronthosting.co.za>


R. David Murray <rdmurray at bitdance.com> added the comment:

This is a general property of dunder methods in python3, and I think we have chosen not to change the wording when this has come up in other contexts.  I'm not sure, though.

----------
nosy: +r.david.murray

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32501>
_______________________________________

From report at bugs.python.org  Sat Jan  6 11:03:44 2018
From: report at bugs.python.org (Eric V. Smith)
Date: Sat, 06 Jan 2018 16:03:44 +0000
Subject: [docs] [issue32501] Documentation for dir([object])
In-Reply-To: <1515228843.27.0.467229070634.issue32501@psf.upfronthosting.co.za>
Message-ID: <1515254624.14.0.467229070634.issue32501@psf.upfronthosting.co.za>


Eric V. Smith <eric at trueblade.com> added the comment:

It's described here: https://docs.python.org/3/reference/datamodel.html#special-lookup

Maybe we should have a glossary entry for "special method lookup", and somehow link mentions like __dir__ to it?

This is slightly different from https://docs.python.org/3/reference/datamodel.html#specialnames, which already has a glossary entry.

On the other hand, unless you already understand the problem, it's going to be difficult to search for it.

----------
nosy: +eric.smith

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32501>
_______________________________________

From report at bugs.python.org  Sat Jan  6 12:02:24 2018
From: report at bugs.python.org (Guido van Rossum)
Date: Sat, 06 Jan 2018 17:02:24 +0000
Subject: [docs] [issue32500] PySequence_Length() raises TypeError on dict
 type
In-Reply-To: <1515199107.36.0.467229070634.issue32500@psf.upfronthosting.co.za>
Message-ID: <1515258144.71.0.467229070634.issue32500@psf.upfronthosting.co.za>


Guido van Rossum <guido at python.org> added the comment:

If we were to take the docs literally then PySequence_{Size,Length} should just be aliases for PyObject_Size.  But I'm reluctant to change something that has been like this for ages.

In fact maybe we should deprecate them, together with other PySequence_ and PyMapping_ operations that have more general PyObject_ alternatives?

You can read the source code to find the root cause for the behavior -- PySequence_{Size,Length} only looks for tp_as_sequence->sq_length, but dict has that field set to NULL.  (A dict's size is computed by tp_as_mapping->mp_length.)

Fixing dict by adding a redundant sq_length seems brittle (there may be many other mapping types with similar issues).

So I think we should update the docs to recommend PyObject_Size instead.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32500>
_______________________________________

From report at bugs.python.org  Sat Jan  6 15:21:31 2018
From: report at bugs.python.org (Matthew Cowles)
Date: Sat, 06 Jan 2018 20:21:31 +0000
Subject: [docs] [issue32501] Documentation for dir([object])
In-Reply-To: <1515228843.27.0.467229070634.issue32501@psf.upfronthosting.co.za>
Message-ID: <1515270091.16.0.467229070634.issue32501@psf.upfronthosting.co.za>


Matthew Cowles <mdcowles at users.sourceforge.net> added the comment:

If David is right and people have previously decided not to change wording like this, can someone explain why? As it stands, the meaning is clear and incorrect.

----------
nosy: +mdcowles

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32501>
_______________________________________

From report at bugs.python.org  Sat Jan  6 15:48:46 2018
From: report at bugs.python.org (=?utf-8?b?TWljaGHFgiBHw7Nybnk=?=)
Date: Sat, 06 Jan 2018 20:48:46 +0000
Subject: [docs] [issue32500] PySequence_Length() raises TypeError on dict
 type
In-Reply-To: <1515199107.36.0.467229070634.issue32500@psf.upfronthosting.co.za>
Message-ID: <1515271726.26.0.467229070634.issue32500@psf.upfronthosting.co.za>


Micha? G?rny <mgorny at gentoo.org> added the comment:

Well, my two main concerns are:

1) whether it is acceptable for PyPy to not raise TypeError in this case, or if I should report it to PyPy upstream as a bug,

2) and whether programmers can appropriately rely on PySequence_Length() raising TypeError for non-sequence types or if they should use e.g. PySequence_Check() explicitly.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32500>
_______________________________________

From report at bugs.python.org  Sat Jan  6 16:16:47 2018
From: report at bugs.python.org (Guido van Rossum)
Date: Sat, 06 Jan 2018 21:16:47 +0000
Subject: [docs] [issue32500] PySequence_Length() raises TypeError on dict
 type
In-Reply-To: <1515271726.26.0.467229070634.issue32500@psf.upfronthosting.co.za>
Message-ID: <CAP7+vJ+9vdoGjQRQxXbtysEeCfD6Utvh9VD6STSRMZOy7rqAgw@mail.gmail.com>


Guido van Rossum <guido at python.org> added the comment:

Since docs and implementation disagree let's call it undefined. I really
can't comment on what PyPy should do.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32500>
_______________________________________

From report at bugs.python.org  Sat Jan  6 17:54:16 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sat, 06 Jan 2018 22:54:16 +0000
Subject: [docs] [issue32500] PySequence_Length() raises TypeError on dict
 type
In-Reply-To: <1515199107.36.0.467229070634.issue32500@psf.upfronthosting.co.za>
Message-ID: <1515279256.08.0.467229070634.issue32500@psf.upfronthosting.co.za>


Serhiy Storchaka <storchaka+cpython at gmail.com> added the comment:

Note that many other PySequence_* functions support only sequences. For example PySequence_Count(o1, o2) is the equivalent of the Python expression o1 + o2 only if o1 is a sequence. If pass integer objects to PySequence_Count() it will return an error.

I would remove "do not" from the documentation. Or even the whole "For objects that do not provide sequence protocol" since this is implied.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32500>
_______________________________________

From report at bugs.python.org  Sat Jan  6 21:22:33 2018
From: report at bugs.python.org (R. David Murray)
Date: Sun, 07 Jan 2018 02:22:33 +0000
Subject: [docs] [issue32501] Documentation for dir([object])
In-Reply-To: <1515228843.27.0.467229070634.issue32501@psf.upfronthosting.co.za>
Message-ID: <1515291752.92.0.467229070634.issue32501@psf.upfronthosting.co.za>


R. David Murray <rdmurray at bitdance.com> added the comment:

I'm not sure, but the discussion I remember was that it would require changes to an awful lot of places in the docs that would make the docs harder to read.  It is very seldom in normal Python coding that an object has a method that it does *not* get from its class, and by the time you get to the level where you are adding methods to instances it is likely you know about dunder methods only being looked up on classes.  Usually you learn about it the first time you try to put a dunder method on an instance, and you scratch your head for a while, and then you find out...but complicating the docs to mention this at every turn would be...excessive, I think.  But again, I'm not 100% sure I'm remembering the outcome of that conversation, and I can't remember where it took place (it was an issue in this tracker, but I don't know which one.)

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32501>
_______________________________________

From report at bugs.python.org  Sun Jan  7 00:23:34 2018
From: report at bugs.python.org (Guido van Rossum)
Date: Sun, 07 Jan 2018 05:23:34 +0000
Subject: [docs] [issue32500] PySequence_Length() raises TypeError on dict
 type
In-Reply-To: <1515199107.36.0.467229070634.issue32500@psf.upfronthosting.co.za>
Message-ID: <1515302614.19.0.467229070634.issue32500@psf.upfronthosting.co.za>


Guido van Rossum <guido at python.org> added the comment:

Ah, I like dropping "For objects that do not provide sequence protocol". Go for it!

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32500>
_______________________________________

From report at bugs.python.org  Sun Jan  7 00:38:37 2018
From: report at bugs.python.org (Matthew Cowles)
Date: Sun, 07 Jan 2018 05:38:37 +0000
Subject: [docs] [issue32501] Documentation for dir([object])
In-Reply-To: <1515228843.27.0.467229070634.issue32501@psf.upfronthosting.co.za>
Message-ID: <1515303517.01.0.467229070634.issue32501@psf.upfronthosting.co.za>


Matthew Cowles <mdcowles at users.sourceforge.net> added the comment:

My thanks to David for the clarification. I don't find the logic he describes (but does not necessarily subscribe to!) persuasive in this case. In my opinion, "Let's be incorrect for the sake of simplicity," is not the way to document a programming language in the language's official library documentation.

I think that saying, "If the object (technically the class) has a method named..." would add very little burden to people who don't care about the difference.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32501>
_______________________________________

From report at bugs.python.org  Sun Jan  7 12:34:29 2018
From: report at bugs.python.org (Yahya Abou Imran)
Date: Sun, 07 Jan 2018 17:34:29 +0000
Subject: [docs] [issue32471] Add an UML class diagram to the collections.abc
 module documentation
In-Reply-To: <1514785654.69.0.467229070634.issue32471@psf.upfronthosting.co.za>
Message-ID: <1515346468.99.0.467229070634.issue32471@psf.upfronthosting.co.za>


Yahya Abou Imran <yahya-abou-imran at protonmail.com> added the comment:

I have generated SVG files.

Here is the rest of the ABCs present in the module:

https://gitlab.com/yahya-abou-imran/collections-abc-uml/blob/master/plantuml/other_collections.svg

And here is the full version with all ABCs:

https://gitlab.com/yahya-abou-imran/collections-abc-uml/blob/master/plantuml/full.svg

What do you prefer?

I'm gonna submit a PR with the full version right now. I will correct it if you think it's too big.

But I don't know how to run the server of the documentation locally, so I can't test it to see...

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32471>
_______________________________________

From report at bugs.python.org  Sun Jan  7 12:59:35 2018
From: report at bugs.python.org (Yahya Abou Imran)
Date: Sun, 07 Jan 2018 17:59:35 +0000
Subject: [docs] [issue32471] Add an UML class diagram to the collections.abc
 module documentation
In-Reply-To: <1514785654.69.0.467229070634.issue32471@psf.upfronthosting.co.za>
Message-ID: <1515347975.72.0.714561066657.issue32471@psf.upfronthosting.co.za>


Change by Yahya Abou Imran <yahya-abou-imran at protonmail.com>:


----------
keywords: +patch
pull_requests: +4994
stage:  -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32471>
_______________________________________

From report at bugs.python.org  Tue Jan  9 04:53:27 2018
From: report at bugs.python.org (Anant Prakash)
Date: Tue, 09 Jan 2018 09:53:27 +0000
Subject: [docs] [issue24459] Mention PYTHONFAULTHANDLER in the man page
In-Reply-To: <1434487895.85.0.561507121326.issue24459@psf.upfronthosting.co.za>
Message-ID: <1515491607.81.0.467229070634.issue24459@psf.upfronthosting.co.za>


Anant Prakash <anantprakashjsr at gmail.com> added the comment:

I am going to take the patch, edit and make a github PR for this.

Any updates on this issue are welcome. Thank you

----------
nosy: +Anant Prakash

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue24459>
_______________________________________

From adgjl13580 at yeah.net  Sat Jan  6 22:04:12 2018
From: adgjl13580 at yeah.net (adgjl13580)
Date: Sun, 7 Jan 2018 11:04:12 +0800 (CST)
Subject: [docs] Hello,
 there is bug with my matplotlib.1.5.1 when I try to import
 matplotlib.pyplot on Geany
Message-ID: <5a18a674.1a86.160ce935bf9.Coremail.adgjl13580@yeah.net>

when I tried to run 
import matplotlib.pyplot as plt
on Geany,this bug appeared.
But I have also tried to use cmd to run matplotlib.pyplot to show me some images,it could do it.
can you help me?
thank you!
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20180107/e9d7e769/attachment-0001.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: ??.PNG
Type: image/png
Size: 61660 bytes
Desc: not available
URL: <http://mail.python.org/pipermail/docs/attachments/20180107/e9d7e769/attachment-0004.png>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: ??.PNG
Type: image/png
Size: 53973 bytes
Desc: not available
URL: <http://mail.python.org/pipermail/docs/attachments/20180107/e9d7e769/attachment-0005.png>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: ??.PNG
Type: image/png
Size: 61660 bytes
Desc: not available
URL: <http://mail.python.org/pipermail/docs/attachments/20180107/e9d7e769/attachment-0006.png>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: ??.PNG
Type: image/png
Size: 53973 bytes
Desc: not available
URL: <http://mail.python.org/pipermail/docs/attachments/20180107/e9d7e769/attachment-0007.png>

From jaeha0919 at naver.com  Tue Jan  9 07:24:19 2018
From: jaeha0919 at naver.com (=?utf-8?B?7J207J6s7ZWY?=)
Date: Tue, 09 Jan 2018 21:24:19 +0900
Subject: [docs] =?utf-8?q?DE-buging_I_LOVE_LOU!!!!!!!!!!!!!!!!!!!!!!!!!!!?=
 =?utf-8?q?!!!?=
Message-ID: <2e6b7d4b8aa2f333fd938675fc9ea4c@cweb06.nm.nhnsystem.com>

Hello,my name  is Jaeha Lee,and I'm live in Korea. 
I'm student(14) and like programming VERY VERY MUCH!!!!
Of course, I'm writing this e-mail for tell you about the bug in python.
it is very small and small. but please fixed it(im so hard to make my school task TT)
ammm..... first "5**5**5"  [ 5^5^5 ](it's not string.)This expression has the original value of 298023223876953125(3125*5), but appears as(it is little big ^^;;;;;LOL)
1911012597945477520356404559703964599198437621363257303216452829794868625762453622180176732249405676428193600787207138370723553054463561539464011853484937927195145945055082327492216058489129109451899599486861995431476669380130371761635925944797461642250823164909672857121717081232327904818172683275101127467823174109858886837085.....................................4394218232191357223054066715373374248543645663782045701654593218154053548393614250664498585403307466468541890148134347714650315037954175778622811776585876941680908203125
his means not 3125*5 but 5*3125 
it means a^a^a=&gt;a^(a^a) 
?
not (a^a)^a
so, please debuging it. thank you...
last,
The Zen of Python, by Tim Peters
Beautiful is better than ugly.
Explicit is better than implicit.
Simple is better than complex.
Complex is better than complicated.
Flat is better than nested.
Sparse is better than dense.
Readability counts.
Special cases aren't special enough to break the rules.
Although practicality beats purity.
Errors should never pass silently.
Unless explicitly silenced.
In the face of ambiguity, refuse the temptation to guess.
There should be one-- and preferably only one --obvious way to do it.
Although that way may not be obvious at first unless you're Dutch.
Now is better than never.
Although never is often better than *right* now.
If the implementation is hard to explain, it's a bad idea.
If the implementation is easy to explain, it may be a good idea.
Namespaces are one honking great idea -- let's do more of those!
 
.
.
 
.
I LOVE YOU!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20180109/2a051611/attachment.html>

From monkeylil970 at gmail.com  Fri Jan  5 20:31:11 2018
From: monkeylil970 at gmail.com (Untamed Guerilla)
Date: Fri, 5 Jan 2018 19:31:11 -0600
Subject: [docs] Help Install
In-Reply-To: <CAP1rxO5xna-RY+0Y1hkaxvbmUWAj3a70r26i240B7pCeZUQMOg@mail.gmail.com>
References: <CADvK7CqGqXZqTqrdzUg=5D9c-GTkNcApi3HRvKGozfeMxJ4vfA@mail.gmail.com>
 <CAP1rxO5SEQfS--GOUD4Ub-Eaqvg6f4BA6Q8j3EwoiCAnOgQ5Mg@mail.gmail.com>
 <CAP1rxO5xna-RY+0Y1hkaxvbmUWAj3a70r26i240B7pCeZUQMOg@mail.gmail.com>
Message-ID: <CADvK7Cq5qEqB6nwggEgQEiUz5tq0YzbrTwJDk=VArGpUL_FVoA@mail.gmail.com>

Thanks for the tip!

On Jan 5, 2018 10:20 AM, "Bob Gailer" <bgailer at gmail.com> wrote:

> By the way docks at python.org is not the proper list for this kind of
> question.
>
> I suggest you send your reply and future questions to help at python.org.
>
> I'm dictating this hence the odd spelling.
>
> On Jan 5, 2018 11:18 AM, "Bob Gailer" <bgailer at gmail.com> wrote:
>
>> On Jan 5, 2018 11:00 AM, "Untamed Guerilla" <monkeylil970 at gmail.com>
>> wrote:
>> >
>> > Help With Installation, Please.....Thanks.
>>
>> We need more information. What operating system are you using?
>>
>> What Have you tried? What problems have you encountered?
>>
>> The normal procedure for installing python is to download the installer
>> for your operating system and then run that installer.
>>
>> Each operating system has its own quirks and peculiarities, which is why
>> we asked which one you're using.
>>
>> We eagerly expect your reply.
>> >
>> > _______________________________________________
>> > docs mailing list
>> > docs at python.org
>> > https://mail.python.org/mailman/listinfo/docs
>> >
>>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20180105/13c299ea/attachment.html>

From report at bugs.python.org  Tue Jan  9 08:11:07 2018
From: report at bugs.python.org (Anant Prakash)
Date: Tue, 09 Jan 2018 13:11:07 +0000
Subject: [docs] [issue24459] Mention PYTHONFAULTHANDLER in the man page
In-Reply-To: <1434487895.85.0.561507121326.issue24459@psf.upfronthosting.co.za>
Message-ID: <1515503467.5.0.467229070634.issue24459@psf.upfronthosting.co.za>


Anant Prakash <anantprakashjsr at gmail.com> added the comment:

Ignore my previous comment.
My bad.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue24459>
_______________________________________

From berker.peksag at gmail.com  Tue Jan  9 09:59:19 2018
From: berker.peksag at gmail.com (=?UTF-8?Q?Berker_Peksa=C4=9F?=)
Date: Tue, 9 Jan 2018 17:59:19 +0300
Subject: [docs] DE-buging I LOVE LOU!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
In-Reply-To: <2e6b7d4b8aa2f333fd938675fc9ea4c@cweb06.nm.nhnsystem.com>
References: <2e6b7d4b8aa2f333fd938675fc9ea4c@cweb06.nm.nhnsystem.com>
Message-ID: <CAF4280KP=z+Nuyg4cVk3u5kg+ccD3LdvsViShLc80L9R7q0Gnw@mail.gmail.com>

On Tue, Jan 9, 2018 at 3:24 PM, ??? <jaeha0919 at naver.com> wrote:

> Hello,my name  is Jaeha Lee,and I'm live in Korea.
>
> I'm student(14) and like programming VERY VERY MUCH!!!!
>
> Of course, I'm writing this e-mail for tell you about the bug in python.
>
> it is very small and small. but please fixed it(im so hard to make my
> school task TT)
>
> ammm..... first "5**5**5"  [ 5^5^5 ](it's not string.)This expression has
> the original value of 298023223876953125(3125*5), but appears as(it is
> little big ^^;;;;;LOL)
>
> 191101259794547752035640455970396459919843762136325730321645
> 282979486862576245362218017673224940567642819360078720713837
> 072355305446356153946401185348493792719514594505508232749221
> 605848912910945189959948686199543147666938013037176163592594
> 479746164225082316490967285712171708123232790481817268327510
> 1127467823174109858886837085.....................................
> 439421823219135722305406671537337424854364566378204570165459
> 321815405354839361425066449858540330746646854189014813434771
> 4650315037954175778622811776585876941680908203125
>
> his means not 3125*5 but 5*3125
>
> it means a^a^a=>a^(a^a)
>
> ?
> not (a^a)^a
>
> so, please debuging it. thank you...
>
Hi Jaeha,

Thank you for your email. I know this is a bit confusing but the result of
5**5**5 is correct. Python usually evaluate operators within the same
category (for example + and - operators) from left to right. So 5 - 2 + 3
will return 6 (it would return 0 if Python evaluated them from right to
left) However, the ** operator is an exception to the "evaluate from left
to right" rule and Python will evaluate them from right to left. So 5**5**5
will be calculated as 5**3125 not 3125**5 as you already described in your
email.

I hope that helps and thank you for using Python! :)

--Berker
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20180109/5072d176/attachment-0001.html>

From report at bugs.python.org  Tue Jan  9 10:59:35 2018
From: report at bugs.python.org (Marcel Plch)
Date: Tue, 09 Jan 2018 15:59:35 +0000
Subject: [docs] [issue32374] Document that m_traverse for multi-phase
 initialized modules can be called with m_state=NULL
In-Reply-To: <1513694438.46.0.213398074469.issue32374@psf.upfronthosting.co.za>
Message-ID: <1515513575.54.0.714561066657.issue32374@psf.upfronthosting.co.za>


Change by Marcel Plch <gmarcel.plch at gmail.com>:


----------
pull_requests: +4999

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32374>
_______________________________________

From report at bugs.python.org  Tue Jan  9 11:11:34 2018
From: report at bugs.python.org (Marcel Plch)
Date: Tue, 09 Jan 2018 16:11:34 +0000
Subject: [docs] [issue32374] Document that m_traverse for multi-phase
 initialized modules can be called with m_state=NULL
In-Reply-To: <1513694438.46.0.213398074469.issue32374@psf.upfronthosting.co.za>
Message-ID: <1515514294.71.0.467229070634.issue32374@psf.upfronthosting.co.za>


Marcel Plch <gmarcel.plch at gmail.com> added the comment:

I have created a PR at https://github.com/python/cpython/pull/5140
It contains documentation, plus, in --with-pydebug mode, it calls m_traverse to catch easy cases of not handling the m_state==NULL case early.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32374>
_______________________________________

From report at bugs.python.org  Tue Jan  9 11:21:22 2018
From: report at bugs.python.org (Ned Deily)
Date: Tue, 09 Jan 2018 16:21:22 +0000
Subject: [docs] [issue32523] inconsistent spacing in changelog.html
Message-ID: <1515514882.86.0.467229070634.issue32523@psf.upfronthosting.co.za>


New submission from Ned Deily <nad at python.org>:

The rendered changelog.html files produced "make html" have inconsistent spacing between items. Usually, the first changelog topic section (e.g. Security) starts with no blank lines between items but occasionally some subsequent sections will render with a blank link between items; this seems to be often true for the Library section, but not always. This is visible across the recent 3.x branches; here's an example with the stable 3.5 docs:

Library section has blank line separator:
https://docs.python.org/3.5/whatsnew/changelog.html#id5

Library section has no blank separators:
https://docs.python.org/3.5/whatsnew/changelog.html#id11

----------
assignee: docs at python
components: Documentation
messages: 309711
nosy: docs at python, ned.deily
priority: normal
severity: normal
status: open
title: inconsistent spacing in changelog.html
versions: Python 3.6, Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32523>
_______________________________________

From report at bugs.python.org  Tue Jan  9 11:22:51 2018
From: report at bugs.python.org (Ned Deily)
Date: Tue, 09 Jan 2018 16:22:51 +0000
Subject: [docs] [issue32523] inconsistent spacing in changelog.html
In-Reply-To: <1515514882.86.0.467229070634.issue32523@psf.upfronthosting.co.za>
Message-ID: <1515514971.19.0.467229070634.issue32523@psf.upfronthosting.co.za>


Ned Deily <nad at python.org> added the comment:

See also discussion at https://github.com/python/core-workflow/issues/209

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32523>
_______________________________________

From report at bugs.python.org  Tue Jan  9 19:54:36 2018
From: report at bugs.python.org (Barry A. Warsaw)
Date: Wed, 10 Jan 2018 00:54:36 +0000
Subject: [docs] [issue11260] smtpd-as-a-script feature should be documented
 and should use argparse
In-Reply-To: <1298232231.08.0.088023732748.issue11260@psf.upfronthosting.co.za>
Message-ID: <1515545676.22.0.467229070634.issue11260@psf.upfronthosting.co.za>


Barry A. Warsaw <barry at python.org> added the comment:

I'm closing this as won't fix since smtpd.py is deprecated and will likely not get any future development.  Please see aiosmtpd as a much better third party replacement.

----------
resolution:  -> wont fix
stage: patch review -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue11260>
_______________________________________

From gilles.feyrit at gmail.com  Wed Jan 10 03:08:23 2018
From: gilles.feyrit at gmail.com (Gilles Feyrit)
Date: Wed, 10 Jan 2018 09:08:23 +0100
Subject: [docs] Bug?
Message-ID: <CAO0cfdJ0hdZtzPg8Ny1dDOVmv_kMhLzPgu98Tq2-=hxE23au+g@mail.gmail.com>

Hi,

In:
https://docs.python.org/3/library/re.html#regular-expression-syntax
at:
\WMatches any character which is not a word character. This is the opposite
of \w. If the ASCII <https://docs.python.org/3/library/re.html#re.ASCII>
flag is used this becomes the equivalent of [^a-zA-Z0-9_] (but the flag
affects the entire regular expression, so in such cases using an explicit
[^a-zA-Z0-9_] may be a better choice). If the LOCALE
<https://docs.python.org/3/library/re.html#re.LOCALE> flag is used, matches
characters considered alphanumeric in the current locale and the underscore.
shouldn't it be instead:
\WMatches any character which is not a word character. This is the opposite
of \w. If the ASCII <https://docs.python.org/3/library/re.html#re.ASCII>
flag is used this becomes the equivalent of [^a-zA-Z0-9_] (but the flag
affects the entire regular expression, so in such cases using an explicit
[^a-zA-Z0-9_] may be a better choice). If the LOCALE
<https://docs.python.org/3/library/re.html#re.LOCALE> flag is used, matches
characters not considered alphanumeric in the current locale and the
underscore.
?
Thanks.

Gilles.

*---*
*Expect the best, plan for the worst, and prepare to be surprised. *
(Esp?re le meilleur, pr?pare-toi pour le pire & attends-toi ? ?tre surpris.)

*Denis Waitley*
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20180110/b31c177c/attachment.html>

From yvonneliu1107 at outlook.com  Wed Jan 10 04:34:56 2018
From: yvonneliu1107 at outlook.com (Liu Yvonne)
Date: Wed, 10 Jan 2018 09:34:56 +0000
Subject: [docs] undefined symbol: PyExc_SystemError
Message-ID: <5bec750fd1514a1d9c0f63c19ce5ac47d70c563db7aa4f03a9c9e77d00662ccePS1PR0601MB186579C72E0D61C76D298378AE110@PS1PR0601MB1865.apcprd06.prod.outlook.com>

Hi,


I am trying to embed python into c++ and then embed c++ into nodejs, one error is gotten when run node to call python, I spent a lot of time to figure it out, but failed, so I would like to seek help from you.


error message when run draw.js is shown as the screenshot of 'runError.jpg'

python configure is shown as 'pythonConfigure.jpg'

system is ubuntu16.04

js calling python is:

var draw = require('./build/Release/draw.node');
console.log(draw.draw('yv_po'));



Please let me know if more information is needed or there is mistakes made.


Looking forward to your reply.



Thanks


Best regards

Yvonne




-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20180110/7f7edb08/attachment-0001.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: pythonConfigure.JPG
Type: image/jpeg
Size: 94306 bytes
Desc: pythonConfigure.JPG
URL: <http://mail.python.org/pipermail/docs/attachments/20180110/7f7edb08/attachment-0002.jpe>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: runError.JPG
Type: image/jpeg
Size: 97188 bytes
Desc: runError.JPG
URL: <http://mail.python.org/pipermail/docs/attachments/20180110/7f7edb08/attachment-0003.jpe>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: binding.gyp
Type: application/octet-stream
Size: 735 bytes
Desc: binding.gyp
URL: <http://mail.python.org/pipermail/docs/attachments/20180110/7f7edb08/attachment-0002.obj>
-------------- next part --------------
An embedded and charset-unspecified text was scrubbed...
Name: draw.cc
URL: <http://mail.python.org/pipermail/docs/attachments/20180110/7f7edb08/attachment-0004.ksh>
-------------- next part --------------
An embedded and charset-unspecified text was scrubbed...
Name: draw.cpp
URL: <http://mail.python.org/pipermail/docs/attachments/20180110/7f7edb08/attachment-0005.ksh>
-------------- next part --------------
An embedded and charset-unspecified text was scrubbed...
Name: draw.h
URL: <http://mail.python.org/pipermail/docs/attachments/20180110/7f7edb08/attachment-0001.h>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: Makefile
Type: application/octet-stream
Size: 1216 bytes
Desc: Makefile
URL: <http://mail.python.org/pipermail/docs/attachments/20180110/7f7edb08/attachment-0003.obj>
-------------- next part --------------
An embedded and charset-unspecified text was scrubbed...
Name: pie.py
URL: <http://mail.python.org/pipermail/docs/attachments/20180110/7f7edb08/attachment-0006.ksh>
-------------- next part --------------
An embedded and charset-unspecified text was scrubbed...
Name: sql_query.py
URL: <http://mail.python.org/pipermail/docs/attachments/20180110/7f7edb08/attachment-0007.ksh>

From report at bugs.python.org  Thu Jan 11 01:25:56 2018
From: report at bugs.python.org (Xiang Zhang)
Date: Thu, 11 Jan 2018 06:25:56 +0000
Subject: [docs] [issue32532] improve sys.settrace and sys.setprofile
 documentation
Message-ID: <1515651956.68.0.467229070634.issue32532@psf.upfronthosting.co.za>


New submission from Xiang Zhang <angwerzx at 126.com>:

I propose to mention the behaviour that "if exception raised in tracefunc or profilefunc, the handler will be unset" in the documentation of sys.settrace and sys.setprofile. I encounter this behaviour and surprised by it since I can't get the info from the doc. Only by digging into the source code, I can find out why the profile messages suddenly disappear.

----------
assignee: docs at python
components: Documentation
keywords: easy
messages: 309793
nosy: docs at python, xiang.zhang
priority: normal
severity: normal
stage: needs patch
status: open
title: improve sys.settrace and sys.setprofile documentation
type: enhancement

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32532>
_______________________________________

From report at bugs.python.org  Thu Jan 11 04:10:45 2018
From: report at bugs.python.org (Xiang Zhang)
Date: Thu, 11 Jan 2018 09:10:45 +0000
Subject: [docs] [issue17799] settrace docs are wrong about "c_call" events
In-Reply-To: <1366428980.14.0.538502026896.issue17799@psf.upfronthosting.co.za>
Message-ID: <1515661845.04.0.467229070634.issue17799@psf.upfronthosting.co.za>


Xiang Zhang <angwerzx at 126.com> added the comment:

Is there any reason not to respond to "c_call" events in trace function?

----------
nosy: +xiang.zhang

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue17799>
_______________________________________

From report at bugs.python.org  Thu Jan 11 04:12:45 2018
From: report at bugs.python.org (Mark Lawrence)
Date: Thu, 11 Jan 2018 09:12:45 +0000
Subject: [docs] [issue17799] settrace docs are wrong about "c_call" events
In-Reply-To: <1366428980.14.0.538502026896.issue17799@psf.upfronthosting.co.za>
Message-ID: <1515661965.43.0.714561066657.issue17799@psf.upfronthosting.co.za>


Change by Mark Lawrence <breamoreboy at gmail.com>:


----------
nosy:  -BreamoreBoy

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue17799>
_______________________________________

From carlosromeromartin1955 at gmail.com  Thu Jan 11 05:56:13 2018
From: carlosromeromartin1955 at gmail.com (Carlos Romero Martin)
Date: Thu, 11 Jan 2018 11:56:13 +0100
Subject: [docs] Doc not Found
Message-ID: <2060478.3yC4NapHYL@laptopcrm.crmdevapp.be>

Hello,

First Happy New Year.

When I request the documentation from https://docs.python.org/fr/3.6/
download.html, I receive "python-3.6.4-docs-pdf-a4.zip" 404 Not Found.


Carlos Romero Martin
gsm:+32 489 091 244




-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20180111/e0ba134d/attachment.html>

From report at bugs.python.org  Fri Jan 12 09:09:49 2018
From: report at bugs.python.org (=?utf-8?q?Jo=C3=A3o_Sebasti=C3=A3o_de_Oliveira_Bueno?=)
Date: Fri, 12 Jan 2018 14:09:49 +0000
Subject: [docs] [issue19431] Document PyFrame_FastToLocals() and
 PyFrame_FastToLocalsWithError()
In-Reply-To: <1383040535.91.0.284405039579.issue19431@psf.upfronthosting.co.za>
Message-ID: <1515766188.99.0.467229070634.issue19431@psf.upfronthosting.co.za>


Jo?o Sebasti?o de Oliveira Bueno <gwidion at gmail.com> added the comment:

This discussion is fresh, so maybe it is worth asking here prior to python-ideas:

In Python we can change any global variable, object attribute or mapping-value with function calls. Locals and nonlocals are the only exceptions and from time to time that gets in the way of clever oneliners, and it is just plain asymmetric. 

What do you say of adding a wrapper to this as an oficial Python function in the stdlib? Maybe inspect.setlocal() that could set f_locals and call this?? That would  provide a workaround to the asymmetry that locals currently experiment. 

It would not impose any extra security risks, since this can be called via ctypes already, and also it is not any more subject to abuse than setattr or globals()[...] =  can already be abused.

----------
nosy: +Jo?o.Sebasti?o.de.Oliveira.Bueno

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue19431>
_______________________________________

From report at bugs.python.org  Fri Jan 12 09:37:57 2018
From: report at bugs.python.org (Tilman Beck)
Date: Fri, 12 Jan 2018 14:37:57 +0000
Subject: [docs] [issue32537] multiprocessing.pool.Pool.starmap_async - wrong
 parameter name
Message-ID: <1515767877.08.0.467229070634.issue32537@psf.upfronthosting.co.za>


New submission from Tilman Beck <tilman-beck at gmx.de>:

The optional parameter for the error callback function is named "error_callback" not "error_back"

----------
assignee: docs at python
components: Documentation
files: bug.png
messages: 309857
nosy: devnull, docs at python
priority: normal
severity: normal
status: open
title: multiprocessing.pool.Pool.starmap_async - wrong parameter name
versions: Python 3.5
Added file: https://bugs.python.org/file47381/bug.png

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32537>
_______________________________________

From pushergene at protonmail.com  Fri Jan 12 09:21:30 2018
From: pushergene at protonmail.com (Pushergene)
Date: Fri, 12 Jan 2018 09:21:30 -0500
Subject: [docs] Code not working
Message-ID: <cIxupHE1waFOPW_wDPxRQxZZZh_bJ__4Zo8rwBWZf-W-96F-CedDcIvJbKiTf5zGlQbate1_xYPSfEewtRjrOZ-XXNpAGQbwQXGAhkChwZc=@protonmail.com>

Hey,
The code in https://docs.python.org/3/library/operator.html#inplace-operators is not working.
Its confusing, please change it... python 3.6.4
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20180112/6b2260d9/attachment.html>

From report at bugs.python.org  Fri Jan 12 13:07:13 2018
From: report at bugs.python.org (Jason R. Coombs)
Date: Fri, 12 Jan 2018 18:07:13 +0000
Subject: [docs] [issue32540] venv docs - doesn't match behavior
Message-ID: <1515780433.02.0.467229070634.issue32540@psf.upfronthosting.co.za>


New submission from Jason R. Coombs <jaraco at jaraco.com>:

In the docs for the venv command, it states:

> Changed in version 3.4: In earlier versions, if the target directory already existed, an error was raised, unless the --clear or --upgrade option was provided. Now, if an existing directory is specified, its contents are removed and the directory is processed as if it had been newly created.

However, that's not the behavior I observe:

$ python -m venv env
$ env/bin/pip install -q requests
$ python -m venv env          
$ env/bin/python -c "import requests"
$

Plus, I believe the _current_ behavior should be documented not in a 'change' note. I suggest the change note should read:

> Changed in version 3.4: In earlier versions, if the target directory already existed, an error was raised, unless the --clear or --upgrade option was provided.

And the third paragraph, following "It also creates an (initially empty...Lib\site-packages).":

> If an existing directory is specified, it will be re-used.

----------
assignee: docs at python
components: Documentation
messages: 309867
nosy: docs at python, jason.coombs
priority: normal
severity: normal
status: open
title: venv docs - doesn't match behavior

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32540>
_______________________________________

From berker.peksag at gmail.com  Fri Jan 12 16:32:02 2018
From: berker.peksag at gmail.com (=?UTF-8?Q?Berker_Peksa=C4=9F?=)
Date: Sat, 13 Jan 2018 00:32:02 +0300
Subject: [docs] Code not working
In-Reply-To: <cIxupHE1waFOPW_wDPxRQxZZZh_bJ__4Zo8rwBWZf-W-96F-CedDcIvJbKiTf5zGlQbate1_xYPSfEewtRjrOZ-XXNpAGQbwQXGAhkChwZc=@protonmail.com>
References: <cIxupHE1waFOPW_wDPxRQxZZZh_bJ__4Zo8rwBWZf-W-96F-CedDcIvJbKiTf5zGlQbate1_xYPSfEewtRjrOZ-XXNpAGQbwQXGAhkChwZc=@protonmail.com>
Message-ID: <CAF4280JMLqqyAuNWvVTQAbP-AqL-CtKB2WaSihtLiijnpvUrQw@mail.gmail.com>

On Fri, Jan 12, 2018 at 5:21 PM, Pushergene via docs <docs at python.org> wrote:
> Hey,
> The code in
> https://docs.python.org/3/library/operator.html#inplace-operators is not
> working.
> Its confusing, please change it... python 3.6.4

Can you give us a little bit more details? Both snippet work for me:

>>> from operator import iadd
>>> a = 'hello'
>>> iadd(a, ' world')
'hello world'
>>> s = ['h', 'e', 'l', 'l', 'o']
>>> iadd(s, [' ', 'w', 'o', 'r', 'l', 'd'])
['h', 'e', 'l', 'l', 'o', ' ', 'w', 'o', 'r', 'l', 'd']
>>> s
['h', 'e', 'l', 'l', 'o', ' ', 'w', 'o', 'r', 'l', 'd']

--Berker

From report at bugs.python.org  Fri Jan 12 18:22:25 2018
From: report at bugs.python.org (Martin Panter)
Date: Fri, 12 Jan 2018 23:22:25 +0000
Subject: [docs] [issue32537] multiprocessing.pool.Pool.starmap_async - wrong
 parameter name
In-Reply-To: <1515767877.08.0.467229070634.issue32537@psf.upfronthosting.co.za>
Message-ID: <1515799345.49.0.467229070634.issue32537@psf.upfronthosting.co.za>


Martin Panter <vadmium+py at gmail.com> added the comment:

This was supposed to be fixed in 3.6+ by Issue 31304. In general, 3.5 only gets security fixes at this stage. I?m not sure if it is easy or worth back porting this.

----------
nosy: +martin.panter

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32537>
_______________________________________

From report at bugs.python.org  Fri Jan 12 18:41:18 2018
From: report at bugs.python.org (Ned Deily)
Date: Fri, 12 Jan 2018 23:41:18 +0000
Subject: [docs] [issue32537] multiprocessing.pool.Pool.starmap_async - wrong
 parameter name
In-Reply-To: <1515767877.08.0.467229070634.issue32537@psf.upfronthosting.co.za>
Message-ID: <1515800478.75.0.467229070634.issue32537@psf.upfronthosting.co.za>


Ned Deily <nad at python.org> added the comment:

This wouldn't qualify as a security problem so, if the problem no longer exists in 3.6, then this issue should be closed

----------
nosy: +ned.deily

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32537>
_______________________________________

From report at bugs.python.org  Sat Jan 13 22:52:39 2018
From: report at bugs.python.org (Jay Crotts)
Date: Sun, 14 Jan 2018 03:52:39 +0000
Subject: [docs] [issue8243] curses writing to window's bottom right position
 raises: `_curses.error: addstr() returned ERR'
In-Reply-To: <1352121880.55.0.191535515397.issue8243@psf.upfronthosting.co.za>
Message-ID: <1515901959.55.0.714561066657.issue8243@psf.upfronthosting.co.za>


Change by Jay Crotts <crotts.jay at gmail.com>:


----------
keywords: +patch
pull_requests: +5031
stage: needs patch -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue8243>
_______________________________________

From report at bugs.python.org  Sun Jan 14 04:31:15 2018
From: report at bugs.python.org (Paul Rudin)
Date: Sun, 14 Jan 2018 09:31:15 +0000
Subject: [docs] [issue17972] inspect module docs omits many functions
In-Reply-To: <1368501068.91.0.677640111487.issue17972@psf.upfronthosting.co.za>
Message-ID: <1515922274.97.0.467229070634.issue17972@psf.upfronthosting.co.za>


Paul Rudin <paul at rudin.co.uk> added the comment:

Although formatannotation is undocumented, its actually documented as a default value for one of the parameters of formatargspec, so it does form part of the module's public interface. However formatargspec is deprecated, so it's still OK to deprecate formatannotation.

formatannotation is also used as a helper within Parameter, which isn't deprecated, but the public interface or docs of Parameter don't mention formatannotation, so using _formatannotation instead is fine.

Since I've looked through this and, as far as I can tell, nobody is working on it, I'll make the changes and make a PR.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue17972>
_______________________________________

From report at bugs.python.org  Sun Jan 14 16:53:49 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Sun, 14 Jan 2018 21:53:49 +0000
Subject: [docs] [issue26330] shutil.disk_usage() on Windows can't properly
 handle unicode
In-Reply-To: <1455117077.45.0.531847730839.issue26330@psf.upfronthosting.co.za>
Message-ID: <1515966829.83.0.714561066657.issue26330@psf.upfronthosting.co.za>


Change by Cheryl Sabella <chekat2 at gmail.com>:


----------
keywords: +patch
pull_requests: +5038
stage:  -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue26330>
_______________________________________

From report at bugs.python.org  Sun Jan 14 16:54:47 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Sun, 14 Jan 2018 21:54:47 +0000
Subject: [docs] [issue26330] shutil.disk_usage() on Windows can't properly
 handle unicode
In-Reply-To: <1455117077.45.0.531847730839.issue26330@psf.upfronthosting.co.za>
Message-ID: <1515966887.36.0.714561066657.issue26330@psf.upfronthosting.co.za>


Change by Cheryl Sabella <chekat2 at gmail.com>:


----------
versions: +Python 3.7 -Python 3.3, Python 3.4, Python 3.5, Python 3.6

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue26330>
_______________________________________

From report at bugs.python.org  Sun Jan 14 16:55:03 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Sun, 14 Jan 2018 21:55:03 +0000
Subject: [docs] [issue26330] shutil.disk_usage() on Windows can't properly
 handle unicode
In-Reply-To: <1455117077.45.0.531847730839.issue26330@psf.upfronthosting.co.za>
Message-ID: <1515966903.27.0.467229070634.issue26330@psf.upfronthosting.co.za>


Cheryl Sabella <chekat2 at gmail.com> added the comment:

I've submitted a PR for the documentation change.

----------
nosy: +csabella

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue26330>
_______________________________________

From report at bugs.python.org  Sun Jan 14 17:07:38 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Sun, 14 Jan 2018 22:07:38 +0000
Subject: [docs] [issue15115] Duplicated Content-Transfer-Encoding header
 when applying email.encoders
In-Reply-To: <1340188711.86.0.286169814605.issue15115@psf.upfronthosting.co.za>
Message-ID: <1515967658.65.0.467229070634.issue15115@psf.upfronthosting.co.za>


Cheryl Sabella <chekat2 at gmail.com> added the comment:

Barry/David,

Is this still a change you wanted to include in the documentation?


Thanks!

----------
nosy: +csabella

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue15115>
_______________________________________

From report at bugs.python.org  Sun Jan 14 18:07:47 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Sun, 14 Jan 2018 23:07:47 +0000
Subject: [docs] [issue15221] os.path.is*() may return False if path can't be
 accessed
In-Reply-To: <1340929189.09.0.471144924132.issue15221@psf.upfronthosting.co.za>
Message-ID: <1515971267.72.0.714561066657.issue15221@psf.upfronthosting.co.za>


Change by Cheryl Sabella <chekat2 at gmail.com>:


----------
keywords: +patch
pull_requests: +5039
stage:  -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue15221>
_______________________________________

From report at bugs.python.org  Sun Jan 14 18:11:24 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Sun, 14 Jan 2018 23:11:24 +0000
Subject: [docs] [issue15221] os.path.is*() may return False if path can't be
 accessed
In-Reply-To: <1340929189.09.0.471144924132.issue15221@psf.upfronthosting.co.za>
Message-ID: <1515971484.47.0.467229070634.issue15221@psf.upfronthosting.co.za>


Cheryl Sabella <chekat2 at gmail.com> added the comment:

I created a PR for this by making the word 'existing' a link to 'os.path.exists' since Nick mentioned that that word already implied the definition.

----------
nosy: +csabella
versions: +Python 3.7 -Python 2.7, Python 3.2, Python 3.3

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue15221>
_______________________________________

From report at bugs.python.org  Sun Jan 14 20:27:27 2018
From: report at bugs.python.org (Eryk Sun)
Date: Mon, 15 Jan 2018 01:27:27 +0000
Subject: [docs] [issue26330] shutil.disk_usage() on Windows can't properly
 handle unicode
In-Reply-To: <1455117077.45.0.531847730839.issue26330@psf.upfronthosting.co.za>
Message-ID: <1515979647.28.0.467229070634.issue26330@psf.upfronthosting.co.za>


Eryk Sun <eryksun at gmail.com> added the comment:

This is the high-level shutil module, so why not try to use the resolved parent directory? For example:

    def disk_usage(path):
        try:
            total, free = nt._getdiskusage(path)
        except NotADirectoryError:
            path = os.path.dirname(nt._getfinalpathname(path))
            total, free = nt._getdiskusage(path)
        used = total - free
        return _ntuple_diskusage(total, used, free)

Also, as noted in msg260022, nt._getdiskusage was overlooked when implementing PEP 529. The same applies to nt._getfinalpathname and nt._getvolumepathname. nt._getfullpathname works with bytes because it takes an argument-clinic `path_t` instead of `unicode` or `Py_UNICODE`. I think the other 3 should be rewritten to use path_t, but it's out of scope for this issue.

----------
nosy: +eryksun

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue26330>
_______________________________________

From report at bugs.python.org  Sun Jan 14 21:08:16 2018
From: report at bugs.python.org (Paul Watson)
Date: Mon, 15 Jan 2018 02:08:16 +0000
Subject: [docs] [issue32553] venv says to use python3 which does not exist
 in 3.6.4
Message-ID: <1515982096.25.0.467229070634.issue32553@psf.upfronthosting.co.za>


New submission from Paul Watson <paul.hermeneutic at gmail.com>:

The 3.6.4 documentation on venv specifies using 'python3', but no python3 executable is in the 3.6.4 kit.

https://docs.python.org/3/library/venv.html?highlight=venv#module-venv

----------
assignee: docs at python
components: Documentation
messages: 309943
nosy: Paul Watson, docs at python
priority: normal
severity: normal
status: open
title: venv says to use python3 which does not exist in 3.6.4
type: enhancement
versions: Python 3.6

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32553>
_______________________________________

From report at bugs.python.org  Sun Jan 14 23:57:54 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 15 Jan 2018 04:57:54 +0000
Subject: [docs] [issue15221] os.path.is*() may return False if path can't be
 accessed
In-Reply-To: <1340929189.09.0.471144924132.issue15221@psf.upfronthosting.co.za>
Message-ID: <1515992273.91.0.467229070634.issue15221@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:


New changeset b3dd18d4035803b50c65a434955966d1b3b1f363 by Mariatta (Cheryl Sabella) in branch 'master':
bpo-15221: Update os.path.is*() documentation (GH-5185)
https://github.com/python/cpython/commit/b3dd18d4035803b50c65a434955966d1b3b1f363


----------
nosy: +Mariatta

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue15221>
_______________________________________

From report at bugs.python.org  Sun Jan 14 23:58:08 2018
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 15 Jan 2018 04:58:08 +0000
Subject: [docs] [issue15221] os.path.is*() may return False if path can't be
 accessed
In-Reply-To: <1340929189.09.0.471144924132.issue15221@psf.upfronthosting.co.za>
Message-ID: <1515992288.16.0.714561066657.issue15221@psf.upfronthosting.co.za>


Change by Roundup Robot <devnull at psf.upfronthosting.co.za>:


----------
pull_requests: +5040

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue15221>
_______________________________________

From report at bugs.python.org  Mon Jan 15 00:08:39 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 15 Jan 2018 05:08:39 +0000
Subject: [docs] [issue26330] shutil.disk_usage() on Windows can't properly
 handle unicode
In-Reply-To: <1455117077.45.0.531847730839.issue26330@psf.upfronthosting.co.za>
Message-ID: <1515992919.2.0.467229070634.issue26330@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:


New changeset ee3b83547c6b0cac1da2cb44aaaea533a1d1bbc8 by Mariatta (Cheryl Sabella) in branch 'master':
bpo-26330: Update shutil.disk_usage() documentation (GH-5184)
https://github.com/python/cpython/commit/ee3b83547c6b0cac1da2cb44aaaea533a1d1bbc8


----------
nosy: +Mariatta

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue26330>
_______________________________________

From report at bugs.python.org  Mon Jan 15 00:08:48 2018
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 15 Jan 2018 05:08:48 +0000
Subject: [docs] [issue26330] shutil.disk_usage() on Windows can't properly
 handle unicode
In-Reply-To: <1455117077.45.0.531847730839.issue26330@psf.upfronthosting.co.za>
Message-ID: <1515992928.03.0.714561066657.issue26330@psf.upfronthosting.co.za>


Change by Roundup Robot <devnull at psf.upfronthosting.co.za>:


----------
pull_requests: +5042

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue26330>
_______________________________________

From report at bugs.python.org  Mon Jan 15 00:26:41 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 15 Jan 2018 05:26:41 +0000
Subject: [docs] [issue32553] venv says to use python3 which does not exist
 in 3.6.4
In-Reply-To: <1515982096.25.0.467229070634.issue32553@psf.upfronthosting.co.za>
Message-ID: <1515994001.36.0.467229070634.issue32553@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:

People who has more than one Python versions installed will have python3.

----------
nosy: +Mariatta

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32553>
_______________________________________

From report at bugs.python.org  Mon Jan 15 00:44:51 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 15 Jan 2018 05:44:51 +0000
Subject: [docs] [issue15221] os.path.is*() may return False if path can't be
 accessed
In-Reply-To: <1340929189.09.0.471144924132.issue15221@psf.upfronthosting.co.za>
Message-ID: <1515995091.34.0.467229070634.issue15221@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:


New changeset bb80645d06c16461b0b58d8983cd7fa6962ba3c6 by Mariatta (Miss Islington (bot)) in branch '3.6':
bpo-15221: Update os.path.is*() documentation (GH-5185) (GH-5186)
https://github.com/python/cpython/commit/bb80645d06c16461b0b58d8983cd7fa6962ba3c6


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue15221>
_______________________________________

From report at bugs.python.org  Mon Jan 15 00:46:30 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 15 Jan 2018 05:46:30 +0000
Subject: [docs] [issue15221] os.path.is*() may return False if path can't be
 accessed
In-Reply-To: <1340929189.09.0.471144924132.issue15221@psf.upfronthosting.co.za>
Message-ID: <1515995190.1.0.467229070634.issue15221@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:

Thanks!

----------
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue15221>
_______________________________________

From report at bugs.python.org  Mon Jan 15 04:13:25 2018
From: report at bugs.python.org (STINNER Victor)
Date: Mon, 15 Jan 2018 09:13:25 +0000
Subject: [docs] [issue32554] random seed is not consistent when using tuples
 with a str element
In-Reply-To: <1516007302.18.0.467229070634.issue32554@psf.upfronthosting.co.za>
Message-ID: <1516007605.67.0.467229070634.issue32554@psf.upfronthosting.co.za>


STINNER Victor <victor.stinner at gmail.com> added the comment:

random.seed(str) uses:

        if version == 2 and isinstance(a, (str, bytes, bytearray)):
            if isinstance(a, str):
                a = a.encode()
            a += _sha512(a).digest()
            a = int.from_bytes(a, 'big')

Whereas for other types, random.seed(obj) uses hash(obj), and hash is randomized by default in Python 3.

Yeah, the random.seed() documentation should describe the implementation and explain that hash(obj) is used and that the hash function is randomized by default:
https://docs.python.org/dev/library/random.html#random.seed

----------
assignee:  -> docs at python
components: +Documentation
nosy: +docs at python, mark.dickinson, rhettinger, vstinner

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32554>
_______________________________________

From report at bugs.python.org  Mon Jan 15 04:13:51 2018
From: report at bugs.python.org (STINNER Victor)
Date: Mon, 15 Jan 2018 09:13:51 +0000
Subject: [docs] [issue32554] random.seed(tuple) uses the randomized hash
 function and so is not reproductible
In-Reply-To: <1516007302.18.0.467229070634.issue32554@psf.upfronthosting.co.za>
Message-ID: <1516007631.06.0.714561066657.issue32554@psf.upfronthosting.co.za>


Change by STINNER Victor <victor.stinner at gmail.com>:


----------
title: random seed is not consistent when using tuples with a str element -> random.seed(tuple) uses the randomized hash function and so is not reproductible

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32554>
_______________________________________

From report at bugs.python.org  Mon Jan 15 09:32:19 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 15 Jan 2018 14:32:19 +0000
Subject: [docs] [issue26330] shutil.disk_usage() on Windows can't properly
 handle unicode
In-Reply-To: <1455117077.45.0.531847730839.issue26330@psf.upfronthosting.co.za>
Message-ID: <1516026739.05.0.467229070634.issue26330@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:


New changeset fb8569e36f2629654d5bc9c7ba05978edce408f4 by Mariatta (Miss Islington (bot)) in branch '3.6':
bpo-26330: Update shutil.disk_usage() documentation (GH-5184) (GH-5188)
https://github.com/python/cpython/commit/fb8569e36f2629654d5bc9c7ba05978edce408f4


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue26330>
_______________________________________

From report at bugs.python.org  Mon Jan 15 09:33:33 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 15 Jan 2018 14:33:33 +0000
Subject: [docs] [issue26330] shutil.disk_usage() on Windows can't properly
 handle unicode
In-Reply-To: <1455117077.45.0.531847730839.issue26330@psf.upfronthosting.co.za>
Message-ID: <1516026813.23.0.467229070634.issue26330@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:

Thanks!

----------
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed
versions: +Python 3.6

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue26330>
_______________________________________

From report at bugs.python.org  Mon Jan 15 11:40:20 2018
From: report at bugs.python.org (Tristan Colombo)
Date: Mon, 15 Jan 2018 16:40:20 +0000
Subject: [docs] [issue32558] Socketserver documentation : error in server
 example
Message-ID: <1516034420.52.0.467229070634.issue32558@psf.upfronthosting.co.za>


New submission from Tristan Colombo <tristan.colombo at gmail.com>:

In the documentation, at page :
- https://docs.python.org/3.6/library/socketserver.html
- Section 21.21.4.1

In the server side code :
if __name__ == "__main__":
    HOST, PORT = "localhost", 9999

    # Create the server, binding to localhost on port 9999
    with socketserver.TCPServer((HOST, PORT), MyTCPHandler) as server:
    ...

We got an error line 24 :     
with socketserver.TCPServer((HOST, PORT), MyTCPHandler) as server:
AttributeError: __exit__

socketserver.TCPServer object has no __exit__() method and can not be used in 'with' statement.

Proposed correction :
server = socketserver.TCPServer((HOST, PORT), MyTCPHandler)
with server:
    ...

----------
assignee: docs at python
components: Documentation
messages: 309995
nosy: docs at python, tcolombo
priority: normal
severity: normal
status: open
title: Socketserver documentation : error in server example
versions: Python 3.6

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32558>
_______________________________________

From report at bugs.python.org  Mon Jan 15 11:43:42 2018
From: report at bugs.python.org (Tristan Colombo)
Date: Mon, 15 Jan 2018 16:43:42 +0000
Subject: [docs] [issue32558] Socketserver documentation : error in server
 example
In-Reply-To: <1516034420.52.0.467229070634.issue32558@psf.upfronthosting.co.za>
Message-ID: <1516034622.89.0.467229070634.issue32558@psf.upfronthosting.co.za>


Tristan Colombo <tristan.colombo at gmail.com> added the comment:

Correction of my previous correction :
server = socketserver.TCPServer((HOST, PORT), MyTCPHandler)

'with' statement can not be used...

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32558>
_______________________________________

From report at bugs.python.org  Mon Jan 15 11:45:32 2018
From: report at bugs.python.org (Ned Deily)
Date: Mon, 15 Jan 2018 16:45:32 +0000
Subject: [docs] [issue32558] Socketserver documentation : error in server
 example
In-Reply-To: <1516034420.52.0.467229070634.issue32558@psf.upfronthosting.co.za>
Message-ID: <1516034732.68.0.467229070634.issue32558@psf.upfronthosting.co.za>


Ned Deily <nad at python.org> added the comment:

In what environment are you trying this?  The example works for me (on a current macOS) system.

----------
nosy: +ned.deily

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32558>
_______________________________________

From report at bugs.python.org  Mon Jan 15 11:51:12 2018
From: report at bugs.python.org (Tristan Colombo)
Date: Mon, 15 Jan 2018 16:51:12 +0000
Subject: [docs] [issue32558] Socketserver documentation : error in server
 example
In-Reply-To: <1516034420.52.0.467229070634.issue32558@psf.upfronthosting.co.za>
Message-ID: <1516035072.9.0.467229070634.issue32558@psf.upfronthosting.co.za>


Tristan Colombo <tristan.colombo at gmail.com> added the comment:

Running on Debian Etch
Ok, my python3 was broken and links to python3.5.3
All my apologizes

----------
stage:  -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32558>
_______________________________________

From report at bugs.python.org  Mon Jan 15 12:04:47 2018
From: report at bugs.python.org (Ned Deily)
Date: Mon, 15 Jan 2018 17:04:47 +0000
Subject: [docs] [issue32553] venv says to use python3 which does not exist
 in 3.6.4
In-Reply-To: <1515982096.25.0.467229070634.issue32553@psf.upfronthosting.co.za>
Message-ID: <1516035887.25.0.467229070634.issue32553@psf.upfronthosting.co.za>


Ned Deily <nad at python.org> added the comment:

Unfortunately, it may depend on what environment and/or from which distributor you obtain Python 3.6 as to whether there is a "python3" link installed.  On Unix-like systems, the default Python installation built from source ("make install") does install both "python3.6" and "python3" links in the configured "bin" directory.  But that may not be true everywhere.  On what environment are you running Python 3.6 and from where was it installed?

----------
nosy: +ned.deily

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32553>
_______________________________________

From report at bugs.python.org  Mon Jan 15 12:08:43 2018
From: report at bugs.python.org (Paul Watson)
Date: Mon, 15 Jan 2018 17:08:43 +0000
Subject: [docs] [issue32553] venv says to use python3 which does not exist
 in 3.6.4
In-Reply-To: <1515982096.25.0.467229070634.issue32553@psf.upfronthosting.co.za>
Message-ID: <1516036123.33.0.467229070634.issue32553@psf.upfronthosting.co.za>


Paul Watson <paul.hermeneutic at gmail.com> added the comment:

I am running 3.6.4 from a download on pythong.org yesterday.

Python 3.6.4 (v3.6.4:d48eceb, Dec 19 2017, 06:54:40) [MSC v.1900 64 bit (AMD64)] on win32

There is a python3.dll, but no python3 executable.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32553>
_______________________________________

From report at bugs.python.org  Mon Jan 15 12:09:20 2018
From: report at bugs.python.org (Ned Deily)
Date: Mon, 15 Jan 2018 17:09:20 +0000
Subject: [docs] [issue32553] venv says to use python3 which does not exist
 in 3.6.4
In-Reply-To: <1515982096.25.0.467229070634.issue32553@psf.upfronthosting.co.za>
Message-ID: <1516036160.44.0.714561066657.issue32553@psf.upfronthosting.co.za>


Change by Ned Deily <nad at python.org>:


----------
components: +Windows
nosy: +paul.moore, steve.dower, tim.golden, zach.ware

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32553>
_______________________________________

From report at bugs.python.org  Mon Jan 15 12:09:51 2018
From: report at bugs.python.org (Ned Deily)
Date: Mon, 15 Jan 2018 17:09:51 +0000
Subject: [docs] [issue32553] venv says to use python3 which does not exist
 in 3.6.4
In-Reply-To: <1515982096.25.0.467229070634.issue32553@psf.upfronthosting.co.za>
Message-ID: <1516036191.73.0.467229070634.issue32553@psf.upfronthosting.co.za>


Ned Deily <nad at python.org> added the comment:

Thanks! Pinging the Windows team.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32553>
_______________________________________

From report at bugs.python.org  Mon Jan 15 12:41:44 2018
From: report at bugs.python.org (Paul Moore)
Date: Mon, 15 Jan 2018 17:41:44 +0000
Subject: [docs] [issue32553] venv says to use python3 which does not exist
 in 3.6.4
In-Reply-To: <1515982096.25.0.467229070634.issue32553@psf.upfronthosting.co.za>
Message-ID: <1516038104.44.0.467229070634.issue32553@psf.upfronthosting.co.za>


Paul Moore <p.f.moore at gmail.com> added the comment:

Actually, for Windows, the docs don't recommend "python3", they say:

"""
On Windows, invoke the venv command as follows:

c:\>c:\Python35\python -m venv c:\path\to\myenv
"""

This should probably be altered to say "py -m venv" (or maybe "py -3 -m venv", but I don't think that's really necessary), as using the launcher is less tied to having your PATH set, or using an explicit path.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32553>
_______________________________________

From report at bugs.python.org  Mon Jan 15 13:19:48 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Mon, 15 Jan 2018 18:19:48 +0000
Subject: [docs] [issue32554] random.seed(tuple) uses the randomized hash
 function and so is not reproductible
In-Reply-To: <1516007302.18.0.467229070634.issue32554@psf.upfronthosting.co.za>
Message-ID: <1516040388.83.0.714561066657.issue32554@psf.upfronthosting.co.za>


Change by Raymond Hettinger <raymond.hettinger at gmail.com>:


----------
assignee: docs at python -> rhettinger

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32554>
_______________________________________

From report at bugs.python.org  Mon Jan 15 13:41:43 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Mon, 15 Jan 2018 18:41:43 +0000
Subject: [docs] [issue32554] random.seed(tuple) uses the randomized hash
 function and so is not reproductible
In-Reply-To: <1516007302.18.0.467229070634.issue32554@psf.upfronthosting.co.za>
Message-ID: <1516041703.0.0.467229070634.issue32554@psf.upfronthosting.co.za>


Raymond Hettinger <raymond.hettinger at gmail.com> added the comment:

I'm getting a nice improvement in dispersion statistics by shuffling in higher bits right at the end:

     /* Disperse patterns arising in nested frozensets */
  +  hash ^= (hash >> 11) ^ (~hash >> 25);
     hash = hash * 69069U + 907133923UL;

Results for range() check:

                     range       range
                    baseline      new
  1st percentile     35.06%      40.63%
  1st decile         48.03%      51.34%
  mean               61.47%      63.24%      
  median             63.24%      65.58% 

Test code for the letter_range() test:

                     letter      letter
                    baseline      new
  1st percentile     39.59%      40.14%
  1st decile         50.90%      51.07%
  mean               63.02%      63.04%      
  median             65.21%      65.23% 


    def letter_range(n):
        return string.ascii_letters[:n]

    def powerset(s):
        for i in range(len(s)+1):
            yield from map(frozenset, itertools.combinations(s, i))

    # range() check
    for i in range(10000):
        for n in range(5, 19):
            t = 2 ** n
            mask = t - 1
            u = len({h & mask for h in map(hash, powerset(range(i, i+n)))})
            print(u/t*100)

    # letter_range() check needs to be restarted (reseeded on every run)
    for n in range(5, 19):
        t = 2 ** n
        mask = t - 1
        u = len({h & mask for h in map(hash, powerset(letter_range(n)))})
        print(u/t)

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32554>
_______________________________________

From report at bugs.python.org  Mon Jan 15 13:45:16 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Mon, 15 Jan 2018 18:45:16 +0000
Subject: [docs] [issue32554] random.seed(tuple) uses the randomized hash
 function and so is not reproductible
In-Reply-To: <1516007302.18.0.467229070634.issue32554@psf.upfronthosting.co.za>
Message-ID: <1516041916.95.0.714561066657.issue32554@psf.upfronthosting.co.za>


Change by Raymond Hettinger <raymond.hettinger at gmail.com>:


----------
Removed message: https://bugs.python.org/msg310006

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32554>
_______________________________________

From report at bugs.python.org  Mon Jan 15 13:46:17 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Mon, 15 Jan 2018 18:46:17 +0000
Subject: [docs] [issue32554] random.seed(tuple) uses the randomized hash
 function and so is not reproductible
In-Reply-To: <1516007302.18.0.467229070634.issue32554@psf.upfronthosting.co.za>
Message-ID: <1516041977.25.0.467229070634.issue32554@psf.upfronthosting.co.za>


Raymond Hettinger <raymond.hettinger at gmail.com> added the comment:

> This is very confusing, I hope you can fix the behavior, not the doc string.

I'll fix the docstring to make it more specific.

We really don't want to use hash(obj) because it produces too few bits of entropy.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32554>
_______________________________________

From report at bugs.python.org  Mon Jan 15 14:43:31 2018
From: report at bugs.python.org (R. David Murray)
Date: Mon, 15 Jan 2018 19:43:31 +0000
Subject: [docs] [issue15115] Duplicated Content-Transfer-Encoding header
 when applying email.encoders
In-Reply-To: <1340188711.86.0.286169814605.issue15115@psf.upfronthosting.co.za>
Message-ID: <1516045411.06.0.467229070634.issue15115@psf.upfronthosting.co.za>


R. David Murray <rdmurray at bitdance.com> added the comment:

I believe so.  For python3 I think it should only apply to the legacy API docs (you would use set_content (directly or indirectly) in python3, not set_payload).  I've updated the versions.

----------
versions: +Python 3.6, Python 3.7 -Python 3.2, Python 3.3

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue15115>
_______________________________________

From report at bugs.python.org  Mon Jan 15 15:58:38 2018
From: report at bugs.python.org (Paul Watson)
Date: Mon, 15 Jan 2018 20:58:38 +0000
Subject: [docs] [issue32553] venv says to use python3 which does not exist
 in 3.6.4
In-Reply-To: <1515982096.25.0.467229070634.issue32553@psf.upfronthosting.co.za>
Message-ID: <1516049918.73.0.467229070634.issue32553@psf.upfronthosting.co.za>


Paul Watson <paul.hermeneutic at gmail.com> added the comment:

Ok, I do find later on where it says to do something different on Windows. However, the first "Note" box in "28.3. venv" specifies using "python3". It does not say that this is for non-Windows systems. This should be changed.

Also, the path specified, "c:\Python35\python", would not be the default location for a Windows install. "C:\Program Files\Python36\python" or "C:\Program Files (x86)\Python36\python" should be specified.

I detest that it is this complex and verbose, but it is. Glossing over it does not help the user.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32553>
_______________________________________

From report at bugs.python.org  Mon Jan 15 16:49:39 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Mon, 15 Jan 2018 21:49:39 +0000
Subject: [docs] [issue32554] random.seed(tuple) uses the randomized hash
 function and so is not reproductible
In-Reply-To: <1516007302.18.0.467229070634.issue32554@psf.upfronthosting.co.za>
Message-ID: <1516052979.02.0.467229070634.issue32554@psf.upfronthosting.co.za>


Serhiy Storchaka <storchaka+cpython at gmail.com> added the comment:

Maybe deprecate using a hash?

----------
nosy: +serhiy.storchaka

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32554>
_______________________________________

From report at bugs.python.org  Mon Jan 15 18:20:02 2018
From: report at bugs.python.org (Paul Moore)
Date: Mon, 15 Jan 2018 23:20:02 +0000
Subject: [docs] [issue32553] venv says to use python3 which does not exist
 in 3.6.4
In-Reply-To: <1515982096.25.0.467229070634.issue32553@psf.upfronthosting.co.za>
Message-ID: <1516058402.61.0.467229070634.issue32553@psf.upfronthosting.co.za>


Paul Moore <p.f.moore at gmail.com> added the comment:

That's why I suggest using the launcher rather than absolute paths - there are far too many variations to enumerate with absolue paths (you didn't mention per-user Python 3.6 installations, for example).

If you have a suggested wording that you feel would explain things better, feel free to propose it. What's there at the moment seems relatively OK to me (aside from a minor tweak to use the launcher) so I'm not sure I could modify it in a way that would address your concerns.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32553>
_______________________________________

From report at bugs.python.org  Mon Jan 15 18:55:43 2018
From: report at bugs.python.org (Eryk Sun)
Date: Mon, 15 Jan 2018 23:55:43 +0000
Subject: [docs] [issue32553] venv says to use python3 which does not exist
 in 3.6.4
In-Reply-To: <1515982096.25.0.467229070634.issue32553@psf.upfronthosting.co.za>
Message-ID: <1516060543.62.0.467229070634.issue32553@psf.upfronthosting.co.za>


Eryk Sun <eryksun at gmail.com> added the comment:

`PATHEXT` is irrelevant here, so that should be removed. As to the py launcher, it's optional and not always installed for all users, though that's the default. I'd prefer `python` that's found in PATH as the first example. Then add another example with `py -X.Y` to show how to create virtual environments for other versions.

----------
nosy: +eryksun

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32553>
_______________________________________

From report at bugs.python.org  Tue Jan 16 04:11:12 2018
From: report at bugs.python.org (Paul Moore)
Date: Tue, 16 Jan 2018 09:11:12 +0000
Subject: [docs] [issue32553] venv says to use python3 which does not exist
 in 3.6.4
In-Reply-To: <1515982096.25.0.467229070634.issue32553@psf.upfronthosting.co.za>
Message-ID: <1516093872.04.0.467229070634.issue32553@psf.upfronthosting.co.za>


Paul Moore <p.f.moore at gmail.com> added the comment:

Agreed, the docs don't need to mention PATHEXT.

I don't have a machine to hand with Python 3.6 not installed, to check, but I believe the launcher is installed by default (although as you say it can be deselected - and it's definitely described as "recommended") whereas adding Python to PATH is deselected by default. So "py" is more likely to work on a typical installation than "python".

As I say, though, I have no feel here for the right level of detail. Maybe something like

"""
To execute the venv command, use

    python -m venv

Unix installations typically name the Python 3.x executable "python3", and on Windows the "py" launcher is generally available even if the Python interpreter is not on your PATH, so you may need to substitute the appropriate means of invoking Python in place of the "python" command above.
"""

But that's (to my mind) still wordy and complex - and the new users I've spoken to already find the docs too full of confusing detail.

Ideally, I'd prefer it if "Invoking Python" were described once and for all in a separate section of the docs (i.e., the "Python Setup and Usage" manual) and everywhere else in the official documentation we simply used "python", with no qualifications, on the understanding that this stands for "whatever you use on your PC to run Python". I suspect that would generate complaints from a lot of people, though, as most people hit the doc pages via direct links, not by reading the manuals in order...

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32553>
_______________________________________

From report at bugs.python.org  Tue Jan 16 04:28:50 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Tue, 16 Jan 2018 09:28:50 +0000
Subject: [docs] [issue32565] Document the version of adding opcodes
Message-ID: <1516094930.57.0.467229070634.issue32565@psf.upfronthosting.co.za>


New submission from Serhiy Storchaka <storchaka+cpython at gmail.com>:

The version of adding a new opcode is not specified for some opcodes. The proposed PR adds missed 'versionadded' directives (as usually, only when added after 3.0).

----------
assignee: docs at python
components: Documentation
messages: 310061
nosy: docs at python, ncoghlan, pitrou, serhiy.storchaka, yselivanov
priority: normal
severity: normal
status: open
title: Document the version of adding opcodes
type: enhancement
versions: Python 3.6, Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32565>
_______________________________________

From report at bugs.python.org  Tue Jan 16 04:32:15 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Tue, 16 Jan 2018 09:32:15 +0000
Subject: [docs] [issue32565] Document the version of adding opcodes
In-Reply-To: <1516094930.57.0.467229070634.issue32565@psf.upfronthosting.co.za>
Message-ID: <1516095135.43.0.714561066657.issue32565@psf.upfronthosting.co.za>


Change by Serhiy Storchaka <storchaka+cpython at gmail.com>:


----------
keywords: +patch
pull_requests: +5053
stage:  -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32565>
_______________________________________

From report at bugs.python.org  Tue Jan 16 14:46:28 2018
From: report at bugs.python.org (Pedro)
Date: Tue, 16 Jan 2018 19:46:28 +0000
Subject: [docs] [issue32573] sys.argv documentation should include caveat
 for embedded environments
Message-ID: <1516131988.33.0.467229070634.issue32573@psf.upfronthosting.co.za>


New submission from Pedro <pgacv2+pythonbugs at gmail.com>:

Embedded Python interpreters, such as Boost.Python, do not have sys.argv available. (sys itself works fine.) This causes the interpreter to crash with the following exception when you try to access argv:

    AttributeError: 'module' object has no attribute 'argv'

I'm not sure how closely related this is to #15577 or PEP 432. A simple workaround is to manually assign a list with an empty string to argv, as suggested by https://github.com/google/oauth2client/issues/642. However, the documentation for the sys module makes no mention of this special case for argv, and the line at the top that says "It is always available" can easily be interpreted to mean that *all* of sys's attributes will always be available. I suggest adding the following to the documentation for sys.argv:

========

Since `argv` contains the list of **command line** arguments passed to the Python interpreter, `argv` is not available within embedded interpreters, and scripts that run in embedded environments will raise an `AttributeError` when they attempt to access `argv`. As a workaround, assign a list with an empty string manually:
```
import sys

if not hasattr(sys, 'argv'):
    sys.argv  = ['']
```

----------
assignee: docs at python
components: Documentation
messages: 310105
nosy: docs at python, pgacv2
priority: normal
severity: normal
status: open
title: sys.argv documentation should include caveat for embedded environments
type: enhancement
versions: Python 2.7, Python 3.4, Python 3.5, Python 3.6, Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32573>
_______________________________________

From report at bugs.python.org  Tue Jan 16 14:52:58 2018
From: report at bugs.python.org (Jay Crotts)
Date: Tue, 16 Jan 2018 19:52:58 +0000
Subject: [docs] [issue8243] curses writing to window's bottom right position
 raises: `_curses.error: addstr() returned ERR'
In-Reply-To: <1352121880.55.0.191535515397.issue8243@psf.upfronthosting.co.za>
Message-ID: <1516132378.01.0.467229070634.issue8243@psf.upfronthosting.co.za>


Jay Crotts <crotts.jay at gmail.com> added the comment:

Submitted a PR for this issue, awaiting review.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue8243>
_______________________________________

From report at bugs.python.org  Tue Jan 16 14:56:50 2018
From: report at bugs.python.org (R. David Murray)
Date: Tue, 16 Jan 2018 19:56:50 +0000
Subject: [docs] [issue32573] sys.argv documentation should include caveat
 for embedded environments
In-Reply-To: <1516131988.33.0.467229070634.issue32573@psf.upfronthosting.co.za>
Message-ID: <1516132610.67.0.467229070634.issue32573@psf.upfronthosting.co.za>


R. David Murray <rdmurray at bitdance.com> added the comment:

A better question might be: is there something in the embedding framework that should initialize argv to the empty list?  embedding framework here could have two meanings: either the third party code, or the code that we provide for supporting embedding.

----------
nosy: +r.david.murray

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32573>
_______________________________________

From report at bugs.python.org  Tue Jan 16 16:34:14 2018
From: report at bugs.python.org (STINNER Victor)
Date: Tue, 16 Jan 2018 21:34:14 +0000
Subject: [docs] [issue32573] sys.argv documentation should include caveat
 for embedded environments
In-Reply-To: <1516131988.33.0.467229070634.issue32573@psf.upfronthosting.co.za>
Message-ID: <1516138454.55.0.714561066657.issue32573@psf.upfronthosting.co.za>


Change by STINNER Victor <victor.stinner at gmail.com>:


----------
nosy: +ncoghlan

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32573>
_______________________________________

From report at bugs.python.org  Tue Jan 16 20:17:42 2018
From: report at bugs.python.org (Pedro)
Date: Wed, 17 Jan 2018 01:17:42 +0000
Subject: [docs] [issue32573] sys.argv documentation should include caveat
 for embedded environments
In-Reply-To: <1516131988.33.0.467229070634.issue32573@psf.upfronthosting.co.za>
Message-ID: <1516151861.84.0.467229070634.issue32573@psf.upfronthosting.co.za>


Pedro <pgacv2+pythonbugs at gmail.com> added the comment:

My first inclination would be no. An argv value of [''] means "zero command-line arguments" (not even a filename), which implies the following as far as I know:
1. Python was called as an executable rather than a library, because you can't pass command-line arguments to a library
2. No arguments were passed to the executable
3. You are running from inside the REPL

All three are false in an embedded context.

A not-much-better-but-maybe-worth-considering question might also be: should scripts be able to tell whether they are being run from an embedded interpreter? If so, do they have any other way of doing so if an initialization is forced for argv?

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32573>
_______________________________________

From report at bugs.python.org  Tue Jan 16 20:19:00 2018
From: report at bugs.python.org (Pedro)
Date: Wed, 17 Jan 2018 01:19:00 +0000
Subject: [docs] [issue32573] sys.argv documentation should include caveat
 for embedded environments
In-Reply-To: <1516131988.33.0.467229070634.issue32573@psf.upfronthosting.co.za>
Message-ID: <1516151939.92.0.467229070634.issue32573@psf.upfronthosting.co.za>


Pedro <pgacv2+pythonbugs at gmail.com> added the comment:

My comment above uses "code that we provide for supporting embedding," not "third party code," as the definition of embedded.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32573>
_______________________________________

From report at bugs.python.org  Wed Jan 17 00:27:28 2018
From: report at bugs.python.org (Nick Coghlan)
Date: Wed, 17 Jan 2018 05:27:28 +0000
Subject: [docs] [issue32573] sys.argv documentation should include caveat
 for embedded environments
In-Reply-To: <1516131988.33.0.467229070634.issue32573@psf.upfronthosting.co.za>
Message-ID: <1516166848.42.0.467229070634.issue32573@psf.upfronthosting.co.za>


Nick Coghlan <ncoghlan at gmail.com> added the comment:

There are actually 3 attributes that may be absent when CPython itself isn't managing the C level entry point: sys.argv, sys.warnoptions, and sys._xoptions.

I'd be more inclined to make the implementation match the docs though, and have these all be empty lists in the not-configured case, rather than absent entirely. (Accessing sys.argv[0] would still be an error in that situation, just an IndexError instead of an AttributeError)

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32573>
_______________________________________

From report at bugs.python.org  Wed Jan 17 13:00:55 2018
From: report at bugs.python.org (Tim Morris)
Date: Wed, 17 Jan 2018 18:00:55 +0000
Subject: [docs] [issue32586] urllib2 HOWTO URLError example minor error
Message-ID: <1516212055.1.0.467229070634.issue32586@psf.upfronthosting.co.za>


New submission from Tim Morris <timothy at morrises.org.uk>:

In the HOWTO for urllib2 for Python 2, in the Handling Exceptions section, it discusses the URLError exception being raised by urlopen() (https://docs.python.org/2/howto/urllib2.html#urlerror). The code snippet example for this has (I think) a minor error:
the 3rd line reads:
"except URLError as e:"
which I think should be:
"except urllib2.URLError as e:"

The code as given only works if urllib2 had been imported via:
"from urllib2 import *"
The snippet doesn't list the import statements but all the other examples just use "import urllib2" (and obviously "from x import *" is bad practice anyway and wouldn't be encouraged or expected).

I am relatively new to Python, so it's possible it *is* correct and I just implemented it incorrectly. But if not, it would be helpful to correct it (even though it's a very minor error) so that other newbies like me don't come unstuck when using the tutorial.

----------
assignee: docs at python
components: Documentation
messages: 310201
nosy: MarmiteFox, docs at python
priority: normal
severity: normal
status: open
title: urllib2 HOWTO URLError example minor error
versions: Python 2.7

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32586>
_______________________________________

From report at bugs.python.org  Thu Jan 18 08:51:34 2018
From: report at bugs.python.org (Skip Montanaro)
Date: Thu, 18 Jan 2018 13:51:34 +0000
Subject: [docs] [issue32594] File object 'name' attribute inconsistent type
 and not obviously documented
Message-ID: <1516283494.43.0.467229070634.issue32594@psf.upfronthosting.co.za>


New submission from Skip Montanaro <skip.montanaro at gmail.com>:

I stumbled on what I think is an inconsistency in the "name" attribute of file objects. When a file is opened with an existing file descriptor, the "name" attribute is of type int (this from a 3.6.4 session, but it also exists in 2.7):

>>> import sys
>>> sys.stderr.name
'<stderr>'
>>> f = open(sys.stderr.fileno())
>>> f.name
2
>>> type(f.name)
<class 'int'>

I thought it odd that the standard I/O objects would be blessed with string filenames (despite not representing real filesystem paths), but that files opened by file descriptor would have that file descriptor as their name.

I looked in the documentation for open():

https://docs.python.org/3/library/functions.html#open

but saw no mention of the "name" attribute at all. In fact, the first argument to open() is called "file", so it's not obvious that the "name" attribute needs to be a copy of that parameter.

It seems to me that "name" attributes of open file objects should be of a consistent type, even if they might not represent an actual path in the filesystem. Even if this dual-type behavior is retained, it should be documented.

----------
assignee: docs at python
components: Documentation, IO, Interpreter Core
messages: 310237
nosy: docs at python, skip.montanaro
priority: normal
severity: normal
status: open
title: File object 'name' attribute inconsistent type and not obviously documented
type: behavior
versions: Python 2.7, Python 3.6, Python 3.7, Python 3.8

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32594>
_______________________________________

From report at bugs.python.org  Thu Jan 18 08:55:49 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Thu, 18 Jan 2018 13:55:49 +0000
Subject: [docs] [issue32594] File object 'name' attribute inconsistent type
 and not obviously documented
In-Reply-To: <1516283494.43.0.467229070634.issue32594@psf.upfronthosting.co.za>
Message-ID: <1516283749.73.0.467229070634.issue32594@psf.upfronthosting.co.za>


St?phane Wirtel <stephane at wirtel.be> added the comment:

Hi Skip,

I only tested with the last revision of 2.7

Python 2.7.14+ (heads/2.7:b1a52b1167, Jan 18 2018, 14:53:29) 
[GCC 7.2.1 20170915 (Red Hat 7.2.1-2)] on linux2
Type "help", "copyright", "credits" or "license" for more information.
>>> import sys
>>> sys.stderr.name
'<stderr>'
>>> f = open(sys.stderr.fileno())
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
TypeError: coercing to Unicode: need string or buffer, int found


I can't create a file with an int.

----------
nosy: +matrixise

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32594>
_______________________________________

From report at bugs.python.org  Thu Jan 18 08:58:11 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Thu, 18 Jan 2018 13:58:11 +0000
Subject: [docs] [issue32594] File object 'name' attribute inconsistent type
 and not obviously documented
In-Reply-To: <1516283494.43.0.467229070634.issue32594@psf.upfronthosting.co.za>
Message-ID: <1516283891.44.0.467229070634.issue32594@psf.upfronthosting.co.za>


St?phane Wirtel <stephane at wirtel.be> added the comment:

but I can confirm your issue with 3.6.4+

Python 3.6.4+ (heads/3.6:f31c70b0d6, Jan 18 2018, 14:57:01) 
[GCC 7.2.1 20170915 (Red Hat 7.2.1-2)] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> import sys
>>> sys.stderr.name
'<stderr>'
>>> f = open(sys.stderr.fileno())
>>> f.name
2
>>>

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32594>
_______________________________________

From report at bugs.python.org  Thu Jan 18 08:58:33 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Thu, 18 Jan 2018 13:58:33 +0000
Subject: [docs] [issue32594] File object 'name' attribute inconsistent type
 and not obviously documented
In-Reply-To: <1516283494.43.0.467229070634.issue32594@psf.upfronthosting.co.za>
Message-ID: <1516283913.8.0.714561066657.issue32594@psf.upfronthosting.co.za>


Change by St?phane Wirtel <stephane at wirtel.be>:


----------
versions:  -Python 2.7

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32594>
_______________________________________

From report at bugs.python.org  Thu Jan 18 09:53:26 2018
From: report at bugs.python.org (R. David Murray)
Date: Thu, 18 Jan 2018 14:53:26 +0000
Subject: [docs] [issue32594] File object 'name' attribute inconsistent type
 and not obviously documented
In-Reply-To: <1516283494.43.0.467229070634.issue32594@psf.upfronthosting.co.za>
Message-ID: <1516287206.82.0.467229070634.issue32594@psf.upfronthosting.co.za>


R. David Murray <rdmurray at bitdance.com> added the comment:

This has been discussed previously.  The nature of the 'name' attribute for file objects is not really specified, so I'm not even sure what we would document.  Maybe just that it is unspecified.

----------
nosy: +r.david.murray

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32594>
_______________________________________

From report at bugs.python.org  Thu Jan 18 10:32:06 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Thu, 18 Jan 2018 15:32:06 +0000
Subject: [docs] [issue32594] File object 'name' attribute inconsistent type
 and not obviously documented
In-Reply-To: <1516283494.43.0.467229070634.issue32594@psf.upfronthosting.co.za>
Message-ID: <1516289525.99.0.467229070634.issue32594@psf.upfronthosting.co.za>


St?phane Wirtel <stephane at wirtel.be> added the comment:

Maybe we could add in the documentation.

"""
if we use a file descriptor as the parameter, the name of the returned file object will be the file descriptor itself.
"""

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32594>
_______________________________________

From report at bugs.python.org  Thu Jan 18 10:51:10 2018
From: report at bugs.python.org (Skip Montanaro)
Date: Thu, 18 Jan 2018 15:51:10 +0000
Subject: [docs] [issue32594] File object 'name' attribute inconsistent type
 and not obviously documented
In-Reply-To: <1516283494.43.0.467229070634.issue32594@psf.upfronthosting.co.za>
Message-ID: <1516290670.32.0.467229070634.issue32594@psf.upfronthosting.co.za>


Skip Montanaro <skip.montanaro at gmail.com> added the comment:

Apologies for the incomplete report. In 2.7 this anomaly exists in the io.open() function. You are correct, builtin open() in 2.x doesn't support opening by file descriptor.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32594>
_______________________________________

From report at bugs.python.org  Thu Jan 18 11:01:06 2018
From: report at bugs.python.org (Skip Montanaro)
Date: Thu, 18 Jan 2018 16:01:06 +0000
Subject: [docs] [issue32594] File object 'name' attribute inconsistent type
 and not obviously documented
In-Reply-To: <1516283494.43.0.467229070634.issue32594@psf.upfronthosting.co.za>
Message-ID: <1516291266.66.0.467229070634.issue32594@psf.upfronthosting.co.za>


Skip Montanaro <skip.montanaro at gmail.com> added the comment:

I'm not terribly concerned with the end result, only that we wind up with a more consistent system. As I see it, there are two main problems:

1. The type of the name attribute varies

2. The name attribute appears to be undocumented, at least not in the obvious place.

Of lesser importance, but still unintuitive, is that the "name" attribute doesn't refer to an actual name in the filesystem. (I realize that the "name" of sys.std{in,out,err} is also meaningless when interpreted as an actual filename, but that ship sailed long ago.)

I realize that it might well be infeasible to modify behavior at this point. I do think it important to document the "name" attribute (item #2). After all, it doesn't appear to be obviously private.

I live in a Linux-only world, so this workaround in my own code is likely not useful everywhere, but, when I try to convert a builtin file object to an io.TextIOWrapper object using io.open(f.fileno()), I actually do this:

io.open("/dev/fd/{}".format(f.fileno()), ...)

This gives me a meaningful "name" attribute in that it is a string, and that it names an actual filename. How this might work on systems without "/dev/fd", I don't know, but might be worth thinking about for a couple minutes before dismissing it out-of-hand.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32594>
_______________________________________

From report at bugs.python.org  Thu Jan 18 13:15:39 2018
From: report at bugs.python.org (R. David Murray)
Date: Thu, 18 Jan 2018 18:15:39 +0000
Subject: [docs] [issue32594] File object 'name' attribute inconsistent type
 and not obviously documented
In-Reply-To: <1516283494.43.0.467229070634.issue32594@psf.upfronthosting.co.za>
Message-ID: <1516299339.74.0.467229070634.issue32594@psf.upfronthosting.co.za>


R. David Murray <rdmurray at bitdance.com> added the comment:

I believe you are correct that it is too late to modify the existing behavior.  Too many programs depend on it.  As far as documenting, my point is that it is *not specified* what the name attribute contains.  It can contain literally anything, depending on the particular file object involved.

Could we document what the open function actually does?  That perhaps we could do, since it is likely that other python implementations will want to copy what CPython does in this case.  But as you observe, this can also be *system dependent*, so it is not completely clear to me exactly how we should do that.  That is, the description of what actually happens could be so complex that it might be better to just say something like "The exact type and value of the name attribute is not specified, but when the file is opened via a file system path it will almost always be that path as a string.".

I'd be happy for a better answer, though :)

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32594>
_______________________________________

From report at bugs.python.org  Thu Jan 18 18:46:49 2018
From: report at bugs.python.org (Pablo Galindo Salgado)
Date: Thu, 18 Jan 2018 23:46:49 +0000
Subject: [docs] [issue32586] urllib2 HOWTO URLError example minor error
In-Reply-To: <1516212055.1.0.467229070634.issue32586@psf.upfronthosting.co.za>
Message-ID: <1516319209.37.0.714561066657.issue32586@psf.upfronthosting.co.za>


Change by Pablo Galindo Salgado <pablogsal at gmail.com>:


----------
keywords: +patch
pull_requests: +5084
stage:  -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32586>
_______________________________________

From report at bugs.python.org  Thu Jan 18 18:49:56 2018
From: report at bugs.python.org (Pablo Galindo Salgado)
Date: Thu, 18 Jan 2018 23:49:56 +0000
Subject: [docs] [issue32586] urllib2 HOWTO URLError example minor error
In-Reply-To: <1516212055.1.0.467229070634.issue32586@psf.upfronthosting.co.za>
Message-ID: <1516319396.45.0.467229070634.issue32586@psf.upfronthosting.co.za>


Pablo Galindo Salgado <pablogsal at gmail.com> added the comment:

Thanks for reporting this issue. Indeed, this is an error in the documentation. Notice that this is corrected in Python3 's version:

https://docs.python.org/3.6/howto/urllib2.html#handling-exceptions

I have prepared a Pull Request fixing this. Thanks!

----------
nosy: +pablogsal
priority: normal -> low

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32586>
_______________________________________

From report at bugs.python.org  Thu Jan 18 18:59:20 2018
From: report at bugs.python.org (Pablo Galindo Salgado)
Date: Thu, 18 Jan 2018 23:59:20 +0000
Subject: [docs] [issue32532] improve sys.settrace and sys.setprofile
 documentation
In-Reply-To: <1515651956.68.0.467229070634.issue32532@psf.upfronthosting.co.za>
Message-ID: <1516319960.25.0.467229070634.issue32532@psf.upfronthosting.co.za>


Pablo Galindo Salgado <pablogsal at gmail.com> added the comment:

There are some issues in the documentation for this function (slightly related) to this described here: https://bugs.python.org/issue17799. 

I can update the PR linked to that issue with this information as well.

----------
nosy: +pablogsal
versions: +Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32532>
_______________________________________

From report at bugs.python.org  Thu Jan 18 19:16:15 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 19 Jan 2018 00:16:15 +0000
Subject: [docs] [issue32586] urllib2 HOWTO URLError example minor error
In-Reply-To: <1516212055.1.0.467229070634.issue32586@psf.upfronthosting.co.za>
Message-ID: <1516320975.89.0.467229070634.issue32586@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:


New changeset 8ca036d4716fc86ff42474ba35d3cd32f0188a15 by Mariatta (Pablo Galindo) in branch '2.7':
bpo-32586: Fix code example in urllib2's doc  (GH-5238)
https://github.com/python/cpython/commit/8ca036d4716fc86ff42474ba35d3cd32f0188a15


----------
nosy: +Mariatta

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32586>
_______________________________________

From report at bugs.python.org  Thu Jan 18 19:19:23 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 19 Jan 2018 00:19:23 +0000
Subject: [docs] [issue32586] urllib2 HOWTO URLError example minor error
In-Reply-To: <1516212055.1.0.467229070634.issue32586@psf.upfronthosting.co.za>
Message-ID: <1516321163.21.0.467229070634.issue32586@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:

Thanks!

----------
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32586>
_______________________________________

From report at bugs.python.org  Thu Jan 18 19:32:02 2018
From: report at bugs.python.org (Pablo Galindo Salgado)
Date: Fri, 19 Jan 2018 00:32:02 +0000
Subject: [docs] [issue32537] multiprocessing.pool.Pool.starmap_async - wrong
 parameter name
In-Reply-To: <1515767877.08.0.467229070634.issue32537@psf.upfronthosting.co.za>
Message-ID: <1516321922.08.0.467229070634.issue32537@psf.upfronthosting.co.za>


Pablo Galindo Salgado <pablogsal at gmail.com> added the comment:

Closed as is a duplicate of 31304. Thanks for reporting this!

----------
nosy: +pablogsal
resolution:  -> duplicate
stage:  -> resolved
status: open -> closed
superseder:  -> Update doc for starmap_async error_back kwarg

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32537>
_______________________________________

From report at bugs.python.org  Thu Jan 18 19:43:54 2018
From: report at bugs.python.org (MarmiteFox)
Date: Fri, 19 Jan 2018 00:43:54 +0000
Subject: [docs] [issue32586] urllib2 HOWTO URLError example minor error
In-Reply-To: <1516212055.1.0.467229070634.issue32586@psf.upfronthosting.co.za>
Message-ID: <1516322634.5.0.467229070634.issue32586@psf.upfronthosting.co.za>


MarmiteFox <timothy at morrises.org.uk> added the comment:

Thanks for the fix and the tip about cross-checking in Python 3 - will remember that for the future.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32586>
_______________________________________

From report at bugs.python.org  Fri Jan 19 14:56:08 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 19 Jan 2018 19:56:08 +0000
Subject: [docs] [issue32553] venv says to use python3 which does not exist
 in 3.6.4
In-Reply-To: <1515982096.25.0.467229070634.issue32553@psf.upfronthosting.co.za>
Message-ID: <1516391768.79.0.467229070634.issue32553@psf.upfronthosting.co.za>


Terry J. Reedy <tjreedy at udel.edu> added the comment:

As far as I know, Windows binaries have only been named python.exe or pythonw.exe.  Before 3.5, I believe, "C:\Pythonxy", where x,y were major,minor, *was* the default Windows installation directory.  'Python35' must have been the result of a mechanical update.

----------
nosy: +terry.reedy

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32553>
_______________________________________

From report at bugs.python.org  Fri Jan 19 15:51:37 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 19 Jan 2018 20:51:37 +0000
Subject: [docs] [issue32573] All sys attributes (.argv,
 ...) should exist in embedded environments
In-Reply-To: <1516131988.33.0.467229070634.issue32573@psf.upfronthosting.co.za>
Message-ID: <1516395097.76.0.467229070634.issue32573@psf.upfronthosting.co.za>


Terry J. Reedy <tjreedy at udel.edu> added the comment:

Pedro: David and Nick are proposing initializing sys.argv to [] rather than [''] for embedded interpreters.  This would say 'running embedded'.  The .argv entry would need an additional sentence.

I like Nick's proposal, except that _xoptions should be {}.  Documenting absence should only be a fallback is there is no sensible default.

----------
components: +Library (Lib) -Documentation
nosy: +terry.reedy
title: sys.argv documentation should include caveat for embedded environments -> All sys attributes (.argv, ...) should exist in embedded environments
versions: +Python 3.8 -Python 2.7, Python 3.4, Python 3.5, Python 3.6

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32573>
_______________________________________

From report at bugs.python.org  Fri Jan 19 18:20:51 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Fri, 19 Jan 2018 23:20:51 +0000
Subject: [docs] [issue32603] Deprecation warning on strings used in re module
Message-ID: <1516404051.77.0.467229070634.issue32603@psf.upfronthosting.co.za>


New submission from Cheryl Sabella <chekat2 at gmail.com>:

I apologize if this is a duplicate question, but I couldn't find another issue about this.  It's hard to search on 're'.

In 3.7, I get a deprecation warning when using a regular string with re escape characters:
>>> s = '123abcd'
>>> re.findall('\d', s)
<stdin>:1: DeprecationWarning: invalid escape sequence \d
['1', '2', '3']

Of course, this works:
>>> s = '123abcd'
>>> re.findall(r'\d', s)
['1', '2', '3']


I know that the documentation strongly suggests using raw strings with re, but I didn't see anywhere mentioning that it would be a requirement.  I would think this would break a lot of 're' code.

----------
assignee: docs at python
components: Documentation
messages: 310300
nosy: csabella, docs at python
priority: normal
severity: normal
status: open
title: Deprecation warning on strings used in re module
type: enhancement
versions: Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32603>
_______________________________________

From report at bugs.python.org  Fri Jan 19 18:29:30 2018
From: report at bugs.python.org (Zachary Ware)
Date: Fri, 19 Jan 2018 23:29:30 +0000
Subject: [docs] [issue32603] Deprecation warning on strings used in re module
In-Reply-To: <1516404051.77.0.467229070634.issue32603@psf.upfronthosting.co.za>
Message-ID: <1516404570.65.0.467229070634.issue32603@psf.upfronthosting.co.za>


Zachary Ware <zachary.ware at gmail.com> added the comment:

This is actually combination of a deprecation in in 3.6's string literals (not related to the re module), documented here: https://docs.python.org/dev/whatsnew/3.6.html#deprecated-python-behavior (see issue27364) and showing DeprecationWarning in the REPL by default in 3.7 (PEP 565).

----------
nosy: +zach.ware

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32603>
_______________________________________

From report at bugs.python.org  Fri Jan 19 19:06:06 2018
From: report at bugs.python.org (Pedro)
Date: Sat, 20 Jan 2018 00:06:06 +0000
Subject: [docs] [issue32573] All sys attributes (.argv,
 ...) should exist in embedded environments
In-Reply-To: <1516131988.33.0.467229070634.issue32573@psf.upfronthosting.co.za>
Message-ID: <1516406766.27.0.467229070634.issue32573@psf.upfronthosting.co.za>


Pedro <pgacv2+pythonbugs at gmail.com> added the comment:

I agree that an empty list, instead of a list with an empty string, makes more sense. Leaving _xoptions as {} would be the same as when it runs non-embedded without any -X arguments, but I guess there's no way of making {} any more empty.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32573>
_______________________________________

From report at bugs.python.org  Fri Jan 19 19:11:57 2018
From: report at bugs.python.org (STINNER Victor)
Date: Sat, 20 Jan 2018 00:11:57 +0000
Subject: [docs] [issue32573] All sys attributes (.argv,
 ...) should exist in embedded environments
In-Reply-To: <1516131988.33.0.467229070634.issue32573@psf.upfronthosting.co.za>
Message-ID: <1516407117.84.0.714561066657.issue32573@psf.upfronthosting.co.za>


Change by STINNER Victor <victor.stinner at gmail.com>:


----------
nosy: +vstinner

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32573>
_______________________________________

From report at bugs.python.org  Fri Jan 19 19:22:24 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Sat, 20 Jan 2018 00:22:24 +0000
Subject: [docs] [issue32603] Deprecation warning on strings used in re module
In-Reply-To: <1516404051.77.0.467229070634.issue32603@psf.upfronthosting.co.za>
Message-ID: <1516407744.09.0.467229070634.issue32603@psf.upfronthosting.co.za>


Cheryl Sabella <chekat2 at gmail.com> added the comment:

Thank you, Zach.

There was some mention of regular expressions in #27364, but I'm still wondering if the DeprecationWarning should be mentioned on the re doc page and if there should be stronger language about using raw strings.

Thanks!

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32603>
_______________________________________

From report at bugs.python.org  Fri Jan 19 19:25:39 2018
From: report at bugs.python.org (STINNER Victor)
Date: Sat, 20 Jan 2018 00:25:39 +0000
Subject: [docs] [issue25910] Fixing links in documentation
In-Reply-To: <1450530544.1.0.9187941337.issue25910@psf.upfronthosting.co.za>
Message-ID: <1516407939.68.0.467229070634.issue25910@psf.upfronthosting.co.za>


STINNER Victor <victor.stinner at gmail.com> added the comment:


New changeset 338cd83c5dceaed785f5bf613e2122f871908e2a by Victor Stinner (Sanyam Khurana) in branch 'master':
bpo-25910: Link redirections in docs (#1933)
https://github.com/python/cpython/commit/338cd83c5dceaed785f5bf613e2122f871908e2a


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue25910>
_______________________________________

From report at bugs.python.org  Fri Jan 19 19:29:37 2018
From: report at bugs.python.org (STINNER Victor)
Date: Sat, 20 Jan 2018 00:29:37 +0000
Subject: [docs] [issue25910] Fixing links in documentation
In-Reply-To: <1450530544.1.0.9187941337.issue25910@psf.upfronthosting.co.za>
Message-ID: <1516408177.16.0.467229070634.issue25910@psf.upfronthosting.co.za>


STINNER Victor <victor.stinner at gmail.com> added the comment:

Can we now close this old issue?

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue25910>
_______________________________________

From report at bugs.python.org  Fri Jan 19 19:49:28 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 20 Jan 2018 00:49:28 +0000
Subject: [docs] [issue32573] All sys attributes (.argv,
 ...) should exist in embedded environments
In-Reply-To: <1516131988.33.0.467229070634.issue32573@psf.upfronthosting.co.za>
Message-ID: <1516409368.62.0.467229070634.issue32573@psf.upfronthosting.co.za>


Terry J. Reedy <tjreedy at udel.edu> added the comment:

For detecting 'embedded', it is enough that only one documented attribute value be unique to embedded situations.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32573>
_______________________________________

From bgailer at gmail.com  Fri Jan 19 20:34:01 2018
From: bgailer at gmail.com (bob gailer)
Date: Fri, 19 Jan 2018 20:34:01 -0500
Subject: [docs] Error in 10.2. functools
Message-ID: <b754a942-83bb-ae6a-accc-87d0c575fba3@gmail.com>

|functools.||reduce|(/function/, /iterable/[, /initializer/])

    Apply /function/ of two arguments cumulatively to the items of
    /sequence/....

/sequence /should be /iterable/


From bgailer at gmail.com  Fri Jan 19 20:25:14 2018
From: bgailer at gmail.com (bob gailer)
Date: Fri, 19 Jan 2018 20:25:14 -0500
Subject: [docs] Code not working
In-Reply-To: <CAF4280JMLqqyAuNWvVTQAbP-AqL-CtKB2WaSihtLiijnpvUrQw@mail.gmail.com>
References: <cIxupHE1waFOPW_wDPxRQxZZZh_bJ__4Zo8rwBWZf-W-96F-CedDcIvJbKiTf5zGlQbate1_xYPSfEewtRjrOZ-XXNpAGQbwQXGAhkChwZc=@protonmail.com>
 <CAF4280JMLqqyAuNWvVTQAbP-AqL-CtKB2WaSihtLiijnpvUrQw@mail.gmail.com>
Message-ID: <01bec18d-2368-b5c3-680d-571477306e7b@gmail.com>

On 1/12/2018 4:32 PM, Berker Peksa? wrote:
> On Fri, Jan 12, 2018 at 5:21 PM, Pushergene via docs <docs at python.org> wrote:
>> Hey,
>> The code in
>> https://docs.python.org/3/library/operator.html#inplace-operators is not
>> working.
>> Its confusing, please change it... python 3.6.4
> Can you give us a little bit more details? Both snippet work for me:
The snippet does not include

from operator import iadd

Berker realizes that and "automatically" adds it.
Pushergene tries the snippet as given and wonders why it does not work.
It would seem to me trivial to add the import to the snippet.
>>>> from operator import iadd
>>>> a = 'hello'
>>>> iadd(a, ' world')
> 'hello world'
>>>> s = ['h', 'e', 'l', 'l', 'o']
>>>> iadd(s, [' ', 'w', 'o', 'r', 'l', 'd'])
> ['h', 'e', 'l', 'l', 'o', ' ', 'w', 'o', 'r', 'l', 'd']
>>>> s
> ['h', 'e', 'l', 'l', 'o', ' ', 'w', 'o', 'r', 'l', 'd']
>
> --Berker
> _______________________________________________
> docs mailing list
> docs at python.org
> https://mail.python.org/mailman/listinfo/docs
>

-- 
Image and video hosting by TinyPic

From report at bugs.python.org  Fri Jan 19 22:00:36 2018
From: report at bugs.python.org (Schmehl Bastian)
Date: Sat, 20 Jan 2018 03:00:36 +0000
Subject: [docs] [issue25910] How many "critical"-level open issues are there?
In-Reply-To: <1450530544.1.0.9187941337.issue25910@psf.upfronthosting.co.za>
Message-ID: <1516417236.46.0.714561066657.issue25910@psf.upfronthosting.co.za>


Change by Schmehl Bastian <Bastian.schmehl at web.de>:


----------
title: Fixing links in documentation -> How many "critical"-level open issues are there?
versions: +Python 2.7 -Python 3.5, Python 3.6

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue25910>
_______________________________________

From report at bugs.python.org  Sat Jan 20 00:04:49 2018
From: report at bugs.python.org (Guido van Rossum)
Date: Sat, 20 Jan 2018 05:04:49 +0000
Subject: [docs] [issue25910] How many "critical"-level open issues are there?
In-Reply-To: <1450530544.1.0.9187941337.issue25910@psf.upfronthosting.co.za>
Message-ID: <1516424689.72.0.467229070634.issue25910@psf.upfronthosting.co.za>


Guido van Rossum <guido at python.org> added the comment:

Who is Basti5611 (Schmehl Bastian), why do they have permission to change issue titles, and why did they change this issue title?

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue25910>
_______________________________________

From report at bugs.python.org  Sat Jan 20 00:05:23 2018
From: report at bugs.python.org (Steven D'Aprano)
Date: Sat, 20 Jan 2018 05:05:23 +0000
Subject: [docs] [issue32603] Deprecation warning on strings used in re module
In-Reply-To: <1516404051.77.0.467229070634.issue32603@psf.upfronthosting.co.za>
Message-ID: <1516424723.04.0.467229070634.issue32603@psf.upfronthosting.co.za>


Steven D'Aprano <steve+python at pearwood.info> added the comment:

I agree with Cheryl that it would be a good idea to mention this change in the re docs, since regexes are especially likely to run into this issue.

----------
nosy: +steven.daprano

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32603>
_______________________________________

From report at bugs.python.org  Sat Jan 20 02:16:30 2018
From: report at bugs.python.org (Sanyam Khurana)
Date: Sat, 20 Jan 2018 07:16:30 +0000
Subject: [docs] [issue25910] How many "critical"-level open issues are there?
In-Reply-To: <1450530544.1.0.9187941337.issue25910@psf.upfronthosting.co.za>
Message-ID: <1516432590.47.0.467229070634.issue25910@psf.upfronthosting.co.za>


Sanyam Khurana <sanyam.khurana01 at gmail.com> added the comment:

Victor, there is just one last thing to do in here.

All the links pointing to Github (that are build automatically) are permanently redirected from https://github.com/python/cpython/tree/master/* to https://github.com/python/cpython/blob/master/*

I will issue a separate PR for it, and then we're good to close this issue.

PS: Guido, I'm not sure about the title change either.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue25910>
_______________________________________

From report at bugs.python.org  Sat Jan 20 02:39:30 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sat, 20 Jan 2018 07:39:30 +0000
Subject: [docs] [issue25910] Fixing links in documentation
In-Reply-To: <1450530544.1.0.9187941337.issue25910@psf.upfronthosting.co.za>
Message-ID: <1516433970.74.0.714561066657.issue25910@psf.upfronthosting.co.za>


Change by Serhiy Storchaka <storchaka+cpython at gmail.com>:


----------
title: How many "critical"-level open issues are there? -> Fixing links in documentation
versions: +Python 3.7 -Python 2.7

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue25910>
_______________________________________

From report at bugs.python.org  Sat Jan 20 04:01:58 2018
From: report at bugs.python.org (STINNER Victor)
Date: Sat, 20 Jan 2018 09:01:58 +0000
Subject: [docs] [issue25910] How many "critical"-level open issues are there?
In-Reply-To: <1516432590.47.0.467229070634.issue25910@psf.upfronthosting.co.za>
Message-ID: <CAMpsgwbjT_C6jyCBcVKoFkLGGSoOvAe-+3+ubJvP-HLCKCPfcg@mail.gmail.com>


STINNER Victor <victor.stinner at gmail.com> added the comment:

"I will issue a separate PR for it, and then we're good to close this
issue."

Ok.

----------
title: Fixing links in documentation -> How many "critical"-level open issues are there?

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue25910>
_______________________________________

From report at bugs.python.org  Sat Jan 20 06:21:44 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sat, 20 Jan 2018 11:21:44 +0000
Subject: [docs] [issue25910] Fixing links in documentation
In-Reply-To: <1450530544.1.0.9187941337.issue25910@psf.upfronthosting.co.za>
Message-ID: <1516447304.19.0.714561066657.issue25910@psf.upfronthosting.co.za>


Change by Serhiy Storchaka <storchaka+cpython at gmail.com>:


----------
title: How many "critical"-level open issues are there? -> Fixing links in documentation

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue25910>
_______________________________________

From report at bugs.python.org  Sat Jan 20 08:20:59 2018
From: report at bugs.python.org (R. David Murray)
Date: Sat, 20 Jan 2018 13:20:59 +0000
Subject: [docs] [issue25910] Fixing links in documentation
In-Reply-To: <1450530544.1.0.9187941337.issue25910@psf.upfronthosting.co.za>
Message-ID: <1516454459.6.0.467229070634.issue25910@psf.upfronthosting.co.za>


R. David Murray <rdmurray at bitdance.com> added the comment:

@guido: in roundup, by default anyone can change the issue title.  I imagine he is a new user who just didn't understand that he was doing so.  (And indeed, the account was created on 1/19).

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue25910>
_______________________________________

From report at bugs.python.org  Sat Jan 20 09:52:22 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sat, 20 Jan 2018 14:52:22 +0000
Subject: [docs] [issue32594] File object 'name' attribute inconsistent type
 and not obviously documented
In-Reply-To: <1516283494.43.0.467229070634.issue32594@psf.upfronthosting.co.za>
Message-ID: <1516459942.62.0.467229070634.issue32594@psf.upfronthosting.co.za>


Serhiy Storchaka <storchaka+cpython at gmail.com> added the comment:

Isn't this a duplicate of issue18534?

----------
nosy: +serhiy.storchaka

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32594>
_______________________________________

From report at bugs.python.org  Sat Jan 20 10:09:21 2018
From: report at bugs.python.org (R. David Murray)
Date: Sat, 20 Jan 2018 15:09:21 +0000
Subject: [docs] [issue32594] File object 'name' attribute inconsistent type
 and not obviously documented
In-Reply-To: <1516283494.43.0.467229070634.issue32594@psf.upfronthosting.co.za>
Message-ID: <1516460961.05.0.467229070634.issue32594@psf.upfronthosting.co.za>


R. David Murray <rdmurray at bitdance.com> added the comment:

Ah, yes.  When I said "this has been discussed previously", that's the issue I was thinking of but couldn't find.

----------
resolution:  -> duplicate
stage:  -> resolved
status: open -> closed
superseder:  -> State clearly that open() 'file' param is "name" attr of the result

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32594>
_______________________________________

From report at bugs.python.org  Sat Jan 20 13:12:50 2018
From: report at bugs.python.org (Andrew Svetlov)
Date: Sat, 20 Jan 2018 18:12:50 +0000
Subject: [docs] [issue32472] Mention of __await__ missing in Coroutine
 Abstract Methods
In-Reply-To: <1514786801.71.0.467229070634.issue32472@psf.upfronthosting.co.za>
Message-ID: <1516471970.81.0.714561066657.issue32472@psf.upfronthosting.co.za>


Change by Andrew Svetlov <andrew.svetlov at gmail.com>:


----------
resolution: not a bug -> 
stage: resolved -> 
status: closed -> open

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32472>
_______________________________________

From report at bugs.python.org  Sat Jan 20 16:37:09 2018
From: report at bugs.python.org (Pablo Galindo Salgado)
Date: Sat, 20 Jan 2018 21:37:09 +0000
Subject: [docs] [issue32603] Deprecation warning on strings used in re module
In-Reply-To: <1516404051.77.0.467229070634.issue32603@psf.upfronthosting.co.za>
Message-ID: <1516484229.59.0.467229070634.issue32603@psf.upfronthosting.co.za>


Pablo Galindo Salgado <pablogsal at gmail.com> added the comment:

+1 to this. I have seen a lot of regular expressions not using raw strings that makes use of "\d" and friends. I will work on a patch to the docs if that's ok.

----------
nosy: +pablogsal

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32603>
_______________________________________

From report at bugs.python.org  Sat Jan 20 21:23:50 2018
From: report at bugs.python.org (Pablo Galindo Salgado)
Date: Sun, 21 Jan 2018 02:23:50 +0000
Subject: [docs] [issue32603] Deprecation warning on strings used in re module
In-Reply-To: <1516404051.77.0.467229070634.issue32603@psf.upfronthosting.co.za>
Message-ID: <1516501430.44.0.714561066657.issue32603@psf.upfronthosting.co.za>


Change by Pablo Galindo Salgado <pablogsal at gmail.com>:


----------
keywords: +patch
pull_requests: +5102
stage:  -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32603>
_______________________________________

From report at bugs.python.org  Sun Jan 21 11:20:25 2018
From: report at bugs.python.org (Xiang Zhang)
Date: Sun, 21 Jan 2018 16:20:25 +0000
Subject: [docs] [issue32532] improve sys.settrace and sys.setprofile
 documentation
In-Reply-To: <1515651956.68.0.467229070634.issue32532@psf.upfronthosting.co.za>
Message-ID: <1516551625.28.0.467229070634.issue32532@psf.upfronthosting.co.za>


Xiang Zhang <angwerzx at 126.com> added the comment:

Hi Pablo, it would be nice. But for #17799, I don't know actually which part should be fixed, doc or code? I think it's better to consult gurus on python-dev mail list.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32532>
_______________________________________

From report at bugs.python.org  Sun Jan 21 16:01:31 2018
From: report at bugs.python.org (Guido van Rossum)
Date: Sun, 21 Jan 2018 21:01:31 +0000
Subject: [docs] [issue17799] settrace docs are wrong about "c_call" events
In-Reply-To: <1366428980.14.0.538502026896.issue17799@psf.upfronthosting.co.za>
Message-ID: <1516568491.57.0.467229070634.issue17799@psf.upfronthosting.co.za>


Guido van Rossum <guido at python.org> added the comment:

The reason not to pass C calls to the tracing function is that tracing exists to support pdb and other debuggers, and pdb only cares about tracing through Python code. So the docs should be updated.

----------
nosy: +gvanrossum

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue17799>
_______________________________________

From report at bugs.python.org  Sun Jan 21 17:47:38 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Sun, 21 Jan 2018 22:47:38 +0000
Subject: [docs] [issue32614] Fix documentation examples of using re with
 escape sequences
Message-ID: <1516574858.82.0.467229070634.issue32614@psf.upfronthosting.co.za>


New submission from Cheryl Sabella <chekat2 at gmail.com>:

If a documentation example would produce a DeprecationWarning for an invalid escape sequence, change the example to use a raw string.

----------
assignee: docs at python
components: Documentation
messages: 310386
nosy: csabella, docs at python
priority: normal
severity: normal
status: open
title: Fix documentation examples of using re with escape sequences
type: enhancement
versions: Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32614>
_______________________________________

From report at bugs.python.org  Sun Jan 21 17:51:16 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Sun, 21 Jan 2018 22:51:16 +0000
Subject: [docs] [issue32614] Fix documentation examples of using re with
 escape sequences
In-Reply-To: <1516574858.82.0.467229070634.issue32614@psf.upfronthosting.co.za>
Message-ID: <1516575076.19.0.714561066657.issue32614@psf.upfronthosting.co.za>


Change by Cheryl Sabella <chekat2 at gmail.com>:


----------
keywords: +patch
pull_requests: +5111
stage:  -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32614>
_______________________________________

From report at bugs.python.org  Sun Jan 21 22:06:04 2018
From: report at bugs.python.org (Xiang Zhang)
Date: Mon, 22 Jan 2018 03:06:04 +0000
Subject: [docs] [issue17799] settrace docs are wrong about "c_call" events
In-Reply-To: <1366428980.14.0.538502026896.issue17799@psf.upfronthosting.co.za>
Message-ID: <1516590364.75.0.467229070634.issue17799@psf.upfronthosting.co.za>


Xiang Zhang <angwerzx at 126.com> added the comment:

Hi Guido. Looking at the implementation, it seems pdb ignores c_call not by relying on the interpreter, but bdb takes no action when encountering C events. Yeah, even bdb wrongly expects C events will be triggered for settrace. [1]

And what if some debuggers want not only to trace Python events but also C events, then it has to mix the power of trace and profile but can't only rely on trace.

[1] https://github.com/python/cpython/blob/master/Lib/bdb.py#L59

----------
versions: +Python 3.6, Python 3.7 -Python 3.4, Python 3.5

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue17799>
_______________________________________

From report at bugs.python.org  Mon Jan 22 01:03:10 2018
From: report at bugs.python.org (Guido van Rossum)
Date: Mon, 22 Jan 2018 06:03:10 +0000
Subject: [docs] [issue17799] settrace docs are wrong about "c_call" events
In-Reply-To: <1516590364.75.0.467229070634.issue17799@psf.upfronthosting.co.za>
Message-ID: <CAP7+vJLGv1gSuMQjw6xac7YX=tni91xXEZyQg9Bq2Ccs51X78A@mail.gmail.com>


Guido van Rossum <guido at python.org> added the comment:

Too bad, it's been like this since the feature was first created. It would
most likely break other code that uses the tracing hooks, so you'd have to
propose it as a new feature.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue17799>
_______________________________________

From report at bugs.python.org  Mon Jan 22 08:42:38 2018
From: report at bugs.python.org (Yahya Abou Imran)
Date: Mon, 22 Jan 2018 13:42:38 +0000
Subject: [docs] [issue32472] Mention of __await__ missing in Coroutine
 Abstract Methods
In-Reply-To: <1514786801.71.0.467229070634.issue32472@psf.upfronthosting.co.za>
Message-ID: <1516628558.3.0.714561066657.issue32472@psf.upfronthosting.co.za>


Change by Yahya Abou Imran <yahya-abou-imran at protonmail.com>:


----------
keywords: +patch
pull_requests: +5114
stage:  -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32472>
_______________________________________

From report at bugs.python.org  Mon Jan 22 08:54:43 2018
From: report at bugs.python.org (Yury Selivanov)
Date: Mon, 22 Jan 2018 13:54:43 +0000
Subject: [docs] [issue32472] Mention of __await__ missing in Coroutine
 Abstract Methods
In-Reply-To: <1514786801.71.0.467229070634.issue32472@psf.upfronthosting.co.za>
Message-ID: <1516629283.44.0.467229070634.issue32472@psf.upfronthosting.co.za>


Yury Selivanov <yselivanov at gmail.com> added the comment:

+1 to what Andres said.

----------
nosy: +yselivanov
resolution:  -> not a bug
stage: patch review -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32472>
_______________________________________

From report at bugs.python.org  Mon Jan 22 11:41:02 2018
From: report at bugs.python.org (Berker Peksag)
Date: Mon, 22 Jan 2018 16:41:02 +0000
Subject: [docs] [issue29344] sock_recv not detected a coroutine
In-Reply-To: <1485094185.41.0.725056014669.issue29344@psf.upfronthosting.co.za>
Message-ID: <1516639262.56.0.467229070634.issue29344@psf.upfronthosting.co.za>


Berker Peksag <berker.peksag at gmail.com> added the comment:

Andrew, shouldn't we fix 3.6 documentation? sock_* methods still documented as coroutines.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue29344>
_______________________________________

From report at bugs.python.org  Mon Jan 22 11:49:02 2018
From: report at bugs.python.org (Yury Selivanov)
Date: Mon, 22 Jan 2018 16:49:02 +0000
Subject: [docs] [issue29344] sock_recv not detected a coroutine
In-Reply-To: <1485094185.41.0.725056014669.issue29344@psf.upfronthosting.co.za>
Message-ID: <1516639742.1.0.467229070634.issue29344@psf.upfronthosting.co.za>


Yury Selivanov <yselivanov at gmail.com> added the comment:

> Andrew, shouldn't we fix 3.6 documentation? sock_* methods still documented as coroutines.

We only fixed it in 3.7 and the doc was updated.  3.6 stays as is.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue29344>
_______________________________________

From report at bugs.python.org  Mon Jan 22 12:10:14 2018
From: report at bugs.python.org (Berker Peksag)
Date: Mon, 22 Jan 2018 17:10:14 +0000
Subject: [docs] [issue29344] sock_recv not detected a coroutine
In-Reply-To: <1485094185.41.0.725056014669.issue29344@psf.upfronthosting.co.za>
Message-ID: <1516641013.95.0.467229070634.issue29344@psf.upfronthosting.co.za>


Berker Peksag <berker.peksag at gmail.com> added the comment:

> We only fixed it in 3.7 and the doc was updated.  3.6 stays as is.

I'm not talking about fixing code in 3.6. In 3.6, sock_* methods still documented as coroutines but they are normal functions:

* https://docs.python.org/3.6/library/asyncio-eventloop.html#low-level-socket-operations
* https://github.com/python/cpython/blob/4002d5dbf4c058bbf2462f9f5dea057956d1caff/Doc/library/asyncio-eventloop.rst#low-level-socket-operations
* https://github.com/python/cpython/blob/4002d5dbf4c058bbf2462f9f5dea057956d1caff/Lib/asyncio/selector_events.py#L354

3.6 documentation still needs to be fixed. See my patch.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue29344>
_______________________________________

From report at bugs.python.org  Mon Jan 22 12:16:32 2018
From: report at bugs.python.org (Yury Selivanov)
Date: Mon, 22 Jan 2018 17:16:32 +0000
Subject: [docs] [issue29344] sock_recv not detected a coroutine
In-Reply-To: <1485094185.41.0.725056014669.issue29344@psf.upfronthosting.co.za>
Message-ID: <1516641392.45.0.467229070634.issue29344@psf.upfronthosting.co.za>


Yury Selivanov <yselivanov at gmail.com> added the comment:

Since we made them coroutines in 3.7, I'd prefer to keep the 3.6 documentation as is (so that people don't write code that expects them to be not coroutines in 3.6).

Please let's keep the current status quo.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue29344>
_______________________________________

From report at bugs.python.org  Mon Jan 22 12:41:42 2018
From: report at bugs.python.org (Alexander Belopolsky)
Date: Mon, 22 Jan 2018 17:41:42 +0000
Subject: [docs] [issue32625] Update the dis module documentation to reflect
 switch to wordcode
Message-ID: <1516642902.05.0.467229070634.issue32625@psf.upfronthosting.co.za>


New submission from Alexander Belopolsky <alexander.belopolsky at gmail.com>:

A switch to wordcode is implemented in Python 3.6, but the documentation in the dis module was mostly left unchanged.  See issue 26647, msg266388 and issue 27095, msg268389.

----------
assignee: docs at python
components: Documentation
messages: 310440
nosy: belopolsky, docs at python
priority: normal
severity: normal
stage: needs patch
status: open
title: Update the dis module documentation to reflect switch to wordcode
versions: Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32625>
_______________________________________

From report at bugs.python.org  Mon Jan 22 12:45:16 2018
From: report at bugs.python.org (Alexander Belopolsky)
Date: Mon, 22 Jan 2018 17:45:16 +0000
Subject: [docs] [issue32625] Update the dis module documentation to reflect
 switch to wordcode
In-Reply-To: <1516642902.05.0.467229070634.issue32625@psf.upfronthosting.co.za>
Message-ID: <1516643116.33.0.467229070634.issue32625@psf.upfronthosting.co.za>


Alexander Belopolsky <alexander.belopolsky at gmail.com> added the comment:

There is an uncommitted update for the EXTENDED_ARG opcode documentation attached to issue 27095 as mkfu4.patch by Demur Rumed.

----------
nosy: +Demur Rumed

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32625>
_______________________________________

From report at bugs.python.org  Mon Jan 22 13:00:30 2018
From: report at bugs.python.org (Berker Peksag)
Date: Mon, 22 Jan 2018 18:00:30 +0000
Subject: [docs] [issue29344] sock_recv not detected a coroutine
In-Reply-To: <1485094185.41.0.725056014669.issue29344@psf.upfronthosting.co.za>
Message-ID: <1516644030.53.0.467229070634.issue29344@psf.upfronthosting.co.za>


Berker Peksag <berker.peksag at gmail.com> added the comment:

Well, the current status quo has already confused a user (see msg286011)

> (so that people don't write code that expects them to be not coroutines in 3.6)

Even if people expect these methods to be coroutines, two functions of the asyncio public API (iscoroutinefunction() and iscoroutine()) disagree with them as described in msg286011.

In similar scenarios, we've always keep the code as is and clarified the docs in stable releases, then changed the code behave as documented in master.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue29344>
_______________________________________

From report at bugs.python.org  Mon Jan 22 13:17:06 2018
From: report at bugs.python.org (Yury Selivanov)
Date: Mon, 22 Jan 2018 18:17:06 +0000
Subject: [docs] [issue29344] sock_recv not detected a coroutine
In-Reply-To: <1485094185.41.0.725056014669.issue29344@psf.upfronthosting.co.za>
Message-ID: <1516645026.14.0.467229070634.issue29344@psf.upfronthosting.co.za>


Yury Selivanov <yselivanov at gmail.com> added the comment:

They have been documented as coroutines and were returning futures since Python 3.4. I believe we can keep the status quo especially if only one user complained about it during the last 5 years.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue29344>
_______________________________________

From report at bugs.python.org  Mon Jan 22 14:01:34 2018
From: report at bugs.python.org (Alexander Belopolsky)
Date: Mon, 22 Jan 2018 19:01:34 +0000
Subject: [docs] [issue32625] Update the dis module documentation to reflect
 switch to wordcode
In-Reply-To: <1516642902.05.0.467229070634.issue32625@psf.upfronthosting.co.za>
Message-ID: <1516647694.2.0.714561066657.issue32625@psf.upfronthosting.co.za>


Change by Alexander Belopolsky <alexander.belopolsky at gmail.com>:


----------
nosy: +vstinner

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32625>
_______________________________________

From hallo at golderweb.de  Fri Jan 19 15:14:49 2018
From: hallo at golderweb.de (Jonathan Golder)
Date: Fri, 19 Jan 2018 21:14:49 +0100
Subject: [docs] Missing header "Date" in email: Examples
Message-ID: <1a340a8b-2b6e-6f12-58a0-97e3ab2d0fe5@golderweb.de>

Hello,

as RFC2822 (https://tools.ietf.org/html/rfc2822.html) states out in
section /3.6 Field definitions, /the header field "Date" is mandatory.

This should be reflected in the examples shown on
https://docs.python.org/3.6/library/email-examples.html. For example by
adding a line like

??? msg["Date"] = email.utils.format_datetime(email.utils.localtime())

to each example.

Regards

Jonathan Golder

-- 
	GOLDERWEB
	Jonathan Golder
	In den Gei?hecken 15
	73614 Schorndorf
	
E-Mail:	hallo at golderweb.de
Web:	http://golderweb.de



From mark.luther0987 at protonmail.com  Mon Jan 22 06:47:54 2018
From: mark.luther0987 at protonmail.com (Mark.luther0987)
Date: Mon, 22 Jan 2018 06:47:54 -0500
Subject: [docs] Issue while using/CallerLookup package
Message-ID: <qCe4cpW75EBuGVVghLjCMraLagmQWGOwQcCc1PSToPh41W5N719Ic4I7olVzXvIVwQ80i47-ueI_OH1Cux_mzlZY5xocrX1tdXrDo6nObtc=@protonmail.com>

I accessed the CallerLookup package from below link
https://pypi.python.org/pypi/CallerLookup

and faced the following issue-
>>>
RESTART: C:\Users\hp\Desktop\CallerLookup-1.2.94\CallerLookup-1.2.94\CallerLookup\Main.py

Traceback (most recent call last):
  File "C:\Users\hp\Desktop\CallerLookup-1.2.94\CallerLookup-1.2.94\CallerLookup\Main.py", line 6, in <module>
    from CallerLookup.Responses import *
  File "C:\Python27\lib\site-packages\CallerLookup\__init__.py", line 6, in <module>
    from CallerLookup.Main import lookup_number
  File "C:\Python27\lib\site-packages\CallerLookup\Main.py", line 6, in <module>
    from CallerLookup.Responses import *
  File "C:\Python27\lib\site-packages\CallerLookup\Responses.py", line 7, in <module>
    from CallerLookup.Utils.Logs import format_exception
ImportError: No module named Utils.Logs

I tried on python 2.7.14. Please help to resolve this issue.

Sent with [ProtonMail](https://protonmail.com) Secure Email.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20180122/ece91daf/attachment.html>

From mos96b at yahoo.com  Tue Jan 23 02:09:21 2018
From: mos96b at yahoo.com (Tom mosninetysixb)
Date: Tue, 23 Jan 2018 07:09:21 +0000 (UTC)
Subject: [docs] Sincere question from retired librarian about Why should I
 attempt to learn te Python Programming Language
References: <1115717001.3120080.1516691361457.ref@mail.yahoo.com>
Message-ID: <1115717001.3120080.1516691361457@mail.yahoo.com>

I tried a computer programming course in college back in 1968, and received a grade of D.? I took a course in web page development in 1998, and prepared a website for the course.? I was not called upon to develop any web pages at work, except "fill in the blanks" for guides that use the "libguide" format

LibGuides - Content Management and Curation ?
springshare.com/libguides
LibGuides is an easy-to-use content management system deployed at thousands of libraries worldwide. Librarians use it to curate knowledge and share information .
The guides that I created for the University of Texas at Arlington Library have been deleted since my retirement.
My retirement projects are taking stacks of things, such as books, or VHS cassettes, or government publications, and turning them into lists of materials for other people to review and request an item.
I have never played computer games such as Pacman or anything like that.
I was in the public library recently and walked past the children's book section.? I knew that the Dewey Decimal Classification for computer books is 005, and saw? a shelf of books about computer programming for elementary school students.?
Have a feeling that learning SOME computer programming language is a task I ought to do to encourage younger people and their parents.But I keep remembering the long time question of children who ask? "? Teacher, what do we need to know all this math for?"
In the 53 years since I graduate from high school, I have not used mathematics beyond algebra and geometry.? Trying to learn calculus at college was a waste? of my time at college and hundreds of dollars in tuition and textbook purchases
.I am not trying to be "snarky".? I help tutor young people after school. and I need some real, reasonable answers to their questions,? and my own questions about WHY a person should learn a computer programming language.
Respectfully yours,? Thomas K. Lindsey,? Master of Library Science, and enrollment in at least 16 others college courses, and advanced professional military education.
mos96b at yahoo.com ?
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20180123/f40cd077/attachment.html>

From snowflake01986 at 126.com  Wed Jan 17 04:15:04 2018
From: snowflake01986 at 126.com (wu)
Date: Wed, 17 Jan 2018 17:15:04 +0800
Subject: [docs] how to prevent repeat click on tkinter button
Message-ID: <64743cac-305a-fb10-bad4-e68898849bd2@126.com>

Dear tkinter developper,

I try to learn tkinter recently, I have a problem about the button 
wedge, an example code is as follows:

/import tkinter as tk
import time
master = tk.Tk()
master.geometry("200x200")

def sleeptime():
     print("dfdhdhdhh")
     time.sleep(4)

tk.Button(master, text = 'start working', repeatinterval = 3, 
command=sleeptime).pack()
master.mainloop()/

/
/

try to click on the button quickly for several times and you will find 
that the button still works when in gray. Is there any way to get it 
over? (Python 3.5.2+)

I appreciate your reply. Thank you very much.

Sincerely,

Huan

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20180117/d2551e23/attachment.html>

From bgailer at gmail.com  Tue Jan 23 09:29:07 2018
From: bgailer at gmail.com (Bob Gailer)
Date: Tue, 23 Jan 2018 09:29:07 -0500
Subject: [docs] Sincere question from retired librarian about Why should
 I attempt to learn te Python Programming Language
In-Reply-To: <1115717001.3120080.1516691361457@mail.yahoo.com>
References: <1115717001.3120080.1516691361457.ref@mail.yahoo.com>
 <1115717001.3120080.1516691361457@mail.yahoo.com>
Message-ID: <CAP1rxO5du3adJHOmcMyKZN6VRGnmnmZYL046iARDAWmUUHLZzg@mail.gmail.com>

Because it's fun, stimulating, challenging, educational. You get to learn a
new skill , to create something that controls your computer, to understand
what's behind everything your computer does.

Python is an excellent language to learn because it is extremely simple,
straightforward, yet very powerful. There are various tutorials offered at
the python.org website. I recommend trying one of these and see how you
like it.

An investment of several hours going through a tutorial will probably
answer your question.

We are here to help beginners. Please address any further questions to
tutor@ python.org.

On Jan 23, 2018 8:14 AM, "Tom mosninetysixb via docs" <docs at python.org>
wrote:

> I tried a computer programming course in college back in 1968, and
> received a grade of D.  I took a course in web page development in 1998,
> and prepared a website for the course.  I was not called upon to develop
> any web pages at work, except "fill in the blanks" for guides that use the
> "libguide" format
>
> *LibGuides* - Content Management and Curation ?
> <http://springshare.com/libguides/>
> springshare.com/*libguides*
> <https://www.bing.com/search?q=libguides&form=EDGTCT&qs=PF&cvid=acf6ad080359419a9712800bb703b6be&refig=96b81d7c6e214753952bc94890955205&cc=US&setlang=en-US&elv=AXK1c4IvZoNqPoPnS%21QRLONfi6aDtkrBU%21zfrcJF9Pi4lKrCX9aXA09e8X9V%217Am0yALAre0rKOmlYRJykW6*FU7dHz2vhai2zlG32EoAnim#>
>
> *LibGuides* is an easy-to-use content management system deployed at
> thousands of libraries worldwide. Librarians use it to curate knowledge and
> share information .
> The guides that I created for the University of Texas at Arlington Library
> have been deleted since my retirement.
>
> My retirement projects are taking stacks of things, such as books, or VHS
> cassettes, or government publications, and turning them into lists of
> materials for other people to review and request an item.
>
> I have never played computer games such as Pacman or anything like that.
>
> I was in the public library recently and walked past the children's book
> section.  I knew that the Dewey Decimal Classification for computer books
> is 005, and saw  a shelf of books about computer programming for elementary
> school students.
>
> Have a feeling that learning SOME computer programming language is a task
> I ought to do to encourage younger people and their parents.
> But I keep remembering the long time question of children who ask  "
> Teacher, what do we need to know all this math for?"
>
> In the 53 years since I graduate from high school, I have not used
> mathematics beyond algebra and geometry.  Trying to learn calculus at
> college was a waste  of my time at college and hundreds of dollars in
> tuition and textbook purchases
> .
> I am not trying to be "snarky".  I help tutor young people after school.
> and I need some real, reasonable answers to their questions,  and my own
> questions about WHY a person should learn a computer programming language.
>
> Respectfully yours,  Thomas K. Lindsey,  Master of Library Science, and
> enrollment in at least 16 others college courses, and advanced professional
> military education.
>
> mos96b at yahoo.com
>
>
> _______________________________________________
> docs mailing list
> docs at python.org
> https://mail.python.org/mailman/listinfo/docs
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20180123/b9d4fb17/attachment-0001.html>

From report at bugs.python.org  Tue Jan 23 16:32:21 2018
From: report at bugs.python.org (Malcolm Smith)
Date: Tue, 23 Jan 2018 21:32:21 +0000
Subject: [docs] [issue32640] Python 2.7 str.join documentation is incorrect
Message-ID: <1516743141.31.0.467229070634.issue32640@psf.upfronthosting.co.za>


New submission from Malcolm Smith <malcolm.smith at gmail.com>:

At some point the Python 3 documentation of str.join has been copied to Python 2. This includes the sentence "A TypeError will be raised if there are any non-string values in iterable, including bytes objects." 

The second half of this sentence is wrong for Python 2. Not only is there no "bytes" type in Python 2, but join() in this version will happily join any mixture of unicode and (byte-)str objects, producing unicode output if any of the items (or separator) were unicode.

https://docs.python.org/2/library/stdtypes.html#str.join

----------
assignee: docs at python
components: Documentation
messages: 310525
nosy: Malcolm Smith, docs at python
priority: normal
severity: normal
status: open
title: Python 2.7 str.join documentation is incorrect
type: behavior
versions: Python 2.7

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32640>
_______________________________________

From report at bugs.python.org  Tue Jan 23 17:22:07 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Tue, 23 Jan 2018 22:22:07 +0000
Subject: [docs] [issue20709] os.utime(path_to_directory): wrong
 documentation for Windows.
In-Reply-To: <1392937056.04.0.541478480244.issue20709@psf.upfronthosting.co.za>
Message-ID: <1516746126.91.0.467229070634.issue20709@psf.upfronthosting.co.za>


Cheryl Sabella <chekat2 at gmail.com> added the comment:

@jgehrcke, would you be able to convert your patch to a Github pull request on the master branch?

----------
nosy: +csabella
stage:  -> needs patch
versions: +Python 3.7 -Python 2.7, Python 3.1, Python 3.2, Python 3.3, Python 3.4, Python 3.5

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue20709>
_______________________________________

From report at bugs.python.org  Tue Jan 23 17:41:15 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Tue, 23 Jan 2018 22:41:15 +0000
Subject: [docs] [issue32640] Python 2.7 str.join documentation is incorrect
In-Reply-To: <1516743141.31.0.467229070634.issue32640@psf.upfronthosting.co.za>
Message-ID: <1516747274.98.0.467229070634.issue32640@psf.upfronthosting.co.za>


Cheryl Sabella <chekat2 at gmail.com> added the comment:

Looks like this happened in PR1898.

----------
nosy: +Mariatta, csabella
stage:  -> needs patch

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32640>
_______________________________________

From report at bugs.python.org  Wed Jan 24 07:57:52 2018
From: report at bugs.python.org (Xiang Zhang)
Date: Wed, 24 Jan 2018 12:57:52 +0000
Subject: [docs] [issue17799] settrace docs are wrong about "c_call" events
In-Reply-To: <1366428980.14.0.538502026896.issue17799@psf.upfronthosting.co.za>
Message-ID: <1516798672.45.0.467229070634.issue17799@psf.upfronthosting.co.za>


Xiang Zhang <angwerzx at 126.com> added the comment:


New changeset 131fd7f96c619bc7eaea956e45c6337175f4b27f by Xiang Zhang (Pablo Galindo) in branch 'master':
bpo-17799: Explain real behaviour of sys.settrace and sys.setprofile (#4056)
https://github.com/python/cpython/commit/131fd7f96c619bc7eaea956e45c6337175f4b27f


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue17799>
_______________________________________

From report at bugs.python.org  Wed Jan 24 08:02:30 2018
From: report at bugs.python.org (Xiang Zhang)
Date: Wed, 24 Jan 2018 13:02:30 +0000
Subject: [docs] [issue32649] complete C API doc debug and profile part with
 new PyTrace_OPCODE
Message-ID: <1516798950.57.0.467229070634.issue32649@psf.upfronthosting.co.za>


New submission from Xiang Zhang <angwerzx at 126.com>:

As the title, the new PyTrace_OPCODE event is not documented in C API doc yet.

----------
assignee: docs at python
components: Documentation
messages: 310588
nosy: docs at python, ncoghlan, pablogsal, xiang.zhang
priority: normal
severity: normal
status: open
title: complete C API doc debug and profile part with new PyTrace_OPCODE
versions: Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32649>
_______________________________________

From report at bugs.python.org  Wed Jan 24 08:43:01 2018
From: report at bugs.python.org (Xiang Zhang)
Date: Wed, 24 Jan 2018 13:43:01 +0000
Subject: [docs] [issue17799] settrace docs are wrong about "c_call" events
In-Reply-To: <1366428980.14.0.538502026896.issue17799@psf.upfronthosting.co.za>
Message-ID: <1516801381.62.0.714561066657.issue17799@psf.upfronthosting.co.za>


Change by Xiang Zhang <angwerzx at 126.com>:


----------
pull_requests: +5145

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue17799>
_______________________________________

From report at bugs.python.org  Wed Jan 24 08:58:11 2018
From: report at bugs.python.org (Xiang Zhang)
Date: Wed, 24 Jan 2018 13:58:11 +0000
Subject: [docs] [issue17799] settrace docs are wrong about "c_call" events
In-Reply-To: <1366428980.14.0.538502026896.issue17799@psf.upfronthosting.co.za>
Message-ID: <1516802291.58.0.714561066657.issue17799@psf.upfronthosting.co.za>


Change by Xiang Zhang <angwerzx at 126.com>:


----------
pull_requests: +5146

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue17799>
_______________________________________

From report at bugs.python.org  Wed Jan 24 09:44:55 2018
From: report at bugs.python.org (Xiang Zhang)
Date: Wed, 24 Jan 2018 14:44:55 +0000
Subject: [docs] [issue17799] settrace docs are wrong about "c_call" events
In-Reply-To: <1366428980.14.0.538502026896.issue17799@psf.upfronthosting.co.za>
Message-ID: <1516805095.22.0.467229070634.issue17799@psf.upfronthosting.co.za>


Xiang Zhang <angwerzx at 126.com> added the comment:


New changeset fd844efa9c31e1f00e04b07940875b9dacff3d77 by Xiang Zhang in branch '3.6':
bpo-17799: Explain real behaviour of sys.settrace and sys.setprofile (GH-4056) (#5298)
https://github.com/python/cpython/commit/fd844efa9c31e1f00e04b07940875b9dacff3d77


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue17799>
_______________________________________

From report at bugs.python.org  Wed Jan 24 09:53:45 2018
From: report at bugs.python.org (Xiang Zhang)
Date: Wed, 24 Jan 2018 14:53:45 +0000
Subject: [docs] [issue17799] settrace docs are wrong about "c_call" events
In-Reply-To: <1366428980.14.0.538502026896.issue17799@psf.upfronthosting.co.za>
Message-ID: <1516805624.98.0.467229070634.issue17799@psf.upfronthosting.co.za>


Xiang Zhang <angwerzx at 126.com> added the comment:


New changeset e64a47b37d0c592fd162b2f51e79ecfd046b45ec by Xiang Zhang in branch '2.7':
bpo-17799: Explain real behaviour of sys.settrace and sys.setprofile (GH-4056). (#5299)
https://github.com/python/cpython/commit/e64a47b37d0c592fd162b2f51e79ecfd046b45ec


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue17799>
_______________________________________

From report at bugs.python.org  Wed Jan 24 09:54:45 2018
From: report at bugs.python.org (Xiang Zhang)
Date: Wed, 24 Jan 2018 14:54:45 +0000
Subject: [docs] [issue17799] settrace docs are wrong about "c_call" events
In-Reply-To: <1366428980.14.0.538502026896.issue17799@psf.upfronthosting.co.za>
Message-ID: <1516805685.3.0.714561066657.issue17799@psf.upfronthosting.co.za>


Change by Xiang Zhang <angwerzx at 126.com>:


----------
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue17799>
_______________________________________

From report at bugs.python.org  Wed Jan 24 17:51:17 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Wed, 24 Jan 2018 22:51:17 +0000
Subject: [docs] [issue27505] Missing documentation for setting module
 __class__ attribute
In-Reply-To: <1468373521.97.0.915242819681.issue27505@psf.upfronthosting.co.za>
Message-ID: <1516834277.29.0.467229070634.issue27505@psf.upfronthosting.co.za>


Cheryl Sabella <chekat2 at gmail.com> added the comment:

Nick, 

It looks like #32225 took care of this documentation change, so I think this can be closed?  Thanks!

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue27505>
_______________________________________

From report at bugs.python.org  Wed Jan 24 19:01:01 2018
From: report at bugs.python.org (Kevin Raeder)
Date: Thu, 25 Jan 2018 00:01:01 +0000
Subject: [docs] [issue32658] Metacharacter (\) documentation suggestion
Message-ID: <1516838461.29.0.467229070634.issue32658@psf.upfronthosting.co.za>


New submission from Kevin Raeder <raeder at ucar.edu>:

I've found the Regular Expression HOWTO to be very helpful
(https://docs.python.org/3/howto/regex.html?highlight=regular%20expressions). 
One inconsistency I noticed is that the intro to metacharacters says
"Metacharacters are not active inside classes. "
But farther down we learn that a class can be constructed using \s: [\s,.],
which is "all white space characters , and ."
It's not the 4 characters "\ s , and ."
So I think the first statement would be clearer as
"Metacharacters (except \) are not active inside classes. "

----------
assignee: docs at python
components: Documentation
messages: 310647
nosy: docs at python, kdraeder
priority: normal
severity: normal
status: open
title: Metacharacter (\) documentation suggestion

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32658>
_______________________________________

From report at bugs.python.org  Thu Jan 25 00:01:57 2018
From: report at bugs.python.org (Marcel Widjaja)
Date: Thu, 25 Jan 2018 05:01:57 +0000
Subject: [docs] [issue12706] timeout sentinel in ftplib and poplib
 documentation
In-Reply-To: <1312705981.24.0.601234287082.issue12706@psf.upfronthosting.co.za>
Message-ID: <1516856517.46.0.714561066657.issue12706@psf.upfronthosting.co.za>


Change by Marcel Widjaja <mwidj at yahoo.com>:


----------
pull_requests: +5156
stage: needs patch -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue12706>
_______________________________________

From report at bugs.python.org  Thu Jan 25 00:14:55 2018
From: report at bugs.python.org (Chason Chaffin)
Date: Thu, 25 Jan 2018 05:14:55 +0000
Subject: [docs] [issue31972] Inherited docstrings for pathlib classes are
 confusing
In-Reply-To: <1510081543.19.0.213398074469.issue31972@psf.upfronthosting.co.za>
Message-ID: <1516857295.34.0.714561066657.issue31972@psf.upfronthosting.co.za>


Change by Chason Chaffin <chason at gmail.com>:


----------
pull_requests: +5157

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue31972>
_______________________________________

From report at bugs.python.org  Thu Jan 25 00:39:02 2018
From: report at bugs.python.org (Nick Coghlan)
Date: Thu, 25 Jan 2018 05:39:02 +0000
Subject: [docs] [issue27505] Missing documentation for setting module
 __class__ attribute
In-Reply-To: <1468373521.97.0.915242819681.issue27505@psf.upfronthosting.co.za>
Message-ID: <1516858741.93.0.467229070634.issue27505@psf.upfronthosting.co.za>


Nick Coghlan <ncoghlan at gmail.com> added the comment:

I think the only thing missing for the 3.7 docs now would be a pair of "versionchanged" notes indicating that __class__ has been settable since 3.5, while module level __dir__ and __getattr__ support is new in 3.7.

It would also be desirable to add the __class__ docs to the 3.6 maintenance branch.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue27505>
_______________________________________

From report at bugs.python.org  Thu Jan 25 03:54:10 2018
From: report at bugs.python.org (Richard Neumann)
Date: Thu, 25 Jan 2018 08:54:10 +0000
Subject: [docs] [issue32664] Connector "|" missing between ImportError and
 LookupError
Message-ID: <1516870450.69.0.467229070634.issue32664@psf.upfronthosting.co.za>


New submission from Richard Neumann <r.neumann at homeinfo.de>:

In the documentation of the built-in exceptions hierarchy, there is a "|" missing connecting ImportError and LookupError.

https://docs.python.org/3/library/exceptions.html#exception-hierarchy

>From LookupError.__mro__ we can tell, that it is actually derived from Exception, thus there should be a "|" connecting it to the hierarchy under Exception to emphasize that (like between ArithmeticError and AssertionError).

----------
assignee: docs at python
components: Documentation
messages: 310666
nosy: Richard Neumann, docs at python
priority: normal
severity: normal
status: open
title: Connector "|"  missing between ImportError and LookupError
type: enhancement
versions: Python 3.6

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32664>
_______________________________________

From emacsnt at foxmail.com  Wed Jan 24 02:12:40 2018
From: emacsnt at foxmail.com (=?ISO-8859-1?B?cmVsb2FkZWQ=?=)
Date: Wed, 24 Jan 2018 15:12:40 +0800
Subject: [docs] bug report for itertools.takewhile 20180124
Message-ID: <tencent_F88690E976C6C849FDF85EE8966E27516609@qq.com>

hi, python officer

I am not sure whether it is a correct behavior for takewhile function


from itertools import takewhile
print(list(takewhile(lambda x:x%2==0, [2,1])))
print(list(takewhile(lambda x:x%2==0, [1,2])))

this code results
[2]
[]


it seems that all the number after 1 (in the second argument ) will be ignored(or discarded) by takewhile function
print(list(takewhile(lambda x:x%2==0, [2,1,4,6,8])))
[2]
print(list(takewhile(lambda x:x%2==0, [1,2,4,6,8])))

[]
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20180124/0e3c7a86/attachment-0001.html>

From emacsnt at foxmail.com  Wed Jan 24 02:19:29 2018
From: emacsnt at foxmail.com (=?ISO-8859-1?B?cmVsb2FkZWQ=?=)
Date: Wed, 24 Jan 2018 15:19:29 +0800
Subject: [docs] bug report for itertools.takewhile
Message-ID: <tencent_11467411B79328594379741163FFA45F7C08@qq.com>

hi, python officer


I am not sure whether it is a correct behavior for takewhile function


from itertools import takewhile
print(list(takewhile(lambda x:x%2==0, [2,1])))
print(list(takewhile(lambda x:x%2==0, [1,2])))
this codes results
[2]
[]


it seems that all the elements after 1 (in the second argument ) will be ignored(or discarded) by takewhile function
print(list(takewhile(lambda x:x%2==0, [2,1,4,6,8])))
[2]
print(list(takewhile(lambda x:x%2==0, [1,2,4,6,8])))
[]


it appeared on python3.5.2(win64) and python 3.6.4(CentOS7.1). I do not test on other version of python


your sincerely
Jacky
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20180124/82b5cb3c/attachment.html>

From report at bugs.python.org  Thu Jan 25 08:29:45 2018
From: report at bugs.python.org (Reuben Thomas)
Date: Thu, 25 Jan 2018 13:29:45 +0000
Subject: [docs] [issue32666] Valgrind documentation seems to need updating
Message-ID: <1516886985.24.0.467229070634.issue32666@psf.upfronthosting.co.za>


New submission from Reuben Thomas <rrt at sc3d.org>:

I have just been trying to use Valgrind (in my case, to debug code in a library being tested via a Cython module).

It is working fine, but there seem to be some discrepancies between the documentation in README.valgrind and valgrind-python.supp on the one hand, and the actual code on the other.

README.Valgrind says (current git master):

Second, you must do one of the following:

  * Uncomment Py_USING_MEMORY_DEBUGGER in Objects/obmalloc.c,
    then rebuild Python
  * Uncomment the lines in Misc/valgrind-python.supp that
    suppress the warnings for PyObject_Free and PyObject_Realloc

However, Objects/objmalloc.c no longer contain this symbol (though Python/dtoa.c does).

Further, in https://bugs.python.org/issue31494 I find the following comment:

Also, I don't think --with-pydebug works well with valgrind.

It's either:
   1) --with-pydebug
   2) CFLAGS="-O0 -g" --with-valgrind
   3) CFLAGS="-O0 -g" --without-pymalloc

Combining 2) and 3) probably does not hurt, but is not necessary.

It would be useful to have this information in README.valgrind.

Also, the provided suppressions do not currently work with a normal build of Python, at least with Python 2.7 (with the PyObject_{Free,Realloc} suppressions uncommented). There seem to be at least two problems:

1. Extra symbols from LTO. This can be fixed by adding "*" to PyObject_Realloc in all its suppressions.

2. After fixing that, I still get one more "Invalid read of size 4":

==3227== Invalid read of size 4
==3227==    at 0x4FCEE2: long_dealloc.lto_priv.323 (abstract.c:2000)
==3227==    by 0x4BA22B: frame_dealloc (frameobject.c:458)
==3227==    by 0x4BA22B: PyEval_EvalCodeEx (ceval.c:3593)
==3227==    by 0x4C16E6: fast_function (ceval.c:4445)
==3227==    by 0x4C16E6: call_function (ceval.c:4370)

I can't see how this is related to any existing suppression.

I am using the stock Python 2.7 on Ubuntu 16.04. I find that I can work around both the above problems (that is, use the suppressions file as-is, just uncommenting the extra suppressions for PyObject_{Free,Realloc}) by using Ubuntu's debug build of Python (installed as /usr/bin/python-dbg). It is built with --with-pydebug.

Finally, README.valgrind says: "Valgrind is used periodically by Python developers to try to ensure there are no memory leaks or invalid memory reads/writes." Another reason to use Valgrind is, as in my case, to debug unrelated C code that is being run via Python (this is often a convenient way to write tests). I suggest deleting this sentence and making it more obvious how to simply make Python "transparent to Valgrind" for those trying to debug C libraries.

To summarise:

i. It seems that for current Python 3, this text:

  * Uncomment Py_USING_MEMORY_DEBUGGER in Objects/obmalloc.c,
    then rebuild Python

needs to be updated.

ii. For Python 2.7 at least, and possibly Python 3, extra suppressions are needed to use a standard build.

iii. It would be good to have the specific build advice from https://bugs.python.org/issue31494 in README.valgrind.

iv. It would be nice to clarify how to use a normal build of Python (e.g. by splitting the advice into "For Python developers" and "For Python users").

Given some guidance on what is correct, and what is desired/acceptable, I'd be happy to work up a patch to README.valgrind and valgrind-python.supp.

----------
assignee: docs at python
components: Documentation
messages: 310673
nosy: docs at python, rrt
priority: normal
severity: normal
status: open
title: Valgrind documentation seems to need updating
versions: Python 3.8

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32666>
_______________________________________

From report at bugs.python.org  Thu Jan 25 10:05:59 2018
From: report at bugs.python.org (Berker Peksag)
Date: Thu, 25 Jan 2018 15:05:59 +0000
Subject: [docs] [issue32664] Connector "|" missing between ImportError and
 LookupError
In-Reply-To: <1516870450.69.0.467229070634.issue32664@psf.upfronthosting.co.za>
Message-ID: <1516892759.9.0.714561066657.issue32664@psf.upfronthosting.co.za>


Change by Berker Peksag <berker.peksag at gmail.com>:


----------
keywords: +easy
stage:  -> needs patch
versions: +Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32664>
_______________________________________

From report at bugs.python.org  Thu Jan 25 10:38:30 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Thu, 25 Jan 2018 15:38:30 +0000
Subject: [docs] [issue27505] Missing documentation for setting module
 __class__ attribute
In-Reply-To: <1468373521.97.0.915242819681.issue27505@psf.upfronthosting.co.za>
Message-ID: <1516894710.37.0.714561066657.issue27505@psf.upfronthosting.co.za>


Change by Cheryl Sabella <chekat2 at gmail.com>:


----------
keywords: +patch
pull_requests: +5165
stage: needs patch -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue27505>
_______________________________________

From report at bugs.python.org  Thu Jan 25 10:51:56 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Thu, 25 Jan 2018 15:51:56 +0000
Subject: [docs] [issue27505] Missing documentation for setting module
 __class__ attribute
In-Reply-To: <1468373521.97.0.915242819681.issue27505@psf.upfronthosting.co.za>
Message-ID: <1516895516.67.0.714561066657.issue27505@psf.upfronthosting.co.za>


Change by Cheryl Sabella <chekat2 at gmail.com>:


----------
pull_requests: +5166

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue27505>
_______________________________________

From report at bugs.python.org  Thu Jan 25 10:52:52 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Thu, 25 Jan 2018 15:52:52 +0000
Subject: [docs] [issue27505] Missing documentation for setting module
 __class__ attribute
In-Reply-To: <1468373521.97.0.915242819681.issue27505@psf.upfronthosting.co.za>
Message-ID: <1516895572.44.0.467229070634.issue27505@psf.upfronthosting.co.za>


Cheryl Sabella <chekat2 at gmail.com> added the comment:

Thanks Nick.  I've made the PRs for the versionadded and to add __class__ to the 3.6 docs.

----------
stage: patch review -> needs patch
versions: +Python 3.7 -Python 3.5

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue27505>
_______________________________________

From report at bugs.python.org  Thu Jan 25 10:53:44 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Thu, 25 Jan 2018 15:53:44 +0000
Subject: [docs] [issue27505] Missing documentation for setting module
 __class__ attribute
In-Reply-To: <1468373521.97.0.915242819681.issue27505@psf.upfronthosting.co.za>
Message-ID: <1516895624.8.0.714561066657.issue27505@psf.upfronthosting.co.za>


Change by Cheryl Sabella <chekat2 at gmail.com>:


----------
stage: needs patch -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue27505>
_______________________________________

From report at bugs.python.org  Thu Jan 25 11:15:24 2018
From: report at bugs.python.org (Yahya Abou Imran)
Date: Thu, 25 Jan 2018 16:15:24 +0000
Subject: [docs] [issue32471] Add an UML class diagram to the collections.abc
 module documentation
In-Reply-To: <1514785654.69.0.467229070634.issue32471@psf.upfronthosting.co.za>
Message-ID: <1516896923.99.0.467229070634.issue32471@psf.upfronthosting.co.za>


Yahya Abou Imran <yahya-abou-imran at protonmail.com> added the comment:

I succeed in submitting a PR and building the doc locally.

But there is a little problem of consistency with the abstract methods:
in some classes, the inherited one are mentioned (Collection, Sequence, Mapping), but not in some others (Coroutine, Reversible).

So I don't not what to show and what to hide.

I opened an other issue for this:
https://bugs.python.org/issue32621

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32471>
_______________________________________

From report at bugs.python.org  Thu Jan 25 12:26:23 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 25 Jan 2018 17:26:23 +0000
Subject: [docs] [issue32640] Python 2.7 str.join documentation is incorrect
In-Reply-To: <1516743141.31.0.467229070634.issue32640@psf.upfronthosting.co.za>
Message-ID: <1516901183.24.0.467229070634.issue32640@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:

Oops.
Thanks, I will work on reverting the change later today.

----------
assignee: docs at python -> Mariatta

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32640>
_______________________________________

From report at bugs.python.org  Thu Jan 25 19:05:50 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Fri, 26 Jan 2018 00:05:50 +0000
Subject: [docs] [issue11023] pep 227 missing text
In-Reply-To: <1296134235.25.0.738218358402.issue11023@psf.upfronthosting.co.za>
Message-ID: <1516925150.27.0.467229070634.issue11023@psf.upfronthosting.co.za>


Cheryl Sabella <chekat2 at gmail.com> added the comment:

Moved to the PEP issue tracker.
https://github.com/python/peps/issues/557

----------
nosy: +csabella
resolution:  -> later
stage: needs patch -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue11023>
_______________________________________

From report at bugs.python.org  Thu Jan 25 21:01:36 2018
From: report at bugs.python.org (Chason Chaffin)
Date: Fri, 26 Jan 2018 02:01:36 +0000
Subject: [docs] [issue31972] Inherited docstrings for pathlib classes are
 confusing
In-Reply-To: <1510081543.19.0.213398074469.issue31972@psf.upfronthosting.co.za>
Message-ID: <1516932096.05.0.714561066657.issue31972@psf.upfronthosting.co.za>


Change by Chason Chaffin <chason at gmail.com>:


----------
nosy: +chason

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue31972>
_______________________________________

From report at bugs.python.org  Thu Jan 25 22:30:50 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 26 Jan 2018 03:30:50 +0000
Subject: [docs] [issue32640] Python 2.7 str.join documentation is incorrect
In-Reply-To: <1516743141.31.0.467229070634.issue32640@psf.upfronthosting.co.za>
Message-ID: <1516937450.78.0.714561066657.issue32640@psf.upfronthosting.co.za>


Change by Mariatta Wijaya <mariatta.wijaya at gmail.com>:


----------
keywords: +patch
pull_requests: +5179
stage: needs patch -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32640>
_______________________________________

From report at bugs.python.org  Thu Jan 25 22:33:10 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 26 Jan 2018 03:33:10 +0000
Subject: [docs] [issue32640] Python 2.7 str.join documentation is incorrect
In-Reply-To: <1516743141.31.0.467229070634.issue32640@psf.upfronthosting.co.za>
Message-ID: <1516937590.87.0.467229070634.issue32640@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:

GH-5333 clarifies that str.join can return a Unicode object if iterable contains a Unicode object, and that it will raise TypeError if there is any non string or non unicode object.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32640>
_______________________________________

From report at bugs.python.org  Fri Jan 26 01:10:52 2018
From: report at bugs.python.org (Xiang Zhang)
Date: Fri, 26 Jan 2018 06:10:52 +0000
Subject: [docs] [issue32673] update tutorial dict part to reflect dict is
 ordered
Message-ID: <1516947052.29.0.467229070634.issue32673@psf.upfronthosting.co.za>


New submission from Xiang Zhang <angwerzx at 126.com>:

Ordered builtin dict is the rule in 3.7, the tutorial part about dict[1] needs updating.

[1] https://docs.python.org/3.7/tutorial/datastructures.html#dictionaries

----------
assignee: docs at python
components: Documentation
messages: 310737
nosy: docs at python, xiang.zhang
priority: normal
severity: normal
stage: needs patch
status: open
title: update tutorial dict part to reflect dict is ordered
versions: Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32673>
_______________________________________

From report at bugs.python.org  Fri Jan 26 01:22:18 2018
From: report at bugs.python.org (Chason Chaffin)
Date: Fri, 26 Jan 2018 06:22:18 +0000
Subject: [docs] [issue32673] update tutorial dict part to reflect dict is
 ordered
In-Reply-To: <1516947052.29.0.467229070634.issue32673@psf.upfronthosting.co.za>
Message-ID: <1516947738.96.0.714561066657.issue32673@psf.upfronthosting.co.za>


Change by Chason Chaffin <chason at gmail.com>:


----------
nosy: +chason

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32673>
_______________________________________

From report at bugs.python.org  Fri Jan 26 01:41:42 2018
From: report at bugs.python.org (Qian Yun)
Date: Fri, 26 Jan 2018 06:41:42 +0000
Subject: [docs] [issue32674] minor documentation fix for '__import__'
Message-ID: <1516948902.25.0.467229070634.issue32674@psf.upfronthosting.co.za>


New submission from Qian Yun <oldk1331 at gmail.com>:

This is a minor documentation for builtin function '__import__'.

----------
assignee: docs at python
components: Documentation
messages: 310741
nosy: Qian Yun, docs at python
priority: normal
severity: normal
status: open
title: minor documentation fix for '__import__'
versions: Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32674>
_______________________________________

From report at bugs.python.org  Fri Jan 26 01:46:52 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Fri, 26 Jan 2018 06:46:52 +0000
Subject: [docs] [issue32674] minor documentation fix for '__import__'
In-Reply-To: <1516948902.25.0.467229070634.issue32674@psf.upfronthosting.co.za>
Message-ID: <1516949211.98.0.467229070634.issue32674@psf.upfronthosting.co.za>


St?phane Wirtel <stephane at wirtel.be> added the comment:

minor documentation?

I don't understand, the documentation of __import__ is well done, could you explain ?

https://docs.python.org/3/library/functions.html#__import__

thank you

----------
nosy: +matrixise

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32674>
_______________________________________

From report at bugs.python.org  Fri Jan 26 01:47:53 2018
From: report at bugs.python.org (Qian Yun)
Date: Fri, 26 Jan 2018 06:47:53 +0000
Subject: [docs] [issue32674] minor documentation fix for '__import__'
In-Reply-To: <1516948902.25.0.467229070634.issue32674@psf.upfronthosting.co.za>
Message-ID: <1516949273.45.0.714561066657.issue32674@psf.upfronthosting.co.za>


Change by Qian Yun <oldk1331 at gmail.com>:


----------
keywords: +patch
pull_requests: +5186
stage:  -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32674>
_______________________________________

From report at bugs.python.org  Fri Jan 26 02:00:14 2018
From: report at bugs.python.org (Qian Yun)
Date: Fri, 26 Jan 2018 07:00:14 +0000
Subject: [docs] [issue32674] minor documentation fix for '__import__'
In-Reply-To: <1516948902.25.0.467229070634.issue32674@psf.upfronthosting.co.za>
Message-ID: <1516950014.04.0.467229070634.issue32674@psf.upfronthosting.co.za>


Qian Yun <oldk1331 at gmail.com> added the comment:

Sorry, a typo, it's "minor documentation fix".

See https://github.com/python/cpython/pull/5339

diff --git a/Python/bltinmodule.c b/Python/bltinmodule.c
index d8971bef2a..80b4f9447c 100644
--- a/Python/bltinmodule.c
+++ b/Python/bltinmodule.c
@@ -317,7 +317,7 @@ PyDoc_STRVAR(import_doc,
 "__import__(name, globals=None, locals=None, fromlist=(), level=0) -> module\n\
 \n\
 Import a module. Because this function is meant for use by the Python\n\
-interpreter and not for general use it is better to use\n\
+interpreter and not for general use, it is better to use\n\
 importlib.import_module() to programmatically import a module.\n\
 \n\
 The globals argument is only used to determine the context;\n\
@@ -326,8 +326,8 @@ should be a list of names to emulate ``from name import ...'', or an\n\
 empty list to emulate ``import name''.\n\
 When importing a module from a package, note that __import__('A.B', ...)\n\
 returns package A when fromlist is empty, but its submodule B when\n\
-fromlist is not empty.  Level is used to determine whether to perform \n\
-absolute or relative imports. 0 is absolute while a positive number\n\
+fromlist is not empty.  The level argument is used to determine whether to\n\
+perform absolute or relative imports, 0 is absolute while a positive number\n\
 is the number of parent directories to search relative to the current module.");

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32674>
_______________________________________

From report at bugs.python.org  Fri Jan 26 02:16:29 2018
From: report at bugs.python.org (Martin Panter)
Date: Fri, 26 Jan 2018 07:16:29 +0000
Subject: [docs] [issue32673] update tutorial dict part to reflect dict is
 ordered
In-Reply-To: <1516947052.29.0.467229070634.issue32673@psf.upfronthosting.co.za>
Message-ID: <1516950989.05.0.467229070634.issue32673@psf.upfronthosting.co.za>


Martin Panter <vadmium+py at gmail.com> added the comment:

See Issue 32337

----------
nosy: +martin.panter

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32673>
_______________________________________

From report at bugs.python.org  Fri Jan 26 02:16:47 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Fri, 26 Jan 2018 07:16:47 +0000
Subject: [docs] [issue32674] minor documentation fix for '__import__'
In-Reply-To: <1516950014.04.0.467229070634.issue32674@psf.upfronthosting.co.za>
Message-ID: <20180126071643.GA16431@xps>


St?phane Wirtel <stephane at wirtel.be> added the comment:

Don't worry, but in fact, I did not understand because when you post
your issue, there was no associated PR.

Now, I do understand.

Thank you

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32674>
_______________________________________

From report at bugs.python.org  Fri Jan 26 02:39:38 2018
From: report at bugs.python.org (Xiang Zhang)
Date: Fri, 26 Jan 2018 07:39:38 +0000
Subject: [docs] [issue32673] update tutorial dict part to reflect dict is
 ordered
In-Reply-To: <1516947052.29.0.467229070634.issue32673@psf.upfronthosting.co.za>
Message-ID: <1516952378.41.0.467229070634.issue32673@psf.upfronthosting.co.za>


Xiang Zhang <angwerzx at 126.com> added the comment:

Thanks for reminding, Martin.

----------
resolution:  -> duplicate
stage: needs patch -> resolved
status: open -> closed
superseder:  -> Dict order is now guaranteed, so add tests and doc for it

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32673>
_______________________________________

From report at bugs.python.org  Fri Jan 26 12:55:18 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 26 Jan 2018 17:55:18 +0000
Subject: [docs] [issue32640] Python 2.7 str.join documentation is incorrect
In-Reply-To: <1516743141.31.0.467229070634.issue32640@psf.upfronthosting.co.za>
Message-ID: <1516989318.12.0.467229070634.issue32640@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:


New changeset f5e8f71fe339fe5e47c4d24ac2e5177fa3c02922 by Mariatta in branch '2.7':
[2.7] bpo-32640: Clarify the behavior of str.join and unicode object (GH-5333)
https://github.com/python/cpython/commit/f5e8f71fe339fe5e47c4d24ac2e5177fa3c02922


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32640>
_______________________________________

From report at bugs.python.org  Fri Jan 26 12:55:48 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 26 Jan 2018 17:55:48 +0000
Subject: [docs] [issue32640] Python 2.7 str.join documentation is incorrect
In-Reply-To: <1516743141.31.0.467229070634.issue32640@psf.upfronthosting.co.za>
Message-ID: <1516989348.61.0.467229070634.issue32640@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:

Thanks!

----------
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32640>
_______________________________________

From report at bugs.python.org  Fri Jan 26 16:59:17 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 26 Jan 2018 21:59:17 +0000
Subject: [docs] [issue32614] Fix documentation examples of using re with
 escape sequences
In-Reply-To: <1516574858.82.0.467229070634.issue32614@psf.upfronthosting.co.za>
Message-ID: <1517003957.73.0.467229070634.issue32614@psf.upfronthosting.co.za>


Terry J. Reedy <tjreedy at udel.edu> added the comment:

Definitely.  x.y code, including doc examples, should free of such warnings.

----------
nosy: +terry.reedy

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32614>
_______________________________________

From report at bugs.python.org  Fri Jan 26 17:41:06 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Fri, 26 Jan 2018 22:41:06 +0000
Subject: [docs] [issue15115] Duplicated Content-Transfer-Encoding header
 when applying email.encoders
In-Reply-To: <1340188711.86.0.286169814605.issue15115@psf.upfronthosting.co.za>
Message-ID: <1517006466.91.0.714561066657.issue15115@psf.upfronthosting.co.za>


Change by Cheryl Sabella <chekat2 at gmail.com>:


----------
keywords: +patch
pull_requests: +5200
stage: needs patch -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue15115>
_______________________________________

From report at bugs.python.org  Fri Jan 26 17:42:44 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Fri, 26 Jan 2018 22:42:44 +0000
Subject: [docs] [issue15115] Duplicated Content-Transfer-Encoding header
 when applying email.encoders
In-Reply-To: <1340188711.86.0.286169814605.issue15115@psf.upfronthosting.co.za>
Message-ID: <1517006564.62.0.467229070634.issue15115@psf.upfronthosting.co.za>


Cheryl Sabella <chekat2 at gmail.com> added the comment:

Hi David, 

I've made a pull request for the way I think you wanted this documented.  Please take a look and let me know if it's even close to what you were suggesting.  Thanks!   :-)

----------
stage: patch review -> needs patch

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue15115>
_______________________________________

From report at bugs.python.org  Fri Jan 26 18:53:42 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 26 Jan 2018 23:53:42 +0000
Subject: [docs] [issue32621] Problem of consistence in collection.abc
 documentation
In-Reply-To: <1516631316.64.0.467229070634.issue32621@psf.upfronthosting.co.za>
Message-ID: <1517010822.24.0.714561066657.issue32621@psf.upfronthosting.co.za>


Change by Terry J. Reedy <tjreedy at udel.edu>:


----------
assignee:  -> docs at python
components: +Documentation, Library (Lib)
nosy: +docs at python
stage:  -> needs patch

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32621>
_______________________________________

From report at bugs.python.org  Fri Jan 26 21:40:54 2018
From: report at bugs.python.org (Nick Coghlan)
Date: Sat, 27 Jan 2018 02:40:54 +0000
Subject: [docs] [issue27505] Missing documentation for setting module
 __class__ attribute
In-Reply-To: <1468373521.97.0.915242819681.issue27505@psf.upfronthosting.co.za>
Message-ID: <1517020854.28.0.467229070634.issue27505@psf.upfronthosting.co.za>


Nick Coghlan <ncoghlan at gmail.com> added the comment:


New changeset 85527cf50a9a4eecaca4022f7c6cb9e0bae1fa5f by Nick Coghlan (Cheryl Sabella) in branch 'master':
bpo-27505: Add change notes in module attribute docs (GH-5320)
https://github.com/python/cpython/commit/85527cf50a9a4eecaca4022f7c6cb9e0bae1fa5f


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue27505>
_______________________________________

From report at bugs.python.org  Fri Jan 26 21:45:27 2018
From: report at bugs.python.org (Nick Coghlan)
Date: Sat, 27 Jan 2018 02:45:27 +0000
Subject: [docs] [issue27505] Missing documentation for setting module
 __class__ attribute
In-Reply-To: <1468373521.97.0.915242819681.issue27505@psf.upfronthosting.co.za>
Message-ID: <1517021127.11.0.467229070634.issue27505@psf.upfronthosting.co.za>


Nick Coghlan <ncoghlan at gmail.com> added the comment:


New changeset 8f68cb7db37322cfeeb8338e78474e5f25d930c5 by Nick Coghlan (Cheryl Sabella) in branch '3.6':
[3.6] bpo-27505: Retrofit module __class__ documentation from 3.7 (GH-5321)
https://github.com/python/cpython/commit/8f68cb7db37322cfeeb8338e78474e5f25d930c5


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue27505>
_______________________________________

From report at bugs.python.org  Fri Jan 26 21:46:59 2018
From: report at bugs.python.org (Nick Coghlan)
Date: Sat, 27 Jan 2018 02:46:59 +0000
Subject: [docs] [issue27505] Missing documentation for setting module
 __class__ attribute
In-Reply-To: <1468373521.97.0.915242819681.issue27505@psf.upfronthosting.co.za>
Message-ID: <1517021219.0.0.467229070634.issue27505@psf.upfronthosting.co.za>


Nick Coghlan <ncoghlan at gmail.com> added the comment:

Thanks for the PRs!

----------
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue27505>
_______________________________________

From report at bugs.python.org  Fri Jan 26 23:39:19 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 27 Jan 2018 04:39:19 +0000
Subject: [docs] [issue32664] Connector "|" missing between ImportError and
 LookupError
In-Reply-To: <1516870450.69.0.467229070634.issue32664@psf.upfronthosting.co.za>
Message-ID: <1517027959.48.0.467229070634.issue32664@psf.upfronthosting.co.za>


Terry J. Reedy <tjreedy at udel.edu> added the comment:

Agreed, like there is a bar between NameError and OSError.

The 2.7 version does not have the problem.

----------
nosy: +terry.reedy

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32664>
_______________________________________

From report at bugs.python.org  Sat Jan 27 00:03:43 2018
From: report at bugs.python.org (KINEBUCHI Tomohiko)
Date: Sat, 27 Jan 2018 05:03:43 +0000
Subject: [docs] [issue32664] Connector "|" missing between ImportError and
 LookupError
In-Reply-To: <1516870450.69.0.467229070634.issue32664@psf.upfronthosting.co.za>
Message-ID: <1517029423.83.0.714561066657.issue32664@psf.upfronthosting.co.za>


Change by KINEBUCHI Tomohiko <cocoatomo77 at gmail.com>:


----------
keywords: +patch
pull_requests: +5201
stage: needs patch -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32664>
_______________________________________

From report at bugs.python.org  Sat Jan 27 00:05:11 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 27 Jan 2018 05:05:11 +0000
Subject: [docs] [issue32664] Connector "|" missing between ImportError and
 LookupError
In-Reply-To: <1516870450.69.0.467229070634.issue32664@psf.upfronthosting.co.za>
Message-ID: <1517029511.05.0.467229070634.issue32664@psf.upfronthosting.co.za>


Terry J. Reedy <tjreedy at udel.edu> added the comment:

PR-1173 fixed this for 3.7, but it was not backported then.  I added a comment there.

----------
keywords:  -patch
stage: patch review -> backport needed
versions:  -Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32664>
_______________________________________

From report at bugs.python.org  Sat Jan 27 00:28:00 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 27 Jan 2018 05:28:00 +0000
Subject: [docs] [issue32666] Valgrind documentation seems to need updating
In-Reply-To: <1516886985.24.0.467229070634.issue32666@psf.upfronthosting.co.za>
Message-ID: <1517030880.79.0.467229070634.issue32666@psf.upfronthosting.co.za>


Terry J. Reedy <tjreedy at udel.edu> added the comment:

Christian or Brett, do either of you know who maintains the Valgrind stuff?  There is no listing in the Expert's index.

----------
nosy: +brett.cannon, christian.heimes, terry.reedy

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32666>
_______________________________________

From report at bugs.python.org  Sat Jan 27 09:34:05 2018
From: report at bugs.python.org (Xiang Zhang)
Date: Sat, 27 Jan 2018 14:34:05 +0000
Subject: [docs] [issue32532] improve sys.settrace and sys.setprofile
 documentation
In-Reply-To: <1515651956.68.0.467229070634.issue32532@psf.upfronthosting.co.za>
Message-ID: <1517063645.81.0.714561066657.issue32532@psf.upfronthosting.co.za>


Change by Xiang Zhang <angwerzx at 126.com>:


----------
keywords: +patch
pull_requests: +5204
stage: needs patch -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32532>
_______________________________________

From report at bugs.python.org  Sat Jan 27 10:04:49 2018
From: report at bugs.python.org (Xiang Zhang)
Date: Sat, 27 Jan 2018 15:04:49 +0000
Subject: [docs] [issue32532] improve sys.settrace and sys.setprofile
 documentation
In-Reply-To: <1515651956.68.0.467229070634.issue32532@psf.upfronthosting.co.za>
Message-ID: <1517065489.19.0.467229070634.issue32532@psf.upfronthosting.co.za>


Xiang Zhang <angwerzx at 126.com> added the comment:


New changeset 60da99b8e2f7bf497569ae4d6c218866575729bf by Xiang Zhang in branch 'master':
bpo-32532: Improve documentation of settrace and setprofile (#5359)
https://github.com/python/cpython/commit/60da99b8e2f7bf497569ae4d6c218866575729bf


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32532>
_______________________________________

From report at bugs.python.org  Sat Jan 27 10:05:37 2018
From: report at bugs.python.org (Xiang Zhang)
Date: Sat, 27 Jan 2018 15:05:37 +0000
Subject: [docs] [issue32532] improve sys.settrace and sys.setprofile
 documentation
In-Reply-To: <1515651956.68.0.467229070634.issue32532@psf.upfronthosting.co.za>
Message-ID: <1517065537.46.0.714561066657.issue32532@psf.upfronthosting.co.za>


Change by Xiang Zhang <angwerzx at 126.com>:


----------
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32532>
_______________________________________

From report at bugs.python.org  Sat Jan 27 10:09:52 2018
From: report at bugs.python.org (ppperry)
Date: Sat, 27 Jan 2018 15:09:52 +0000
Subject: [docs] [issue32621] Problem of consistency in collection.abc
 documentation
In-Reply-To: <1516631316.64.0.467229070634.issue32621@psf.upfronthosting.co.za>
Message-ID: <1517065792.73.0.714561066657.issue32621@psf.upfronthosting.co.za>


Change by ppperry <mapreader at olum.org>:


----------
title: Problem of consistence in collection.abc documentation -> Problem of consistency in collection.abc documentation

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32621>
_______________________________________

From report at bugs.python.org  Sat Jan 27 10:39:23 2018
From: report at bugs.python.org (Xiang Zhang)
Date: Sat, 27 Jan 2018 15:39:23 +0000
Subject: [docs] [issue32649] complete C API doc debug and profile part with
 new PyTrace_OPCODE
In-Reply-To: <1516798950.57.0.467229070634.issue32649@psf.upfronthosting.co.za>
Message-ID: <1517067563.29.0.714561066657.issue32649@psf.upfronthosting.co.za>


Change by Xiang Zhang <angwerzx at 126.com>:


----------
keywords: +patch
pull_requests: +5205
stage:  -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32649>
_______________________________________

From report at bugs.python.org  Sat Jan 27 10:58:19 2018
From: report at bugs.python.org (Xiang Zhang)
Date: Sat, 27 Jan 2018 15:58:19 +0000
Subject: [docs] [issue32687] wrong meaning of arg in Py_tracefunc doc
Message-ID: <1517068699.74.0.467229070634.issue32687@psf.upfronthosting.co.za>


New submission from Xiang Zhang <angwerzx at 126.com>:

The meaning of arg for PyTrace_Line and PyTrace_CALL is wrong, it is not always NULL but always Py_None.

----------
assignee: docs at python
components: Documentation
messages: 310865
nosy: docs at python, xiang.zhang
priority: normal
severity: normal
status: open
title: wrong meaning of arg in Py_tracefunc doc
versions: Python 2.7, Python 3.6, Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32687>
_______________________________________

From report at bugs.python.org  Sat Jan 27 11:29:45 2018
From: report at bugs.python.org (Xiang Zhang)
Date: Sat, 27 Jan 2018 16:29:45 +0000
Subject: [docs] [issue32687] wrong meaning of arg in Py_tracefunc doc
In-Reply-To: <1517068699.74.0.467229070634.issue32687@psf.upfronthosting.co.za>
Message-ID: <1517070585.4.0.714561066657.issue32687@psf.upfronthosting.co.za>


Change by Xiang Zhang <angwerzx at 126.com>:


----------
keywords: +patch
pull_requests: +5206
stage:  -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32687>
_______________________________________

From report at bugs.python.org  Sat Jan 27 13:51:38 2018
From: report at bugs.python.org (Brett Cannon)
Date: Sat, 27 Jan 2018 18:51:38 +0000
Subject: [docs] [issue32666] Valgrind documentation seems to need updating
In-Reply-To: <1516886985.24.0.467229070634.issue32666@psf.upfronthosting.co.za>
Message-ID: <1517079098.31.0.467229070634.issue32666@psf.upfronthosting.co.za>


Brett Cannon <brett at python.org> added the comment:

I don't think there is anyone specific who maintains it. Just whomever wants to use it next and needs to fix it to make it work.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32666>
_______________________________________

From report at bugs.python.org  Sat Jan 27 22:31:24 2018
From: report at bugs.python.org (Roundup Robot)
Date: Sun, 28 Jan 2018 03:31:24 +0000
Subject: [docs] [issue32664] Connector "|" missing between ImportError and
 LookupError
In-Reply-To: <1516870450.69.0.467229070634.issue32664@psf.upfronthosting.co.za>
Message-ID: <1517110284.81.0.714561066657.issue32664@psf.upfronthosting.co.za>


Change by Roundup Robot <devnull at psf.upfronthosting.co.za>:


----------
keywords: +patch
pull_requests: +5214
stage: backport needed -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32664>
_______________________________________

From report at bugs.python.org  Sat Jan 27 22:32:32 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sun, 28 Jan 2018 03:32:32 +0000
Subject: [docs] [issue32664] Connector "|" missing between ImportError and
 LookupError
In-Reply-To: <1516870450.69.0.467229070634.issue32664@psf.upfronthosting.co.za>
Message-ID: <1517110352.69.0.467229070634.issue32664@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:

I will backport the change to 3.6.

----------
assignee: docs at python -> Mariatta
nosy: +Mariatta

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32664>
_______________________________________

From report at bugs.python.org  Sat Jan 27 22:52:54 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sun, 28 Jan 2018 03:52:54 +0000
Subject: [docs] [issue32664] Connector "|" missing between ImportError and
 LookupError
In-Reply-To: <1516870450.69.0.467229070634.issue32664@psf.upfronthosting.co.za>
Message-ID: <1517111574.92.0.467229070634.issue32664@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:


New changeset d331515847f0a053b929e5a4795715cb111f42b3 by Mariatta (Miss Islington (bot)) in branch '3.6':
[3.6] bpo-32664: Add missing "|" connector in Exceptions doc (GH-1173) (GH-5372)
https://github.com/python/cpython/commit/d331515847f0a053b929e5a4795715cb111f42b3


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32664>
_______________________________________

From report at bugs.python.org  Sat Jan 27 22:56:14 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sun, 28 Jan 2018 03:56:14 +0000
Subject: [docs] [issue32664] Connector "|" missing between ImportError and
 LookupError
In-Reply-To: <1516870450.69.0.467229070634.issue32664@psf.upfronthosting.co.za>
Message-ID: <1517111774.65.0.467229070634.issue32664@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:

Thanks!

----------
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32664>
_______________________________________

From report at bugs.python.org  Sun Jan 28 02:38:23 2018
From: report at bugs.python.org (Xiang Zhang)
Date: Sun, 28 Jan 2018 07:38:23 +0000
Subject: [docs] [issue32687] wrong meaning of arg in Py_tracefunc doc
In-Reply-To: <1517068699.74.0.467229070634.issue32687@psf.upfronthosting.co.za>
Message-ID: <1517125103.38.0.467229070634.issue32687@psf.upfronthosting.co.za>


Xiang Zhang <angwerzx at 126.com> added the comment:


New changeset 9ed0aee27c249dada410a22fff4325a4a61df36d by Xiang Zhang in branch 'master':
bpo-32687: Fix wrong meaning of args for PyTrace_LINE/CALL in documentation (#5361)
https://github.com/python/cpython/commit/9ed0aee27c249dada410a22fff4325a4a61df36d


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32687>
_______________________________________

From report at bugs.python.org  Sun Jan 28 02:38:29 2018
From: report at bugs.python.org (miss-islington)
Date: Sun, 28 Jan 2018 07:38:29 +0000
Subject: [docs] [issue32687] wrong meaning of arg in Py_tracefunc doc
In-Reply-To: <1517068699.74.0.467229070634.issue32687@psf.upfronthosting.co.za>
Message-ID: <1517125109.39.0.714561066657.issue32687@psf.upfronthosting.co.za>


Change by miss-islington <mariatta.wijaya+miss-islington at gmail.com>:


----------
pull_requests: +5218

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32687>
_______________________________________

From report at bugs.python.org  Sun Jan 28 02:39:30 2018
From: report at bugs.python.org (miss-islington)
Date: Sun, 28 Jan 2018 07:39:30 +0000
Subject: [docs] [issue32687] wrong meaning of arg in Py_tracefunc doc
In-Reply-To: <1517068699.74.0.467229070634.issue32687@psf.upfronthosting.co.za>
Message-ID: <1517125170.28.0.714561066657.issue32687@psf.upfronthosting.co.za>


Change by miss-islington <mariatta.wijaya+miss-islington at gmail.com>:


----------
pull_requests: +5219

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32687>
_______________________________________

From report at bugs.python.org  Sun Jan 28 03:41:10 2018
From: report at bugs.python.org (Xiang Zhang)
Date: Sun, 28 Jan 2018 08:41:10 +0000
Subject: [docs] [issue32687] wrong meaning of arg in Py_tracefunc doc
In-Reply-To: <1517068699.74.0.467229070634.issue32687@psf.upfronthosting.co.za>
Message-ID: <1517128870.28.0.467229070634.issue32687@psf.upfronthosting.co.za>


Xiang Zhang <angwerzx at 126.com> added the comment:


New changeset 854f0424de389f023b375dfd0b50c34dea29e8f8 by Xiang Zhang (Miss Islington (bot)) in branch '3.6':
bpo-32687: Fix wrong meaning of args for PyTrace_LINE/CALL in documentation (GH-5361) (GH-5377)
https://github.com/python/cpython/commit/854f0424de389f023b375dfd0b50c34dea29e8f8


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32687>
_______________________________________

From report at bugs.python.org  Sun Jan 28 03:41:31 2018
From: report at bugs.python.org (Xiang Zhang)
Date: Sun, 28 Jan 2018 08:41:31 +0000
Subject: [docs] [issue32687] wrong meaning of arg in Py_tracefunc doc
In-Reply-To: <1517068699.74.0.467229070634.issue32687@psf.upfronthosting.co.za>
Message-ID: <1517128891.62.0.467229070634.issue32687@psf.upfronthosting.co.za>


Xiang Zhang <angwerzx at 126.com> added the comment:


New changeset 745e9de7dd9d237d54e92d6e4b469e916fb0352b by Xiang Zhang (Miss Islington (bot)) in branch '2.7':
bpo-32687: Fix wrong meaning of args for PyTrace_LINE/CALL in documentation (GH-5361) (GH-5378)
https://github.com/python/cpython/commit/745e9de7dd9d237d54e92d6e4b469e916fb0352b


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32687>
_______________________________________

From report at bugs.python.org  Sun Jan 28 03:43:19 2018
From: report at bugs.python.org (Xiang Zhang)
Date: Sun, 28 Jan 2018 08:43:19 +0000
Subject: [docs] [issue32687] wrong meaning of arg in Py_tracefunc doc
In-Reply-To: <1517068699.74.0.467229070634.issue32687@psf.upfronthosting.co.za>
Message-ID: <1517128999.86.0.714561066657.issue32687@psf.upfronthosting.co.za>


Change by Xiang Zhang <angwerzx at 126.com>:


----------
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32687>
_______________________________________

From report at bugs.python.org  Sun Jan 28 04:53:46 2018
From: report at bugs.python.org (Nick Coghlan)
Date: Sun, 28 Jan 2018 09:53:46 +0000
Subject: [docs] [issue32649] complete C API doc debug and profile part with
 new PyTrace_OPCODE
In-Reply-To: <1516798950.57.0.467229070634.issue32649@psf.upfronthosting.co.za>
Message-ID: <1517133226.68.0.467229070634.issue32649@psf.upfronthosting.co.za>


Nick Coghlan <ncoghlan at gmail.com> added the comment:


New changeset 255f7a26da47ca6b7bd1d375b8a04920f68c119c by Nick Coghlan (Xiang Zhang) in branch 'master':
bpo-32649: Add C API docs for per-opcode tracing & profiling (GH-5360)
https://github.com/python/cpython/commit/255f7a26da47ca6b7bd1d375b8a04920f68c119c


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32649>
_______________________________________

From report at bugs.python.org  Sun Jan 28 04:54:19 2018
From: report at bugs.python.org (Nick Coghlan)
Date: Sun, 28 Jan 2018 09:54:19 +0000
Subject: [docs] [issue32649] complete C API doc debug and profile part with
 new PyTrace_OPCODE
In-Reply-To: <1516798950.57.0.467229070634.issue32649@psf.upfronthosting.co.za>
Message-ID: <1517133259.67.0.467229070634.issue32649@psf.upfronthosting.co.za>


Nick Coghlan <ncoghlan at gmail.com> added the comment:

Merged, thanks!

----------
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed
type:  -> enhancement

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32649>
_______________________________________

From report at bugs.python.org  Sun Jan 28 13:22:17 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Sun, 28 Jan 2018 18:22:17 +0000
Subject: [docs] [issue32621] Problem of consistency in collection.abc
 documentation
In-Reply-To: <1516631316.64.0.467229070634.issue32621@psf.upfronthosting.co.za>
Message-ID: <1517163737.05.0.714561066657.issue32621@psf.upfronthosting.co.za>


Change by Raymond Hettinger <raymond.hettinger at gmail.com>:


----------
assignee: docs at python -> rhettinger

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32621>
_______________________________________

From report at bugs.python.org  Sun Jan 28 18:34:50 2018
From: report at bugs.python.org (Julien Palard)
Date: Sun, 28 Jan 2018 23:34:50 +0000
Subject: [docs] [issue32701] Typo in quopri documentation
Message-ID: <1517182490.19.0.467229070634.issue32701@psf.upfronthosting.co.za>


New submission from Julien Palard <julien+python at palard.fr>:

Spotted a typo in https://docs.python.org/3/library/quopri.html: "must be provideda"

But I also can't extract the meaning of the sentence:

> quotetabs, a flag which controls whether to encode embedded spaces and tabs must be provideda and when true it encodes such embedded whitespace, and when false it leaves them unencoded.

So here's the diff from 99597c4d12e358174275945d97e504c0318a3783:

+ *quotetabs*, a flag which controls whether to encode embedded spaces and tabs must be provideda and when true it encodes such embedded whitespace, and when false it leaves them unencoded.
- *quotetabs* is a flag which controls whether to encode embedded spaces and tabs; when true it encodes such embedded whitespace, and when false it leaves them unencoded.

So the "must be provided" has been added, I propose:

*quotetabs*, a non-optional flag which controls whether to encode embedded spaces and tabs; when true it encodes such embedded whitespace, and when false it leaves them unencoded.

----------
assignee: docs at python
components: Documentation
messages: 311033
nosy: docs at python, mdk, orsenthil
priority: low
severity: normal
status: open
title: Typo in quopri documentation
versions: Python 3.6, Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32701>
_______________________________________

From report at bugs.python.org  Sun Jan 28 18:47:34 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sun, 28 Jan 2018 23:47:34 +0000
Subject: [docs] [issue32701] Typo in quopri documentation
In-Reply-To: <1517182490.19.0.467229070634.issue32701@psf.upfronthosting.co.za>
Message-ID: <1517183254.49.0.467229070634.issue32701@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:

Thanks! I like your proposed change.

Please create the PR.

----------
nosy: +Mariatta

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32701>
_______________________________________

From report at bugs.python.org  Sun Jan 28 18:52:04 2018
From: report at bugs.python.org (Julien Palard)
Date: Sun, 28 Jan 2018 23:52:04 +0000
Subject: [docs] [issue32701] Typo in quopri documentation
In-Reply-To: <1517182490.19.0.467229070634.issue32701@psf.upfronthosting.co.za>
Message-ID: <1517183524.47.0.714561066657.issue32701@psf.upfronthosting.co.za>


Change by Julien Palard <julien+python at palard.fr>:


----------
keywords: +patch
pull_requests: +5235
stage:  -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32701>
_______________________________________

From report at bugs.python.org  Sun Jan 28 22:22:16 2018
From: report at bugs.python.org (Steve Dower)
Date: Mon, 29 Jan 2018 03:22:16 +0000
Subject: [docs] [issue32699] pythonXY._pth : unclear how .pth files are
 handled
In-Reply-To: <1517165510.64.0.467229070634.issue32699@psf.upfronthosting.co.za>
Message-ID: <1517196136.66.0.467229070634.issue32699@psf.upfronthosting.co.za>


Steve Dower <steve.dower at python.org> added the comment:

Hopefully that's enough of a clarification.

----------
assignee:  -> docs at python
components: +Documentation
nosy: +docs at python
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed
type:  -> enhancement
versions: +Python 3.7, Python 3.8

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32699>
_______________________________________

From report at bugs.python.org  Sun Jan 28 22:44:32 2018
From: report at bugs.python.org (KINEBUCHI Tomohiko)
Date: Mon, 29 Jan 2018 03:44:32 +0000
Subject: [docs] [issue32702] Minor markup typo
Message-ID: <1517197472.5.0.467229070634.issue32702@psf.upfronthosting.co.za>


New submission from KINEBUCHI Tomohiko <cocoatomo77 at gmail.com>:

In the staticmethod document [1], code snippet should be a literal block, but actually be a block quote.
See the attached image file.

[1] https://docs.python.org/3.6/library/functions.html#staticmethod

----------
assignee: docs at python
components: Documentation
files: Screen Shot 2018-01-29 at 12.37.37.png
messages: 311048
nosy: cocoatomo, docs at python
priority: normal
severity: normal
status: open
title: Minor markup typo
versions: Python 3.6, Python 3.7, Python 3.8
Added file: https://bugs.python.org/file47415/Screen Shot 2018-01-29 at 12.37.37.png

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32702>
_______________________________________

From report at bugs.python.org  Sun Jan 28 22:52:40 2018
From: report at bugs.python.org (KINEBUCHI Tomohiko)
Date: Mon, 29 Jan 2018 03:52:40 +0000
Subject: [docs] [issue32702] Minor markup typo
In-Reply-To: <1517197472.5.0.467229070634.issue32702@psf.upfronthosting.co.za>
Message-ID: <1517197960.53.0.714561066657.issue32702@psf.upfronthosting.co.za>


Change by KINEBUCHI Tomohiko <cocoatomo77 at gmail.com>:


----------
keywords: +patch
pull_requests: +5240
stage:  -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32702>
_______________________________________

From report at bugs.python.org  Mon Jan 29 03:17:38 2018
From: report at bugs.python.org (Thomas Kluyver)
Date: Mon, 29 Jan 2018 08:17:38 +0000
Subject: [docs] [issue32699] pythonXY._pth : unclear how .pth files are
 handled
In-Reply-To: <1517165510.64.0.467229070634.issue32699@psf.upfronthosting.co.za>
Message-ID: <1517213858.12.0.467229070634.issue32699@psf.upfronthosting.co.za>


Thomas Kluyver <thomas at kluyver.me.uk> added the comment:

Thanks Steve, that looks good.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32699>
_______________________________________

From report at bugs.python.org  Mon Jan 29 03:34:17 2018
From: report at bugs.python.org (miss-islington)
Date: Mon, 29 Jan 2018 08:34:17 +0000
Subject: [docs] [issue32702] Minor markup typo
In-Reply-To: <1517197472.5.0.467229070634.issue32702@psf.upfronthosting.co.za>
Message-ID: <1517214857.56.0.714561066657.issue32702@psf.upfronthosting.co.za>


Change by miss-islington <mariatta.wijaya+miss-islington at gmail.com>:


----------
pull_requests: +5250

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32702>
_______________________________________

From report at bugs.python.org  Mon Jan 29 04:25:03 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Mon, 29 Jan 2018 09:25:03 +0000
Subject: [docs] [issue32702] Minor markup typo
In-Reply-To: <1517197472.5.0.467229070634.issue32702@psf.upfronthosting.co.za>
Message-ID: <1517217903.5.0.467229070634.issue32702@psf.upfronthosting.co.za>


Raymond Hettinger <raymond.hettinger at gmail.com> added the comment:

Thanks for the patch.

----------
nosy: +rhettinger
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32702>
_______________________________________

From mark.luther0987 at protonmail.com  Mon Jan 29 05:52:19 2018
From: mark.luther0987 at protonmail.com (Mark.luther0987)
Date: Mon, 29 Jan 2018 05:52:19 -0500
Subject: [docs] Issues while using CallerLookup Package
Message-ID: <dhOjb4i1TEZiWxtcgvtEzUdYQ1c1B1HUgSsgHB68jExAYKTEp23TklFXfEvlErUeRoIN1BM_rPeTeUAwYXhXsOGmgwNvMta4sb0Vz0LcUbQ=@protonmail.com>

I accessed the CallerLookup package from below link
https://pypi.python.org/pypi/CallerLookup

and faced the following issue-
>>>
RESTART: C:\Users\hp\Desktop\CallerLookup-1.2.94\CallerLookup-1.2.94\CallerLookup\Main.py

Traceback (most recent call last):
  File "C:\Users\hp\Desktop\CallerLookup-1.2.94\CallerLookup-1.2.94\CallerLookup\Main.py", line 6, in <module>
    from CallerLookup.Responses import *
  File "C:\Python27\lib\site-packages\CallerLookup\__init__.py", line 6, in <module>
    from CallerLookup.Main import lookup_number
  File "C:\Python27\lib\site-packages\CallerLookup\Main.py", line 6, in <module>
    from CallerLookup.Responses import *
  File "C:\Python27\lib\site-packages\CallerLookup\Responses.py", line 7, in <module>
    from CallerLookup.Utils.Logs import format_exception
ImportError: No module named Utils.Logs

I tried on python 2.7.14. Please help to resolve this issue.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20180129/c01be7b5/attachment-0001.html>

From rosuav at gmail.com  Mon Jan 29 06:37:36 2018
From: rosuav at gmail.com (Chris Angelico)
Date: Mon, 29 Jan 2018 22:37:36 +1100
Subject: [docs] Issues while using CallerLookup Package
In-Reply-To: <dhOjb4i1TEZiWxtcgvtEzUdYQ1c1B1HUgSsgHB68jExAYKTEp23TklFXfEvlErUeRoIN1BM_rPeTeUAwYXhXsOGmgwNvMta4sb0Vz0LcUbQ=@protonmail.com>
References: <dhOjb4i1TEZiWxtcgvtEzUdYQ1c1B1HUgSsgHB68jExAYKTEp23TklFXfEvlErUeRoIN1BM_rPeTeUAwYXhXsOGmgwNvMta4sb0Vz0LcUbQ=@protonmail.com>
Message-ID: <CAPTjJmrbyvFdM1tudLw9FwanrOfzUYMqket2Zwus5uj_ggRNgw@mail.gmail.com>

On Mon, Jan 29, 2018 at 9:52 PM, Mark.luther0987 via Python-list
<python-list at python.org> wrote:
> I accessed the CallerLookup package from below link
> https://pypi.python.org/pypi/CallerLookup
>
> and faced the following issue-
>>>>
> RESTART: C:\Users\hp\Desktop\CallerLookup-1.2.94\CallerLookup-1.2.94\CallerLookup\Main.py
>
> Traceback (most recent call last):
>   File "C:\Users\hp\Desktop\CallerLookup-1.2.94\CallerLookup-1.2.94\CallerLookup\Main.py", line 6, in <module>
>     from CallerLookup.Responses import *
>   File "C:\Python27\lib\site-packages\CallerLookup\__init__.py", line 6, in <module>
>     from CallerLookup.Main import lookup_number
>   File "C:\Python27\lib\site-packages\CallerLookup\Main.py", line 6, in <module>
>     from CallerLookup.Responses import *
>   File "C:\Python27\lib\site-packages\CallerLookup\Responses.py", line 7, in <module>
>     from CallerLookup.Utils.Logs import format_exception
> ImportError: No module named Utils.Logs
>
> I tried on python 2.7.14. Please help to resolve this issue.

Did you follow the installation and usage instructions in the PyPI landing page?

ChrisA

From report at bugs.python.org  Mon Jan 29 07:40:46 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Mon, 29 Jan 2018 12:40:46 +0000
Subject: [docs] [issue32709] the iterable for itertools.groupby must be
 sorted
Message-ID: <1517229646.32.0.467229070634.issue32709@psf.upfronthosting.co.za>


New submission from St?phane Wirtel <stephane at wirtel.be>:

The documentation of itertools.groupby indicates that generally, the iterable needs to be sorted. In fact, this iterable MUST be sorted.

----------
assignee: docs at python
components: Documentation
messages: 311115
nosy: docs at python, matrixise
priority: normal
severity: normal
status: open
title: the iterable for itertools.groupby must be sorted
versions: Python 3.6, Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32709>
_______________________________________

From report at bugs.python.org  Mon Jan 29 07:42:54 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Mon, 29 Jan 2018 12:42:54 +0000
Subject: [docs] [issue32709] the iterable for itertools.groupby must be
 sorted
In-Reply-To: <1517229646.32.0.467229070634.issue32709@psf.upfronthosting.co.za>
Message-ID: <1517229774.35.0.714561066657.issue32709@psf.upfronthosting.co.za>


Change by St?phane Wirtel <stephane at wirtel.be>:


----------
keywords: +patch
pull_requests: +5259
stage:  -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32709>
_______________________________________

From report at bugs.python.org  Mon Jan 29 07:49:59 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Mon, 29 Jan 2018 12:49:59 +0000
Subject: [docs] [issue32709] the iterable for itertools.groupby must be
 sorted
In-Reply-To: <1517229646.32.0.467229070634.issue32709@psf.upfronthosting.co.za>
Message-ID: <1517230199.4.0.467229070634.issue32709@psf.upfronthosting.co.za>


Cheryl Sabella <chekat2 at gmail.com> added the comment:

It depends upon your use case.

In general, if you want it to work like SQL group by, then yes, it needs to be sorted, and I believe the documentation already covers that.  However, there are scenarios where you want to condense a string, but keep the ordering, such as:

'aaaaabbbbbbccccaaaaddd' into '5a6b4c4a3d'

and itertools.groupby works very nicely for that.

----------
nosy: +csabella

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32709>
_______________________________________

From report at bugs.python.org  Mon Jan 29 07:53:37 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Mon, 29 Jan 2018 12:53:37 +0000
Subject: [docs] [issue32709] the iterable for itertools.groupby must be
 sorted
In-Reply-To: <1517229646.32.0.467229070634.issue32709@psf.upfronthosting.co.za>
Message-ID: <1517230417.45.0.467229070634.issue32709@psf.upfronthosting.co.za>


St?phane Wirtel <stephane at wirtel.be> added the comment:

good catch, I only use itertools.groupby when I work for a collection.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32709>
_______________________________________

From report at bugs.python.org  Mon Jan 29 07:54:45 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Mon, 29 Jan 2018 12:54:45 +0000
Subject: [docs] [issue32709] the iterable for itertools.groupby must be
 sorted
In-Reply-To: <1517229646.32.0.467229070634.issue32709@psf.upfronthosting.co.za>
Message-ID: <1517230485.05.0.467229070634.issue32709@psf.upfronthosting.co.za>


St?phane Wirtel <stephane at wirtel.be> added the comment:

I am going to close my issue because with your use case, this issue makes no sense.

----------
stage: patch review -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32709>
_______________________________________

From bizhanalipour120 at gmail.com  Mon Jan 29 07:50:05 2018
From: bizhanalipour120 at gmail.com (bizhan alipour)
Date: Mon, 29 Jan 2018 13:50:05 +0100
Subject: [docs] Python Errors
Message-ID: <CAKzLXnnCYXrtGTvUqvjmu91_48e8P=7kVEN=6XiuwXA68L2yAQ@mail.gmail.com>

Dear, I keep receiving same error when I run the written script on the
socket page
so I was thinking to share it here maybe you can solve my problem and also
add a notification on the page for those who will get in touch.


 s = socket.socket(socket.AF_INET, socket.SOCK_RAW, socket.IPPROTO_IP)

Here you can see the error

socket.error: [Errno 93] Protocol not supported

I have searched so many websites but no result
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20180129/34235a4e/attachment-0001.html>

From report at bugs.python.org  Mon Jan 29 19:28:19 2018
From: report at bugs.python.org (cowlinator)
Date: Tue, 30 Jan 2018 00:28:19 +0000
Subject: [docs] [issue22374] Replace contextmanager example and improve
 explanation
In-Reply-To: <1410296292.35.0.34327651623.issue22374@psf.upfronthosting.co.za>
Message-ID: <1517272099.56.0.467229070634.issue22374@psf.upfronthosting.co.za>


cowlinator <cowlinator at gmail.com> added the comment:

I would like to second the improved explanation of contextlib.contextmanager, and additionally point out another problem:  
A very important piece of information is missing from the documentation:  how to return data from the contextmanager-wrapped function.  

I had to go look up the source code, which had a wonderful explanation in the comments: https://gist.github.com/enuomi/1385336#file-contextlib-py-L56 

In particular, note that 

@contextmanager
def some_generator(<arguments>):
  yield <return_data>

can be used to return <return_data> to the caller, via

with some_generator(<arguments>) as <return_data>:
  print(return_data)

This information is wholly and completely missing from the contextlib.contextmanager documentation.

----------
nosy: +cowlinator
versions: +Python 2.7, Python 3.4, Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue22374>
_______________________________________

From report at bugs.python.org  Mon Jan 29 22:36:09 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 30 Jan 2018 03:36:09 +0000
Subject: [docs] [issue32701] Typo in quopri documentation
In-Reply-To: <1517182490.19.0.467229070634.issue32701@psf.upfronthosting.co.za>
Message-ID: <1517283369.63.0.467229070634.issue32701@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:


New changeset 9424dcbb3e20a26dfdd81659303b989f7d3da044 by Mariatta (Julien Palard) in branch 'master':
bpo-32701: Clarify the quotetabs flag in quopri documentation (GH-5401)
https://github.com/python/cpython/commit/9424dcbb3e20a26dfdd81659303b989f7d3da044


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32701>
_______________________________________

From report at bugs.python.org  Mon Jan 29 22:36:19 2018
From: report at bugs.python.org (miss-islington)
Date: Tue, 30 Jan 2018 03:36:19 +0000
Subject: [docs] [issue32701] Typo in quopri documentation
In-Reply-To: <1517182490.19.0.467229070634.issue32701@psf.upfronthosting.co.za>
Message-ID: <1517283379.59.0.714561066657.issue32701@psf.upfronthosting.co.za>


Change by miss-islington <mariatta.wijaya+miss-islington at gmail.com>:


----------
pull_requests: +5271

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32701>
_______________________________________

From report at bugs.python.org  Mon Jan 29 23:16:23 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 30 Jan 2018 04:16:23 +0000
Subject: [docs] [issue32701] Typo in quopri documentation
In-Reply-To: <1517182490.19.0.467229070634.issue32701@psf.upfronthosting.co.za>
Message-ID: <1517285783.45.0.467229070634.issue32701@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:


New changeset 04f99ba9d7186278eaf072e9a62c03aa63a8a6bb by Mariatta (Miss Islington (bot)) in branch '3.6':
bpo-32701: Clarify the quotetabs flag in quopri documentation (GH-5401) (GH-5438)
https://github.com/python/cpython/commit/04f99ba9d7186278eaf072e9a62c03aa63a8a6bb


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32701>
_______________________________________

From report at bugs.python.org  Mon Jan 29 23:23:14 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 30 Jan 2018 04:23:14 +0000
Subject: [docs] [issue32701] Typo in quopri documentation
In-Reply-To: <1517182490.19.0.467229070634.issue32701@psf.upfronthosting.co.za>
Message-ID: <1517286194.52.0.467229070634.issue32701@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:

Thanks!

----------
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32701>
_______________________________________

From report at bugs.python.org  Mon Jan 29 23:45:29 2018
From: report at bugs.python.org (Nick Coghlan)
Date: Tue, 30 Jan 2018 04:45:29 +0000
Subject: [docs] [issue32720] Format mini-language integer definition is
 incorrect
Message-ID: <1517287529.39.0.467229070634.issue32720@psf.upfronthosting.co.za>


New submission from Nick Coghlan <ncoghlan at gmail.com>:

I just noticed that https://docs.python.org/3/library/string.html#formatspec links to the "integer" definition in the main Python grammar for the permitted format of numeric fields.

This isn't accurate:

```
>>> format(10e4, ",.2f")
'100,000.00'
>>> format(10e4, ",.0x2f")
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
ValueError: Invalid format specifier
>>> format(10e4, ",.2_2f")
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
ValueError: Invalid format specifier
```

Instead, the `width` and `precision` subfields should be defined as "digit+"

----------
assignee: docs at python
components: Documentation
messages: 311229
nosy: docs at python, ncoghlan
priority: normal
severity: normal
stage: needs patch
status: open
title: Format mini-language integer definition is incorrect
type: behavior
versions: Python 3.6, Python 3.7, Python 3.8

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32720>
_______________________________________

From report at bugs.python.org  Tue Jan 30 00:41:01 2018
From: report at bugs.python.org (Soothsayer)
Date: Tue, 30 Jan 2018 05:41:01 +0000
Subject: [docs] [issue32722] Classes
Message-ID: <1517290861.72.0.467229070634.issue32722@psf.upfronthosting.co.za>


New submission from Soothsayer <qd57h9m4q2 at snkmail.com>:

In the Python tutorial, in "9. Classes", in "9.10 Generator expression", a list of sample generator expressions used as arguments to functions is given. However, one of the examples isn't a generator expression, it's a set comprehension.

sine_table = {x: sin(x*pi/180) for x in range(0, 91)}

Perhaps this used to be a call to set() and was mistakenly converted?

----------
assignee: docs at python
components: Documentation
messages: 311235
nosy: Soothsayer, docs at python
priority: normal
severity: normal
status: open
title: Classes
type: enhancement
versions: Python 3.7, Python 3.8

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32722>
_______________________________________

From report at bugs.python.org  Tue Jan 30 00:41:46 2018
From: report at bugs.python.org (Soothsayer)
Date: Tue, 30 Jan 2018 05:41:46 +0000
Subject: [docs] [issue32722] Classes
In-Reply-To: <1517290861.72.0.467229070634.issue32722@psf.upfronthosting.co.za>
Message-ID: <1517290906.45.0.714561066657.issue32722@psf.upfronthosting.co.za>


Change by Soothsayer <qd57h9m4q2 at snkmail.com>:


----------
versions: +Python 3.5, Python 3.6 -Python 3.7, Python 3.8

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32722>
_______________________________________

From report at bugs.python.org  Tue Jan 30 00:44:19 2018
From: report at bugs.python.org (Soothsayer)
Date: Tue, 30 Jan 2018 05:44:19 +0000
Subject: [docs] [issue32722] Classes
In-Reply-To: <1517290861.72.0.467229070634.issue32722@psf.upfronthosting.co.za>
Message-ID: <1517291059.28.0.467229070634.issue32722@psf.upfronthosting.co.za>


Soothsayer <qd57h9m4q2 at snkmail.com> added the comment:

Correction: it's a dictionary comprehension, and it did indeed used to be a call to dict() in the 2.7 documentation.

----------
versions: +Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32722>
_______________________________________

From report at bugs.python.org  Tue Jan 30 02:59:33 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Tue, 30 Jan 2018 07:59:33 +0000
Subject: [docs] [issue32724] Fix references to commands in Doc/pdb.rst
Message-ID: <1517299173.52.0.467229070634.issue32724@psf.upfronthosting.co.za>


New submission from St?phane Wirtel <stephane at wirtel.be>:

In the documentation of pdb.rst, we explain that we have to use some commands, but there is no link to these commands.

----------
assignee: docs at python
components: Documentation
messages: 311253
nosy: Mariatta, docs at python, matrixise
priority: normal
severity: normal
status: open
title: Fix references to commands in Doc/pdb.rst
versions: Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32724>
_______________________________________

From report at bugs.python.org  Tue Jan 30 03:02:37 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Tue, 30 Jan 2018 08:02:37 +0000
Subject: [docs] [issue32724] Fix references to commands in Doc/pdb.rst
In-Reply-To: <1517299173.52.0.467229070634.issue32724@psf.upfronthosting.co.za>
Message-ID: <1517299357.09.0.714561066657.issue32724@psf.upfronthosting.co.za>


Change by St?phane Wirtel <stephane at wirtel.be>:


----------
keywords: +patch
pull_requests: +5276
stage:  -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32724>
_______________________________________

From report at bugs.python.org  Tue Jan 30 04:34:39 2018
From: report at bugs.python.org (Andrew Svetlov)
Date: Tue, 30 Jan 2018 09:34:39 +0000
Subject: [docs] [issue32724] Fix references to commands in Doc/pdb.rst
In-Reply-To: <1517299173.52.0.467229070634.issue32724@psf.upfronthosting.co.za>
Message-ID: <1517304879.73.0.467229070634.issue32724@psf.upfronthosting.co.za>


Andrew Svetlov <andrew.svetlov at gmail.com> added the comment:


New changeset 67adb31a416864f853772c3e74a06caeadc9b6f1 by Andrew Svetlov (St?phane Wirtel) in branch 'master':
bpo-32724: Fix references to commands in Doc/pdb.rst (GH-5444)
https://github.com/python/cpython/commit/67adb31a416864f853772c3e74a06caeadc9b6f1


----------
nosy: +asvetlov

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32724>
_______________________________________

From report at bugs.python.org  Tue Jan 30 04:34:58 2018
From: report at bugs.python.org (Andrew Svetlov)
Date: Tue, 30 Jan 2018 09:34:58 +0000
Subject: [docs] [issue32724] Fix references to commands in Doc/pdb.rst
In-Reply-To: <1517299173.52.0.467229070634.issue32724@psf.upfronthosting.co.za>
Message-ID: <1517304898.95.0.714561066657.issue32724@psf.upfronthosting.co.za>


Change by Andrew Svetlov <andrew.svetlov at gmail.com>:


----------
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32724>
_______________________________________

From report at bugs.python.org  Tue Jan 30 04:35:53 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Tue, 30 Jan 2018 09:35:53 +0000
Subject: [docs] [issue32724] Fix references to commands in Doc/pdb.rst
In-Reply-To: <1517299173.52.0.467229070634.issue32724@psf.upfronthosting.co.za>
Message-ID: <1517304953.8.0.467229070634.issue32724@psf.upfronthosting.co.za>


St?phane Wirtel <stephane at wirtel.be> added the comment:

thanks

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32724>
_______________________________________

From report at bugs.python.org  Tue Jan 30 05:29:51 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Tue, 30 Jan 2018 10:29:51 +0000
Subject: [docs] [issue32722] Classes
In-Reply-To: <1517290861.72.0.467229070634.issue32722@psf.upfronthosting.co.za>
Message-ID: <1517308191.58.0.714561066657.issue32722@psf.upfronthosting.co.za>


Change by St?phane Wirtel <stephane at wirtel.be>:


----------
keywords: +patch
pull_requests: +5278
stage:  -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32722>
_______________________________________

From report at bugs.python.org  Tue Jan 30 05:37:22 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Tue, 30 Jan 2018 10:37:22 +0000
Subject: [docs] [issue32722] Classes
In-Reply-To: <1517290861.72.0.467229070634.issue32722@psf.upfronthosting.co.za>
Message-ID: <1517308642.15.0.467229070634.issue32722@psf.upfronthosting.co.za>


St?phane Wirtel <stephane at wirtel.be> added the comment:

This example is also in 2.7 
https://docs.python.org/2.7/tutorial/classes.html#generator-expressions

-> I add 2.7

----------
nosy: +matrixise
versions: +Python 2.7

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32722>
_______________________________________

From report at bugs.python.org  Tue Jan 30 13:36:27 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Tue, 30 Jan 2018 18:36:27 +0000
Subject: [docs] [issue27428] Document WindowsRegistryFinder inherits from
 MetaPathFinder
In-Reply-To: <1467326072.76.0.431868228595.issue27428@psf.upfronthosting.co.za>
Message-ID: <1517337387.25.0.467229070634.issue27428@psf.upfronthosting.co.za>


Cheryl Sabella <chekat2 at gmail.com> added the comment:

Since WindowsRegistryFinder was deprecated in 3.6, should this be closed or should the documentation still be corrected?

----------
nosy: +csabella
versions: +Python 3.7 -Python 3.5, Python 3.6

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue27428>
_______________________________________

From report at bugs.python.org  Tue Jan 30 14:32:56 2018
From: report at bugs.python.org (Brett Cannon)
Date: Tue, 30 Jan 2018 19:32:56 +0000
Subject: [docs] [issue27428] Document WindowsRegistryFinder inherits from
 MetaPathFinder
In-Reply-To: <1467326072.76.0.431868228595.issue27428@psf.upfronthosting.co.za>
Message-ID: <1517340776.48.0.467229070634.issue27428@psf.upfronthosting.co.za>


Brett Cannon <brett at python.org> added the comment:

Docs should still be correct.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue27428>
_______________________________________

From report at bugs.python.org  Tue Jan 30 15:28:48 2018
From: report at bugs.python.org (Brett Cannon)
Date: Tue, 30 Jan 2018 20:28:48 +0000
Subject: [docs] [issue32722] Mislabeling of a dict comprehension as a
 generator expression in the tutorial
In-Reply-To: <1517290861.72.0.467229070634.issue32722@psf.upfronthosting.co.za>
Message-ID: <1517344128.99.0.714561066657.issue32722@psf.upfronthosting.co.za>


Change by Brett Cannon <brett at python.org>:


----------
title: Classes -> Mislabeling of a dict comprehension as a generator expression in the tutorial

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32722>
_______________________________________

From report at bugs.python.org  Tue Jan 30 18:18:14 2018
From: report at bugs.python.org (Soothsayer)
Date: Tue, 30 Jan 2018 23:18:14 +0000
Subject: [docs] [issue32722] Mislabeling of a dict comprehension as a
 generator expression in the tutorial
In-Reply-To: <1517290861.72.0.467229070634.issue32722@psf.upfronthosting.co.za>
Message-ID: <1517354294.1.0.467229070634.issue32722@psf.upfronthosting.co.za>


Soothsayer <qd57h9m4q2 at snkmail.com> added the comment:

I agree that 2.7 is incorrect also, 2.7 has dict comprehensions also so there's no reason to pass a generator expression to dict().

I add 3.4 and 3.8 because they also have the problem.

----------
versions: +Python 3.4, Python 3.8

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32722>
_______________________________________

From report at bugs.python.org  Wed Jan 31 15:56:00 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Wed, 31 Jan 2018 20:56:00 +0000
Subject: [docs] [issue32735] Typo in f-string example in docs
Message-ID: <1517432160.79.0.467229070634.issue32735@psf.upfronthosting.co.za>


New submission from Cheryl Sabella <chekat2 at gmail.com>:

On the lexical analysis doc page, in f-strings example, the following example isn't quite right:

>>> f"{today:%b %d, %Y}"  # using date format specifier
'January 27, 2017'

Submitting a patch shortly to use %B instead of %b.

----------
assignee: docs at python
components: Documentation
messages: 311371
nosy: csabella, docs at python
priority: normal
severity: normal
status: open
title: Typo in f-string example in docs
type: enhancement
versions: Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32735>
_______________________________________

From report at bugs.python.org  Wed Jan 31 15:57:18 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Wed, 31 Jan 2018 20:57:18 +0000
Subject: [docs] [issue32735] Typo in f-string example in docs
In-Reply-To: <1517432160.79.0.467229070634.issue32735@psf.upfronthosting.co.za>
Message-ID: <1517432238.66.0.714561066657.issue32735@psf.upfronthosting.co.za>


Change by Cheryl Sabella <chekat2 at gmail.com>:


----------
keywords: +patch
pull_requests: +5290
stage:  -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32735>
_______________________________________

From report at bugs.python.org  Wed Jan 31 16:13:38 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Wed, 31 Jan 2018 21:13:38 +0000
Subject: [docs] [issue32735] Typo in f-string example in docs
In-Reply-To: <1517432160.79.0.467229070634.issue32735@psf.upfronthosting.co.za>
Message-ID: <1517433218.71.0.467229070634.issue32735@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:

Good catch!

I checked my presentation slides (where this example comes from).
It appeared that I meant it as %b, so the output should have been `Jan` instead of `January`.

But no strong preference, the idea is to demonstrate how to use the specifier, so %B works too.

----------
nosy: +Mariatta
versions: +Python 3.6

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32735>
_______________________________________

From report at bugs.python.org  Wed Jan 31 16:37:59 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Wed, 31 Jan 2018 21:37:59 +0000
Subject: [docs] [issue32735] Typo in f-string example in docs
In-Reply-To: <1517432160.79.0.467229070634.issue32735@psf.upfronthosting.co.za>
Message-ID: <1517434679.89.0.467229070634.issue32735@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:


New changeset b299393cc372f3ecbef4304f8eaa4c7838e975ca by Mariatta (Cheryl Sabella) in branch 'master':
bpo-32735: Fix typo in f-strings datetime format specifier example (GH-5464)
https://github.com/python/cpython/commit/b299393cc372f3ecbef4304f8eaa4c7838e975ca


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32735>
_______________________________________

From report at bugs.python.org  Wed Jan 31 16:38:02 2018
From: report at bugs.python.org (miss-islington)
Date: Wed, 31 Jan 2018 21:38:02 +0000
Subject: [docs] [issue32735] Typo in f-string example in docs
In-Reply-To: <1517432160.79.0.467229070634.issue32735@psf.upfronthosting.co.za>
Message-ID: <1517434682.44.0.714561066657.issue32735@psf.upfronthosting.co.za>


Change by miss-islington <mariatta.wijaya+miss-islington at gmail.com>:


----------
pull_requests: +5291

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32735>
_______________________________________

From report at bugs.python.org  Wed Jan 31 17:17:10 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Wed, 31 Jan 2018 22:17:10 +0000
Subject: [docs] [issue32735] Typo in f-string example in docs
In-Reply-To: <1517432160.79.0.467229070634.issue32735@psf.upfronthosting.co.za>
Message-ID: <1517437030.82.0.467229070634.issue32735@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:


New changeset 581ce25e1ffa374e62547ef266b6326bee0c54e5 by Mariatta (Miss Islington (bot)) in branch '3.6':
bpo-32735: Fix typo in f-strings datetime format specifier example (GH-5464) (GH-5465)
https://github.com/python/cpython/commit/581ce25e1ffa374e62547ef266b6326bee0c54e5


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32735>
_______________________________________

From report at bugs.python.org  Wed Jan 31 17:20:15 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Wed, 31 Jan 2018 22:20:15 +0000
Subject: [docs] [issue32735] Typo in f-string example in docs
In-Reply-To: <1517432160.79.0.467229070634.issue32735@psf.upfronthosting.co.za>
Message-ID: <1517437215.33.0.714561066657.issue32735@psf.upfronthosting.co.za>


Change by Mariatta Wijaya <mariatta.wijaya at gmail.com>:


----------
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32735>
_______________________________________

From report at bugs.python.org  Wed Jan 31 17:20:21 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Wed, 31 Jan 2018 22:20:21 +0000
Subject: [docs] [issue32735] Typo in f-string example in docs
In-Reply-To: <1517432160.79.0.467229070634.issue32735@psf.upfronthosting.co.za>
Message-ID: <1517437221.36.0.467229070634.issue32735@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:

Thanks!

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32735>
_______________________________________

From report at bugs.python.org  Wed Jan 31 17:29:34 2018
From: report at bugs.python.org (STINNER Victor)
Date: Wed, 31 Jan 2018 22:29:34 +0000
Subject: [docs] [issue32735] Typo in f-string example in docs
In-Reply-To: <1517432160.79.0.467229070634.issue32735@psf.upfronthosting.co.za>
Message-ID: <1517437774.95.0.467229070634.issue32735@psf.upfronthosting.co.za>


STINNER Victor <victor.stinner at gmail.com> added the comment:

@Cheryl: I concur with Mariatta, good catch, thanks!

----------
nosy: +vstinner

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32735>
_______________________________________

From report at bugs.python.org  Wed Jan 31 18:12:39 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Wed, 31 Jan 2018 23:12:39 +0000
Subject: [docs] [issue27428] Document WindowsRegistryFinder inherits from
 MetaPathFinder
In-Reply-To: <1467326072.76.0.431868228595.issue27428@psf.upfronthosting.co.za>
Message-ID: <1517440359.57.0.714561066657.issue27428@psf.upfronthosting.co.za>


Change by Cheryl Sabella <chekat2 at gmail.com>:


----------
keywords: +easy
stage:  -> needs patch
type:  -> enhancement

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue27428>
_______________________________________

From report at bugs.python.org  Wed Jan 31 18:33:10 2018
From: report at bugs.python.org (Ned Deily)
Date: Wed, 31 Jan 2018 23:33:10 +0000
Subject: [docs] [issue32735] Typo in f-string example in docs
In-Reply-To: <1517432160.79.0.467229070634.issue32735@psf.upfronthosting.co.za>
Message-ID: <1517441590.1.0.057773128935.issue32735@psf.upfronthosting.co.za>


Ned Deily <nad at python.org> added the comment:


New changeset 70e304252af34dfde3d89c9a1aa48c0c4af17dd3 by Ned Deily (Cheryl Sabella) in branch '3.7':
bpo-32735: Fix typo in f-strings datetime format specifier example (GH-5464)
https://github.com/python/cpython/commit/70e304252af34dfde3d89c9a1aa48c0c4af17dd3


----------
nosy: +ned.deily

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32735>
_______________________________________

From report at bugs.python.org  Wed Jan 31 19:08:16 2018
From: report at bugs.python.org (D. Michael Parrish)
Date: Thu, 01 Feb 2018 00:08:16 +0000
Subject: [docs] [issue32737] str.format not producing strings for nan
 argument in accordance with documentation
Message-ID: <1517443696.2.0.467229070634.issue32737@psf.upfronthosting.co.za>


New submission from D. Michael Parrish <will.hill.fx at gmail.com>:

>>> version_info
(3, 0, 1, 'final', 0)
# I know this is an older version---stuck with it at work.
# I did not see this issue in the tracker (380 results for nan).
# Perhaps there is better documentation for how to use the issue
# tracker. Many of the links on the Dealing with Bugs page---
# https://docs.python.org/3/bugs.html#contributing-to-python
# ---are not helpful, e.g., 'contribute' just links back the same
# page.
#
# There are similar problems with inf and -inf
>>> isnan(float('nan'))
True
>>> repr(float('nan'))
'nan'
>>> '{0:f}'.format(float('nan'))
'-1.#IND00'
>>> '{0:F}'.format(float('nan'))
'-1.#IND00'
>>> '{0:g}'.format(float('nan'))
'-1.#IND'
>>> '{0:G}'.format(float('nan'))
'-1.#IND'
>>> '{0:.2f}'.format(float('nan'))
'-1.#J'

# c.f. https://docs.python.org/3/library/string.html#formatspec

----------
assignee: docs at python
components: Documentation
messages: 311393
nosy: ana, docs at python
priority: normal
severity: normal
status: open
title: str.format not producing strings for nan argument in accordance with documentation
type: behavior

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32737>
_______________________________________

From report at bugs.python.org  Wed Jan 31 19:13:05 2018
From: report at bugs.python.org (Zachary Ware)
Date: Thu, 01 Feb 2018 00:13:05 +0000
Subject: [docs] [issue32737] str.format not producing strings for nan
 argument in accordance with documentation
In-Reply-To: <1517443696.2.0.467229070634.issue32737@psf.upfronthosting.co.za>
Message-ID: <1517443985.88.0.467229070634.issue32737@psf.upfronthosting.co.za>


Zachary Ware <zachary.ware at gmail.com> added the comment:

I think you need to clarify with whoever is restricting your Python version which version you can actually use: Python 3.0.1 has been out of support for the better part of 10 years now and hardly anybody ever actually used that particular version (aside from me :))

I have confirmed that Python 3.6 (the oldest version which would receive a fix for this at this point) behaves as expected:

In [1]: '{0:f}'.format(float('nan'))
Out[1]: 'nan'

In [2]: '{0:F}'.format(float('nan'))
Out[2]: 'NAN'

In [3]: '{0:g}'.format(float('nan'))
Out[3]: 'nan'

In [4]: '{0:G}'.format(float('nan'))
Out[4]: 'NAN'

In [5]: '{0:.2f}'.format(float('nan'))
Out[5]: 'nan'

----------
nosy: +zach.ware
resolution:  -> out of date
stage:  -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32737>
_______________________________________

From report at bugs.python.org  Wed Jan 31 19:31:52 2018
From: report at bugs.python.org (D. Michael Parrish)
Date: Thu, 01 Feb 2018 00:31:52 +0000
Subject: [docs] [issue32737] str.format not producing strings for nan
 argument in accordance with documentation
In-Reply-To: <1517443696.2.0.467229070634.issue32737@psf.upfronthosting.co.za>
Message-ID: <1517445112.8.0.467229070634.issue32737@psf.upfronthosting.co.za>


D. Michael Parrish <will.hill.fx at gmail.com> added the comment:

Thank you so much for that reply. Maybe with that I can push for an upgrade.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32737>
_______________________________________

From artgoldberg at gmail.com  Wed Jan 31 10:26:04 2018
From: artgoldberg at gmail.com (Arthur Goldberg)
Date: Wed, 31 Jan 2018 10:26:04 -0500
Subject: [docs] unittest documentation
Message-ID: <f01adc64-5a5c-dd94-cc1a-b1b6551f5a2b@gmail.com>

Hello

The first example in the unittest documentation 
(https://docs.python.org/3.4/library/unittest.html and 
https://docs.python.org/2/library/unittest.html) contains the comment:

    # check that s.split fails when the separator is not a string

However, this comment does not correctly describe the code, and reflects 
a common misconception about testing. More accurately, the comment 
should say:

    # check that s.split fails when the separator is an int

Test code to "check that s.split fails when the separator is not a 
string" would need to test every type other than string, which is 
impossible because the set of possible types is infinite.

Thanks

Arthur


-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20180131/a4cf4b16/attachment.html>