Implementa una búsqueda por título confiable usando TDD. Aquí verás cómo preparar datos controlados con Factory Bot, validar query params en el request y afirmar que el response solo incluya los posts esperados. Con un enfoque práctico, cada paso asegura precisión y mantiene el código comprobable.
¿Cuál es el objetivo de la búsqueda por título?
La meta es filtrar posts por coincidencias en el título y comprobar que la respuesta de la API refleje ese criterio. Se trabaja con query params en la URL para enviar el término a filtrar y con aserciones claras que validan el resultado.
¿Qué valida la prueba con query params?
Que el payload no sea vacío.
Que el tamaño sea el esperado (por ejemplo, dos resultados).
Que los IDs sean exactamente los de los posts que contienen la palabra buscada.
Que el orden no afecte la comparación al usar ordenamiento previo.
¿Cómo aislar efectos en pruebas?
Incluir el request solo en la prueba que lo necesita.
Quitar inclusiones o configuraciones globales innecesarias que afectan otras pruebas.
¿Cómo preparar datos de prueba con Factory Bot?
Para evitar aleatoriedad en el atributo de publicación, se define una factory específica que garantice un estado estable. Así, las pruebas operan con posts publicados y títulos controlados.
¿Cómo controlar el atributo publish en la factory?
Crear una factory nombrada, por ejemplo, published_post.
Especificar la clase y fijar publish en true para asegurar consistencia.
# factory de posts con una variante publicadaFactoryBot.define do factory :published_post,class:'Post'do publish {true}# otros atributos según el factory baseendend
Luego, se crean tres registros con títulos similares y uno distinto para verificar el filtrado por coincidencia parcial:
Se agrega un query param en la URL con el término "hola" para que el request retorne solo los posts que contienen esa palabra en el título. Con TDD, primero se ejecuta la prueba esperando que falle y luego se implementa la lógica hasta que pase.
¿Qué aserciones garantizan el comportamiento correcto?
Verificar que el payload no esté vacío.
Verificar que el tamaño sea dos cuando se busca "hola".
Mapear y ordenar IDs para comparar sin depender del orden de llegada.
# suponer que el response ya está parseado a jsonexpect(json).not_to be_empty
expect(json.size).to eq(2)returned_ids = json.map {|p| p['id']}.sort
expected_ids =[post1.id, post2.id].sort
expect(returned_ids).to eq(expected_ids)
Además, se confirma el flujo propio de TDD: primero la prueba falla porque aún se regresan los tres posts creados y no existe la lógica de filtrado; luego se implementa el comportamiento para que solo lleguen los dos relevantes.
¿Tienes una estrategia distinta para probar búsquedas por título? Cuéntala en los comentarios y enriquezcamos la práctica de pruebas entre todos.
Implementa una búsqueda por título confiable usando TDD. Aquí verás cómo preparar datos controlados con Factory Bot, validar query params en el request y afirmar que el response solo incluya los posts esperados. Con un enfoque práctico, cada paso asegura precisión y mantiene el código comprobable.
¿Cuál es el objetivo de la búsqueda por título?
La meta es filtrar posts por coincidencias en el título y comprobar que la respuesta de la API refleje ese criterio. Se trabaja con query params en la URL para enviar el término a filtrar y con aserciones claras que validan el resultado.
¿Qué valida la prueba con query params?
Que el payload no sea vacío.
Que el tamaño sea el esperado (por ejemplo, dos resultados).
Que los IDs sean exactamente los de los posts que contienen la palabra buscada.
Que el orden no afecte la comparación al usar ordenamiento previo.
¿Cómo aislar efectos en pruebas?
Incluir el request solo en la prueba que lo necesita.
Quitar inclusiones o configuraciones globales innecesarias que afectan otras pruebas.
¿Cómo preparar datos de prueba con Factory Bot?
Para evitar aleatoriedad en el atributo de publicación, se define una factory específica que garantice un estado estable. Así, las pruebas operan con posts publicados y títulos controlados.
¿Cómo controlar el atributo publish en la factory?
Crear una factory nombrada, por ejemplo, published_post.
Especificar la clase y fijar publish en true para asegurar consistencia.
# factory de posts con una variante publicada
FactoryBot.define do
factory :published_post, class: 'Post' do
publish { true }
# otros atributos según el factory base
end
end
Luego, se crean tres registros con títulos similares y uno distinto para verificar el filtrado por coincidencia parcial:
Se agrega un query param en la URL con el término "hola" para que el request retorne solo los posts que contienen esa palabra en el título. Con TDD, primero se ejecuta la prueba esperando que falle y luego se implementa la lógica hasta que pase.
¿Qué aserciones garantizan el comportamiento correcto?
Verificar que el payload no esté vacío.
Verificar que el tamaño sea dos cuando se busca "hola".
Mapear y ordenar IDs para comparar sin depender del orden de llegada.
# suponer que el response ya está parseado a json
expect(json).not_to be_empty
expect(json.size).to eq(2)
returned_ids = json.map { |p| p['id'] }.sort
expected_ids = [post1.id, post2.id].sort
expect(returned_ids).to eq(expected_ids)
Además, se confirma el flujo propio de TDD: primero la prueba falla porque aún se regresan los tres posts creados y no existe la lógica de filtrado; luego se implementa el comportamiento para que solo lleguen los dos relevantes.
¿Tienes una estrategia distinta para probar búsquedas por título? Cuéntala en los comentarios y enriquezcamos la práctica de pruebas entre todos.
Podría utilizarse un operador ternario en esta condicional?
Nos ahorramos unas lineas de codigo ademas de ser mucho mas legible al implementar la prueba de la siguiente forma?
factory :post do
title { Faker::Lorem.sentence }
content { Faker::Lorem.paragraph }
published {
r = rand(0..1)
r == 0 ? false : true
}
user
end
Original
factory :post do
title { Faker::Lorem.sentence }
content { Faker::Lorem.paragraph }
published {
r = rand(0..1)
if r == 0
false
else
true
end
}
user
end```
Tambien para implementar caracteristicas especificas, se pueden usar traits, para especificar y ser explicito en ciertas necesidades que debe de cumplir el factory:
FactoryBot.define do
factory :post do
title { 'Example title'}
content { 'Example content' }
published { false }
user
end
trait :published_post do
published { true }
end
end
Y asi ya solo especificar el trait o traits que debera de cumplir el factory al momento de crear el objeto:
Alguien entiende cual el motivo de agregar get '/posts?search=Hola' si al final no esta utilizan el query param?
Porque en el caso que lo utilizaría debería darle solo 2 post y no 3.
En el caso que te interese en esta prueba la utilidad de un query param puedes en agregar lo siguiente:
En "application_controller.rb":
# GET /posts
def index
if params[:search].present?
@posts = Post.where("title LIKE ?", "%#{params[:search]}%")
else
@posts = Post.where(published: true)
end
render json: @posts, status: :ok
end
```Ejemplo de prueba "search":
```js
describe "Search" do
let!(:example_post_1) { create :post, :published_post, title: 'example_post_1'}
let!(:example_post_2) { create :post, :published_post, title: 'example_post_2' }
let!(:post_3) { create :post, :published_post, title: 'post_3' }
it "should return posts by title" do
get '/posts?search=post'
payload = JSON.parse(response.body)
expect(payload).to_not be_empty
expect(payload.size).to eq(2)
expect(payload.map { |p| p["id"]}.sort).to eq([example_post_1.id, example_post_2.id].sort)
expect(response).to have_http_status(200)
end
end
Si generas esta prueba teniendo en cuenta un query param "search", el valor de "payload.size" seria igual 2 y buscarías que la prueba tenga éxito. En el caso que quieres que falle cambiar : expect(payload.size).to eq(3).
Podría utilizarse un operador ternario en esta condicional?
Nos ahorramos unas lineas de codigo ademas de ser mucho mas legible al implementar la prueba de la siguiente forma?
factory:post do title {Faker::Lorem.sentence} content {Faker::Lorem.paragraph} published { r =rand(0..1) r ==0?false:true} user
end
Original
factory:post do title {Faker::Lorem.sentence} content {Faker::Lorem.paragraph} published { r =rand(0..1)if r ==0falseelsetrue end
} user
end```
yo use
0==rand(0..1)
y funciona, ya que el resultado sera un booleano
@vifrac y @luis_reyesh98 gracias por sus comentarios mucachos!
Espero sirva.
Tambien para implementar caracteristicas especificas, se pueden usar traits, para especificar y ser explicito en ciertas necesidades que debe de cumplir el factory:
FactoryBot.definedofactory:post do title {'Example title'} content {'Example content'} published {false} user
end
trait:published_post do published {true} end
end
Y asi ya solo especificar el trait o traits que debera de cumplir el factory al momento de crear el objeto:
let(:example_post){create:post,:published_post }
Alguien entiende cual el motivo de agregar get '/posts?search=Hola' si al final no esta utilizan el query param?
Porque en el caso que lo utilizaría debería darle solo 2 post y no 3.
En el caso que te interese en esta prueba la utilidad de un query param puedes en agregar lo siguiente:
En "application_controller.rb":
# GET/posts
def index
if params[:search].present? @posts =Post.where("title LIKE ?","%#{params[:search]}%")else @posts =Post.where(published:true) end
render json: @posts,status::ok
end
```Ejemplo de prueba "search":
```js
describe "Search"dolet!(:example_post_1){create:post,:published_post,title:'example_post_1'}let!(:example_post_2){create:post,:published_post,title:'example_post_2'}let!(:post_3){create:post,:published_post,title:'post_3'} it "should return posts by title"doget'/posts?search=post' payload =JSON.parse(response.body)expect(payload).to_not be_empty
expect(payload.size).toeq(2)expect(payload.map{|p| p["id"]}.sort).toeq([example_post_1.id, example_post_2.id].sort)expect(response).tohave_http_status(200) end
end
Si generas esta prueba teniendo en cuenta un query param "search", el valor de "payload.size" seria igual 2 y buscarías que la prueba tenga éxito. En el caso que quieres que falle cambiar : expect(payload.size).to eq(3).