13.1.1. L’editor di script

L’editor è un editor di testo professionale completo, costruito sul core di Qt Creator, con un layout a schede e finestra singola. Le schede in alto consentono di passare tra i file aperti, e le consuete operazioni su file e modifica si trovano nei menu File ed Edit e sui pulsanti della barra degli strumenti lungo il bordo sinistro. Gran parte di esso funziona come ci si aspetta da qualsiasi editor; le funzionalità descritte di seguito sono quelle che contano per il lavoro con MicroPython.

13.1.1.1. Spazi vuoti

In Python l’indentazione è sintassi, e un IndentationError causato da un tab vagante è invisibile nella visualizzazione normale. Quando accade, attiva Visualize Whitespace in Edit → Advanced: ogni spazio e tab viene disegnato sullo schermo, e quello fuori posto è facile da individuare.

13.1.1.2. Trova e sostituisci

Premi Ctrl+F per la barra di ricerca e sostituzione. Trova testo semplice, parole intere o espressioni regolari, e le sostituzioni possono usare gruppi di cattura e preservare il maiuscolo/minuscolo di ogni occorrenza che sostituiscono. Premi Ctrl+Shift+F per Advanced Find, che estende la ricerca a tutti i file aperti o a ogni file in una cartella su disco ed elenca le corrispondenze come risultati cliccabili.

13.1.1.3. Completamento del codice e suggerimenti sulle chiamate

L’editor conosce l’API Python della camera. Digita . dopo il nome di un modulo o di un oggetto e si apre un elenco di completamento con le sue funzioni, i metodi e le costanti; scegline uno e un suggerimento sulla chiamata ti guida tra gli argomenti. Passa il mouse su un qualsiasi nome dell’API per vederne la documentazione in un tooltip, lo stesso testo del riferimento della libreria, senza uscire dall’editor. Il completamento copre i moduli specifici della camera (csi, image, machine e il resto del riferimento della libreria) oltre al linguaggio Python stesso.

Un language server Python incluso controlla il tuo codice mentre digiti, sottolineando nomi non definiti, import inutilizzati ed errori di sintassi prima ancora che lo script venga eseguito: un’intera categoria di crash da refuso non raggiunge mai la camera.

Digita un punto e si apre l’elenco di completamento, ogni voce con la sua firma di chiamata completa.

13.1.1.4. GitHub Copilot

L’editor supporta GitHub Copilot per i suggerimenti di codice inline tramite IA. Non fa nulla finché non accedi con un account GitHub dotato di un abbonamento Copilot, nella sezione Copilot della finestra di dialogo delle preferenze. Per disattivarlo di nuovo, esci o deseleziona la sua casella di abilitazione.

13.1.1.5. Oltre i file Python

L’editor apre più dei soli script. Apri un file immagine e appare in un visualizzatore di immagini con controlli di zoom e adattamento allo schermo, comodo per ispezionare snapshot e modelli salvati senza uscire dall’IDE. Apri un file binario e appare in un editor esadecimale, utile per dare una rapida occhiata all’interno di una registrazione o di un file descrittore.

13.1.1.6. Modifica al di fuori dell’IDE

Gli script sono semplici file .py, e nulla ti obbliga a modificarli nell’IDE. Quando un file aperto nell’editor cambia su disco, salvato da un altro editor o recuperato dal controllo di versione, l’IDE se ne accorge non appena la sua finestra torna in primo piano e ricarica il file. Chiede prima conferma solo se la copia nell’editor ha modifiche non salvate proprie.