С помощью определения собственных функций писать и поддерживать программы проще. Они позволяют объединять составные операции в одну. Поэтому в этом уроке поговорим, как создавать собственные функции.
Допустим, мы хотим отправить письма на сайте — это достаточно сложный процесс, который включает взаимодействие с внешними системами. Но если определить функцию, вся сложность скроется за одной простой функцией:
# Гипотетический пример
# Место откуда берется функция
from emails import send
email = 'support@hexlet.io'
title = 'Помогите'
body = 'Я написал историю успеха, как я могу получить скидку?'
# Один маленький вызов — много логики внутри
send(email, title, body)
Внутри себя этот вызов выполняет много логики: соединяется с почтовым сервером, формирует правильный запрос на основе заголовка и тела сообщения, а затем все отправляет, не забыв закрыть соединение.
Создадим нашу первую функцию. Ее задача — вывести на экран приветствие:
Hello, Hexlet!
# Определение функции
# Определение не вызывает и не выполняет функцию
# Мы лишь говорим, что теперь такая функция существует
def show_greeting():
# Внутри тела отступ четыре пробела
text = 'Hello, Hexlet!'
print(text)
# Вызов функции
show_greeting() # => 'Hello, Hexlet!'
https://replit.com/@hexlet/python-basics-define-function
В отличие от обычных данных, функции выполняют действия. Поэтому их имена нужно указывать через глаголы: «построить что-то», «нарисовать что-то», «открыть что-то».
Описание, которое находится ниже имени функции с отступом, называется телом функции. Внутри тела можно описывать любой код. Это как небольшая самостоятельная программа — набор произвольных инструкций.
Тело выполняется в тот момент, когда запускается функция. При этом каждый вызов функции запускает тело независимо от других вызовов.
Тело функции может быть пустым, тогда внутри него используется ключевое слово pass
:
# Минимальное определение функции
def noop():
pass
noop()
У понятия «создать функцию» много синонимов: «реализовать», «определить» и даже «заимплементить». Они часто встречаются на практике. Создавая свою функцию, вы облегчите сложные операции и сделаете разработку проще.
Реализуйте функцию с именем print_motto()
, которая выведет на экран фразу Winter is coming.
print_motto() # => Winter is coming
В задачах, в которых нужно реализовать функцию, эту функцию вызывать не нужно. Вызывать функцию будут автоматизированные тесты, которые проверяют его работоспособность. Пример с вызовом выше показан только для того, чтобы вы понимали, как ваша функция будет использоваться.
Если вы зашли в тупик, то самое время задать вопрос в «Обсуждениях». Как правильно задать вопрос:
Тесты устроены таким образом, что они проверяют решение разными способами и на разных данных. Часто решение работает с одними входными данными, но не работает с другими. Чтобы разобраться с этим моментом, изучите вкладку «Тесты» и внимательно посмотрите на вывод ошибок, в котором есть подсказки.
Это нормально 🙆, в программировании одну задачу можно выполнить множеством способов. Если ваш код прошел проверку, то он соответствует условиям задачи.
В редких случаях бывает, что решение подогнано под тесты, но это видно сразу.
Создавать обучающие материалы, понятные для всех без исключения, довольно сложно. Мы очень стараемся, но всегда есть что улучшать. Если вы встретили материал, который вам непонятен, опишите проблему в «Обсуждениях». Идеально, если вы сформулируете непонятные моменты в виде вопросов. Обычно нам нужно несколько дней для внесения правок.
Кстати, вы тоже можете участвовать в улучшении курсов: внизу есть ссылка на исходный код уроков, который можно править прямо из браузера.
Ваше упражнение проверяется по этим тестам
1import index
2from hexlet.test import expect_output
3
4
5def test(capsys):
6 index.print_motto()
7 expected = 'Winter is coming'
8 expect_output(capsys, expected)
9
Решение учителя откроется через: