{"id":119,"date":"2018-01-21T12:01:38","date_gmt":"2018-01-21T17:01:38","guid":{"rendered":"http:\/\/blogs.gentoo.org\/chrisadr\/?p=119"},"modified":"2019-11-01T03:35:27","modified_gmt":"2019-11-01T08:35:27","slug":"escribiendo-tus-propias-historias-con-git","status":"publish","type":"post","link":"https:\/\/blogs.gentoo.org\/chrisadr\/2018\/01\/21\/escribiendo-tus-propias-historias-con-git\/","title":{"rendered":"Escribiendo tus propias historias con git"},"content":{"rendered":"

Buenas con todos :) Antes de continuar\u00a0con los textos de la lista de pedidos, quiero celebrar el lanzamiento de git 2.16 agradeciendo a cada uno de los que mand\u00f3 un parche y a cada uno de los usuarios, en total tuvimos como 4000 l\u00edneas entre actualizaciones y correcciones, lo cual no habla muy bien de mi primera versi\u00f3n, pero si de la amabilidad de ustedes :) \u00a1Gracias! Ahora bien, les contar\u00e9 un peque\u00f1o secreto, hasta ahora no ha habido una vez en la que no me haya sentado a escribir un art\u00edculo y haya pensado mucho al respecto, normalmente solo escribo de corrido, y despu\u00e9s el buen lagarto se toma la amabilidad de corregir mis faltas de tipeo :) as\u00ed que gracias a \u00e9l tambi\u00e9n.<\/p>\n

Esto no es lo mejor cuando hablamos de escribir art\u00edculos, supuestamente deber\u00eda tener un objetivo y armar una estructura, y marcar peque\u00f1os puntos y revisiones y etc etc… Ahora bien, esto no solo aplica para los blogs en general, sino que es fundamental en un software que pretende ser bueno :) Para esta tarea, y tras algunos problemas con el software de control de versiones que se usaba en el desarrollo del kernel hace unos a\u00f1os, naci\u00f3 git<\/code> :)<\/p>\n

\u00bfD\u00f3nde aprender git<\/code>?<\/h3>\n

La cantidad de documentaci\u00f3n existente en torno a git es descomunal, incluso si solo tomamos las p\u00e1ginas de manual que vienen con la instalaci\u00f3n, tendr\u00edamos una cantidad inmensa de lectura. Yo personalmente encuentro el libro de git<\/a>\u00a0bastante bien dise\u00f1ado, incluso yo he traducido algunos de los segmentos de la secci\u00f3n 7, todav\u00eda me faltan unos cuantos, pero denme tiempo :P tal vez en este mes pueda traducir lo que queda de esa secci\u00f3n.<\/p>\n

\u00bfQu\u00e9 hace git?<\/h3>\n

Git est\u00e1 dise\u00f1ado para ser r\u00e1pido, eficiente, simple y soportar grandes cargas de informaci\u00f3n, despu\u00e9s de todo, la comunidad del kernel lo creo para su software, el cual es uno de los trabajos conjuntos m\u00e1s grandes del software libre del mundo y cuenta con cientos de contribuciones por hora en una base de c\u00f3digo que supera el mill\u00f3n de l\u00edneas.<\/p>\n

Lo interesante de git es su forma de mantener las versiones de la data. Antiguamente (otros programas de control de versiones) tomaban comprimidos de todos los archivos existentes en un punto de la historia, como hacer un\u00a0backup<\/em>. Git tiene un enfoque diferente, al realizar un\u00a0commit<\/code>\u00a0se marca un punto en la historia, ese punto en la historia cuenta con una serie de modificaciones y trabajos, al final del d\u00eda, se juntan todas las modificaciones a lo largo del tiempo y se obtienen los archivos para poder comprimir o marcar como hitos de versiones. Como s\u00e9 que todo esto suena complicado, voy a llevarlos por un m\u00e1gico viaje en un ejemplo super b\u00e1sico.<\/p>\n

Peque\u00f1o proyecto de calculam\u00e1tica<\/h3>\n

La calculam\u00e1tica ser\u00e1 un programa que encontrar\u00e1 los cuadrados de un n\u00famero dado, lo haremos en C y ser\u00e1 lo m\u00e1s simple posible, as\u00ed que no esperen muchos controles de seguridad de mi parte. Primero vamos a crear un repositorio, lo har\u00e9 con Github para matar dos p\u00e1jaros de un tiro:<\/p>\n

\"\"
Dise\u00f1o propio. Christopher D\u00edaz Riveros<\/figcaption><\/figure>\n

Hemos agregado un par de cosas bastante simples como la licencia (muy importante si quieres proteger tu trabajo, en mi caso, obligarlos a compartir los resultados si lo quieren usar de base :P)<\/p>\n

Ahora vamos a ir a nuestra querida terminal,\u00a0git clone<\/code>\u00a0es el comando que se encarga de descargar el repositorio ubicado en la\u00a0url<\/code>\u00a0asignada y crear una copia local en nuestro equipo.<\/p>\n

\"\"
Dise\u00f1o propio. Christopher D\u00edaz Riveros<\/figcaption><\/figure>\n

Ahora vamos a revisar con\u00a0git log<\/code>\u00a0lo que ha ocurrido en la historia de nuestro proyecto:<\/p>\n

\"\"<\/p>\n

Aqu\u00ed tenemos mucha informaci\u00f3n en diversos colores :) vamos a tratar de explicarla:<\/p>\n

la primer l\u00ednea amarilla es el “c\u00f3digo de barras del commit” cada commit tiene su propio identificador \u00fanico, con el cual puedes hacer bastantes cosas, pero lo vamos a dejar para despu\u00e9s. Ahora tenemos HEAD<\/code> de celeste y master<\/code> de verde. Estos son “punteros” su funci\u00f3n es apuntar a la ubicaci\u00f3n actual de nuestra historia (HEAD<\/code>) y la rama en la que estamos trabajando en nuestra computadora (master<\/code>).<\/p>\n

origin\/master<\/code>\u00a0es la contraparte de internet,\u00a0origin<\/code>\u00a0es el nombre por defecto que se ha asignado a nuestra URL<\/code>, y master<\/code> es la rama en la que est\u00e1 trabajando… para hacerlo sencillo, los que tienen un\u00a0\/<\/code>\u00a0son aquellos que no se encuentran en nuestro equipo, sino que son referencias a lo que est\u00e1 en internet.<\/p>\n

Despu\u00e9s tenemos el autor, la fecha y hora y el resumen del commit. Esta es una peque\u00f1a rese\u00f1a de lo que ha sucedido en ese punto de la historia, muy importante en muchos proyectos y ah\u00ed se condenza bastante informaic\u00f3n. Vamos a ver m\u00e1s de cerca lo que sucedi\u00f3 en el commit con el comando\u00a0git show <c\u00f3digo-de-commit><\/code><\/p>\n

 <\/p>\n

\"\"
Dise\u00f1o propio. Christopher D\u00edaz Riveros<\/figcaption><\/figure>\n

El comando git show nos lleva a esta pantalla en formato parche, donde se aprecia lo que se ha agregado y lo que se ha quitado (si se hubiese quitado algo) en ese momento de la historia, hasta aqu\u00ed solo nos muestra que se agregaron los archivos\u00a0.gitignore<\/code>,README.md<\/code> y\u00a0LICENSE<\/code>.<\/p>\n

Ahora vamos a lo nuestro, vamos a escribir un archivo :) crearemos el primer hito en nuestra historia :D :<\/p>\n

\"\"
Dise\u00f1o propio. Christopher D\u00edaz Riveros<\/figcaption><\/figure>\n

Brevemente, vamos a crear un programa que nos muestre la cantidad de argumentos pasados al momento de ejecutarlo, simple :)<\/p>\n

\"\"
Dise\u00f1o propio. Christopher D\u00edaz Riveros<\/figcaption><\/figure>\n

Eso fue f\u00e1cil :) ahora vamos a ver el siguiente comando \u00fatil:\u00a0git status<\/code><\/p>\n

\"\"
Dise\u00f1o propio. Christopher D\u00edaz Riveros<\/figcaption><\/figure>\n

Alg\u00fan alma de buen coraz\u00f3n ha traducido git para hacerlo sencillo de seguir, aqu\u00ed tenemos mucha informaci\u00f3n \u00fatil, sabemos que estamos en la rama master, que estamos actualizados con\u00a0origin\/master<\/code>(la rama de Github), \u00a1que tenemos archivos sin seguimiento! y que para agregarlos tenemos que usar git add<\/code>, vamos a probar :)<\/p>\n

\"\"
Dise\u00f1o propio. Christopher D\u00edaz Riveros<\/figcaption><\/figure>\n

Ahora tenemos un nuevo espacio de verde, en el cual se muestra el archivo que hemos agregado a la zona de trabajo. En este lugar podemos agrupar nuestros cambios para poder realizar un commit, el commit consiste en un hito a lo largo de la historia de nuestro proyecto, vamos a crear el commit :)\u00a0git commit<\/code><\/p>\n

\"\"
Dise\u00f1o propio. Christopher D\u00edaz Riveros<\/figcaption><\/figure>\n

Brevemente explicado, la l\u00ednea amarilla es el t\u00edtulo de nuestro commit, yo escribo main.c por una mera referencia visual. El texto de negro es la explicaci\u00f3n de los cambios realizados desde el commit anterior hasta ahora :) guardamos el archivo y veremos nuestro commit guardado en el registro.<\/p>\n

\"\"
Dise\u00f1o propio. Christopher D\u00edaz Riveros<\/figcaption><\/figure>\n

Ahora vamos a ver la historia de nuestro proyecto con\u00a0git log<\/code><\/p>\n

\"\"
Dise\u00f1o propio. Christopher D\u00edaz Riveros<\/figcaption><\/figure>\n

Nuevamente en el log, ahora podemos ver que la l\u00ednea verde y la roja han diferido, eso se debe a que en nuestra computadora, estamos un commit por encima de los almacenados en internet :) vamos a seguir el trabajo, supongamos que ahora quiero mostrar un mensaje en caso de que el usuario ponga m\u00e1s de un argumento en el programa (lo cual har\u00eda que la calculadora se confunda :) )<\/p>\n

\"\"<\/p>\n

Como podemos ver, nuestro programa ha crecido bastante :D , ahora tenemos la funci\u00f3n imprimir_ayuda()<\/code>\u00a0que muestra un mensaje sobre c\u00f3mo usar la calculamatica, y en el bloque\u00a0main()<\/code>\u00a0ahora hacemos una revisi\u00f3n con\u00a0if<\/code>(algo que veremos en un tutorial de programaci\u00f3n en otro momento, por ahora solo es necesario saber que si se ingresan m\u00e1s de 2 argumentos a la calculam\u00e1tica, que el programa termine y se muestre la ayuda. Vamos a ejecutarlo:<\/p>\n

\"\"
Dise\u00f1o propio. Christopher D\u00edaz Riveros<\/figcaption><\/figure>\n

Como pueden ver ahora imprime el n\u00famero que ha sido entregado en lugar de la cantidad de argumentos, pero eso yo no se los hab\u00eda contado antes :) para los curiosos\u00a0echo $?<\/code>\u00a0muestra el c\u00f3digo de salida del \u00faltimo programa ejecutado, el cual es\u00a01<\/code>\u00a0porque ha terminado en error. Ahora vamos a revisar c\u00f3mo va nuestra historia:<\/p>\n

\"\"
Dise\u00f1o propio. Christopher D\u00edaz Riveros<\/figcaption><\/figure>\n

Ahora sabemos que estamos 1 commit delante de Github, que el archivo main.c<\/code>\u00a0ha sido modificado, vamos a crear el siguiente commit\u00a0 haciendo git add main.c\u00a0<\/code>\u00a0y luego git commit<\/code>:)<\/p>\n

\"\"
Dise\u00f1o propio. Christopher D\u00edaz Riveros<\/figcaption><\/figure>\n

Ahora hemos sido un poco m\u00e1s espec\u00edficos, puesto que hemos implementado una funci\u00f3n y cambiado el c\u00f3digo de validaci\u00f3n. Ahora que se ha guardado vamos a revisar nuestro \u00faltimo cambio. Podemos verlo con\u00a0git show HEAD<\/code><\/p>\n

\"\"
Dise\u00f1o propio. Christopher D\u00edaz Riveros<\/figcaption><\/figure>\n

Ahora se pueden apreciar las l\u00edneas rojas y verdes, hemos agregado la biblioteca\u00a0stdlib.h<\/code>, modificado gran parte del c\u00f3digo y agregado la funci\u00f3n a nuestra historia.<\/p>\n

Ahora vamos a ver el log: (git log<\/code>)<\/p>\n

\"\"
Dise\u00f1o propio. Christopher D\u00edaz Riveros<\/figcaption><\/figure>\n

Podemos ver que estamos dos commits adelante de la versi\u00f3n de Github, vamos a igualar un poco el marcador :) para eso usamos\u00a0git push origin master<\/code><\/p>\n

Con esto decimos, env\u00eda mis commits al url\u00a0origin<\/code>\u00a0en la rama\u00a0master<\/code><\/p>\n

\"\"
Dise\u00f1o propio. Christopher D\u00edaz Riveros<\/figcaption><\/figure>\n

\u00a1Felicidades! Ahora sus cambios est\u00e1n en Github, \u00bfno me creen? vamos a revisarlo ;)<\/p>\n

\"\"
Dise\u00f1o propio. Christopher D\u00edaz Riveros<\/figcaption><\/figure>\n

Ahora tenemos los 3 commits en Github :)<\/p>\n

Resumen<\/h3>\n

Hemos tocado los aspectos m\u00e1s b\u00e1sicos de git<\/code>, ahora pueden crear un flujo de trabajo simple en sus proyectos, esto no es casi nada de toda la gran variedad de cosas que pueden hacerse con git, pero ciertamente es lo m\u00e1s pr\u00e1ctico y de todos los d\u00edas para un desarrollador o blogger. No hemos llegado al final de la calculadora, pero eso lo vamos a dejar para otro momento ;) Muchas gracias por llegar hasta aqu\u00ed y espero les ayude a participar en varios proyectos :D Saludos<\/p>\n

 <\/p>\n","protected":false},"excerpt":{"rendered":"

Buenas con todos :) Antes de continuar\u00a0con los textos de la lista de pedidos, quiero celebrar el lanzamiento de git 2.16 agradeciendo a cada uno de los que mand\u00f3 un parche y a cada uno de los usuarios, en total tuvimos como 4000 l\u00edneas entre actualizaciones y correcciones, lo cual no habla muy bien de … Continue reading Escribiendo tus propias historias con git<\/span><\/a><\/p>\n","protected":false},"author":169,"featured_media":121,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":[],"categories":[23],"tags":[],"jetpack_featured_media_url":"https:\/\/blogs.gentoo.org\/chrisadr\/files\/2018\/01\/git.jpeg","_links":{"self":[{"href":"https:\/\/blogs.gentoo.org\/chrisadr\/wp-json\/wp\/v2\/posts\/119"}],"collection":[{"href":"https:\/\/blogs.gentoo.org\/chrisadr\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blogs.gentoo.org\/chrisadr\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blogs.gentoo.org\/chrisadr\/wp-json\/wp\/v2\/users\/169"}],"replies":[{"embeddable":true,"href":"https:\/\/blogs.gentoo.org\/chrisadr\/wp-json\/wp\/v2\/comments?post=119"}],"version-history":[{"count":2,"href":"https:\/\/blogs.gentoo.org\/chrisadr\/wp-json\/wp\/v2\/posts\/119\/revisions"}],"predecessor-version":[{"id":122,"href":"https:\/\/blogs.gentoo.org\/chrisadr\/wp-json\/wp\/v2\/posts\/119\/revisions\/122"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/blogs.gentoo.org\/chrisadr\/wp-json\/wp\/v2\/media\/121"}],"wp:attachment":[{"href":"https:\/\/blogs.gentoo.org\/chrisadr\/wp-json\/wp\/v2\/media?parent=119"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blogs.gentoo.org\/chrisadr\/wp-json\/wp\/v2\/categories?post=119"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blogs.gentoo.org\/chrisadr\/wp-json\/wp\/v2\/tags?post=119"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}