[issue27723] Document typing.Text and typing.AnyStr

[Guido van Rossum]

Guido van Rossum added the comment:

Committed and merged to 3.6.

changeset:   102670:d5872d0863c8
branch:  3.5
parent:  102663:27a99a722828
user:Guido van Rossum 
date:Mon Aug 15 15:06:38 2016 -0700
summary: Add docs for typing.AnyStr and typing.Text. By Michael Lee.

changeset:   102672:705416c5909e
tag: tip
parent:  102671:247ecbae325c
parent:  102670:d5872d0863c8
user:Guido van Rossum 
date:Mon Aug 15 15:08:11 2016 -0700
summary: Add docs for typing.AnyStr and typing.Text. By Michael Lee. (Merge 
3.5->3.6)

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

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue27723] Document typing.Text and typing.AnyStr

[Ivan Levkivskyi]

Ivan Levkivskyi added the comment:

Looks good to me.
15 Сер 2016 18:57 "Michael Lee"  пише:

>
> Michael Lee added the comment:
>
> Second revision attached below.
>
> --
> Added file: http://bugs.python.org/file44121/document-text-and-
> anystr-2.patch
>
> ___
> Python tracker 
> 
> ___
>

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue27723] Document typing.Text and typing.AnyStr

[Michael Lee]

Michael Lee added the comment:

Second revision attached below.

--
Added file: http://bugs.python.org/file44121/document-text-and-anystr-2.patch

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue27723] Document typing.Text and typing.AnyStr

[Guido van Rossum]

Guido van Rossum added the comment:

Also see my comments in rietveld.

--Guido (mobile)

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue27723] Document typing.Text and typing.AnyStr

[Ivan Levkivskyi]

Ivan Levkivskyi added the comment:

Thank you for the patch, Michael!
I could add a comment that probably it is better to mention the definition of 
AnyStr = TypeVar('AnyStr', str, bytes) at beginning and only then go with 
examples.

--
nosy: +levkivskyi

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue27723] Document typing.Text and typing.AnyStr

[Michael Lee]

New submission from Michael Lee:

This patch documents typing.Text and typing.AnyStr.

I decided against creating a new top-level section to document Text/AnyStr 
mainly because it seems like how exactly str/bytes/unicode is handled by mypy 
and described in PEP 484 might be changing sometime in the future and didn't 
want to add text that would need to be changed later on -- I'm not sure if that 
was the right call or not.

--
assignee: docs@python
components: Documentation
files: document-text-and-anystr.patch
keywords: patch
messages: 272286
nosy: docs@python, gvanrossum, michael0x2a
priority: normal
severity: normal
status: open
title: Document typing.Text and typing.AnyStr
versions: Python 3.5, Python 3.6
Added file: http://bugs.python.org/file44062/document-text-and-anystr.patch

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com