Iniciando un proyecto con Git y Google Code (Parte III)

Y ahora sí, lo más jugoso de este pequeño tutorial.

4. Creamos nuestro proyecto

Creamos un directorio que contenga todos los archivos relacionados con el proyecto. Por ejemplo, dentro del HOME de nuestro usuario creamos la carpeta HolaMundo.

~$ mkdir HolaMundo

Ingresamos a la carpeta recién creada usando el comando cd.

~$ cd HolaMundo/

Creamos el archivo de nuestro programa «Hola Mundo«. Podemos utilizar el editor de texto que más nos guste. Ahora para simplificar las cosas simplemente lo que vamos a hacer es ejecutar el siguiente comando:

~/HolaMundo$ echo "print(\"Hola Mundo\")" > holamundo.py

De esta manera simplemente nos crea el archivo holamundo.py dentro de la carpeta HolaMundo con la instrucción que imprimirá el saludo.

Podemos probar nuestro flamante nuevo programa con la siguiente instrucción:

~/HolaMundo$ python holamundo.py
Hola Mundo
~/HolaMundo$

Así hemos creado nuestra primera versión del programa. Ahora es cuestión de iniciar Git para que controle nuestras versiones futuras.

5. Iniciamos Git

Para comenzar a utilizar Git podemos configurar algunas de las opciones generales, en el libro en la sección 1.5 se detallan algunas de estas opciones. En este caso quiero mostrarles cómo se debe hacer para configurar sólo las opciones para el repositorio local.

~/HolaMundo$ git config --local user.name lecovi
~/HolaMundo$ git config --local user.email colomboleandro@bitson.com.ar
~/HolaMundo$ git config --local core.editor vim

Con estas opciones le estoy definiendo que mi nombre de usuario para este proyecto es «lecovi«, que mi mail para este proyecto es «colomboleandro@bitson.com.ar» y que el editor por defecto que quiero usar cuando ejecute commit es el vim.

La ventaja que tiene usar Git es que corre localmente en el direcotorio de trabajo de nuestro proyecto. Por eso tenemos que inicializarlo en el direcotorio del proyecto con el comando init.

~/HolaMundo$ git init
Initialized empty Git repository in /home/leo/HolaMundo/.git/
~/HolaMundo$

Ahora vamos a crear el archivo .gitignore que le dirá a Git qué archivos y directorios no tiene que seguir. Para mayor información podés consultar el libro. En este caso vamos a decirle que ignore el mismo archivo .gitignore y todos los archivos terminados con .pyc.

~/HolaMundo$ echo .gitignore >> .gitignore
~/HolaMundo$ echo *.pyc >> .gitignore

6. Agregando archivos

Ahora tenemos que agregar los archivos (en este caso sólo tenemos un archivo el holamundo.py, pero creo que se entiende la idea, ¿no?). Utilizando el comando add le diremos que agregue todo el contenido del directorio (exceptuando lo que hayamos escrito en el archivo .gitignore).

~/HolaMundo$ git add .

7. Creando nuestra versión

Una vez que hemos configurado Git y agregado todos los archivos que queríamos tener controlados por nuestro sistema de control de versiones tenemos que hacer el famoso commit.

Con esta instrucción estaremos estableciendo un punto en nuestra historia de desarrollo. Para el primer caso es usual hacer un commit con la descripción «Initial commit«. Por lo general yo omito el estado staged y simplemente ejecuto el comando commit con la opción -a.

~/HolaMundo$ git commit -a

Esto nos abrirá el editor que tengamos seteado por defecto, en mi caso vim, y podremos escribir el detalle del commit. En este caso, simplemente voy a escribir lo mencionado anteriormente. Una vez que guardemos el archivo con el editor, Git se ocupará de hacer el commit.

8. Agregando un repositorio remoto

Ahora es momento de decirle a nuestro Git local que tiene un repositorio remoto. En el libro tenemos descrito el procedimiento para realizar la creación del repositorio en GitHub. En esta sección vamos a utilizar lo que dejamos pendiente en la sección 3 del post anterior.

Para agregar el repositorio remoto tenemos que usar el comando git remote add donde se le pasa como argumento un nombre o alias al repositorio y la URL del mismo. En este caso vamos a usar la del proyecto que cree en Google Code.

~/HolaMundo$ git remote add gc https://code.google.com/p/lecovi-hello-world/

Ahora finalmente para subir nuestro repositorio local al remoto ejecutamos el comando push.

~/HolaMundo$ git push gc master

Como en la sección 3 habíamos creado el archivo .netrc utilizará los parámetros que están almacenados en ese archivo para conectarse con el servidor. Y subirá la rama master al repositorio que guardamos como gc.

En la página de nuestro proyecto de Google Code, podemos ver en la sección Source en el apartado Browse el contenido de nuestro proyecto.

Próximamente…

Hasta acá hemos completado el tutorial de cómo arrancar un proyecto con Git y Google Code.

En la próxima y última entrega de este mini-tutorial estaremos revisando cómo hacer cambios en nuestro proyecto y que se vean reflejados en nuestro sistema de control de versiones.

Saludos!