What are the differences between annotations and docstrings in Python 3.10?

What are the differences between annotations and docstrings in Python 3.10?

In Python 3.10, annotations are used to indicate the expected data types of function parameters and return values, while docstrings provide documentation for the function's purpose and usage.

Can you give me an example of both?

Sure! Here's a simple example:

def add(a: int, b: int) -> int:
    """Adds two integers and returns the result."""
    return a + b

In this example, a: int and b: int are annotations, while the text inside triple quotes is the docstring.

Are annotations mandatory in Python 3.10?

No, annotations are not mandatory. They are optional and mainly serve as hints for type checkers and IDEs.

How do docstrings affect code readability?

Docstrings significantly enhance code readability by providing clear explanations of what a function does, its parameters, and its return values, making it easier for others to understand and use the code.