Editor Python

O editor Python é o coração do IDE do QuantCraft (Layout do espaço de trabalho). Ele abre sempre que você seleciona um arquivo na Files Sidebar ou abre uma aba na faixa do editor, e oferece uma experiência de programação completa e moderna, ajustada para escrever estratégias de trading em Python. Gerencie bibliotecas em Packages (Dependências); execute o código com Run / Test (Execução de código).

Esta página cobre as quatro áreas que você mais usará:

• Edição
• Temas
• Tamanho da fonte
• Format Document

---

Edição

Quando há um arquivo aberto, o editor preenche o centro do IDE Main Panel e se comporta como os editores Python aos quais você já está acostumado.

Escrevendo código

• Realce de sintaxe para Python, com cores definidas pelo tema do editor que você escolher.
• Indentação inteligente — pressionar Enter no fim de uma linha indenta corretamente a próxima para Python (após def, class, if, for, with etc.).
• Quebra de linha — linhas longas são quebradas visualmente para que você não precise rolar na horizontal. O conteúdo real não muda.
• O corretor ortográfico fica desativado no editor, para que identificadores e palavras-chave não sejam sublinhados.
• A tecla Tab insere 4 espaços.

Autocompletar

O editor oferece sugestões sensíveis ao contexto enquanto você digita:

• Snippets para padrões comuns de Python: def, class, for, while, try, with, lambda, import, from, ifmain etc.
• Biblioteca padrão e pacotes instalados — digitar import ou from sugere módulos do ambiente Python do IDE, além das suas próprias pastas e arquivos do espaço de trabalho.
• Preenchimento de membros — digitar . após um módulo, pacote ou objeto conhecido do QuantCraft (por exemplo bar., fundamentals., pd.) lista os atributos e métodos disponíveis. Prefira bar. e fundamentals. nos callbacks da estratégia — o módulo de nível superior qc_ohlcv costuma estar indefinido no momento da importação no IDE.
• As sugestões aparecem automaticamente; você também pode acioná-las explicitamente com Ctrl+Espaço.

Navegando entre arquivos do espaço de trabalho

• Ctrl+clique (ou Cmd+clique no macOS) em um import ou em um símbolo do espaço de trabalho salta para esse arquivo no editor e posiciona o cursor na linha correspondente.
• Cada aba lembra a própria posição de rolagem e a localização do cursor entre as visitas, então trocar de arquivo sempre leva você exatamente de volta ao ponto em que parou.

Localizar e substituir

Um painel de pesquisa integrado fica no topo do editor:

• Find — Ctrl+F (ou Edit → Find).
• Replace — Ctrl+H (ou Edit → Replace).
• A linha de substituição só aparece quando o arquivo é editável.

Comandos de edição padrão

Todas as ações de edição padrão estão disponíveis no menu Edit da barra de ferramentas do editor e por atalhos de teclado:

Dica: copiar e colar usam a área de transferência do sistema, então você pode mover código entre o QuantCraft e qualquer outro aplicativo.

---

Temas

O tema de cores do editor é independente do restante do aplicativo — você pode usar o aplicativo no modo escuro e ainda assim ter um tema de editor claro, ou o contrário.

Alterando o tema

1. Abra a barra de ferramentas do editor, no topo do editor.
2. Clique em Theme.
3. Escolha um tema na lista. O editor é atualizado imediatamente.

A sua escolha é salva automaticamente e restaurada na próxima vez que você abrir o IDE.

Temas disponíveis

O menu Theme inclui uma seleção de temas claros e escuros:

• Default Light, Default Dark
• VS Code Light, VS Code Dark (VS Code Dark é o padrão)
• GitHub Light, GitHub Dark
• Dracula
• Monokai
• Nord
• Solarized Light, Solarized Dark
• Tokyo Night
• Gruvbox Dark
• Material Light, Material Dark

Uma marca de seleção no menu mostra qual tema está ativo.

---

Tamanho da fonte

Você pode escolher o tamanho da fonte do editor para combinar com a sua tela e a sua visão — sem alterar o tamanho das fontes no restante do aplicativo.

Alterando o tamanho da fonte

1. Abra a barra de ferramentas do editor.
2. Clique em Font Size.
3. Escolha um tamanho. O editor é redesenhado imediatamente no novo tamanho.

A sua escolha é lembrada entre as sessões.

Tamanhos disponíveis

11 px, 12 px, 13 px, 14 px (padrão), 15 px, 16 px, 18 px, 20 px, 22 px.

Uma marca de seleção no menu mostra o tamanho ativo.

---

Format Document

O Format Document arruma o arquivo inteiro em uma única etapa — útil antes de confirmar alterações, compartilhar código ou apenas para manter a estratégia legível enquanto você trabalha.

Como executar

• Abra o menu Edit na barra de ferramentas do editor e escolha Format Document, ou
• Pressione Shift+Alt+F com o editor em foco.

O que ele faz

• Em arquivos Python, o editor formata o código usando o formatador Python integrado do QuantCraft.
• Em arquivos JSON, o editor formata o JSON de forma legível (indentação de 2 espaços). JSON delimitado por quebras de linha também é reconhecido, e cada linha é normalizada.
• Se o arquivo não for Python nem JSON válido, a formatação recorre ao formatador Python para que você ainda receba um erro útil.

Onde os erros aparecem

Se não for possível formatar um arquivo (por exemplo, por causa de um erro de sintaxe), o editor deixa o código intacto e escreve a mensagem de erro no painel de saída, na parte inferior do espaço de trabalho, marcada em vermelho. Corrija o problema informado e execute o Format Document novamente.

Dicas

• O Format Document não salva o arquivo — ele apenas reescreve o buffer. Use File → Save As… se precisar salvar com outro nome.
• Desfazer (Ctrl+Z) reverte a formatação em uma única etapa caso você não goste do resultado.
• O comando de formatação também está integrado ao próprio editor, então o atalho Shift+Alt+F funciona tanto no menu quanto enquanto você digita no código.