PáginasPosibles errores · 29 / 29
Posibles errores y soluciones
Errores habituales que puedes encontrar en el IDE de QuantCraft y cómo resolverlos. Esta página irá creciendo a medida que se documenten más problemas. Para la instalación de paquetes en general, consulta Dependencias.
Índice de errores
- Instalación de paquetes: «a file it ships is in use»
- Instalación de paquetes: «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 …»
Instalación de paquetes: «a file it ships is in use»
Lo que verás
La instalación de un paquete desde IDE Packages falla con:
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 debajo, pip encontró [WinError 5] Access is denied en Windows (o [Errno 13] Permission denied en macOS / Linux) sobre una extensión compilada: un archivo .pyd, .so o .dll como _polars_runtime.pyd dentro del entorno de Python del IDE.
Por qué ocurre
Algunos paquetes (polars, numpy, pyarrow y otras bibliotecas nativas) incluyen una extensión compilada que se carga en memoria cuando se importa el paquete. Los procesos en segundo plano del IDE importan tus paquetes instalados para alimentar el autocompletado y el análisis, y eso carga ese archivo. Un archivo que está cargado en ese momento no se puede sobrescribir, así que cuando pip intenta reemplazarlo durante una instalación o actualización, el sistema operativo lo bloquea.
Por eso puede aparecer al instalar la última versión (pip tiene que sobrescribir el archivo cargado) pero no al fijar una versión ya instalada (pip no ve nada que cambiar y omite el archivo por completo).
Cómo solucionarlo
- Cierra QuantCraft por completo: esto termina los procesos de Python en segundo plano que mantienen el archivo abierto.
- Vuelve a abrir QuantCraft.
- Instala el paquete de nuevo, idealmente antes de abrir o ejecutar un script que lo importe.
Consejos:
- Si el paquete ya está instalado y funciona, a menudo no necesitas reinstalarlo.
- Fijar una versión exacta ya instalada (p. ej.
polars==1.41.2) evita la sobrescritura y tendrá éxito sin reiniciar.
Instalación de paquetes: «pip metadata is missing» / «broken install»
Lo que verás
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.o Could not install 'somepkg' (broken install).
Por qué ocurre
Una instalación o desinstalación anterior se interrumpió y dejó el paquete a medio instalar, por lo que pip no encuentra el registro de los archivos que le pertenecen.
Cómo solucionarlo
- Instala el paquete de nuevo desde IDE Packages: normalmente esto fuerza una copia limpia.
- Si sigue fallando, cierra QuantCraft, elimina la carpeta
ide-venvque indica el mensaje y reinicia. La aplicación recrea el entorno; reinstala después tus paquetes adicionales.
Backtest: «User script must define callable: …»
Al archivo de la estrategia le falta uno de los callbacks requeridos (on_init, on_bar, on_tick u on_finish) o no es una función. El botón Test solo comprueba on_init / on_bar / on_finish, así que la causa habitual es que falte on_tick. Añade esto si no lo necesitas:
def on_tick(bar_index, tick_in_bar, price, bar, symbol=None):
passConsulta Ciclo de vida de la estrategia.
Backtest: «No bars in the selected date range after warmup filter …»
Tus fechas de inicio / fin no contienen velas para el símbolo de reloj: por ejemplo, un rango que solo abarca un fin de semana, fechas anteriores a que el símbolo empezara a cotizar o un rango más allá de los datos disponibles. Amplía las fechas o revisa el símbolo. Un feed de QuantCraft (B2) puede en cambio decir No AAPL bars (d) between … Available range is … to …, lo que te indica el rango válido. Consulta Datos OHLCV y de barras.
Backtest: «A screener symbol source needs an explicit start and end date …»
Un backtest cuya Symbol source es Screener resuelve su calendario de reequilibrio a partir del rango de fechas antes de cargar ninguna barra, por lo que se requieren ambas fechas. Establece Start y End en la pestaña Simulation. Consulta Screener.
Debug Test: «Debug test doesn't support a Screener symbol source …»
Debug Test ejecuta una lista fija de símbolos. Cambia Symbol source a Selected symbols, elige uno o dos de los tickers que devuelve tu filtro y depura con ellos. Consulta Depuración.