SearchObject
1.0.0
DSL para construir objetos de búsqueda.
Los objetos de búsqueda comienzan con una colección inicial (alcance) y permiten filtrarla según varias opciones.
Usos:
Agregue esta línea al Gemfile de su aplicación:
gem 'search_object'Y luego ejecuta:
$ bundle
O instálelo usted mismo como:
$ gem install search_object
Los cambios están disponibles en CHANGELOG.md
Simplemente incluya el SearchObject.module y defina sus opciones de búsqueda:
class PostSearch
include SearchObject . module
scope { Post . all }
option ( :name ) { | scope , value | scope . where name : value }
option ( :created_at ) { | scope , dates | scope . created_after dates }
option ( :published , false ) { | scope , value | value ? scope . unopened : scope . opened }
endEntonces puedes buscar en el alcance dado:
search = PostSearch . new ( filters : params [ :filters ] )
# accessing search options
search . name # => name option
search . created_at # => created at option
# accessing results
search . count # => number of found results
search . results? # => is there any results found
search . results # => found results
# params for url generations
search . params # => option values
search . params opened : false # => overwrites the 'opened' optionPuede encontrar ejemplos de las funciones y complementos más importantes aquí.
Complementos de soporte SearchObject , que se pasan al método SearchObject.module .
Los complementos son simplemente módulos Ruby, que se incluyen con SearchObject.module . Se encuentran en el módulo SearchObject::Plugin .
Complemento de paginación realmente simple, que utiliza los métodos simples .limit y .offset .
class ProductSearch
include SearchObject . module ( :paging )
scope { Product . all }
option :name
option :category_name
# per page defaults to 10
per_page 10
# range of values is also possible
min_per_page 5
max_per_page 100
end
search = ProductSearch . new ( filters : params [ :filters ] , page : params [ :page ] , per_page : params [ :per_page ] )
search . page # => page number
search . per_page # => per page (10)
search . results # => paginated page resultsPor supuesto, si desea complementos de paginación más sofisticados, puede utilizar:
include SearchObject . module ( :will_paginate )
include SearchObject . module ( :kaminari )Le ofrece filtros con opciones predefinidas.
class ProductSearch
include SearchObject . module ( :enum )
scope { Product . all }
option :order , enum : %w( popular date )
private
# Gets called when order with 'popular' is given
def apply_order_with_popular ( scope )
scope . by_popularity
end
# Gets called when order with 'date' is given
def apply_order_with_date ( scope )
scope . by_date
end
# (optional) Gets called when invalid enum is given
def handle_invalid_order ( scope , invalid_value )
scope
end
end Extiende su objeto de búsqueda con ActiveModel , para que pueda usarlo en formularios Rails.
class ProductSearch
include SearchObject . module ( :model )
scope { Product . all }
option :name
option :category_name
end <%# in some view: %>
<%= form_for ProductSearch.new do |form| %>
<% form.label :name %>
<% form.text_field :name %>
<% form.label :category_name %>
<% form.text_field :category_name %>
<% end %> Instalado como una gema separada, está diseñado para funcionar con GraphQL:
gem 'search_object_graphql'
class PostResolver
include SearchObject . module ( :graphql )
type PostType
scope { Post . all }
option ( :name , type : types . String ) { | scope , value | scope . where name : value }
option ( :published , type : types . Boolean ) { | scope , value | value ? scope . published : scope . unpublished }
endSolucionar el problema de lidiar con atributos e instrucciones de clasificación.
class ProductSearch
include SearchObject . module ( :sorting )
scope { Product . all }
sort_by :name , :price
end
search = ProductSearch . new ( filters : { sort : 'price desc' } )
search . results # => Product sorted my price DESC
search . sort_attribute # => 'price'
search . sort_direction # => 'desc'
# Smart sort checking
search . sort? ( 'price' ) # => true
search . sort? ( 'price desc' ) # => true
search . sort? ( 'price asc' ) # => false
# Helpers for dealing with reversing sort direction
search . reverted_sort_direction # => 'asc'
search . sort_direction_for ( 'price' ) # => 'asc'
search . sort_direction_for ( 'name' ) # => 'desc'
# Params for sorting links
search . sort_params_for ( 'name' ) Muy a menudo sólo necesitarás los resultados de la búsqueda:
ProductSearch . new ( params ) . results == ProductSearch . results ( params ) class ProductSearch
include SearchObject . module
end
# first arguments is treated as scope (if no scope option is provided)
search = ProductSearch . new ( scope : Product . visible , filters : params [ :f ] )
search . results # => includes only visible products class ProductSearch
include SearchObject . module
scope { Product . all }
# nil values returned from option blocks are ignored
option ( :sold ) { | scope , value | scope . sold if value }
end class ProductSearch
include SearchObject . module
scope { Product . all }
option :name # automaticly applies => { |scope, value| scope.where name: value unless value.blank? }
end class ProductSearch
include SearchObject . module
scope { Product . all }
option ( :date ) { | scope , value | scope . by_date parse_dates ( value ) }
private
def parse_dates ( date_string )
# some "magic" method to parse dates
end
end class ProductSearch
include SearchObject . module
scope { Product . all }
option :date , with : :parse_dates
private
def parse_dates ( scope , value )
# some "magic" method to parse dates
end
end class ProductSearch
include SearchObject . module
scope { RemoteEndpoint . fetch_product_as_hashes }
option ( :name ) { | scope , value | scope . select { | product | product [ :name ] == value } }
option ( :category ) { | scope , value | scope . select { | product | product [ :category ] == value } }
end Puede tener un alcance detallado sobrescribiendo el método initialize :
class ProductSearch
include SearchObject . module
option :name
option :category_name
def initialize ( user , options = { } )
super options . merge ( scope : Product . visible_to ( user ) )
end
end O puede agregar una paginación simple sobrescribiendo tanto initialize como fetch_results (usado para obtener resultados):
class ProductSearch
include SearchObject . module
scope { Product . all }
option :name
option :category_name
attr_reader :page
def initialize ( filters = { } , page = 0 )
super filters
@page = page . to_i . abs
end
def fetch_results
super . paginate page : @page
end
endPuede extraer una clase de búsqueda básica para su aplicación.
class BaseSearch
include SearchObject . module
# ... options and configuration
endEntonces úsalo como:
class ProductSearch < BaseSearch
scope { Product }
end git checkout -b my-new-feature )git commit -am 'Add some feature' )git push origin my-new-feature )rake )Vea también la lista de contribuyentes que participaron en este proyecto.
Licencia MIT
