Python: Комментарии
Кроме самого кода, в исходных файлах часто можно встретить комментарии. Это строки, которые интерпретатор не обрабатывает. Программисты пишут их, чтобы пояснить, как работает код, отметить ошибки или напомнить, что нужно доделать.
# Удалить строку ниже после реализации задачи по регистрации
print(10)В Python все комментарии однострочные. Они начинаются со специального символа #, после которого может идти любой текст. Все, что написано после #, интерпретатор игнорирует.
# комментарий ──→ [ пропущено интерпретатором ]
print('hello') ──→ [ выполнено → hello ]
# еще один ──→ [ пропущено интерпретатором ]Комментарий может занимать всю строку:
# For Winterfell!
# For Lanisters!Или стоять в конце строки с кодом:
print('I am the King') # For Lannisters!Если нужно оставить длинное пояснение, используют несколько строк с #:
# The night is dark and
# full of terrors.
print('I am the King')Интерпретатор игнорирует комментарии. Разработчики благодаря им быстрее разбираются в чужом коде и не забывают важные детали в собственном.
Служебные комментарии
В процессе работы вы будете встречаться с таким кодом в нашем редакторе:
# BEGIN
# ENDBEGIN и END здесь это обычные комментарии, которые никак не влияют на работу программы. Они показывают, куда писать код задания.
# BEGIN
<здесь ваше решение>
# ENDУвидев BEGIN и END, пишите свой код между ними, остальное оставляйте без изменений.
Задание
Добавьте в файл TODO-комментарий с текстом: TODO: добавить функцию приветствия
Такие комментарии помечают место в коде, которое нужно доработать позже. Это один из самых распространенных видов комментариев в реальных проектах.
Полезное
Команда проекта находится в телеграм-сообществе. Там можно задать любой вопрос и повлиять на проект
Если вы зашли в тупик, то самое время поговорить с нашим асситентом Тота во вкладке "ИИ-помощник":
Тесты устроены таким образом, что они проверяют решение разными способами и на разных данных. Часто решение работает с одними входными данными, но не работает с другими. Чтобы разобраться с этим моментом, изучите вкладку «Тесты» и внимательно посмотрите на вывод ошибок, в котором есть подсказки.
Это нормально 🙆, в программировании одну задачу можно выполнить множеством способов. Если ваш код прошел проверку, то он соответствует условиям задачи. В редких случаях бывает, что решение подогнано под тесты, но это видно сразу.
Создавать обучающие материалы, понятные для всех без исключения, довольно сложно. Мы очень стараемся, но всегда есть что улучшать. Если вы встретили материал, который вам непонятен, опишите проблему в обратной связи нашего сообщества
Ваше упражнение проверяется по этим тестам
def test():
with open("solution.py") as file:
comment = file.read().rstrip()
assert comment == "# TODO: добавить функцию приветствия"
print(comment)Решение учителя откроется через:
20:00
