MicroPython:Основы/Язык MicroPython и его реализация/Интерактивный интерпретатор MicroPython (он же REPL)
Режим интерактивного интерпретатора MicroPython (REPL)[1]
В этом разделе будут описаны некоторые характеристики режима интерактивного интерпретатора MicroPython. Его также часто называют REPL (расшифровывается как «Read, Eval, Print, Loop», что можно перевести как «цикл "чтение-вычисление-вывод"») – ниже мы будем использовать именно эту сокращенную аббревиатуру.
Автоматический отступ
Если вы создаете оператор Python, заканчивающийся двоеточием (например, if, for, while), то приглашение командной строки сменится на три точки (...), а курсор автоматически отступит на четыре пробела. Если нажать ↵ Enter (или Return ), на следующей строчке будет либо точно такой же отступ (если это обычный оператор), либо дополнительный отступ (при необходимости). Если нажать ← Backspace , это откатит один уровень отступа.
Если курсор находится в самом начале строки, нажатие на ↵ Enter ( Return ) запустит выполнение введенного вами кода. Ниже показано, что вы увидите, когда напечатаете оператор for (нижнее подчеркивание показывает, куда переместится курсор):
>>> for i in range(30):
... _
Если после этого напечатать оператор if, REPL создаст дополнительный уровень отступа:
>>> for i in range(30):
... if i > 3:
... _
Теперь впишите break, а затем нажмите Enter (Return) и Backspace:
>>> for i in range(30):
... if i > 3:
... break
... _
Наконец, впишите print(i), нажмите ↵ Enter ( Return ), ← Backspace и снова ↵ Enter :
>>> for i in range(30):
... if i > 3:
... break
... print(i)
...
0
1
2
3
>>>
Если в двух предыдущих строчках находятся только пробелы, автоматический отступ сделан не будет. Это значит, что для того, чтобы завершить составной оператор, вам нужно трижды нажать ↵ Enter ( Return ) – третье нажатие завершит оператор и выполнит его.
Автозаполнение
Если вы пишете какую-то команду в REPL и напечатанные вами символы соответствуют началу какой-то конструкции MicroPython, то нажатие на Tab ⇆ покажет вам варианты того, как можно закончить введенную вами команду.
К примеру, сначала импортируйте модуль machine, напечатав import machine, и нажмите ↵ Enter ( Return ). Затем впишите m и нажмите Tab ⇆ – в результате m должна превратиться в machine. Теперь напечатайте точку (.) и снова нажмите Tab ⇆ . Вы должны увидеть примерно следующее:
>>> machine.
__name__ info unique_id reset
bootloader freq rng idle
sleep deepsleep disable_irq enable_irq
Pin
Варианты для автозаполнения будут появляться до тех пор, пока они есть. Например, попробуйте вписать machine.Pin.AF3 и нажмите Tab ⇆ – конструкция увеличится до machine.Pin.AF3_TIM. Если нажать Tab ⇆ второй раз, то вы увидите и другие варианты:
>>> machine.Pin.AF3_TIM
AF3_TIM10 AF3_TIM11 AF3_TIM8 AF3_TIM9
>>> machine.Pin.AF3_TIM
Прерывание работающей программы
Вы можете прервать работу запущенной программы, нажав Ctrl + C . Это вызовет исключение «KeyboardInterrupt», которое вернет вас в REPL, но при условии, что ваша программа не помешает исключению «KeyboardInterrupt».
Например:
>>> for i in range(1000000):
... print(i)
...
0
1
2
3
...
6466
6467
6468
Traceback (most recent call last):
File "<stdin>", line 2, in <module>
KeyboardInterrupt:
>>>
Режим вставки
Если вы захотите вставить в окно терминала фрагмент кода, вам помешает функция автоматического отступа. К примеру, если у вас есть вот такой кусок Python-кода...
def foo():
print('Это тест, демонстрирующий работу режима вставки')
print('Это вторая строчка')
foo()
…и вы попробуете вставить его в обычный REPL, то увидите примерно следующее:
>>> def foo():
... print('Это тест, демонстрирующий работу режима вставки')
... print('Это вторая строчка')
... foo()
...
File "<stdin>", line 3
IndentationError: unexpected indent
Но если нажать Ctrl + E , вы войдете в режим вставки, который отключит функцию автоматического отступа и поменяет приглашение ввода с >>> на ===. Например:
>>>
paste mode; Ctrl-C to cancel, Ctrl-D to finish
=== def foo():
=== print('Это тест, демонстрирующий работу режима вставки')
=== print('Это вторая строчка')
=== foo()
===
Это тест, демонстрирующий работу режима вставки
Это вторая строчка
>>>
Режим вставки позволяет вставлять пустые строчки. Вставленный текст компилируется, как если бы он был файлом. Нажатие на Ctrl + D выполнит выход из режима вставки и запустит компиляцию кода.
Программный сброс
Программный сброс выполнит сброс интерпретатора Python, но постарается не сбрасывать информацию о том, как вы подключены к плате с MicroPython (USB-Serial или WiFi).
Программный сброс можно выполнить из REPL, нажав Ctrl + D , или в Python-коде, выполнив:
machine.soft_reset()
Например, если выполнить сброс MicroPython-платы и запустить команду dir(), вы увидите примерно следующее:
>>> dir()
['__name__', 'pyb']
Теперь создайте несколько переменных и повторите команду dir():
>>> i = 1
>>> j = 23
>>> x = 'abc'
>>> dir()
['j', 'x', '__name__', 'pyb', 'i']
>>>
Теперь, если нажать Ctrl + D и повторить команду dir(), вы увидите, что ваших переменных больше нет:
MPY: sync filesystems
MPY: soft reboot
MicroPython v1.5-51-g6f70283-dirty on 2015-10-30; PYBv1.0 with STM32F405RG
Type "help()" for more information.
>>> dir()
['__name__', 'pyb']
>>>
Специальная переменная _ (нижнее подчеркивание)
В REPL можно делать вычисления и сразу видеть их результаты. MicroPython хранит результаты работы предыдущего оператора в переменной _ (нижнее подчеркивание). То есть вы можете использовать нижнее подчеркивание, чтобы сохранять результат в переменную. Например:
>>> 1 + 2 + 3 + 4 + 5
15
>>> x = _
>>> x
15
>>>
Режим удалённого скрипта (raw REPL)
Обычный пользователь вряд ли будет пользоваться режимом удаленного скрипта. Он нужен при программировании. По сути, это режим вставки, у которого выключена функция эхо-отображения.
Вход в режим удаленного скрипта осуществляется при помощи нажатия на Ctrl + A . Затем вы отправляете свой Python-код, после чего нужно нажать Ctrl + D . В результате вы получите подтверждение «OK», после чего Python-код будет скомпилирован и выполнен. Все выходные данные (и ошибки) будут отправлены обратно. Нажатие на Ctrl + B выполнит выход из режима удаленного скрипта и вернет вас в обычный («дружелюбный») REPL.
Программа tools/pyboard.py использует режим удаленного скрипта для выполнения Python-файлов на MicroPython-плате.