Mailman 3 August 2016 - docs

Add documentation for typing.Generator (issue 27689)
by levkivskyi＠gmail.com Aug. 5, 2016

Aug. 5, 2016

http://bugs.python.org/review/27689/diff/18074/Doc/library/typing.rst File Doc/library/typing.rst (right): http://bugs.python.org/review/27689/diff/18074/Doc/library/typing.rst#newco… Doc/library/typing.rst:474: while sent is not None: One more comment: One might be confused why send type is float and not Optional[float], maybe you could add an explanation that one anyway can only send None as a first value, so that Optional is redundant. http://bugs.python.org/review/27689/

1 0

Re: [docs] Expand documentation about Any in the typing module (issue 27688)
by stephane＠wirtel.be Aug. 5, 2016

Aug. 5, 2016

it's ok for me, but I am not an expert with the type hinting of 3.5. http://bugs.python.org/review/27688/

1 0

[issue20004] csv.DictReader classic class has a property with setter
by Mathieu Dupuy Aug. 5, 2016

Aug. 5, 2016

Mathieu Dupuy added the comment: The comment is still present in python 3 sources at the moment. Shouldn't we remove it in python 3 ? ---------- nosy: +deronnax _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue20004> _______________________________________

1 0

[issue26462] Patch to enhance literal block language declaration
by Julien Aug. 5, 2016

Aug. 5, 2016

New submission from Julien: Hi, As I don't like warnings, and sphinx-doc was verbose about "Could not parse literal_block as "python3". highlighting skipped.", I fixed most of them. Bonus: It's graphically better, as an example the XML block here: https://docs.python.org/3.5/library/pyexpat.html is now nicely colored: http://www.afpy.org/doc/python/3.5/library/pyexpat.html ---------- assignee: docs@python components: Documentation files: literal_blocks_languages.patch keywords: patch messages: 261035 nosy: docs@python, sizeof priority: normal severity: normal status: open title: Patch to enhance literal block language declaration type: enhancement versions: Python 3.5 Added file: http://bugs.python.org/file42050/literal_blocks_languages.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue26462> _______________________________________

8 34

Re: [docs] Expand documentation about Any in the typing module (issue 27688)
by levkivskyi＠gmail.com Aug. 5, 2016

Aug. 5, 2016

Two minor comments. http://bugs.python.org/review/27688/diff/18064/Doc/library/typing.rst File Doc/library/typing.rst (right): http://bugs.python.org/review/27688/diff/18064/Doc/library/typing.rst#newco… Doc/library/typing.rst:222: # The static type checker treats the above Maybe "A static type checker" here too? http://bugs.python.org/review/27688/diff/18064/Doc/library/typing.rst#newco… Doc/library/typing.rst:236: That means when the type of a value is :class:`object`, the type checker will same here "a type checker" http://bugs.python.org/review/27688/

1 0

Python 3.4.4
by Johnson Abraham Aug. 5, 2016

Aug. 5, 2016

Hi, I couldn't download documentation of Python 3.4.4. I've attached the screenshot for your reference. Thank you!

1 0

Expand documentation about Any in the typing module (issue 27688)
by guido＠python.org Aug. 5, 2016

Aug. 5, 2016

http://bugs.python.org/review/27688/diff/18064/Doc/library/typing.rst File Doc/library/typing.rst (right): http://bugs.python.org/review/27688/diff/18064/Doc/library/typing.rst#newco… Doc/library/typing.rst:187: A special kind of type is :class:`Any`. The static type checker will treat Maybe "a static type checker"? http://bugs.python.org/review/27688/diff/18064/Doc/library/typing.rst#newco… Doc/library/typing.rst:188: every type as a subclass of :class:`Any` and :class:`Any` as a subtype of Could you avoid "subclass" and instead say something like "compatible with"? (My apologies if PEP 484 isn't always politically correct on this yet.) http://bugs.python.org/review/27688/diff/18064/Doc/library/typing.rst#newco… Doc/library/typing.rst:211: not throw an error when assigning ``a`` to ``s`` even though ``s`` was throw -> report http://bugs.python.org/review/27688/diff/18064/Doc/library/typing.rst#newco… Doc/library/typing.rst:241: # Fails; an object does not have a `magic` method. Maybe also show that hash(42) *does* type-check? http://bugs.python.org/review/27688/diff/18064/Doc/library/typing.rst#newco… Doc/library/typing.rst:251: manner. Use :class:`Any` to indicate that a value is dynamically typed. Maybe add that you have to use isinstance() to be able to use the value if its type is object? http://bugs.python.org/review/27688/

1 0

Word missing
by Linda Pescatore Aug. 4, 2016

Aug. 4, 2016

Section 3.3.2, there is a word missing at the end of this sentence: This allows you to type python to run the interpreter, and pip or .

2 1

Re: [docs] Reduce Github pull request rate (issue 27680)
by steve＠holdenweb.com Aug. 4, 2016

Aug. 4, 2016

Reviewers: SilentGhost, Message: Submitting a new patch remedying the dyslexia-induced errors pointed out by SilentGhost. Thank! https://bugs.python.org/review/27680/diff/18057/README.md File README.md (right): https://bugs.python.org/review/27680/diff/18057/README.md#newcode16 README.md:16: at https://hg.python.org/, updated daily as a service to those who are already using On 2016/08/04 11:07:19, SilentGhost wrote: > perhaps link to https://hg.python.org/cpython ? Done. https://bugs.python.org/review/27680/diff/18057/README.md#newcode23 README.md:23: explains all you need you know to join the Python developers. If you are On 2016/08/04 11:07:19, SilentGhost wrote: > all you need to know Done. https://bugs.python.org/review/27680/diff/18057/README.md#newcode24 README.md:24: interested in contributring then we especially recommend that you read On 2016/08/04 11:07:19, SilentGhost wrote: > contributing Done. https://bugs.python.org/review/27680/diff/18057/README.md#newcode27 README.md:27: Thanks for taking time to visit the Python repository, and for yout interest in Python. On 2016/08/04 11:07:19, SilentGhost wrote: > your Done. Please review this at https://bugs.python.org/review/27680/ Affected files: README.md diff -r b04560c3ce69 README.md --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/README.md Thu Aug 04 09:40:23 2016 +0100 @@ -0,0 +1,32 @@ +# This Is Not the Official Python Project Repository! + +### Though it will be, some time fairly soon + +You may have read announcements that Python developers have decided to move to git. +That hasn't happened yet. + +## No Pull Requests, Please + +At present the move to Github is still being planned, and so pull requests +to this repository will not be actioned. We try to inform people of this by responding to +pull requests, but the time spent doing that would really be better spent developing the +Python language! + +This site is currently a mirror of Python's official repository, which lives +at https://hg.python.org/, updated daily as a service to those who are already using +Github and find it a more convenient distribution channel. + +## Yes, Contributions Are Welcome + +The official Python source code repository is currently implemented on Mercurial. +The Python Developers' Guide is at https://docs.python.org/devguide/, and it +explains all you need you know to join the Python developers. If you are +interested in contributring then we especially recommend that you read +https://docs.python.org/devguide/#contributing. + +Thanks for taking time to visit the Python repository, and for yout interest in Python. + +----------------------------------------------------------------------- + +This file has been added to assist during the Mercurial-to-Github transition period, +and will be replaced by the traditional README file when the transition is complete.

1 0

Reduce Github pull request rate (issue 27680)
by ghost.adh＠runbox.com Aug. 4, 2016

Aug. 4, 2016

https://bugs.python.org/review/27680/diff/18057/README.md File README.md (right): https://bugs.python.org/review/27680/diff/18057/README.md#newcode16 README.md:16: at https://hg.python.org/, updated daily as a service to those who are already using perhaps link to https://hg.python.org/cpython ? https://bugs.python.org/review/27680/diff/18057/README.md#newcode23 README.md:23: explains all you need you know to join the Python developers. If you are all you need to know https://bugs.python.org/review/27680/diff/18057/README.md#newcode24 README.md:24: interested in contributring then we especially recommend that you read contributing https://bugs.python.org/review/27680/diff/18057/README.md#newcode27 README.md:27: Thanks for taking time to visit the Python repository, and for yout interest in Python. your https://bugs.python.org/review/27680/

1 0