13.1.1. O editor de scripts

O editor é um editor de texto profissional completo construído sobre o núcleo do Qt Creator, em um layout de janela única com abas. As abas ao longo do topo alternam entre os arquivos abertos, e as operações usuais de arquivo e edição estão nos menus File e Edit e nos botões da barra de ferramentas ao longo da borda esquerda. A maior parte funciona da forma que você espera de qualquer editor; os recursos abaixo são os que importam para o trabalho com MicroPython.

13.1.1.1. Espaços em branco

A indentação é sintaxe no Python, e um IndentationError causado por uma tabulação perdida é invisível na exibição normal. Quando isso acontece, ative Visualize Whitespace em Edit → Advanced – cada espaço e tabulação é desenhado na tela, e o que está fora do lugar fica fácil de identificar.

13.1.1.2. Localizar e substituir

Pressione Ctrl+F para a barra de localizar e substituir. Ela corresponde a texto simples, palavras inteiras ou expressões regulares, e as substituições podem usar grupos de captura e preservar a caixa de cada correspondência que substituem. Pressione Ctrl+Shift+F para o Advanced Find, que amplia a busca para todos os arquivos abertos ou para todos os arquivos sob uma pasta no disco e lista as correspondências como resultados clicáveis.

13.1.1.3. Autocompletar de código e dicas de chamada

O editor conhece a API Python da câmera. Digite . após o nome de um módulo ou objeto e uma lista de autocompletar abre com suas funções, métodos e constantes; escolha um e uma dica de chamada o orienta pelos argumentos. Passe o cursor sobre qualquer nome da API para ver sua documentação em uma dica de ferramenta – o mesmo texto da referência da biblioteca, sem sair do editor. O autocompletar cobre os módulos específicos da câmera (csi, image, machine e o restante da referência da biblioteca), assim como a própria linguagem Python.

Um servidor de linguagem Python incluído verifica seu código enquanto você digita, sublinhando nomes indefinidos, importações não utilizadas e erros de sintaxe antes mesmo de o script rodar – toda uma classe de travamentos por erro de digitação nunca chega à câmera.

Digite um ponto e a lista de autocompletar abre – cada entrada com sua assinatura de chamada completa.

13.1.1.4. GitHub Copilot

O editor oferece suporte ao GitHub Copilot para sugestões de código por IA inline. Ele não faz nada até você fazer login com uma conta do GitHub que tenha uma assinatura do Copilot, na seção Copilot da caixa de diálogo de preferências. Para desligá-lo novamente, faça logout ou desmarque sua caixa de habilitação.

13.1.1.5. Além dos arquivos Python

O editor abre mais do que scripts. Abra um arquivo de imagem e ele aparece em um visualizador de imagens com controles de zoom e ajuste à tela – útil para inspecionar snapshots e templates salvos sem sair da IDE. Abra um arquivo binário e ele aparece em um editor hexadecimal, útil para uma olhada rápida dentro de uma gravação ou de um arquivo de descritor.

13.1.1.6. Editando fora da IDE

Os scripts são simples arquivos .py, e nada obriga você a editá-los na IDE. Quando um arquivo aberto no editor muda no disco – salvo por outro editor ou obtido do controle de versão – a IDE percebe assim que sua janela recupera o foco e recarrega o arquivo. Ela pergunta primeiro apenas se a cópia no editor tiver alterações não salvas próprias.