PagesErreurs possibles · 29 / 29
Erreurs possibles et solutions
Erreurs courantes que vous pouvez rencontrer dans l'IDE QuantCraft et comment les résoudre. Cette page s'enrichira à mesure que d'autres problèmes seront documentés. Pour l'installation de paquets en général, voir Dépendances.
Index des erreurs
- Installation de paquet : « a file it ships is in use »
- Installation de paquet : « 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 … »
Installation de paquet : « a file it ships is in use »
Ce que vous voyez
L'installation d'un paquet depuis IDE Packages échoue avec :
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.En dessous, pip a rencontré [WinError 5] Access is denied sous Windows (ou [Errno 13] Permission denied sous macOS / Linux) sur une extension compilée — un fichier .pyd, .so ou .dll tel que _polars_runtime.pyd dans l'environnement Python de l'IDE.
Pourquoi cela arrive
Certains paquets (polars, numpy, pyarrow et d'autres bibliothèques natives) embarquent une extension compilée chargée en mémoire lors de l'import du paquet. Les processus d'arrière-plan de l'IDE importent vos paquets installés pour alimenter la saisie semi-automatique et l'analyse, ce qui charge ce fichier. Un fichier actuellement chargé ne peut pas être écrasé : lorsque pip tente de le remplacer pendant une installation ou une mise à niveau, le système d'exploitation l'en empêche.
C'est pourquoi vous pouvez le voir en installant la dernière version (pip doit écraser le fichier chargé) mais pas en épinglant une version déjà installée (pip ne voit rien à changer et ignore complètement le fichier).
Comment le corriger
- Quittez complètement QuantCraft — cela met fin aux processus Python d'arrière-plan qui maintiennent le fichier ouvert.
- Rouvrez QuantCraft.
- Installez de nouveau le paquet, idéalement avant d'ouvrir ou d'exécuter un script qui l'importe.
Conseils :
- Si le paquet est déjà installé et fonctionne, vous n'avez souvent pas besoin de le réinstaller.
- Épingler une version exacte déjà installée (par ex.
polars==1.41.2) évite l'écrasement et réussit sans redémarrage.
Installation de paquet : « pip metadata is missing » / « broken install »
Ce que vous voyez
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).
Pourquoi cela arrive
Une installation ou une désinstallation précédente a été interrompue et a laissé le paquet à moitié installé ; pip ne retrouve donc pas l'enregistrement des fichiers qui lui appartiennent.
Comment le corriger
- Installez de nouveau le paquet depuis IDE Packages — cela force généralement une copie propre.
- Si cela échoue encore, quittez QuantCraft, supprimez le dossier
ide-venvindiqué dans le message, puis redémarrez. L'application recrée l'environnement ; réinstallez ensuite vos paquets supplémentaires.
Backtest : « User script must define callable: … »
Il manque au fichier de stratégie l'un des rappels requis — on_init, on_bar, on_tick ou on_finish — ou ce n'est pas une fonction. Le bouton Test ne vérifie que on_init / on_bar / on_finish ; un on_tick manquant est donc la cause habituelle. Ajoutez ceci si vous n'en avez pas besoin :
def on_tick(bar_index, tick_in_bar, price, bar, symbol=None):
passVoir Cycle de vie d'une stratégie.
Backtest : « No bars in the selected date range after warmup filter … »
Vos dates de début / de fin ne contiennent aucune bougie pour le symbole d'horloge — par exemple une plage ne couvrant qu'un week-end, des dates antérieures au début de la cotation du symbole, ou une plage au-delà des données disponibles. Élargissez les dates ou vérifiez le symbole. Un flux QuantCraft (B2) peut plutôt indiquer No AAPL bars (d) between … Available range is … to …, ce qui vous donne la plage valide. Voir Données OHLCV et de barres.
Backtest : « A screener symbol source needs an explicit start and end date … »
Un backtest dont la Symbol source est Screener détermine son calendrier de rééquilibrage à partir de la plage de dates avant le chargement des barres ; les deux dates sont donc obligatoires. Définissez Start et End dans l'onglet Simulation. Voir Screener.
Debug Test : « Debug test doesn't support a Screener symbol source … »
Debug Test exécute une liste fixe de symboles. Passez Symbol source à Selected symbols, choisissez un ou deux des symboles renvoyés par votre filtre, et déboguez avec ceux-ci. Voir Débogage.