PáginasPossíveis erros · 29 / 29
Possíveis erros e correções
Erros comuns que você pode encontrar no IDE do QuantCraft e como resolvê-los. Esta página crescerá à medida que mais problemas forem documentados. Para a instalação de pacotes em geral, veja Dependências.
Índice de erros
- Instalação de pacote: “a file it ships is in use”
- Instalação de pacote: “pip metadata is missing” / “broken install”
- Backtest: “User script must define callable: …”
- Backtest: “No bars in the selected date range after warmup filter …”
- Backtest: “A screener symbol source needs an explicit start and end date …”
- Debug Test: “Debug test doesn't support a Screener symbol source …”
Instalação de pacote: “a file it ships is in use”
O que você verá
A instalação de um pacote pelo IDE Packages falha com:
Package install failed (polars): Could not install 'polars' — a file it ships is in use
(a compiled extension like this is loaded by the editor's background workers, so pip
can't replace it). Quit QuantCraft to release the file, reopen it, and install again.
Pinning an exact version that is already installed avoids the overwrite.Por baixo, o pip encontrou [WinError 5] Access is denied no Windows (ou [Errno 13] Permission denied no macOS / Linux) em uma extensão compilada — um arquivo .pyd, .so ou .dll, como _polars_runtime.pyd, dentro do ambiente Python do IDE.
Por que isso acontece
Alguns pacotes (polars, numpy, pyarrow e outras bibliotecas nativas) trazem uma extensão compilada que é carregada na memória quando o pacote é importado. Os processos em segundo plano do IDE importam os pacotes instalados para alimentar o autocompletar e a análise, o que carrega esse arquivo. Um arquivo que está carregado no momento não pode ser sobrescrito; portanto, quando o pip tenta substituí-lo durante uma instalação ou atualização, o sistema operacional bloqueia.
É por isso que você pode ver isso ao instalar a versão mais recente (o pip precisa sobrescrever o arquivo carregado), mas não ao fixar uma versão já instalada (o pip não vê nada para alterar e ignora o arquivo por completo).
Como corrigir
- Feche o QuantCraft por completo — isso encerra os processos Python em segundo plano que mantêm o arquivo aberto.
- Abra o QuantCraft novamente.
- Instale o pacote de novo, de preferência antes de abrir ou executar um script que o importe.
Dicas:
- Se o pacote já está instalado e funcionando, muitas vezes você nem precisa reinstalá-lo.
- Fixar uma versão exata já instalada (por exemplo,
polars==1.41.2) evita a sobrescrita e funciona sem reiniciar.
Instalação de pacote: “pip metadata is missing” / “broken install”
O que você verá
Could not install 'somepkg' (pip metadata is missing). Try installing again to force a
clean copy, or quit QuantCraft, delete the ide-venv folder, and restart the app.ou Could not install 'somepkg' (broken install).
Por que isso acontece
Uma instalação ou desinstalação anterior foi interrompida e deixou o pacote parcialmente instalado, então o pip não encontra o registro de quais arquivos pertencem a ele.
Como corrigir
- Instale o pacote novamente pelo IDE Packages — isso normalmente força uma cópia limpa.
- Se ainda falhar, feche o QuantCraft, exclua a pasta
ide-venvmostrada na mensagem e reinicie. O aplicativo recria o ambiente; depois, reinstale os pacotes extras.
Backtest: “User script must define callable: …”
O arquivo da estratégia não tem um dos callbacks obrigatórios — on_init, on_bar, on_tick ou on_finish — ou ele não é uma função. O botão Test só verifica on_init / on_bar / on_finish, então a causa habitual é a ausência de on_tick. Adicione isto se não precisar dele:
def on_tick(bar_index, tick_in_bar, price, bar, symbol=None):
passVeja Ciclo de vida da estratégia.
Backtest: “No bars in the selected date range after warmup filter …”
As suas datas de início / fim não contêm velas para o símbolo de relógio — por exemplo, um intervalo apenas de fim de semana, datas anteriores ao início da negociação do símbolo ou um intervalo além dos dados disponíveis. Amplie as datas ou verifique o símbolo. Um feed do QuantCraft (B2) pode, em vez disso, mostrar No AAPL bars (d) between … Available range is … to …, que indica o intervalo válido. Veja Dados OHLCV e de barras.
Backtest: “A screener symbol source needs an explicit start and end date …”
Um backtest cuja Symbol source é Screener resolve o cronograma de rebalanceamento a partir do intervalo de datas antes de carregar qualquer barra, portanto as duas datas são obrigatórias. Defina Start e End na aba Simulation. Veja Screener.
Debug Test: “Debug test doesn't support a Screener symbol source …”
O Debug Test executa uma lista fixa de símbolos. Mude Symbol source para Selected symbols, escolha um ou dois dos tickers retornados pelo seu filtro e depure com eles. Veja Depuração.