Supporting type from docstring

[vallsv]

Hi,

After we tests with the master of python/mypy repo, it seems that definition of types from the docstring are not supported.

I try this (https://www.jetbrains.com/help/pycharm/2016.1/using-docstrings-to-specify-types.html):

def gcd(a, b):
    """
    :type a: int
    :type b: int
    :rtype: int
    """
    while b:
        a, b = b, a % b
    return a

And that:

def gcd(a, b):
    """
    @type a: int
    @type b: int
    @rtype: int
    """
    while b:
        a, b = b, a % b
    return a

Is there any way to support it?
Thanks a lot

[gvanrossum]

Sorry, we have considered this and we're not going to support it. Types in docstrings are too often incorrect and unmaintained.

[vallsv]

Then is there a way to write something targeting

• Python >= 2.7
• Python >= 3.4
• Sphinx documentation
• Without duplication of type definition

I try, but i dont find any intersection

If it is possible, it is great. I think there will be no problem to update the codebase i manage.
Thanks.

[JukkaL]

Hopefully Sphinx will start supporting type comments now that they are included in PEP 484 -- then type comments would work everywhere.