Type Hints in Python

Type Hints in Python is another important parameter used by different programmers in performing different tasks. Learn more about it here.

Type Hints in Python: Adding types to a function

Let’s take an example of a function which receives two arguments and returns a value indicating their sum:

def two_sum(a, b):
return a + b

By looking at this code, one can not safely and without doubt indicate the type of the arguments for function two_sum. It works both when supplied with int values:

print(two_sum(2, 1)) # result: 3

and with strings:

print(two_sum("a", "b")) # result: "ab"

and with other values, such as lists, tuples et cetera.

Due to this dynamic nature of python types, where many are applicable for a given operation, any type checker would not be able to reasonably assert whether a call for this function should be allowed or not.

To assist our type checker we can now provide type hints for it in the Function definition indicating the type that we allow.

To indicate that we only want to allow int types we can change our function definition to look like:

def two_sum(a: int, b: int):
return a + b

Annotations follow the argument name and are separated by a : character.

Similarly, to indicate only str types are allowed, we’d change our function to specify it:

def two_sum(a: str, b: str):
return a + b

Apart from specifying the type of the arguments, one could also indicate the return value of a function call. This is done by adding the -> character followed by the type after the closing parenthesis in the argument list but before the : at the end of the function declaration:

def two_sum(a: int, b: int) -> int:
return a + b

Now we’ve indicated that the return value when calling two_sum should be of type int. Similarly we can define appropriate values for str, float, list, set and others.

Although type hints are mostly used by type checkers and IDEs, sometimes you may need to retrieve them. This can be done using the annotations special attribute:


{‘a’: , ‘b’: , ‘return’: }

Type Hints in Python: NamedTuple

Creating a namedtuple with type hints is done using the function NamedTuple from the typing module:

import typing
Point = typing.NamedTuple('Point', [('x', int), ('y', int)])

Note that the name of the resulting type is the first argument to the function, but it should be assigned to a variable with the same name to ease the work of type checkers.

Generic Types

The typing.TypeVar is a generic type factory. It’s primary goal is to serve as a parameter/placeholder for generic function/class/method annotations:

import typing
T = typing.TypeVar("T")
def get_first_element(l: typing.Sequence[T]) -> T:
"""Gets the first element of a sequence."""
return l[0]

Variables and Attributes

Variables are annotated using comments:

x = 3 # type: int
x = negate(x)
x = 'a type-checker might catch this error'

Python 3.x Version ≥ 3.6

Starting from Python 3.6, there is also new syntax for variable annotations. The code above might use the form

int = 3

Unlike with comments, it is also possible to just add a type hint to a variable that was not previously declared, without setting a value to it:


Additionally if these are used in the module or the class level, the type hints can be retrieved using typing.get_type_hints(class_or_module):

class Foo:
str = 'abc'

ChainMap({‘x’: , ‘y’: }, {})

Alternatively, they can be accessed by using the annotations special variable or attribute:


{‘x’: }

class C:

{‘s’: }

Class Members and Methods

class A:
x = None # type: float
def init(self, x: float) -> None:
self should not be annotated
init should be annotated to return None
self.x = x
def from_int(cls, x: int) -> 'A':
cls should not be annotated
Use forward reference to refer to current class with string literal 'A'
return cls(float(x))

Forward reference of the current class is needed since annotations are evaluated when the function is defined.

Forward references can also be used when referring to a class that would cause a circular import if imported.

Type Hints in Python: Type hints for keyword arguments

def hello_world(greeting: str = 'Hello'):
print(greeting + ' world!')

Note the spaces around the equal sign as opposed to how keyword arguments are usually styled.

Learn More


Please enter your comment!
Please enter your name here