[Python-ideas] PEP 484 evolution

[Chris Angelico]

On Sun, Mar 20, 2016 at 12:34 PM, Rick Johnson
<rantingrickjohnson at gmail.com> wrote:
> Yes, I was aware of the "stubfile option", and had stubfiles
> been the *ONLY* option, i would have thrown my support
> behind this type-hints thing 110%!
>

Stub files have *never* been the only option, for the same reason that
external documentation is not a replacement for docstrings. Keeping
information near the code it's connected to gives it a FAR better
chance of staying current than having it out-of-line does. Stub files
are supported for those times when it's impossible or inadvisable to
use inline annotations (eg for Py2 compatibility - the comments are
ugly compared to the proper annotations), but the preferred way to
provide type hints is to use the PEP 3107 annotation syntax.

ChrisA