Démarrage rapide : Clonage d’un dépôt de code Python dans Visual StudioQuickstart: clone a repository of Python code in Visual Studio

Une fois que vous avez installé la prise en charge de Python dans Visual Studio 2017, vous pouvez facilement cloner un dépôt de code Python et créer un projet à partir de celui-ci.Once you've installed Python support in Visual Studio 2017, you can easily clone a repository of Python code and create a project from it.

  1. Pour vous connecter à des dépôts GitHub, exécutez le programme d’installation de Visual Studio, sélectionnez Modifier, puis sélectionnez l’onglet Composants individuels. Faites défiler jusqu’à la section Outils de code, sélectionnez Extension GitHub pour Visual Studio, puis sélectionnez Modifier.To connect to GitHub repositories, run the Visual Studio installer, select Modify, and select the Individual components tab. Scroll down to the Code tools section, select GitHub extension for Visual Studio, and select Modify.

    Sélection de l’extension GitHub dans le programme d’installation de Visual Studio

  1. Lancez Visual Studio.Launch Visual Studio.

  2. Sélectionnez Affichage > Team Explorer pour ouvrir la fenêtre Team Explorer dans laquelle vous pouvez vous connecter à GitHub ou Visual Studio Team Services, ou bien cloner un dépôt.Select View > Team Explorer to open the Team Explorer window in which you can connect to GitHub or Visual Studio Team Services, or clone a repository. (Si la page Connecter ne s’affiche pas ci-dessous, sélectionnez l’icône de connexion sur la barre d’outils supérieure pour ouvrir cette page.)(If you don't see the Connect page shown below, select the plug icon on the top toolbar, which takes you to that page.)

    Fenêtre Team Explorer montrant Visual Studio Team Services, GitHub et le clonage d’un dépôt

  3. Sous Dépôts Git locaux, sélectionnez la commande Cloner, puis entrez https://github.com/gregmalcolm/python_koans dans le champ de l’URL, entrez un dossier pour les fichiers clonés et sélectionnez le bouton Cloner.Under Local Git Repositories, select the Clone command, then enter https://github.com/gregmalcolm/python_koans in the URL field, enter a folder for the cloned files, and select the Clone button.

    Conseil

    Le dossier que vous spécifiez dans Team Explorer est exactement le dossier qui recevra les fichiers clonés.The folder you specify in Team Explorer is the exact folder to receive the cloned files. Contrairement à la commande git clone, la création d’un clone dans Team Explorer ne crée pas automatiquement un sous-dossier avec le nom du dépôt.Unlike the git clone command, creating a clone in Team Explorer does not automatically create a subfolder with the name of the repository.

  4. Lorsque le clonage est terminé, le nom du référentiel s’affiche dans la liste référentiels Git locaux.When cloning is complete, the repository name appears in the Local Git Repositories list. Double-cliquez sur ce nom pour accéder au tableau de bord du référentiel dans Team Explorer.Double-click that name to navigate to the repository dashboard in Team Explorer.

  5. Sous Solutions, sélectionnez Nouveau.Under Solutions, select New.

    Fenêtre Team Explorer, création d’un projet à partir d’un clone

  6. Dans la boîte de dialogue Nouveau projet qui s’affiche, accédez au langage Python (ou cherchez sur « Python »), sélectionnez « À partir de code Python existant », spécifiez un nom pour le projet, définissez Emplacement sur le même dossier que le dépôt, puis sélectionnez OK.In the New Project dialog that appears, navigate to the Python language (or search on "Python"), select "From Existing Python Code", specify a name for the project, set Location to the same folder as the repository, and select OK. Dans l’Assistant qui apparaît, sélectionnez Terminer.In the wizard that appears, select Finish.

  7. Sélectionnez Affichage > Explorateur de solutions dans le menu.Select View > Solution Explorer from the menu.

  8. Dans l’Explorateur de solutions, développez le nœud python3, cliquez avec le bouton droit surcontemplate_koans.py, puis sélectionnez Définir comme fichier de démarrage.In Solution Explorer, expand the python3 node, right-click contemplate_koans.py, and select Set as Startup File. Cette étape indique à Visual Studio quel fichier utiliser quand vous exécutez le projet.This step tells Visual Studio which file it should use when running the project.

  9. Sélectionnez Projet > Propriétés Koans dans le menu, sélectionnez l’onglet Général, puis affectez la valeur « python3 » à Répertoire de travail.Select Project > Koans Properties from the menu, select the General tab, and set Working Directory to "python3". Cette étape est nécessaire; car par défaut, Visual Studio définit le répertoire de travail sur la racine du projet et non pas sur l’emplacement du fichier de démarrage (python3\contemplate_koans.py, que vous pouvez également voir dans les propriétés du projet).This step is necessary because by default Visual Studio sets the working directory to the project root rather than the location of the startup file (python3\contemplate_koans.py, which you can see in the project properties as well). Le code du programme recherche un fichier koans.txt dans le dossier de travail. Par conséquent, si vous ne changez pas cette valeur, vous recevrez une erreur à l’exécution.The program code looks for a file koans.txt in the working folder, so without changing this value you see a runtime error.

    Définition du répertoire de travail pour un projet Python

  10. Appuyez sur Ctrl+F5 ou sélectionnez Déboguer > Démarrer sans débogage pour exécuter le programme.Press Ctrl+F5 or select Debug > Start Without Debugging to run the program. Si vous voyez un message FileNotFoundError pour koans.txt, vérifiez le paramètre du répertoire de travail conformément à la description de l’étape précédente.If you see a FileNotFoundError for koans.txt, check the working directory setting as described in the previous step.

  11. Quand le programme s’exécute avec succès, une erreur d’assertion s’affiche sur la ligne 17 de python3/koans/about_asserts.py.When the program runs successfully, it displays an assertion error on line 17 of python3/koans/about_asserts.py. Ceci est intentionnel : le programme est conçu pour vous apprendre Python en vous demandant de corriger toutes les erreurs intentionnelles.This is intentional: the program is designed to teach Python by having you correct all the intentional errors. (Vous pouvez trouver plus d’informations sur Ruby Koans, qui a inspiré Python Koans.)(More details are found on Ruby Koans, which inspired Python Koans.)

    Première sortie du programme koans Python

  12. Ouvrez python3/koans/about_asserts.py en y accédant dans l’Explorateur de solutions, puis en double-cliquant sur le fichier.Open python3/koans/about_asserts.py by navigating to it in Solution Explorer and double-clicking the file. Notez que par défaut, les numéros de ligne n’apparaissent pas dans l’éditeur.Notice that line numbers do not appear by default in the editor. Pour changer cela, sélectionnez Outils > Options, sélectionnez Afficher tous les paramètres dans le bas de la boîte de dialogue, puis accédez à Éditeur de texte > Python > Général et sélectionnez Numéros de ligne :To change this, select Tools > Options, select Show all settings at the bottom of the dialog, then navigate to Text Editor > Python > General and select Line numbers:

    Activation des numéros de ligne pour les fichiers Python

  13. Corrigez l’erreur en changeant l’argument False sur la ligne 17 en True.Correct the error by changing the False argument on line 17 to True. La ligne doit se présenter comme suit :The line should read as follows:

    self.assertTrue(True) # This should be True
    
  14. Réexécutez le programme.Run the program again. Si Visual Studio vous avertit qu’il y a des erreurs, répondez Oui pour continuer l’exécution du code.If Visual Studio warns you about errors, respond with Yes to continue running the code. Vous verrez alors que la première vérification réussit et que le programme s’arrête sur le koan suivant.You then see that the first check passes and the program stops on the next koan. Continuez à corriger les erreurs et le programme comme vous le souhaitez.Continue correcting the errors and the program again as you want.

Important

Dans ce démarrage rapide, vous avez créé un clone direct du référentiel python_koans sur GitHub.In this Quickstart, you created a direct clone of the python_koans repository on GitHub. Un dépôt de ce type est protégé par son auteur des modifications directes : par conséquent, la tentative de validation des modifications dans le dépôt échoue.Such a repository is protected by its author from direct changes, so attempting to commit changes to the repository fails. Dans la pratique, les développeurs dupliquent (fork) ce type de dépôt dans leur propre compte GitHub, y apportent leurs modifications, puis créent des demandes de tirage (pull) pour envoyer ces modifications dans le dépôt d’origine.In practice, developers instead fork such a repository to their own GitHub account, make changes there, and then create pull requests to submit those changes to the original repository. Lorsque vous avez votre propre duplication, utilisez son URL au lieu de l’URL du référentiel d’origine préalablement utilisé.When you have your own fork, use its URL instead of the original repository URL used earlier.

Étapes suivantesNext steps

Voir aussiSee also