Type hinting a collection of a specified type

by

Answering my own question; the TLDR answer is No Yes.

Update 2

In September 2015, Python 3.5 was released with support for Type Hints and includes a new typing module. This allows for the specification of types contained within collections. As of November 2015, JetBrains PyCharm 5.0 fully supports Python 3.5 to include Type Hints as illustrated below.

PyCharm 5.0 Code Completion using Type Hints

Update 1

As of May 2015, PEP0484 (Type Hints) has been formally accepted. The draft implementation is also available at github under ambv/typehinting.

Original Answer

As of Aug 2014, I have confirmed that it is not possible to use Python 3 type annotations to specify types within collections (ex: a list of strings).

The use of formatted docstrings such as reStructuredText or Sphinx are viable alternatives and supported by various IDEs.

It also appears that Guido is mulling over the idea of extending type annotations in the spirit of mypy: http://mail.python.org/pipermail/python-ideas/2014-August/028618.html

More Related Contents:

  1. How do I type hint a method with the type of the enclosing class?
  2. What are variable annotations?
  3. How to specify multiple return types using type-hints
  4. How can I specify the function type in my type hints?
  5. What are type hints in Python 3.5?
  6. Using the class as a type hint for arguments in its methods [duplicate]
  7. Type hint for a function that returns only a specific set of values
  8. How to use type hints in python 3.6?
  9. How to specify “nullable” return type with type hints
  10. How should I use the Optional type hint?
  11. Type hints when unpacking a tuple?
  12. Exclude type in Python typing annotation
  13. Python type hinting with exceptions
  14. Type hinting / annotation (PEP 484) for numpy.ndarray
  15. Can I omit Optional if I set default to None?
  16. Name not defined in type annotation [duplicate]
  17. Python 3.5 type hinting does not result in an error
  18. Type annotations for Enum attribute
  19. How to annotate function that takes a tuple of variable length? (variadic tuple type annotation)
  20. Recursive Typing in Python 3.5+ [duplicate]
  21. What is the type hint for a (any) python module?
  22. Type hints: solve circular dependency [duplicate]
  23. Type annotations for *args and **kwargs
  24. How can I tell PyCharm what type a parameter is expected to be?
  25. What’s the difference between a constrained TypeVar and a Union?
  26. Specify length of Sequence or List with Python typing module
  27. Using List/Tuple/etc. from typing vs directly referring type as list/tuple/etc
  28. mypy, type hint: Union[float, int] -> is there a Number type?
  29. “TypeError: ‘type’ object is not subscriptable” in a function signature
  30. Type Hinting for objects of type that’s being defined [duplicate]

Leave a Comment