Assistance Coflow
Coflow est développé et maintenu par une seule personne. Le plus rapide pour obtenir de l’aide : un e-mail avec les informations ci-dessous.
Contact
candidathector@gmail.com — objet « Coflow support » ; le bouton ci-dessus remplit aussi un modèle de rapport de bug
Les messages sont lus et traités par le développeur qui a écrit le code.
Que mettre dans un rapport de bug
Avec ces informations, la plupart des problèmes se reproduisent et se corrigent sans allers-retours.
- Votre version de VS Code : Aide › À propos (sur macOS : Code › À propos de Visual Studio Code).
- Votre version de Coflow : dans la vue Extensions, à côté du nom.
- Le journal Coflow : ouvrez le panneau Sortie (
Ctrl+Shift+U) et choisissez Coflow dans sa liste, ou lancez la commande Coflow: Show Log. Copiez les lignes autour de l’erreur. - Votre système d’exploitation et votre version de Python (
python --versiondans l’interpréteur utilisé par Coflow). - Ce que vous avez fait et ce que vous attendiez. Une capture de la carte aide. Si possible, un petit projet ou fichier qui montre le problème.
N’envoyez pas de code que vous n’avez pas le droit de partager. Un petit exemple inventé qui reproduit le problème est tout aussi utile.
Dépannage
« Interpréteur Python introuvable », ou la carte indique que l’analyse a échoué
Coflow a besoin de Python 3.10 ou plus récent. Il utilise l’interpréteur choisi dans l’extension Python, sinon python3. Choisissez-en un avec Python: Select Interpreter, ou indiquez le chemin complet dans le réglage coflow.pythonPath (par exemple /usr/bin/python3 ou C:\Python312\python.exe). Le message d’erreur propose les boutons Select Interpreter et Set Python Path, et Show Log indique quel interpréteur a été essayé.
Coflow est désactivé, ou la carte ne s’ouvre pas (mode restreint)
Coflow lance votre interpréteur Python, et Record a Run… exécute votre code : il ne fonctionne donc que dans un dossier approuvé. Lancez Workspaces: Manage Workspace Trust, faites confiance au dossier, puis rouvrez la carte. Les espaces de travail virtuels (fichiers qui ne sont pas sur le disque) ne sont pas pris en charge.
La carte est vide
Coflow cartographie des projets Python. Ouvrez le dossier qui contient votre code (pas un fichier seul), et vérifiez que coflow.exclude ne l’exclut pas. Les environnements virtuels, node_modules, les dossiers de build et les caches sont toujours exclus.
Un gros projet est lent, ou l’analyse s’arrête
Une analyse s’arrête au bout de deux minutes. Excluez les dossiers inutiles avec coflow.exclude (comme legacy/** ou du code généré), et désactivez coflow.analyzeOnSave pour ne rafraîchir qu’à la demande (Coflow: Refresh Map). Les niveaux larges sont affichés à une taille lisible : déplacez-vous, ou utilisez Search map pour sauter.
Un lien attendu manque, ou est en pointillés
Les appels via getattr, l’injection de dépendances ou des dictionnaires de handlers ne peuvent pas toujours être prouvés en lisant le code ; ces liens sont en pointillés ou absents. Enregistrez une exécution pour voir exactement ce qui s’est passé.
Quelque chose est masqué sur la carte
Ouvrez View Options (⋯ sur la carte) : chaque option indique combien d’éléments elle masque, et la carte affiche « N hidden here ». Reset View Options revient aux valeurs par défaut.
Plus d’aide
- Les questions courantes (confidentialité, langages, licence) ont leur réponse sur la page Coflow.
- Ce que Coflow fait de votre code : la déclaration de confidentialité.
- Journal des modifications