{"id":33,"date":"2017-10-17T12:05:29","date_gmt":"2017-10-17T17:05:29","guid":{"rendered":"http:\/\/blogs.gentoo.org\/chrisadr\/?p=33"},"modified":"2019-11-01T03:35:28","modified_gmt":"2019-11-01T08:35:28","slug":"tutorial-simple-para-hacer-tu-primer-pr-pull-request","status":"publish","type":"post","link":"https:\/\/blogs.gentoo.org\/chrisadr\/2017\/10\/17\/tutorial-simple-para-hacer-tu-primer-pr-pull-request\/","title":{"rendered":"Tutorial simple para hacer tu primer PR (Pull Request)"},"content":{"rendered":"

Bueno, este\u00a0si creo que ser\u00e1 un tutorial bastante corto y esperemos que did\u00e1ctico ;). Voy a poner a disposici\u00f3n de ustedes un peque\u00f1o repositorio en mi github para que puedan mandar sus PR y al mismo tiempo para que practiquen c\u00f3mo hacer todos los pasos que voy a dejar a continuaci\u00f3n. Aqu\u00ed el link para hacer sus PR de prueba:<\/p>\n

https:\/\/github.com\/CodeLabora\/TuPrimerPR<\/a><\/p>\n

Bueno, vamos a listar r\u00e1pidamente los pasos necesarios para mandar un PR:<\/p>\n

    \n
  1. Fork<\/li>\n
  2. Clone<\/li>\n
  3. Remote<\/li>\n
  4. Branch<\/li>\n
  5. Cambios<\/li>\n
  6. Add<\/li>\n
  7. Commit<\/li>\n
  8. Push<\/li>\n
  9. PR<\/li>\n<\/ol>\n

    Los estoy poniendo en ingl\u00e9s para que encuentren sus respectivas opciones en la l\u00ednea de comando de git.<\/p>\n

    Fork<\/h3>\n

    Un fork es tu propia versi\u00f3n de un repositorio de Github. Este te permite clonar el trabajo de otro proyecto y tenerlo en tu cuenta para que puedas cambiar cosas sin preocupaci\u00f3n de perder tus cambios. Para realizar un fork solo es necesario ir a la p\u00e1gina y dar click al bot\u00f3n Fork que se encuentra en la parte superior derecha.<\/p>\n

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

    Una vez realizado el fork podr\u00e1n ver que en su cuenta aparece el repositorio.<\/p>\n

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

    Clone<\/h3>\n

    Ahora que ya tenemos un repositorio lo vamos a clonar a nuestro equipo. (Asumo que me siguen personas que usan Linux, pero para los usuarios de otros sistemas tambi\u00e9n existen versiones de git que pueden descargar en su p\u00e1gina oficial.<\/p>\n

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

    Y con nuestro terminal hacemos lo siguiente.<\/p>\n

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

    Con esto tendremos una nueva carpeta llamada TuPrimerPR en la que estar\u00e1 nuestro proyecto de Github. entramos a la carpeta con el comando “cd TuPrimerPR” y veremos que dentro est\u00e1n los archivos que se encuentran en nuestro fork.<\/p>\n

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

    (Tengan en cuenta que la cantidad de archivos puede variar dependiendo de lo que encuentren en mi repositorio cuando hagan el fork)<\/p>\n

    Remote<\/h3>\n

    Este es un paso opcional, pero que evita muchos problemas al momento de trabajar de manera continua en un proyecto. Fork por defecto crea una copia exacta del repositorio, pero en el momento exacto de la creaci\u00f3n. Esto quiere decir que si el proyecto sigue avanzando, su repositorio se va a quedar atrasado con el pasar de los d\u00edas u horas. “git remote ”\u00a0 nos permite especificar otro punto de descarga (el proyecto original) y as\u00ed poder actualizar nuestro proyecto cada vez que vemos que el proyecto padre se est\u00e1 actualizando.<\/p>\n

    Para encontrar tu proyecto padre solo hace falta usar el link que se encuentra justo abajo del nombre de tu repositorio. (Revisen la segunda imagen del apartado Fork). Vamos a agregar este dato a continuaci\u00f3n:<\/p>\n

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

    Este es el proyecto original (lo vamos a llamar upstream\u00a0<\/em>para seguir la corriente de muchos proyectos).<\/p>\n

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

    Como pueden ver, he agregado el remote con ” git remote add <nombre> <URL> ”<\/p>\n

    Con esto vamos a poder actualizar el proyecto cuando sea necesario, pero no lo vamos a usar ahora porque no es necesario. (Eso lo explico m\u00e1s adelante, o en otro post, dependiendo de la necesidad)<\/p>\n

    Branch<\/h3>\n

    Los branch (o ramas) permiten crear secciones de c\u00f3digo que puedes trabajar en un entorno aislado. Esto quiere decir que lo que hagas en un branch no necesariamente afecta al c\u00f3digo original hasta que se utilice un ” git merge “. Tambi\u00e9n es una funcionalidad extra que te permite Github, cada vez que tu creas un branch, Github genera autom\u00e1ticamente la fuente del Pull Request cuando es necesario.<\/p>\n

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

    Ahora que estamos en nuestra rama especial, podemos trabajar en nuestra contribuci\u00f3n.<\/p>\n

    Cambios<\/h3>\n

    Voy a agregar un par de archivos para que vean c\u00f3mo se hace.<\/p>\n

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

    “touch ” nos permite crear un archivo (si es que no existe) en blanco. con esto podemos pasar a nuestro siguiente paso.<\/p>\n

    Add<\/h3>\n

    ” git add ” nos permite agregar archivos a nuestro commit (los explico m\u00e1s adelante). Para ver qu\u00e9 archivos puedes agregar se puede utilizar el comando ” git status ”<\/p>\n

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

    Con esto tenemos todo preparado para nuestro Commit<\/p>\n

    Commit<\/h3>\n

    Los commits son marcas (o hitos) en el tiempo. definen un estado para todos los archivos del proyecto y acumulan los cambios necesarios para llegar desde el principio del proyecto hasta el estado actual. Suena un poco complejo, pero es bastante sencillo, solo recuerda que son las escaleras de tu proyecto. Escribimos ” git commit ” y nos saldr\u00e1 una ventana para escribir nuestro mensaje de commit.<\/p>\n

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

    Y al finalizar y guardar el texto, veremos algo como:<\/p>\n

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

    Donde se muestra un resumen de lo que hace el commit.<\/p>\n

    Push<\/h3>\n

    Con push estamos subiendo a nuestra cuenta de Github todos los commits que tenemos en el equipo que no se encuentran en nuestro repositorio en internet. Esto har\u00e1 que Github pueda generar el nuevo PR de manera autom\u00e1tica.<\/p>\n

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

    Noten que estamos usando el nombre de nuestro branch y que nos solicita nuestro usuario y contrase\u00f1a. Al final nos muestra que se ha creado el branch miMejora dentro de nuestra cuenta de Github. Vamos a ver en el navegador lo que hemos conseguido. ;)<\/p>\n

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

    Como pueden ver, se ha creado una nueva l\u00ednea que dice “Compare & Pull request”. Esta funcionalidad de Github nos permite crear el PR de manera sencilla, vamos a dar click para ver qu\u00e9 sucede.<\/p>\n

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

    Github es bastante inteligente. Como pueden apreciar, partes el commit se agregan al formulario para env\u00edo. Solo es necesario dar click al bot\u00f3n y listo :) Sencillo.<\/p>\n

    Extra<\/h3>\n

    Esto es el detr\u00e1s de c\u00e1maras de los proyectos, aparece el PR y el encargado decide si aceptar o no, o escribir m\u00e1s mensajes. En mi caso lo voy a aceptar de manera instant\u00e1nea.<\/p>\n

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

    Una vez realizado el merge, podr\u00e1n ver el log de commits del proyecto y ver su nombre en \u00e9l.<\/p>\n

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

    Pero ahora tenemos un problema. Ese commit no aparece en\u00a0nuestro\u00a0<\/em>repositorio, solamente en el del proyecto. \u00bfRecuerdan nuestro paso de remote? Ahora es cuando rinde frutos :)<\/p>\n

    Volvemos a nuestro branch master y hacemos lo siguiente:<\/p>\n

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

    Con esto hemos descargado toda la informaci\u00f3n del proyecto original a nuestro equipo. Como pueden apreciar, ah\u00ed aparece nuestro commit. Ahora vamos a guardar todo este trabajo en nuestro repositorio de Github para poder eliminar el branch que tiene el aporte que ya agregaron al proyecto.<\/p>\n

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

    Ahora que ya tenemos nuestro repositorio de Github actualizado vamos a borrar nuestro branch, pero primero nos aseguramos que est\u00e9 dentro de nuestra rama principal (master)<\/p>\n

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

    Como pueden ver tuve un ligero error, esto era porque me encontraba en mi branch miMejora al momento de quere borrar. Esto se arregla regresando al branch master.<\/p>\n

    Conclusi\u00f3n<\/h3>\n

    Listo :) tan sencillo como eso. Ahora que dominan los oscuros secretos de Github para mandar PR, espero ver sus contribuciones en diversos proyectos. Y si desean pueden dejar su primer PR en mi repositorio ;) para el recuerdo.<\/p>\n

    No he tocado mil y un beneficios de Git (OJO<\/strong>, no Github) y como es de esperar de desarrolladores que est\u00e1n ligados a la comunidad del Kernel, Git es una herramienta sumamente poderosa, con cientos de funcionalidades.<\/p>\n

    Para poder tener una mejor idea de lo que hace y todo el poder de Git, les recomiendo mucho este libro<\/a>. Estoy seguro que les ayudar\u00e1 bastante a mejorar en el manejo de git.<\/p>\n

    Saludos y espero que les ayude ;)<\/p>\n","protected":false},"excerpt":{"rendered":"

    Bueno, este\u00a0si creo que ser\u00e1 un tutorial bastante corto y esperemos que did\u00e1ctico ;). Voy a poner a disposici\u00f3n de ustedes un peque\u00f1o repositorio en mi github para que puedan mandar sus PR y al mismo tiempo para que practiquen c\u00f3mo hacer todos los pasos que voy a dejar a continuaci\u00f3n. Aqu\u00ed el link para … Continue reading Tutorial simple para hacer tu primer PR (Pull Request)<\/span><\/a><\/p>\n","protected":false},"author":169,"featured_media":34,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":[],"categories":[5],"tags":[3],"jetpack_featured_media_url":"https:\/\/blogs.gentoo.org\/chrisadr\/files\/2017\/10\/git-github.png","_links":{"self":[{"href":"https:\/\/blogs.gentoo.org\/chrisadr\/wp-json\/wp\/v2\/posts\/33"}],"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=33"}],"version-history":[{"count":1,"href":"https:\/\/blogs.gentoo.org\/chrisadr\/wp-json\/wp\/v2\/posts\/33\/revisions"}],"predecessor-version":[{"id":35,"href":"https:\/\/blogs.gentoo.org\/chrisadr\/wp-json\/wp\/v2\/posts\/33\/revisions\/35"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/blogs.gentoo.org\/chrisadr\/wp-json\/wp\/v2\/media\/34"}],"wp:attachment":[{"href":"https:\/\/blogs.gentoo.org\/chrisadr\/wp-json\/wp\/v2\/media?parent=33"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blogs.gentoo.org\/chrisadr\/wp-json\/wp\/v2\/categories?post=33"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blogs.gentoo.org\/chrisadr\/wp-json\/wp\/v2\/tags?post=33"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}