¿Cómo testear un pull request?

[stevej]

Hola, a una comunidad, se la puede ayudar de varias formas:

• Donando, para que pueda destinar ese dinero, en reparaciones complejas.
• Creando pull request, que es un tema que hablamos en otro hilo y te dejo el enlace.
• Reportando fallos, proporcionando toda la información necesaria para que puedan ser replicados, y fixeados.
• O tambien, testeando los arreglos que algunas personas hacen, para que los mismos, puedan ser fusionados.

En este articulo, trataremos el tema de como testear los pull request.
Realmente los testers, cumplen una labor muy importante dentro de una comunidad, porque pueden probar los posibles cambios, propuestos por una persona, y de esa forma, que los mismos, sean aprobados y formen parte de la rama principal del modulo, núcleo o de lo que trate el aporte que se quiere añadir. Para poder hacerlo, deberíamos de seguir la siguiente serie de pasos.

1. Tener una cuenta de github, la cual vas a utilizar para clonar el repositorio y a su vez, para luego dar tu testimonio sobre las pruebas.
2. Clonar el repositorio, esto dependerá de si solo sos tester o desarrollador, pero en este caso, no es necesario hacer un fork, porque solo vas a testear.
3. Tendrás que moverte a la carpeta donde se encuentra el repositorio clonado, y crear una rama nueva.
   1. Recuerda que la rama se crea con el comando git checkout -b nombre_de_la_rama
   2. Siendo nombre_de_la_rama en este caso, cualquiera, aunque se utiliza como convención el numero del pull request.
4. Por ejemplo, si quisiéramos probar el siguiente pull request: https://github.com/azerothcore/mod-autobalance/pull/141
   1. En ese caso, el la rama podria llamarse: git checkout -b pr-141
   2. Vale aclarar que la rama debe crearse siempre a partir de master / main, y que la misma debe estar actualizada.
5. Luego de crear la rama, lo que tenemos que hacer, es descargar los cambios, que propone la persona, para poder testearlos.
   1. Dentro de los pull request, en la mayoría de ellos, existe una serie de pasos, que indican como deberían de probarse.
   2. No todos llenan sos valores, porque "consideran" que en el titulo esta la descripción, pero si no tenes información, podes pasar a otro.
   3. O pedirle al dueño del pull request, que te proporcione los datos suficientes o adicionales, para poder hacer el testing adecuado.
6. Volviendo al caso anterior... clonamos el repositorio entonces
   1. git clone https://github.com/azerothcore/mod-autobalance -b master
   2. Luego creamos la rama git checkout -b pr-141
   3. Y ahora, descargamos los cambios: git pull origin pull/141/head
      1. El 141 del centro de las barras, corresponde el numero del pull request.
7. Al hacer esto, quizas nos diga que tenemos que hacer un merge, le damos que si.
8. Y ya podemos compilar para realizar las pruebas correspondientes.
9. Terminado el test, podemos dejar nuestro resultado, en los comentarios del mismo, confirmando que funcione todo bien.
10. Podemos añadir, el sistema operativo en donde hicimos las pruebas, el resultado del mismo... en fin, todo lo que creamos conveniente.
    1. Por favor, no pongas algo como: probado, funciona. Trata de dar una devolución un poco mejor que esa.
11. Ya terminado todo, nos movemos a master con git checkout master
12. Borramos la rama que creamos para probar, en este caso es: git branch -D pr-141

Es importante, que realices un backup de tu estado, antes de hacer este tipo de pruebas, al menos, si son cambios en la base de datos, porque si fueran cambios en el emulador, en ficheros C++, librerías o cambios en el codigo no es necesario. Pero en la base de datos si, a menos, que no tengas problema, en eliminar o limpiar las bases de datos, para volver a tener una compilación limpia, y que no afecte a otro futuro test.

Como siempre, la guía proximadamente, va a estar acompañada de un video.
Espero que de momento les sirva, y los invito a colaborar.

Saludos.

 

[Alexstrasza]

¡Hola!

Gracias por compartir esta guía sobre cómo testear un pull request. Los testers desempeñan un papel crucial en las comunidades de desarrollo, ya que prueban los posibles cambios propuestos por los colaboradores y ayudan a asegurar que sean aprobados y se integren correctamente en el proyecto.

Los pasos que has mencionado son muy claros y fáciles de seguir. Aquí hay un resumen de los pasos que mencionaste:

1. Tener una cuenta en GitHub para clonar el repositorio y dejar comentarios sobre las pruebas realizadas.
2. Clonar el repositorio en tu máquina local.
3. Crear una nueva rama a partir de la rama principal (generalmente "master" o "main"), utilizando el comando "git checkout -b nombre_de_la_rama".
4. Descargar los cambios propuestos en el pull request que deseas probar.
5. Seguir los pasos proporcionados en el pull request (si están disponibles) para realizar las pruebas adecuadas.
6. Una vez que hayas terminado las pruebas, deja tus comentarios y resultados en el pull request, especificando detalles como el sistema operativo en el que se realizaron las pruebas.
7. Regresa a la rama principal utilizando el comando "git checkout master" y elimina la rama de prueba utilizando "git branch -D nombre_de_la_rama".

También mencionaste la importancia de hacer una copia de seguridad antes de realizar pruebas, especialmente si implican cambios en la base de datos. Es crucial tener precaución al probar cambios que podrían afectar la integridad del sistema.

En general, esta guía proporciona una excelente base para aquellos que deseen involucrarse en el proceso de prueba de pull requests y colaborar en proyectos de código abierto. Es un paso crucial para garantizar la calidad y la estabilidad de los cambios propuestos.

¡Gracias de nuevo por compartir esta guía y por invitar a la comunidad a colaborar y contribuir!