Creación y Actualización de Posts con Pruebas TDD
Clase 13 de 33 • Curso de Creación de APIs con Ruby on Rails
Resumen
¿Cómo implementar los métodos para crear y actualizar un post?
Para empezar a desarrollar métodos que nos permitan crear y actualizar posts, vamos a seguir la metodología de desarrollo impulsado por pruebas (TDD, por sus siglas en inglés). Esto implica que primero crearemos las pruebas necesarias para garantizar el correcto funcionamiento de nuestras funciones, antes de realizar la implementación final.
¿Cómo crear una prueba para el método POST?
El método POST será responsable de la creación de nuevos posts. La creación de una prueba para este método sigue estos pasos:
-
Preparación de datos: Necesitamos una serie de datos que serán enviados a la petición POST. Estos datos incluirán:
- Un título para el post.
- El contenido del post.
- Un campo para indicar si está publicado o no.
- Un
userID
, que lo generaremos creando un usuario en nuestro sistema usandoFactoryBot
.
-
Llamar al endpoint POST: Utilizaremos los datos generados para realizar la petición al endpoint POST. Es importante distinguir entre el método HTTP POST y el modelo de datos llamado "Post".
-
Verificaciones de la prueba:
- Asegurarnos de que el payload de la respuesta no esté vacío.
- Verificar que el payload contenga un
ID
. - Confirmar que la respuesta HTTP tenga un código de estado
created
(201), lo que significa que el recurso ha sido creado exitosamente.
¿Cómo probar el método PUT para actualizar un post?
Para el método PUT, que actualiza un post existente, los pasos son los siguientes:
-
Crear un Post existente: A diferencia del POST, aquí necesitamos un post ya creado para poder actualizarlo.
-
Preparar los parámetros de actualización: Al igual que con la creación, utilizaremos
FactoryBot
junto conFaker
para generar datos aleatorios y realizaremos modificaciones como cambiar el título o el contenido. -
Realizar la petición PUT: Pasaremos el
ID
del post que queremos actualizar, junto con los parámetros de actualización. -
Verificaciones de la prueba:
- Verificar que el payload retornado no esté vacío.
- Comprobar que el
ID
del payload corresponde con elID
del post que se actualizó. - Confirmar que la respuesta HTTP sea
ok
(200), indicando que la operación fue exitosa.
¿Cómo manejar errores en posts y actualizaciones inválidas?
Es crucial verificar cómo el sistema maneja datos incompletos o inválidos. Para esto, agregamos pruebas que comprueben cómo responde el sistema ante estas situaciones:
-
Errores al crear un post: Intentamos crear un post con un campo obligatorio vacío, como el título. La expectativa es recibir una respuesta
unprocessable entity
(422), junto con un mensaje de error. -
Errores al actualizar un post: De manera similar, probamos actualizar un post definiendo campos importantes como el contenido o título a
nil
. La prueba debe verificar que se retorne un estadounprocessable entity
y un mensaje de error.
Para ejecutar estas pruebas, volvemos a la consola de comandos y verificamos que las pruebas respectivas fallen debido a la inexistencia de rutas. Así, hemos establecido un marco de pruebas que validará la correcta implementación de lógica para la creación y actualización de posts. Ahora, estamos listos para pasar a la implementación práctica que hará que estas pruebas sean exitosas en el futuro.