13.1.1. Редактор скриптів#

Редактор є повнофункціональним професійним текстовим редактором, побудованим на основі Qt Creator, з вкладковим однофікованим макетом вікна. Вкладки вгорі перемикають відкриті файли, а звичні операції з файлами та редагування знаходяться в меню «Файл» і «Правка» та на кнопках панелі інструментів вздовж лівого краю. Більшість функцій працює так, як очікується від будь-якого редактора; наведені нижче функції є найважливішими для роботи з MicroPython.

13.1.1.1. Пробіли та відступи#

Відступ є синтаксисом у Python, а IndentationError через хибний символ табуляції невидимий при звичайному відображенні. Коли таке трапляється, увімкніть Visualize Whitespace у меню Edit → Advanced – кожен пробіл і символ табуляції відображатиметься на екрані, і зайвий символ легко помітити.

13.1.1.2. Пошук і заміна#

Натисніть Ctrl+F, щоб відкрити панель пошуку і заміни. Вона підтримує пошук за звичайним текстом, цілими словами або регулярними виразами; при заміні можна використовувати групи захоплення та зберігати регістр кожного збігу. Натисніть Ctrl+Shift+F для Advanced Find – розширеного пошуку по всіх відкритих файлах або по всіх файлах у вибраній папці на диску; результати відображаються як клікабельний список.

13.1.1.3. Автодоповнення та підказки виклику#

Редактор знає Python API камери. Введіть . після назви модуля чи об’єкта, і відкриється список автодоповнення з його функціями, методами й константами; виберіть один, і підказка виклику проведе вас крізь аргументи. Наведіть курсор на будь-яку назву API, щоб побачити її документацію у підказці – той самий текст, що й у довіднику бібліотеки, не залишаючи редактора – або поставте курсор на назву й натисніть F1, щоб відкрити її документацію. Автодоповнення охоплює специфічні для камери модулі (csi, image, machine та решту довідника бібліотеки), а також саму мову Python.

Вбудований мовний сервер Python перевіряє код під час введення: підкреслює невизначені імена, невикористані імпорти та синтаксичні помилки ще до запуску скрипту – цілий клас помилок через опечатки ніколи не дістається до камери.

The editor's completion popup open after typing a dot, listing the image methods with their call signatures

Введіть крапку – відкриється список автодоповнення з повними сигнатурами виклику кожного елемента.#

13.1.1.4. GitHub Copilot#

Редактор підтримує GitHub Copilot для вбудованих AI-підказок коду. Він нічого не робить, доки ви не увійдете в обліковий запис GitHub із підпискою на Copilot у розділі Copilot діалогу налаштувань. Щоб вимкнути, вийдіть з облікового запису або зніміть прапорець увімкнення.

13.1.1.5. Більше ніж Python-файли#

Редактор відкриває більше, ніж скрипти. Відкрийте файл зображення – воно з’явиться у переглядачі зображень із керуванням масштабом і підгонкою до екрана, що зручно для перегляду збережених знімків і шаблонів без виходу з IDE. Відкрийте бінарний файл – він з’явиться у шістнадцятковому редакторі, корисному для швидкого перегляду вмісту запису або файлу дескриптора.

13.1.1.6. Редагування поза IDE#

Скрипти є звичайними файлами .py, і нічого не вимагає їх редагування саме в IDE. Коли файл, відкритий у редакторі, змінюється на диску – збережений з іншого редактора або завантажений із системи контролю версій – IDE помічає це, щойно її вікно знову отримує фокус, і перезавантажує файл. Запит виводиться лише якщо в редакторі є незбережені зміни.