Informations de référence sur les onglets de fenêtre Environnements Python dans Python Tools pour Visual Studio
Pour ouvrir la fenêtre Environnements Python :
- Sélectionnez la commande de menu Affichage>Autres fenêtres>Environnements Python.
- Cliquez avec le bouton droit sur le nœud Environnements Python d’un projet dans l’Explorateur de solutions, puis sélectionnez Afficher tous les environnements Python.
Si vous agrandissez suffisamment la fenêtre Environnements Python, ces options s’affichent sous forme d’onglets, sans doute plus pratiques à utiliser. Dans un souci de clarté, les onglets de cet article apparaissent dans l’affichage développé.
Onglet : Aperçu
Fournit des commandes et des informations de base pour l’environnement :
| Commande | Description |
|---|---|
| Make this environment the default for new projects (Définir cet environnement par défaut pour les nouveaux projets) | Définit l’environnement actif, ce qui risque d’interrompre brièvement le fonctionnement de Visual Studio (2017 version 15.5 et antérieure) pendant le chargement de la base de données IntelliSense. Les environnements avec de nombreux packages peuvent être interrompus pendant plus longtemps. |
| Visit the distributor’s website (Visiter le site web du serveur de distribution) | Dans un navigateur, ouvre l’URL fournie par la distribution Python. Python 3.x, par exemple, accède à python.org. |
| Ouvrir une fenêtre interactive | Ouvre la fenêtre (REPL) interactive pour cet environnement au sein de Visual Studio, en appliquant tous les scripts de démarrage (voir ci-dessous). |
| Explorer les scripts interactifs | Consultez Scripts de démarrage. |
| Utiliser le mode interactif IPython | Quand cette option est définie, ouvre la fenêtre Interactive avec IPython par défaut. Cela permet d’activer les tracés inline, ainsi que la syntaxe IPython étendue telle que name?pour afficher l’aide, et !command pour les commandes de l’interpréteur de commandes. Cette option est recommandée lors de l’utilisation d’une distribution Anaconda, car elle nécessite des packages supplémentaires. Pour plus d’informations, consultez Utiliser IPython dans la fenêtre interactive. |
| Ouvrir dans PowerShell | Démarre l’interpréteur dans une fenêtre Commande PowerShell. |
| (Liens du dossier et du programme) | Vous fournissent un accès rapide au dossier d’installation de l’environnement, à l’interpréteur python.exe et à l’interpréteur pythonw.exe. Le premier s’ouvre dans l’Explorateur Windows et les deux autres ouvrent une fenêtre de console. |
Scripts de démarrage
Quand vous utilisez des fenêtres interactives dans votre flux de travail quotidien, vous développez probablement des fonctions d’assistance que vous utilisez régulièrement. Par exemple, vous pouvez créer une fonction qui ouvre un DataFrame dans Excel, puis vous pouvez enregistrer ce code en tant que script de démarrage pour qu’il soit toujours disponible dans la fenêtre Interactive.
Les scripts de démarrage contiennent du code que la fenêtre Interactive charge et exécute automatiquement, notamment les importations, les définitions de fonctions et, littéralement, tout autre élément. Ces scripts sont référencés de deux manières :
Quand vous installez un environnement, Visual Studio crée un dossier Documents\Visual Studio <version>\Python Scripts<environnement>, où <version> correspond à la version de Visual Studio (par exemple, 2017 ou 2019) et <environnement> au nom de l’environnement. Vous pouvez facilement accéder au dossier spécifique à l’environnement avec la commande Explorer les scripts interactifs. Quand vous démarrez la fenêtre Interactive pour cet environnement, elle charge et exécute tous les fichiers .py qui s’y trouvent dans l’ordre alphabétique.
Le contrôle Scripts sous l’onglet Outils>Options>Python>Fenêtres interactives (consultez Options des fenêtres interactives) est destiné à spécifier un dossier supplémentaire pour les scripts de démarrage qui sont chargés et exécutés dans tous les environnements. Toutefois, cette fonctionnalité ne fonctionne pas actuellement.
Onglet Configurer
S’il est disponible, l’onglet Configure contient les informations décrites dans le tableau ci-dessous. Si cet onglet n’est pas affiché, cela signifie que Visual Studio gère automatiquement toutes les informations.
| Champ | Description |
|---|---|
| Description | Le nom à donner à l’environnement. |
| Chemin de préfixe | L’emplacement du dossier de base de l’interpréteur. En indiquant cette valeur et en cliquant sur Détecter automatiquement, Visual Studio tente de renseigner les autres champs pour vous. |
| Chemin de l’interpréteur | Chemin de l’exécutable de l’interpréteur. En règle générale, il s’agit du chemin de préfixe suivi de python.exe |
| Interpréteur en mode fenêtre | Chemin de l’exécutable qui n’est pas celui de la console. Bien souvent, il s’agit du chemin de préfixe suivi de pythonw.exe. |
| Chemin d’accès à la bibliothèque (s’il est disponible) |
Spécifie la racine de la bibliothèque standard, mais cette valeur peut être ignorée si Visual Studio est en mesure de demander un chemin d’accès plus précis à partir de l’interpréteur. |
| Version du langage | Sélectionnée à partir du menu déroulant. |
| Architecture | Normalement détectée et renseignée automatiquement, sinon 32 bits ou 64 bits est spécifié. |
| Path environment variable (Variable d’environnement de chemin d’accès) | La variable d’environnement que l’interpréteur utilise pour rechercher les chemins de recherche. Visual Studio modifie la valeur de la variable lors du démarrage de Python pour qu’il contienne les chemins de recherche du projet. En général, cette propriété doit avoir la valeur PYTHONPATH, mais certains interpréteurs utilisent une autre valeur. |
Onglet packages
Également appelé « pip » dans les versions antérieures.
Gère les packages installés dans l’environnement à l’aide de pip (l’onglet Packages (PyPI)) ou de conda (l’onglet Packages (Conda), pour les environnements conda dans Visual Studio 2017 version 15.7 et ultérieure). Dans cet onglet, vous pouvez également rechercher et installer de nouveaux packages, y compris leurs dépendances.
Les packages qui sont déjà installés apparaissent avec des contrôles pour mettre à jour (flèche vers le haut) et désinstaller (X dans un cercle) le package :
La saisie d’un terme de recherche filtre la liste des packages installés, ainsi que des packages qui peuvent être installés à partir de PyPI.
Comme vous pouvez le voir dans l’image ci-dessus, les résultats de la recherche affichent plusieurs packages qui correspondent au terme de recherche. Toutefois, la première entrée de la liste est une commande qui permet d’exécuter pip install <nom> directement. Si vous êtes sous l’onglet Packages (Conda), vous voyez plutôt conda install <nom> :
Dans les deux cas, vous pouvez personnaliser l’installation en ajoutant des arguments dans la zone de recherche après le nom du package. Quand vous incluez des arguments, les résultats de la recherche affichent pip install ou conda install suivi du contenu de la zone de recherche :
L’installation d’un package crée des sous-dossiers dans le dossier Lib de l’environnement sur le système de fichiers. Par exemple, si Python 3.6 est installé dans c:\Python36, les packages sont installés dans c:\Python36\Lib. Si Anaconda3 est installé dans c:\Program Files\Anaconda3, les packages sont installés dans c:\Program Files\Anaconda3\Lib. Pour les environnements conda, les packages sont installés dans le dossier de cet environnement.
Octroyer des privilèges d’administrateur pour l’installation des packages
Au moment d’installer des packages dans un environnement situé dans une zone protégée du système de fichiers, par exemple c:\Program Files\Anaconda3\Lib, Visual Studio doit exécuter pip install avec une élévation de privilèges pour lui permettre de créer des sous-dossiers de package. Quand une élévation est nécessaire, Visual Studio affiche l’invite Des privilèges d’administrateur peuvent être nécessaires pour installer, mettre à jour ou supprimer des packages pour cet environnement :
Élever les privilèges maintenant accorde des privilèges d’administrateur à pip pour une seule opération, pouvant aussi faire l’objet d’une demande d’autorisations du système d’exploitation. Quand vous sélectionnez Continuer sans privilège d’administrateur, une tentative d’installation du package a lieu, mais pip ne parvient pas à créer de dossiers, et une sortie telle que Erreur : impossible de créer « C:\Program Files\Anaconda3\Lib\site-packages\png.py » : Autorisation refusée s’affiche.
En sélectionnant Toujours élever les privilèges pour l’installation et la suppression des packages, vous empêchez la boîte de dialogue de s’afficher pour l’environnement en question. Pour que la boîte de dialogue s’affiche à nouveau, accédez à Outils>Options>Python>Général, puis sélectionnez le bouton Réinitialiser toutes les boîtes de dialogue masquées définitivement.
Sous ce même onglet Options, vous pouvez également sélectionner Toujours exécuter pip comme administrateur afin de supprimer la boîte de dialogue pour tous les environnements. Consultez Options - Onglet Général.
Restrictions de sécurité avec les versions antérieures de Python
Quand Python 2.6, 3.1 et 3.2 sont utilisés, Visual Studio affiche un avertissement signalant qu’en raison des restrictions de sécurité, l’installation à partir d’Internet est susceptible de ne pas fonctionner sur cette version de Python :
La raison de cet avertissement est que dans les versions plus anciennes de Python, pip install ne contient pas la prise en charge de la couche de sécurité du transport (TLS) 1.2, qui est nécessaire pour télécharger des packages à partir de la source de packages, pypi.org. Les builds Python personnalisés peuvent prendre en charge TLS 1.2, auquel cas pip install pourrait fonctionner.
Il est possible de télécharger le get-pip.py approprié pour un package à partir de bootstrap.pypa.io, de télécharger manuellement un package à partir de pypi.org, puis d’installer le package à partir de cette copie locale.
La recommandation, toutefois, consiste à simplement passer à une version récente de Python, auquel cas l’avertissement n’apparaît pas.