1.2 Из чего состоит код

Мы обозначили, в каком виде нам будет встречаться код, где мы сможем его писать и как можно будет его запустить. Теперь нужно определить, из чего будет состоять код.

Так, уже было сказано, что каждая строчка в коде является обычным текстом, который воспринимается как некоторая инструкция - команда, которую компьютер должен исполнить. Но здесь ещё необходимо отметить, что инструкции пишутся с начала строки или с некоторым отступом, который будет влиять на то, как такая инструкция будет исполняться. А также некоторые инструкции могут игнорироваться интерпретатором, если они закомментированы.

Собственно, на отступах и комментариях остановимся чуть подробнее.

Отступы

В Python нам не встретятся различные команды, обозначающие начало или конец выполнения кода, также не будет отдельных команд и скобок, объединяющих инструкции в связанные блоки. Вместо этого в Python используются отступы. Отношение инструкций к тому или иному блоку кода будет определяться количеством отступов перед инструкцией. И для каждого нового блока, вложенного в другой, количество отступов будет увеличиваться.

Пока мы не знакомы с конструкциями, которые используют блоки и требуют использования отступов, их мы встретим дальше. Однако мы уже можем сказать, что изначально файл, в котором мы пишем инструкции, - это один основной блок кода, внутри которого уже определен начальный уровень отступов. Этот начальный уровень отступов равен 0, соответственно все обычные инструкции мы должны писать с начала строки. В противном случае мы будем получать ошибку Unexpected indentation.

Комментарии

Также непосредственно в коде на Python не получится встретить отдельных блоков с различными текстовыми пояснениями или описаниями, которые могут присутствовать в Notebook’ах. Но вместо них в коде могут присутствовать комментарии. Комментарии в Python используются для пояснений к вашему коду, никак не влияя на его выполнение. Их основная задача - помочь быстрее разобраться в коде человеку, который впервые его видит, или даже вам самим, когда спустя некоторые время, вы уже сами забыли, что писали.

В основном используются однострочные комментарии. В Python такие комментарии начинаются с символа решетки #, и вся оставшаяся строка после него считается комментарием.

Приведем несколько примеров:

# Это однострочный комментарий
print("Hello, World!")

Hello, World!

print("Hello, World!")  # Это тоже однострочный комментарий

Hello, World!

Многострочных комментариев в Python нет, вместо этого следует использовать последовательные однострочные комментарии. Однако в реальных проектах в качестве многострочных комментариев можно встретить конструкцию, где текст, занимающий несколько строк, заключен в тройные одинарные кавычки ''' ''' или тройные двойные кавычки """ """.

Это может выглядеть следующим образом:

"""
Это многострочный комментарий.
Это вторая строка комментария.
"""
print("Hello, World!")

Hello, World!

Обычно такая конструкция используется для документирования кода. Более правильно её называть Docstring. Далее в материалах она будет встречаться для описания различных функций, их документирования: что делает функция, какие параметры принимает и какие значения возвращает.

Горячие клавиши

При работе с кодом часто придется комментировать и раскомментировать по несколько строк сразу. Для этого пригодится горячая клавиша ctrl + /, которая делает эти действия сразу для всех выделенных строк.