13.1.1. O editor de scripts

O editor é um editor de texto profissional completo construído sobre o núcleo do Qt Creator, num esquema de janela única com separadores. Os separadores na parte superior alternam entre os ficheiros abertos, e as operações habituais de ficheiro e edição encontram-se nos menus Ficheiro e Editar e nos botões da barra de ferramentas ao longo da margem esquerda. A maioria funciona como seria de esperar em qualquer editor; as funcionalidades abaixo são as que importam para o trabalho com MicroPython.

13.1.1.1. Espaço em branco

A indentação é sintaxe em Python, e um IndentationError causado por um separador de tabulação perdido é invisível na visualização normal. Quando isso acontece, ative Visualize Whitespace em Editar → Avançado – cada espaço e tabulação é desenhado no ecrã, e o intruso é fácil de identificar.

13.1.1.2. Localizar e substituir

Prima Ctrl+F para a barra de localizar e substituir. Esta pesquisa texto simples, palavras inteiras ou expressões regulares, e as substituições podem usar grupos de captura e preservar a capitalização de cada correspondência substituída. Prima Ctrl+Shift+F para Advanced Find, que alarga a pesquisa a todos os ficheiros abertos ou a todos os ficheiros numa pasta em disco e lista as correspondências como resultados clicáveis.

13.1.1.3. Completação de código e dicas de chamada

O editor conhece a API Python da câmara. Escreva . após o nome de um módulo ou objeto e abre-se uma lista de completação com as suas funções, métodos e constantes; selecione um e uma dica de chamada guia-o pelos argumentos. Passe o cursor sobre qualquer nome de API para ver a respetiva documentação numa dica de ferramenta – o mesmo texto da referência da biblioteca, sem sair do editor. A completação abrange os módulos específicos da câmara (csi, image, machine e o restante da referência da biblioteca), bem como a própria linguagem Python.

Um servidor de linguagem Python incluído verifica o seu código enquanto escreve, sublinhando nomes indefinidos, importações não utilizadas e erros de sintaxe antes de o script alguma vez ser executado – toda uma classe de falhas por gralha nunca chega à câmara.

Escreva um ponto e a lista de completação abre – cada entrada com a respetiva assinatura de chamada completa.

13.1.1.4. GitHub Copilot

O editor suporta o GitHub Copilot para sugestões de código AI inline. Não faz nada até iniciar sessão com uma conta GitHub que tenha uma subscrição Copilot, na secção Copilot do diálogo de preferências. Para o desativar novamente, termine a sessão ou desmarque a sua caixa de ativação.

13.1.1.5. Para além de ficheiros Python

O editor abre mais do que scripts. Abra um ficheiro de imagem e este aparece num visualizador de imagens com controlos de zoom e ajuste ao ecrã – útil para inspecionar capturas de imagem e modelos guardados sem sair do IDE. Abra um ficheiro binário e este aparece num editor hexadecimal, útil para uma consulta rápida ao interior de uma gravação ou de um ficheiro de descritor.

13.1.1.6. Editar fora do IDE

Os scripts são ficheiros .py simples, e nada obriga a editá-los no IDE. Quando um ficheiro aberto no editor muda em disco – guardado por outro editor ou extraído do controlo de versões – o IDE dá conta assim que a sua janela recupera o foco e recarrega o ficheiro. Pede confirmação apenas se a cópia no editor tiver alterações não guardadas.