Inició rápido: Clonado de un repositorio de código Python en Visual StudioQuickstart: Clone a repository of Python code in Visual Studio

Cuando haya instalado compatibilidad de Python en Visual Studio 2017, puede agregar la extensión de GitHub para Visual Studio.Once you've installed Python support in Visual Studio 2017, you can add the GitHub Extension for Visual Studio. La extensión le permite clonar fácilmente un repositorio de código de Python y crear un proyecto a partir de allí desde el IDE.The extension lets you easily clone a repository of Python code and create a project from it from within the IDE. Siempre puede clonar repositorios en la línea de comandos y después trabajar con ellos en Visual Studio.You can always clone repositories on the command line as well, and then work with them in Visual Studio.

Instalación de la extensión de GitHub para Visual StudioInstall the GitHub Extension for Visual Studio

Para trabajar con repositorios de GitHub desde VS, debe instalar la extensión de GitHub para Visual Studio.To work with GitHub repositories from within VS, you need to install the GitHub Extension for Visual Studio. Para ello, ejecute el instalador de Visual Studio, seleccione Modificar y seleccione la pestaña Componentes individuales. Desplácese hacia abajo hasta la sección Herramientas de código, seleccione Extensión de GitHub para Visual Studio y haga clic en Modificar.To do so, 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.

Selección de la extensión de GitHub en el instalador de Visual Studio

Trabajo con GitHub en Visual StudioWork with GitHub in Visual Studio

  1. Inicie Visual Studio.Launch Visual Studio.

  2. Seleccione Ver > Team Explorer para abrir la ventana Team Explorer desde la que puede conectarse a GitHub o Azure Repos, o bien clonar un repositorio.Select View > Team Explorer to open the Team Explorer window in which you can connect to GitHub or Azure Repos, or clone a repository. (Si no ve la página Conectar que se muestra a continuación, seleccione el icono de enchufe en la barra de herramientas superior, que le llevará a esa página).(If you don't see the Connect page shown below, select the plug icon on the top toolbar, which takes you to that page.)

    Ventana de Team Explorer en la que se muestra Azure Repos, GitHub y la clonación de un repositorio

  3. En Repositorios GIT locales, seleccione el comando Clonar escriba https://github.com/gregmalcolm/python_koans en el campo de dirección URL, especifique una carpeta para los archivos clonados y seleccione el botón Clonar.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.

    Tip

    La carpeta que especifique en Team Explorer es la carpeta exacta para recibir los archivos clonados.The folder you specify in Team Explorer is the exact folder to receive the cloned files. A diferencia del comando git clone, al crear un clon en Team Explorer no se crea automáticamente una subcarpeta con el nombre del repositorio.Unlike the git clone command, creating a clone in Team Explorer does not automatically create a subfolder with the name of the repository.

  4. Cuando se complete la clonación, aparecerá el nombre del repositorio en la lista Repositorios GIT locales.When cloning is complete, the repository name appears in the Local Git Repositories list. Haga doble clic en ese nombre para ir al panel de repositorio en Team Explorer.Double-click that name to navigate to the repository dashboard in Team Explorer.

  5. En Soluciones, seleccione Nueva.Under Solutions, select New.

    Ventana de Team Explorer, con la creación de un proyecto nuevo a partir de un clon

  6. En el cuadro de diálogo Nuevo proyecto que se muestra, vaya al lenguaje Python (o busque "Python"), seleccione Desde código de Python existente, especifique un nombre para el proyecto, establezca Ubicación en la misma carpeta que el repositorio y haga clic en Aceptar.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. En el asistente que aparece, haga clic en Finalizar.In the wizard that appears, select Finish.

  7. Seleccione Vista > Explorador de soluciones en el menú.Select View > Solution Explorer from the menu.

  8. En el Explorador de soluciones, expanda el nodo python3, haga clic con el botón derecho en contemplate_koans.py y seleccione Establecer como archivo de inicio.In Solution Explorer, expand the python3 node, right-click contemplate_koans.py, and select Set as Startup File. Este paso indica a Visual Studio qué archivo debe usar al ejecutar el proyecto.This step tells Visual Studio which file it should use when running the project.

  9. Seleccione Proyecto > Koans Properties en el menú, seleccione la pestaña General y establezca Directorio de trabajo en "python3".Select Project > Koans Properties from the menu, select the General tab, and set Working Directory to "python3". Este paso es necesario porque, de forma predeterminada, Visual Studio establece el directorio de trabajo en la raíz del proyecto en lugar de hacerlo en la ubicación del archivo de inicio (python3\contemplate_koans.py, que también puede ver en las propiedades del proyecto).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). El código de programa busca un archivo koans.txt en la carpeta de trabajo por lo que, si no cambia este valor, verá un error en tiempo de ejecución.The program code looks for a file koans.txt in the working folder, so without changing this value you see a runtime error.

    Configuración del directorio de trabajo para un proyecto de Python

  10. Presione Ctrl+F5 o seleccione Depurar > Iniciar sin depurar para ejecutar el programa.Press Ctrl+F5 or select Debug > Start without Debugging to run the program. Si ve un FileNotFoundError para koans.txt, compruebe el directorio de trabajo como se describe en el paso anterior.If you see a FileNotFoundError for koans.txt, check the working directory setting as described in the previous step.

  11. Cuando el programa se ejecuta correctamente, muestra un error de aserción en la línea 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. Este comportamiento es deliberado: el programa está diseñado para que, con sus correcciones de todos los errores intencionados, se pueda enseñar a Python.This is intentional: the program is designed to teach Python by having you correct all the intentional errors. (Encontrará más información en Ruby Koans, en el que se inspira Python Koans).(More details are found on Ruby Koans, which inspired Python Koans.)

    Primer resultado del programa Python Koans

  12. Abra python3/koans/about_asserts.py desde el Explorador de soluciones y haga doble clic en el archivo.Open python3/koans/about_asserts.py by navigating to it in Solution Explorer and double-clicking the file. Tenga en cuenta que los números de línea no aparecen de forma predeterminada en el editor.Notice that line numbers do not appear by default in the editor. Para cambiar esta configuración, seleccione Herramientas > Opciones, seleccione Mostrar todas las configuraciones en la parte inferior del cuadro de diálogo, vaya a Editor de texto > Python > General y seleccione Números de línea: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:

    Activar el número de línea para archivos de Python

  13. Para corregir el error, cambie el False argumento de la línea 17 por True.Correct the error by changing the False argument on line 17 to True. La línea debe indicar lo siguiente:The line should read as follows:

    self.assertTrue(True) # This should be True
    
  14. Ejecute el programa otra vez.Run the program again. Si Visual Studio le advierte sobre los errores, responda con para continuar la ejecución de código.If Visual Studio warns you about errors, respond with Yes to continue running the code. Verá entonces que se supera la primera comprobación y el programa se detiene en el siguiente koan.You then see that the first check passes and the program stops on the next koan. Siga corrigiendo los errores y ejecutando el programa como quiera.Continue correcting the errors and the program again as you want.

Important

En este inicio rápido, ha creado un clon directo del repositorio python_koans en GitHub.In this Quickstart, you created a direct clone of the python_koans repository on GitHub. El autor de este repositorio lo protege de cambios directos, por lo que se produce un error al intentar aplicar cambios.Such a repository is protected by its author from direct changes, so attempting to commit changes to the repository fails. En la práctica, los desarrolladores bifurcan este repositorio en su propia cuenta de GitHub, efectúan cambios y crean solicitudes de incorporación de cambios para enviarlos al repositorio original.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. Cuando tenga su propia rama, use su dirección URL en lugar de la dirección URL de repositorio original utilizada anteriormente.When you have your own fork, use its URL instead of the original repository URL used earlier.

Pasos siguientesNext steps

Vea tambiénSee also