integrar pydev y github en eclipse

Cuanto más programas, más indispensables se vuelven los sistemas de control de versiones. Aunque ya he hablado de alguno ellos en este blog anteriormente, hoy voy a explicar cómo integrar eclipse + PyDev + GitHub. Para programar en python como un pro ;)

Requisitos previos

• Eclipse
• python
• Git
• Cuenta en github

1. Instalar PyDev (rama Main)

   Requisitos:

   • Java 7
   • Python >= 2.1 o Jython >= 2.1 o IronPython >= 2.6
   • Eclipse >= 3.8

   Abrimos Eclipse y vamos al menú: Help > Install New Software...

   

   En la siguiente pantalla, pulsamos Add y añadimos la dirección de las actualizaciones de la rama main de PyDev: http://pydev.org/updates. Como nombre le pondremos "PyDev".

   

   Marcamos PyDev y desmarcamos la opción "Contact all update sites during install to find required software".

   

   Pulsamos Next. Leemos y aceptamos la licencia y pulsamos Finish.

2. Instalar EGit y GitHub Mylyn Connector

   • Volvemos al menú Help > Install New Software... de Eclipse
   • Introducimos la dirección de las actualizaciones de nuestra versión de Eclipse (en mi caso "3.8 Juno" -> http://download.eclipse.org/releases/juno/).
   • Filtramos los resultados por "git" y seleccionamos: EGit, JGit y Mylyn Github
     
   • Pulsar Next y finalizar la instalación.

3. Manejando los repositorios de GitHub

   • Crear el repositorio en la web de github
     
   • Importar el repositorio en Eclipse

     Aunque hay muchos tutoriales disponibles para hacer esto, en ellos recomiendan crear los archivos directamente en Eclipse, hacer un commit y un push en el repostorio local de Git y asociar el repositorio local de Git con el repositorio remoto en GitHub. Pero eso crea una carpeta con el nombre que tiene el proyecto en Eclipse dentro del repositorio en GitHub. Cosa que no me gusta nada. Por eso, esta parte la voy a hacer "a mi manera", cambiando el modo, y evitando así tener esa carpeta en el repositorio de GitHub.

     • En el área de proyectos pulsar botón derecho, "Import"
       
     • Seleccionar Git/Projects from Git y pulsar Next
       
     • Seleccionar "URL"
       
     • Introducir la URL del repositorio en GitHub (los campos Host y Repository path se autocompletan. Introducir el usuario y la contraseña y marcar la opción "Store in Secure Store".
       
       Pulsar "Next", "Next", "Next" hasta llegar a la pantalla para seleccionar el asistente para importar proyectos.
     • Importar el proyecto como proyecto general (general project)
       
       Pulsar "Next" y "Finish"

     Ahora ya tendremos nuestro proyecto de GitHub importado en Eclipse

     
     • Añadir los archivos al proyecto
     • Hacer el primer commit

       Botón derecho sobre el proyecto > Team > Commit.

       

       *Hasta que no hagamos un commit, los archivos del proyecto mostrarán un pequeño interrogante.

     • Introducir el primer comentario. Seleccionar los archivos que queremos incluír en el commit y que queremos sincronizar con el repositorio en GitHub y pulsar "Commit" o "Commit and Push" (si los queremos subir ya).
       

     Si no hemos hecho el push (o para futuros pushs)

     • Seleccionamos el proyecto, botón derecho > Team > Push to Upstream

       

       Y ya tendremos los cambios locales sincronizados con nuestro repositorio en GitHub

       

4. Activando PyDev

   En estos momentos, notaremos que no nos funcionan las comprobaciones de PyDev.

   
   Para solucionarlo:
   • Seleccionar el proyecto > botón derecho > PyDev > Set as Source Folder (add to PYTHONPATH)
     
     No os preocupéis, enseguida lo borramos de ahí ;)
   • Seleccionar el proyecto > botón derecho > PyDev > Code analysis
     
   • Quitar el proyecto de PYTHONPATH

     Como ya está funcionando PyDev, si no lo necesitamos explícitamente, eliminamos el proyecto del PYTHONPATH.

     

Y ya está. Ya tendremos todo listo. La verdad es que parece un proceso tedioso, pero en cuanto se hace una o dos veces, uno se da cuenta de que no son más que un par de clicks aquí y allí ;)

Enjoy!

Fuentes:

• PyDev/Manual/Install
• Eclipse/GitHubEclipse