使用Python 3的函数注释,可以指定包含在同质列表(或其他集合)中的项的类型,以便在PyCharm和其他ide中进行类型提示。

int列表的伪python代码示例:

def my_func(l:list<int>):
    pass

我知道使用Docstring是可能的…

def my_func(l):
    """
    :type l: list[int]
    """
    pass

... 但如果可能的话,我更喜欢注释风格。


当前回答

回答我自己的问题;TLDR的答案是否定的。

更新2

2015年9月,Python 3.5发布了对类型提示的支持,并包含了一个新的类型模块。这允许指定集合中包含的类型。截至2015年11月,JetBrains PyCharm 5.0完全支持Python 3.5,包括如下所示的类型提示。

更新1

截止2015年5月,PEP0484 (Type Hints)已被正式接受。实现草案也可以在github的ambv/typehinting下找到。

原来的答案

截至2014年8月,我已经确认不可能使用Python 3类型注释来指定集合中的类型(例如:字符串列表)。

使用格式化的文档字符串(如reStructuredText或Sphinx)是可行的替代方案,并得到各种ide的支持。

Guido似乎也在考虑以mypy: http://mail.python.org/pipermail/python-ideas/2014-August/028618.html的精神扩展类型注释的想法

其他回答

类型注释从PEP 484开始添加

from . import Monitor
from typing import List, Set, Tuple, Dict


active_monitors = [] # type: List[Monitor]
# or
active_monitors: List[Monitor] = []

# bonus
active_monitors: Set[Monitor] = set()
monitor_pair: Tuple[Monitor, Monitor] = (Monitor(), Monitor())
monitor_dict: Dict[str, Monitor] = {'codename': Monitor()}

# nested
monitor_pair_list: List[Dict[str, Monitor]] = [{'codename': Monitor()}]

这目前在Python 3.6.4的PyCharm上为我工作

更新:请查看其他答案,这个已经过时了。

原答案(2015):

现在Python 3.5正式发布了,有类型提示支持模块-类型和通用容器的相关List“类型”。

换句话说,现在你可以做:

from typing import List

def my_func(l: List[int]):
    pass

有了BDFL的支持,现在几乎可以肯定的是,python(可能是3.5)将通过函数注释为类型提示提供标准化语法。

https://www.python.org/dev/peps/pep-0484/

正如PEP中所引用的,有一个实验性的类型检查器(有点像pylint,但用于类型)称为myypy,它已经使用了这个标准,并且不需要任何新的语法。

http://mypy-lang.org/

回答我自己的问题;TLDR的答案是否定的。

更新2

2015年9月,Python 3.5发布了对类型提示的支持,并包含了一个新的类型模块。这允许指定集合中包含的类型。截至2015年11月,JetBrains PyCharm 5.0完全支持Python 3.5,包括如下所示的类型提示。

更新1

截止2015年5月,PEP0484 (Type Hints)已被正式接受。实现草案也可以在github的ambv/typehinting下找到。

原来的答案

截至2014年8月,我已经确认不可能使用Python 3类型注释来指定集合中的类型(例如:字符串列表)。

使用格式化的文档字符串(如reStructuredText或Sphinx)是可行的替代方案,并得到各种ide的支持。

Guido似乎也在考虑以mypy: http://mail.python.org/pipermail/python-ideas/2014-August/028618.html的精神扩展类型注释的想法

从Python 3.9开始,内建类型相对于类型注释来说是泛型的(参见PEP 585)。这允许直接指定元素的类型:

def my_func(l: list[int]):
    pass

这也扩展到标准库的大多数其他容器类型,例如collections.deque或collections.abc.Mapping。


在Python 3.9之前,各种工具都可能支持此语法。当注释在运行时没有被检查时,使用引号或__future__.annotations语法是有效的。

# quoted
def my_func(l: 'list[int]'):
    pass
# postponed evaluation of annotation
from __future__ import annotations

def my_func(l: list[int]):
    pass

作为PEP 585的结果,在与标准库类型相对应的类型方面的大多数帮助程序都已弃用,例如类型。列表,输入。Deque或typing.Mapping。只有在需要与3.9之前的Python版本兼容时才应该使用它们。