Creación y Actualización de Posts con Pruebas TDD

Clase 13 de 33Curso 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:

  1. 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 usando FactoryBot.
  2. 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".

  3. 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:

  1. Crear un Post existente: A diferencia del POST, aquí necesitamos un post ya creado para poder actualizarlo.

  2. Preparar los parámetros de actualización: Al igual que con la creación, utilizaremos FactoryBot junto con Faker para generar datos aleatorios y realizaremos modificaciones como cambiar el título o el contenido.

  3. Realizar la petición PUT: Pasaremos el ID del post que queremos actualizar, junto con los parámetros de actualización.

  4. Verificaciones de la prueba:

    • Verificar que el payload retornado no esté vacío.
    • Comprobar que el ID del payload corresponde con el ID 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:

  1. 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.

  2. 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 estado unprocessable 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.