13.1.1. El editor de scripts

El editor es un editor de texto profesional completo construido sobre el núcleo de Qt Creator, en un diseño de ventana única con pestañas. Las pestañas en la parte superior cambian entre los archivos abiertos, y las operaciones habituales de archivo y edición están en los menús File y Edit y en los botones de la barra de herramientas del borde izquierdo. La mayor parte funciona como esperarías de cualquier editor; las características de abajo son las que importan para el trabajo con MicroPython.

13.1.1.1. Espacios en blanco

La indentación es sintaxis en Python, y un IndentationError causado por una tabulación extraviada es invisible en la visualización normal. Cuando eso ocurra, activa Visualize Whitespace en Edit → Advanced: cada espacio y tabulación se dibuja en pantalla, y el que sobra es fácil de detectar.

13.1.1.2. Buscar y reemplazar

Pulsa Ctrl+F para la barra de buscar y reemplazar. Coincide con texto sencillo, palabras completas o expresiones regulares, y los reemplazos pueden usar grupos de captura y preservar las mayúsculas y minúsculas de cada coincidencia que reemplazan. Pulsa Ctrl+Shift+F para Advanced Find, que amplía la búsqueda a todos los archivos abiertos o a cada archivo bajo una carpeta del disco y lista las coincidencias como resultados en los que se puede hacer clic.

13.1.1.3. Autocompletado de código y sugerencias de llamada

El editor conoce la API de Python de la cámara. Escribe . tras el nombre de un módulo u objeto y se abre una lista de autocompletado con sus funciones, métodos y constantes; elige una y una sugerencia de llamada te guía por los argumentos. Pasa el cursor sobre cualquier nombre de API para ver su documentación en un tooltip: el mismo texto que la referencia de la biblioteca, sin salir del editor. El autocompletado cubre los módulos específicos de la cámara (csi, image, machine y el resto de la referencia de la biblioteca) así como el propio lenguaje Python.

Un servidor de lenguaje Python incluido revisa tu código mientras escribes, subrayando nombres no definidos, importaciones no usadas y errores de sintaxis antes de que el script se ejecute siquiera: toda una clase de fallos por errores tipográficos nunca llega a la cámara.

La ventana emergente de autocompletado del editor abierta tras escribir un punto, mostrando los métodos de imagen con sus firmas de llamada

Escribe un punto y se abre la lista de autocompletado: cada entrada con su firma de llamada completa.

13.1.1.4. GitHub Copilot

El editor admite GitHub Copilot para sugerencias de código en línea por IA. No hace nada hasta que inicias sesión con una cuenta de GitHub que tenga una suscripción a Copilot, en la sección Copilot del cuadro de diálogo de preferencias. Para desactivarlo de nuevo, cierra la sesión o desmarca su casilla de habilitación.

13.1.1.5. Más allá de los archivos Python

El editor abre algo más que scripts. Abre un archivo de imagen y aparece en un visor de imágenes con controles de zoom y ajuste a pantalla, práctico para inspeccionar capturas y plantillas guardadas sin salir del IDE. Abre un archivo binario y aparece en un editor hexadecimal, útil para echar un vistazo rápido al interior de una grabación o un archivo de descriptor.

13.1.1.6. Editar fuera del IDE

Los scripts son archivos .py sencillos, y nada te obliga a editarlos en el IDE. Cuando un archivo abierto en el editor cambia en el disco – guardado desde otro editor, o extraído del control de versiones – el IDE lo nota en cuanto su ventana recupera el foco y recarga el archivo. Pregunta primero solo si la copia en el editor tiene cambios sin guardar propios.