DEV Community

Cover image for Type Hinting and Annotations in Python: Improving Code Readability and Understanding
MyExamCloud
MyExamCloud

Posted on

Type Hinting and Annotations in Python: Improving Code Readability and Understanding

Python is a popular and powerful programming language known for its dynamic typing, where variable types are inferred at runtime. While this allows for flexibility, it can make code more difficult to understand in a collaborative setting.

To address this issue, Python introduced type hinting and annotations. This allows developers to annotate the expected types for function arguments and return values. For example:

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

In this function, the parameters and return type are denoted as integers. This makes it easier for other people (and yourself) to understand the function and its intended use.

It's important to note that type annotations are not enforced during runtime. This means that the function will still run even if incorrect types are passed in. However, this can lead to unexpected behavior or errors. For instance, if you try to add a string and an integer in the sum function, Python will throw a TypeError since it doesn't know how to add these two types together.

To better understand this concept, let's look at some sample test cases for the sum function:

print(sum(2,2)) # 4
# print(sum('python', 1)) # TypeError: can only concatenate str (not "int") to str
# print(sum(3,'python')) # TypeError: unsupported operand type(s) for +: 'int' and 'str'
print(sum('python', 'world')) # pythonworld

In the first two cases, we see the expected behavior of adding two integers and getting the sum as the output. However, in the remaining two cases, where incorrect types are passed in, we get TypeErrors.

To use type hinting, we use the colon (:) after the parameter name, followed by the type of data expected. For example, consider a function that calculates the area of a rectangle. We can specify the input as length (int) and width (int) and the return type as float as follows:

def calculate_area(length: int, width: int) -> float:
area = length * width
return area

Here, the int and float types are built-in data types in Python. Using type hinting in this way makes the function's purpose clear and helps with debugging and code maintenance. Without type hinting, the function would be written as follows:

def calculate_area(length, width):
area = length * width
return area

Without specifying the parameter types, it is not immediately clear what data types the function expects, making it less readable.

Apart from built-in types, we can also specify custom-defined types. For example, if we have a custom-defined class called Person, we can use it as the type of a function parameter or return value as follows:

class Person:
def __init__(self, name, age):
self.name = name
self.age = age

def get_person_info(person: Person) -> str:
return f"{person.name} is {person.age} years old."

Here, we specify the type of the person parameter as Person and the return type as str (string).

The typing library, introduced in Python 3.5, offers even more advanced features for type hinting. Let's look at some examples to understand its use better.

To specify that a parameter can accept multiple data types, we use the Union type annotation. For instance, in a function that calculates the sum of values in an iterable, we can specify the parameter to accept either a numpy array or a list:

from typing import Union
import numpy as np

def sum(iterable: Union[np.ndarray, list]) -> float:
total = 0
# function body to calculate the sum of values in iterable
return total

We can also specify that the members of a list parameter should all be of a particular type. For example, in the same sum function as above, let's say we want the list members to be of type float. We can do so using the following type hint:

def sum(iterable: Union[np.ndarray, list[float]]) -> float:
total = 0
# function body to calculate the sum of values in iterable
return total

The typing library also includes features such as Optional, which allows a parameter to accept either a certain type or None. It also supports various iterables, Generics, and custom-defined types, providing developers with more precise and clear ways to express complex data structures and relationships.

In conclusion, type hinting in Python greatly improves code readability and maintainability. Its basic usage helps to make function purpose clear, while the features in the typing library offer more advanced options for expressing data types. As projects grow and become more complex, using type hinting becomes even more beneficial.

MyExamCloud Study Plans
Java Certifications Practice Tests - MyExamCloud Study Plans
Python Certifications Practice Tests - MyExamCloud Study Plans
AWS Certification Practice Tests - MyExamCloud Study Plans
Google Cloud Certification Practice Tests - MyExamCloud Study Plans
MyExamCloud Aptitude Practice Tests Study Plan
MyExamCloud AI Exam Generator

Top comments (0)