Configuración de Gemas en Proyectos Rails: Arspec, Factory Bot y Database Cleaner

Curso de Creación de APIs con Ruby on Rails

Contenido del curso

Introducción

Proyecto

Cierre

33
Creación de APIs con Rails: Buenas Prácticas y Features Avanzados
00:43 min

Tomar examen

Cursos Empresas Blog Live Conf Eventos Precios

0:007:25

Configuración de Gemas en Proyectos Rails: Arspec, Factory Bot y Database Cleaner

Curso de Creación de APIs con Ruby on Rails

Clase 5 de 33

Clase 5 / 33

Recursos

Pon a punto un entorno de pruebas sólido en Rails con RSpec Rails, shutdown matchers, Database Cleaner y Factory Bot. Con una configuración correcta y verificaciones constantes con bundle exec rspec, aseguras estabilidad desde el inicio y evitas errores difíciles de rastrear.

¿Cómo instalar y validar RSpec Rails en un proyecto?

Primero, ve a GitHub de RSpec Rails y sigue las instrucciones. La gema debe estar en los grupos de development y test. Después, ejecuta la instalación y genera los archivos necesarios para que RSpec funcione.

Ejecuta la instalación de gemas.

bundle install

Genera los archivos base de RSpec según las instrucciones del repositorio.
Verifica el set de pruebas con el comando estándar.

bundle exec rspec

Si aún no hay pruebas configuradas, verás que se ejecuta con éxito indicando cero ejemplos y cero fallos. Este será el comando de uso frecuente para correr el conjunto de pruebas.

¿Qué comando usar para correr las pruebas con RSpec?

Usa bundle exec rspec para ejecutar todo el set de pruebas.
Úsalo también tras cada cambio de configuración para validar que todo siga funcionando.

¿Qué esperar si no hay pruebas aún?

Salida con 0 ejemplos y 0 fallos.
Confirmación de que RSpec quedó operativo.

¿Cómo configurar shutdown matchers en Rails Helper?

Desde el Getting started del repositorio, añade la configuración en Rails Helper y omite las líneas indicadas por la guía. Es clave respetar el punto a partir del cual Rails ya está cargado.

# Add additional requires below this line

Añade los "requires" después de esa línea: ahí Rails ya está listo.
Elimina dependencias de minitest y test unit: usarás solo RSpec.
Conserva ActiveRecord, ActiveModel, Action Controller y la librería Rails.

Estos módulos permiten que shutdown matchers agregue matchers específicos para Rails: ActiveRecord/ActiveModel integran con la base de datos y Action Controller gestiona los controladores HTTP.

Tras guardar, ejecuta nuevamente bundle exec rspec. Si algo falla, el error señalará la línea correspondiente en Rails Helper para corregir rápido.

¿Por qué importar después de la línea indicada?

Antes de ese punto, Rails no está completamente cargado.
Cargar matchers y dependencias después evita errores de inicialización.

¿Cómo preparar Database Cleaner y Factory Bot con RSpec?

Ve al repositorio de Database Cleaner y copia la configuración de RSpec dentro del bloque RSpec.configure (en el ejemplo, estaba en la línea 47). Define la estrategia y la limpieza antes de la suite y alrededor de cada example.

Antes de cada suite: estrategia de transacción y limpieza por truncado.
Alrededor de cada example: aplica la estrategia y ejecuta el ejemplo.

Para Factory Bot, incluye su configuración dentro del mismo bloque de RSpec.configure, antes de la configuración de Database Cleaner. Esto habilita el uso de sus métodos directamente en los archivos de RSpec.

Al terminar, valida con:

bundle exec rspec

Si RSpec corre sin errores, la configuración quedó bien.

¿Qué hace la estrategia por transacción y truncado?

Transacción: abre una transacción por prueba y la revierte al finalizar.
Truncado: limpia la base antes de la suite para empezar en blanco.
Beneficio inmediato: datos aislados y repetibles en cada ejecución.

¿Cómo habilitar métodos de Factory Bot en las pruebas?

Incluye su módulo en RSpec.configure.
Luego puedes llamar sus métodos sin importar manualmente la librería.

¿Qué conceptos y habilidades aplicas en esta configuración?

RSpec Rails: gemas y comandos para pruebas en Rails.
bundle install: instalación de dependencias.
bundle exec rspec: ejecución del set de pruebas.
Rails Helper: archivo central de configuración de pruebas.
shutdown matchers: matchers adicionales integrados con Rails.
ActiveRecord/ActiveModel: integración con la base de datos.
Action Controller: controladores y respuestas HTTP.
Database Cleaner: estrategias de limpieza por transacción y truncado; configuración en la suite y cada example.
Factory Bot: helpers para generar datos de prueba.
GitHub: fuente de instrucciones y fragmentos de configuración.

¿Quieres que revisemos tu configuración o un error específico de Rails Helper o RSpec? Deja un comentario con el mensaje de error y lo vemos juntos.

Comentarios (11)11 comentarios

Natalia Hashimoto

Hace 8 años

Agrega en rails_helper.rb

Shoulda::Matchers.configure do |config|
  config.integrate do |with|
    # Choose a test framework:
    with.test_framework :rspec

    # Choose one or more libraries:
    with.library :active_record
    with.library :active_model
    with.library :action_controller
    # Or, choose all of the above:
    with.library :rails
  end
end

Eleonora Lester

Hace 7 años

En el mismo archivo, dentro de RSpec.configure do |config|, agregar tambien:

  config.before(:suite) do
    DatabaseCleaner.strategy = :transaction
    DatabaseCleaner.clean_with(:truncation)
  end

  config.around(:each) do |example|
    DatabaseCleaner.cleaning do
      example.run
    end
  end

Por último, también dentro de RSpec.configure do |config| agregar config.include FactoryBot::Syntax::Methods

Nathaly Sotomayor Ampudia

Hace 5 años

Es un gran alivio tener en el curso clases como ésta, donde además de mostrarnos cómo configurar las gemas, el profesor explica qué es lo que hace ese código adicional que agregamos para la configuración.

Cuando se aprende una nueva tecnología se desconocen muchas cosas, como éste tipo de detalles.

Es posible llegar a perder muchas horas por errores generados por una mala configuración.

Jesús Alberto Martínez Hernández

2020

group :test do
  gem 'factory_bot_rails', '~> 4.0'
  gem 'shoulda', '~> 3.6.0'
  gem 'shoulda-matchers', '~> 3.1.3'
  gem 'rails-controller-testing', '~> 1.0.4'
  gem 'faker', '~> 1.9'
  gem 'database_cleaner', '~> 1.7'
  gem 'rspec-rails', '~> 3.5'
end

Carlos Mauro Cárdenas Fernández

Hace 4 años

Holas!!!

Hay una actualizacion amigos asi que no se coloca nada en rails_helper

Alfonso Camp

no explican nada, solo habla, habla y habla

Esteban Ramos Fernández

Hace 6 años

El profe asume que lo manejas bien y no se va a centrar en detalles del lenguaje, haz el curso de ruby, date una vuelta respira y pasate por el curso :D

Julio A

Cristian Mendoza

Tambien se pueden correr las pruebas ejecutando solamente el statement rspec

Viejo que cursos mas de mierda jaja

viejo, el curso requiere que sepas muy bien ruby, además es normal tenerle miedo a algo nuevo y criticarlo de antemano, pero suele ser por desconocimiento, te recomiendo que sigas adelante, el material es muy bueno, pero insisto aprende ruby bien, porque el profe asume que lo manejas bien y no se va a centrar en detalles del lenguaje. saludos que estés bien.

YEINER CARVAJAL QUINA

En la documentación de shoulda-matchers aparece, en la configuración, estas líneas:

Shoulda::Matchers.configure do |config| config.integrate do |with| with.test_framework :rspec with.library :rails end end

Entiendo que con "with.library :rails" incluye active_record, etc.

David Espino

Hace 3 años

importante

En 2023, no debes usar directamente la gema "database_cleaner", debes usar la que incluye los drivers que más se adecuen a tu proyecto. En este caso, debemos instalar la gema "database_cleaner-active_record' Más información

Victor Manuel Franco Cañon

Configuración de factory_bot

Cuando se habla de la configuración de “FactoryBot” en el minuto 6:25, lo que se esta diciendo es que no hay que configurarla (explícitamente) sino que la gema que instalamos “factory_bot_rails” hereda todos los metodos de factory_bot ?

Anibal Rojas

Profesor

Esa línea en la configuración es un shortcut para inicializar la biblioteca, no se puede realmente hablar de que una gema herede métodos de otra gema, la herencia está definida entre clases. Lo que debe estar sucediendo es que factory_bot_rails incluye y extiende factory_bot para dar soporte dentro del ambiente de Rails.

Gustavo Fabian Sandoval

Genial la explicación previa al desarrollo

Introducción

API de blog con Ruby on Rails y TDD

Verificar herramientas antes del proyecto Rails

Proyecto

Creación de APIs con Rails: Proyecto Blog API paso a paso

Configuración de Gemas para Pruebas en Proyectos Rails

Configuración de Gemas en Proyectos Rails: Arspec, Factory Bot y Database Cleaner

Implementación de un Health Check Endpoint en API con RSpec

Diseño de Casos de Uso y Diagramas de Entidad para Aplicaciones

Diagrama entidad relación: usuario y post

Modelado de Aplicaciones con TDD en Rails

Validaciones y Pruebas TDD en Rails: Modelos USR y Post

Implementación de Endpoints para Listar y Mostrar Posts con TDD

Implementar controlador Posts con TDD

Pruebas TDD para crear y actualizar posts

Implementación de Métodos y Manejo de Excepciones en Rails API

Active Model serializers: control total de JSON en Rails

Búsqueda y Filtrado de Posts por Título con TDD

Implementación de Búsqueda de Posts con Servicios en Rails

Problema N+1 en Rails: Detección y Solución Eficaz

Identificación y solución del problema N+1 en Rails

Flujo de Autenticación en APIs con Tokens y Proveedores

Tests con RSpec para autenticación de tokens

Autenticación con Tokens: Implementación en Rails API

Autenticación de Usuarios en Controladores Rails

Autenticación y Seguridad en CRUD de Posts en Rails

Pruebas de Creación y Actualización con Autenticación en Rails

Probando API Ruby on Rails con Postman

Caching en Aplicaciones Web: Funciones y Niveles

Aceleración de Búsquedas en Rails con Caching

Background Jobs en Rails: Conceptos y Funcionalidades

Procesamiento en Background y Envío de Correos con Rails

Envío de Correos en Rails con ActionMailer y Background Jobs

Autenticación y Autorización con JWT y Auth0 en Aplicaciones Web

Cierre

Creación de APIs con Rails: Buenas Prácticas y Features Avanzados

Configuración de Gemas en Proyectos Rails: Arspec, Factory Bot y Database Cleaner