Editor de Python

El editor de Python es el corazón del IDE de QuantCraft (Diseño del espacio de trabajo). Se abre cuando seleccionas un archivo en la Files Sidebar o abres una pestaña en la tira del editor, y te ofrece una experiencia de programación completa y moderna, pensada para escribir estrategias de trading en Python. Gestiona las bibliotecas en Packages (Dependencias); ejecuta el código con Run / Test (Ejecución de código).

Esta página cubre las cuatro áreas que más usarás:

• Edición
• Temas
• Tamaño de fuente
• Format Document

---

Edición

Cuando hay un archivo abierto, el editor ocupa el centro del IDE Main Panel y se comporta como los editores de Python a los que ya estás acostumbrado.

Escribir código

• Resaltado de sintaxis para Python, con colores determinados por el tema del editor que elijas.
• Sangría inteligente — al pulsar Intro al final de una línea, la siguiente se sangra correctamente para Python (tras def, class, if, for, with, etc.).
• Ajuste de línea — las líneas largas se ajustan visualmente para que no tengas que desplazarte en horizontal. El contenido real no cambia.
• El corrector ortográfico está desactivado en el editor, de modo que los identificadores y las palabras clave no se subrayan.
• El tabulador inserta 4 espacios.

Autocompletado

El editor ofrece sugerencias según el contexto mientras escribes:

• Fragmentos (snippets) para patrones habituales de Python: def, class, for, while, try, with, lambda, import, from, ifmain, etc.
• Biblioteca estándar y paquetes instalados — al escribir import o from se sugieren módulos del entorno de Python del IDE, además de tus propias carpetas y archivos del espacio de trabajo.
• Completado de miembros — al escribir . tras un módulo, un paquete o un objeto conocido de QuantCraft (por ejemplo bar., fundamentals., pd.) se listan los atributos y métodos disponibles. Prefiere bar. y fundamentals. en los callbacks de la estrategia: el módulo qc_ohlcv de nivel superior suele no estar definido al importar en el IDE.
• Las sugerencias aparecen automáticamente; también puedes activarlas de forma explícita con Ctrl+Espacio.

Navegar entre archivos del espacio de trabajo

• Ctrl+clic (o Cmd+clic en macOS) sobre un import o un símbolo del espacio de trabajo salta a ese archivo en el editor y coloca el cursor en la línea correspondiente.
• Cada pestaña recuerda su posición de desplazamiento y la ubicación del cursor entre visitas, así que al cambiar de archivo vuelves exactamente donde lo dejaste.

Buscar y reemplazar

Un panel de búsqueda integrado está en la parte superior del editor:

• Find — Ctrl+F (o Edit → Find).
• Replace — Ctrl+H (o Edit → Replace).
• La fila de reemplazo solo aparece cuando el archivo es editable.

Comandos de edición estándar

Todas las acciones de edición estándar están disponibles en el menú Edit de la barra de herramientas del editor y mediante atajos de teclado:

Consejo: copiar y pegar usan el portapapeles del sistema, así que puedes mover código entre QuantCraft y cualquier otra aplicación.

---

Temas

El tema de color del editor es independiente del resto de la aplicación: puedes usar la aplicación en modo oscuro y aun así tener un tema de editor claro, o al revés.

Cambiar el tema

1. Abre la barra de herramientas del editor, en la parte superior.
2. Haz clic en Theme.
3. Elige un tema de la lista. El editor se actualiza al instante.

Tu elección se guarda automáticamente y se restaura la próxima vez que abras el IDE.

Temas disponibles

El menú Theme incluye una selección de temas claros y oscuros:

• Default Light, Default Dark
• VS Code Light, VS Code Dark (VS Code Dark es el predeterminado)
• GitHub Light, GitHub Dark
• Dracula
• Monokai
• Nord
• Solarized Light, Solarized Dark
• Tokyo Night
• Gruvbox Dark
• Material Light, Material Dark

Una marca de verificación en el menú indica qué tema está activo.

---

Tamaño de fuente

Puedes elegir el tamaño de fuente del editor para adaptarlo a tu pantalla y a tu vista, sin cambiar el tamaño de las fuentes en ningún otro lugar de la aplicación.

Cambiar el tamaño de fuente

1. Abre la barra de herramientas del editor.
2. Haz clic en Font Size.
3. Elige un tamaño. El editor se vuelve a dibujar al instante con el nuevo tamaño.

Tu elección se recuerda entre sesiones.

Tamaños disponibles

11 px, 12 px, 13 px, 14 px (predeterminado), 15 px, 16 px, 18 px, 20 px, 22 px.

Una marca de verificación en el menú indica el tamaño activo.

---

Format Document

Format Document ordena todo el archivo en un solo paso: es útil antes de confirmar cambios, compartir código o simplemente para mantener legible una estrategia mientras trabajas.

Cómo ejecutarlo

• Abre el menú Edit en la barra de herramientas del editor y elige Format Document, o
• Pulsa Shift+Alt+F con el foco en el editor.

Qué hace

• En los archivos de Python, el editor da formato al código con el formateador de Python integrado de QuantCraft.
• En los archivos JSON, el editor muestra el JSON con formato legible (sangría de 2 espacios). También se reconoce el JSON delimitado por saltos de línea y cada línea se normaliza.
• Si el archivo no es Python ni JSON válido, el formateo recurre al formateador de Python para que aun así obtengas un error útil.

Dónde aparecen los errores

Si no se puede dar formato a un archivo (por ejemplo, por un error de sintaxis), el editor deja el código intacto y escribe el mensaje de error en el panel de salida, en la parte inferior del espacio de trabajo, marcado en rojo. Corrige el problema indicado y vuelve a ejecutar Format Document.

Consejos

• Format Document no guarda el archivo: solo reescribe el búfer. Usa File → Save As… si necesitas guardarlo con otro nombre.
• Deshacer (Ctrl+Z) revierte un formateo en un solo paso si no te gusta el resultado.
• El comando de formato también está integrado en el propio editor, así que el atajo Shift+Alt+F funciona tanto si estás en el menú como si estás escribiendo código.