Type annotations are an ability to specify parameter types and return values for functions in Python. This is not a mandatorType annotations allow programmers to specify parameter types and return values for functions in Python. It is not a mandatory requirement of the language, but it can help programmers in further development, improve the readability of the code and increase its reliability.
Let's look at a simple example of a function without type annotations:
def concat(first, second):
return first + second
This function concatenates two strings into one. At first glance, it is hard to understand what is going on in the code: what types the arguments have, why the function works with strings and not adding, for example, two numbers.
If we use it further in the code, we should check the types of arguments before passing them to the function. It increases the size of the code and makes it harder to understand.
Now let's add type annotations to the function:
def concat(first: str, second: str) -> str:
return first + second
Here we have specified that the arguments first and second must be of string type (str). The return value will also be of string type. When we use this function in code, it will be easier to understand what argument types we can pass and what return value type we expect.
We also can use type annotations to define variable types within a function. For example::
def double(n: int) -> int:
result: int = n * 2
return result
In this example, we have defined the type of the result
variable as int
using type annotation.
Type annotations are not strict type-checking in Python. They do not guarantee that we will call a function with arguments and return values of the specified types. After all, Python is still a dynamically typed language. Type annotations in Python do not affect the ability to pass different argument types or to return values of different types. However, their use helps to track down errors and makes the code more readable.
Implement a function, word_multiply()
. It should accept two parameters:
text = 'python'
print(word_multiply(text, 2)) # => pythonpython
print(word_multiply(text, 0)) # =>
Specify type annotations when declaring a function.
If you've reached a deadlock it's time to ask your question in the «Discussions». How ask a question correctly:
Tests are designed so that they test the solution in different ways and against different data. Often the solution works with one kind of input data but doesn't work with others. Check the «Tests» tab to figure this out, you can find hints at the error output.
It's fine. 🙆 One task in programming can be solved in many different ways. If your code passed all tests, it complies with the task conditions.
In some rare cases, the solution may be adjusted to the tests, but this can be seen immediately.
It's hard to make educational materials that will suit everyone. We do our best but there is always something to improve. If you see a material that is not clear to you, describe the problem in “Discussions”. It will be great if you'll write unclear points in the question form. Usually, we need a few days for corrections.
By the way, you can participate in courses improvement. There is a link below to the lessons course code which you can edit right in your browser.
Your exercise will be checked with these tests:
1import index
2
3
4def test():
5 expected = [str, int, str]
6 annotations = index.word_multiply.__annotations__
7 print(annotations)
8 assert list(annotations.values()) == expected, 'You should use type annotations!' # noqa: E501
9
10 assert index.word_multiply('python', 1) == 'python'
11 assert index.word_multiply('python', 3) == 'pythonpythonpython'
12 assert index.word_multiply('java', 0) == ''
13
Teacher's solution will be available in: