talent_scout 1.0.1 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e8762e9b2380fffc1760108d9519e9d6e936aa5a0372c0b4a15e426fdf002dde
-  data.tar.gz: fa0c26db874aea1c7a1fddcb0b8270bca03ba604d240c42e961ab3d7d2d21f49
+  metadata.gz: d5fd5304fedac4c3a0cddd986f91cbc7a6bbe03e31948a1abdbdeaf58b7e16bf
+  data.tar.gz: 55e50c5eb694771e367f9741d79ae5510adcf48c05fdd62252895a31157730d2
 SHA512:
-  metadata.gz: 2b0d2cd202e33572ca6a24c4235f4e7a36f0975361ba09ed870e03a758c89cfafe07ba544d5e3737a1432535d466993b50383df57fa8ee5f8d7039f77b2acad7
-  data.tar.gz: 19e4fe92e92aa8c0b69151034adf430739bee6e538e8878bcb7606d7fb9738b3f1a2f259ce264b64388bf972853c877703c95d72536a9dfc4d6e38c54db18fbf
+  metadata.gz: b4ce41f71c08cc80a4acaf3ed9b4b382b3132966f8656ee7b817751e71abdfcc5571234bc66b93f07e022545be4e939f0317b227b9d662732f5f8916a7a2a967
+  data.tar.gz: dcc4a74c840c6cb423865794008496788af7bbcdfa5fc8d4a3096bf85448efcba553af1c4e1045d62866a38b4a4ec63f8791a25f4e68c5879b43054893b68274

data/README.md

@@ -1,4 +1,4 @@
-# talent_scout [![Build Status](https://travis-ci.org/jonathanhefner/talent_scout.svg?branch=master)](https://travis-ci.org/jonathanhefner/talent_scout)
+# talent_scout
 
 Model-backed searches in Rails.  A whiz-bang example:
 
@@ -83,13 +83,13 @@ In the above example:
 
 * The `PostSearch` class handles the responsibility of searching for
   `Post` models.  It can apply any combination of its defined criteria,
-  automatically ignoring missing or blank input values.  It can also
-  order the results by one of its defined orders, in either ascending or
-  descending direction.
+  automatically ignoring missing, blank, or invalid input values.  It
+  can also order the results by one of its defined orders, in either
+  ascending or descending direction.
 * `PostsController#index` uses the `model_search` helper to construct a
-  `PostSearch`, and assigns it to the `@search` variable for later use
-  in the view.  The search results are also assigned to a variable for
-  use in the view.
+  `PostSearch` instance, and assigns it to the `@search` variable for
+  later use in the view.  The search results are also assigned to a
+  variable for use in the view.
 * The view uses Rails' stock form builder to build a search form with
   the `@search` variable.  The `link_to_search` helper is used to create
   links in the table header which sort the results.  Note that the
@@ -97,13 +97,13 @@ In the above example:
   `@search` unmodified.
 
 For a detailed explanation of the methods used in this example, see
-the [API documentation](http://www.rubydoc.info/gems/talent_scout/).
+the [API documentation](https://www.rubydoc.info/gems/talent_scout/).
 
 
-## Search Objects
+## Search Classes
 
-You can use the `talent_scout:search` generator to generate search
-object class definitions.  For example,
+You can use the `talent_scout:search` generator to generate a model
+search class definition.  For example,
 
 ```bash
 $ rails generate talent_scout:search post
@@ -116,14 +116,14 @@ class PostSearch < TalentScout::ModelSearch
 end
 ```
 
-Search objects inherit from `TalentScout::ModelSearch`.  Their target
-model class is inferred from the search object's class name.  For
-example, `PostSearch` will search for `Post` models by default.  To
-override this behavior, use `ModelSearch::model_class=`:
+Search classes inherit from `TalentScout::ModelSearch`.  Their target
+model class is inferred from the search class name.  For example,
+`PostSearch` will search for `Post` models by default.  To override this
+inference, use `ModelSearch::model_class=`:
 
 ```ruby
 class EmployeeSearch < TalentScout::ModelSearch
-  self.model_class = Person # will search for Person models instead of `Employee`
+  self.model_class = Person # search for Person models instead of `Employee`
 end
 ```
 
@@ -153,7 +153,8 @@ end
 ```
 
 Note that explicit query blocks are evaluated in the context of the
-model's `ActiveRecord::Relation`, just as model scopes are.
+model's `ActiveRecord::Relation`, just like Active Record `scope` blocks
+are.
 
 
 #### Criteria Type
@@ -186,7 +187,7 @@ Available criteria types are the same as for Active Model attributes:
 `:integer`, `:string`, `:time`, plus any custom types you define.
 
 An additional convenience type is also available: `:void`.  The `:void`
-type is just like `:boolean`, except that the criteria will not be
+type typecasts like `:boolean`, but prevents the criteria from being
 applied when the typecasted value is falsey.  For example:
 
 ```ruby
@@ -337,8 +338,8 @@ PostSearch.new(order: :title)
 PostSearch.new(order: :category)
 ```
 
-Only one order can be applied at a time, but an order can be defined
-over multiple columns:
+Only one order can be applied at a time, but an order can comprise
+multiple columns:
 
 ```ruby
 class PostSearch < TalentScout::ModelSearch
@@ -391,7 +392,7 @@ end
 PostSearch.new(order: :category).toggle_order(:category)
 ```
 
-To circumvent this behavior, and instead fix a column in a static
+To circumvent this behavior and instead fix a column in a static
 direction, append `" ASC"` or `" DESC"` to the column name:
 
 ```ruby
@@ -465,7 +466,7 @@ PostSearch.new(order: :title)
 ```
 
 Note that the default order direction can be either ascending or
-descending, by specifing `default: :asc` or `default: :desc`,
+descending by specifying `default: :asc` or `default: :desc`,
 respectively.  Also, just as only one order can be applied at a time,
 only one order can be designated default.
 
@@ -513,10 +514,9 @@ class EmployeesController < ApplicationController
 end
 ```
 
-In these examples, the search object is stored in a variable for use in
-the view, as are the search results.  The search results will be an
-`ActiveRecord::Relation`, so any additional scoping, such as pagination,
-can be applied to `@search.results`.
+In these examples, the search object is stored in `@search` for use in
+the view.  Note that `@search.results` returns an `ActiveRecord::Relation`,
+so any additional scoping, such as pagination, can be applied.
 
 
 ## Search Forms
@@ -539,7 +539,7 @@ object:
 <% end %>
 ```
 
-Notice the `method: :get` argument to `form_with`; **this is required**.
+**Notice the `method: :get` argument to `form_with`.  This is required.**
 
 Form fields will be populated with the criteria input (or default)
 values of the same name from `@search`.  Type-appropriate form fields
@@ -562,7 +562,7 @@ method:
 <%= link_to_search "Sort by title", @search.toggle_order(:title, :asc) %>
 ```
 
-The link will automatically point to current controller and current
+The link will automatically point to the current controller and current
 action, with query parameters from the given search object.  To link to
 a different controller or action, pass an options Hash in place of the
 search object:
@@ -597,9 +597,9 @@ rendering the view.
 One such method is `ModelSearch#toggle_order`, which was shown in
 [previous examples](#order-direction).  Remember that `toggle_order` is
 a builder-style method that does not modify the search object.  Instead,
-it duplicates the search object, and sets the order on the new search
-object.  Such behavior is suitable to generating links to multiple
-variants of a search, such as sort links in table column headers.
+it duplicates the search object, and sets the order on the new object.
+Such behavior is suitable to generating links to multiple variants of a
+search, such as sort links in table column headers.
 
 
 ### `ModelSearch#with` and `ModelSearch#without`
@@ -641,8 +641,7 @@ PostSearch.new(title: "Maaaaath!", published: false).without(:published)
 
 Another helpful method is `ModelSearch#each_choice`, which will iterate
 over the defined choices for a given criteria.  This can be used to
-generate links to variants of a search, or to generate options for a
-select box:
+generate links to variants of a search:
 
 ```ruby
 class PostSearch < TalentScout::ModelSearch
@@ -657,6 +656,12 @@ end
 <% end %>
 ```
 
+Notice that if the block passed to `each_choice` accepts two arguments,
+the 2nd argument will indicate if the choice is currently chosen.
+
+If no block is passed to `each_choice`, it will return an `Enumerator`.
+This can be used to generate options for a select box:
+
 ```html+erb
 <%= form_with model: @search, local: true, method: :get do |form| %>
   <%= form.select :category, @search.each_choice(:category) %>
@@ -664,10 +669,6 @@ end
 <% end %>
 ```
 
-If the block passed to `each_choice` accepts two arguments, the 2nd
-argument will indicate if the choice is currently chosen.  If no block
-is passed to `each_choice`, it will return an `Enumerator`.
-
 The `each_choice` method can also be invoked with `:order`.  Doing so
 will iterate over each direction of each defined order, yielding the
 appropriate labels including direction suffix:
@@ -723,19 +724,13 @@ in the Hash, at most, will be non-`nil`.
 
 ## Installation
 
-Add this line to your application's Gemfile:
-
-```ruby
-gem "talent_scout"
-```
-
-Then execute:
+Add the gem to your Gemfile:
 
 ```bash
-$ bundle install
+$ bundle add talent_scout
 ```
 
-And finally, run the installation generator:
+And run the installation generator:
 
 ```bash
 $ rails generate talent_scout:install
@@ -744,9 +739,9 @@ $ rails generate talent_scout:install
 
 ## Contributing
 
-Run `rake test` to run the tests.
+Run `bin/test` to run the tests.
 
 
 ## License
 
-[MIT License](https://opensource.org/licenses/MIT)
+[MIT License](MIT-LICENSE)

data/Rakefile

@@ -1,22 +1,3 @@
-begin
-  require 'bundler/setup'
-rescue LoadError
-  puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
-end
-
-require 'yard'
-
-YARD::Rake::YardocTask.new(:doc) do |t|
-end
+require 'bundler/setup'
 
 require 'bundler/gem_tasks'
-
-require 'rake/testtask'
-
-Rake::TestTask.new(:test) do |t|
-  t.libs << 'test'
-  t.test_files = FileList['test/**/*_test.rb'].exclude('test/tmp/**/*')
-  t.verbose = false
-end
-
-task default: :test

data/lib/talent_scout/controller.rb

@@ -5,9 +5,9 @@ module TalentScout
     module ClassMethods
       # Returns the controller model search class.  Defaults to a class
       # corresponding to the singular form of the controller name.  The
-      # model search class can also be set with {model_search_class=}.
-      # If the model search class has not been set, and the default
-      # class does not exist, a +NameError+ will be raised.
+      # class can be set with {model_search_class=}.  If the class has
+      # not been set and the default class does not exist, a +NameError+
+      # will be raised.
       #
       # @example
       #   class PostsController < ApplicationController
@@ -17,8 +17,7 @@ module TalentScout
       #
       # @return [Class<TalentScout::ModelSearch>]
       # @raise [NameError]
-      #   if the model search class has not been set and the default
-      #   class does not exist
+      #   if the model search class does not exist
       def model_search_class
         @model_search_class ||= "#{controller_path.classify}Search".constantize
       end
@@ -26,14 +25,13 @@ module TalentScout
       # Sets the controller model search class.  See {model_search_class}.
       #
       # @param klass [Class<TalentScout::ModelSearch>]
-      # @return [Class<TalentScout::ModelSearch>]
+      # @return [klass]
       def model_search_class=(klass)
         @model_search_class = klass
       end
 
       # Similar to {model_search_class}, but returns nil instead of
-      # raising an error when the value has not been set and the default
-      # class does not exist.
+      # raising an error when the model search class does not exist.
       #
       # @return [Class<TalentScout::ModelSearch>, nil]
       def model_search_class?
@@ -46,9 +44,9 @@ module TalentScout
       end
     end
 
-    # Instantiates {ClassMethods#model_search_class} using the current
-    # request's query params.  If that class does not exist, a
-    # +NameError+ will be raised.
+    # Instantiates {ClassMethods#model_search_class ::model_search_class}
+    # using the current request's query params.  If that class does not
+    # exist, a +NameError+ will be raised.
     #
     # @return [TalentScout::ModelSearch]
     # @raise [NameError]

data/lib/talent_scout/criteria.rb

@@ -1,6 +1,7 @@
 module TalentScout
   # @!visibility private
   class Criteria
+    SYMBOL_TO_PROC_ARITY = :to_s.to_proc.arity
 
     attr_reader :names, :allow_nil, :block
 
@@ -14,7 +15,7 @@ module TalentScout
       if applicable?(attribute_set)
         if block
           block_args = names.map{|name| attribute_set[name].value }
-          if block.arity == -1 # block from Symbol#to_proc
+          if block.arity == SYMBOL_TO_PROC_ARITY # assume block is from Symbol#to_proc
             scope.instance_exec(scope, *block_args, &block)
           else
             scope.instance_exec(*block_args, &block)

data/lib/talent_scout/model_search.rb

@@ -7,10 +7,10 @@ module TalentScout
     extend ActiveModel::Translation
 
     # Returns the model class that the search targets.  Defaults to a
-    # class with same name name as the search class, minus the "Search"
-    # suffix.  The model class can also be set with {model_class=}.
-    # If the model class has not been set, and the default class does
-    # not exist, a +NameError+ will be raised.
+    # class with same name as the search class, minus the "Search"
+    # suffix.  The class can be set with {model_class=}.  If the class
+    # has not been set and the default class does not exist, a
+    # +NameError+ will be raised.
     #
     # @example Default behavior
     #   class PostSearch < TalentScout::ModelSearch
@@ -27,8 +27,7 @@ module TalentScout
     #
     # @return [Class]
     # @raise [NameError]
-    #   if the model class has not been set and the default class does
-    #   not exist
+    #   if the model class does not exist
     def self.model_class
       @model_class ||= self.superclass == ModelSearch ?
         self.name.chomp("Search").constantize : self.superclass.model_class
@@ -37,7 +36,7 @@ module TalentScout
     # Sets the model class that the search targets.  See {model_class}.
     #
     # @param model_class [Class]
-    # @return [Class]
+    # @return [model_class]
     def self.model_class=(model_class)
       @model_class = model_class
     end
@@ -66,7 +65,7 @@ module TalentScout
     #   end
     #
     #   class PostSearch < TalentScout::ModelSearch
-    #     default_scope(&:published)
+    #     default_scope &:published
     #   end
     #
     #   PostSearch.new.results  # == Post.published
@@ -78,36 +77,36 @@ module TalentScout
       criteria_list.insert(i, Criteria.new([], true, &block))
     end
 
-    # Defines criteria to incorporate into the search.  Each criteria
-    # corresponds to an attribute on the search object that can be used
-    # when building a search form.
-    #
-    # Each attribute has a type, just as Active Model attributes do, and
-    # values passed into the search object are typecasted before
-    # criteria are evaluated.  Supported types are the same as Active
-    # Model (e.g. +:string+, +:boolean+, +:integer+, etc), with the
-    # addition of a +:void+ type.  A +:void+ type is just like a
-    # +:boolean+ type, except that the criteria is not evaluated when
-    # the typecasted value is falsey.
+    # Defines criteria that can be incorporated into a search.  The
+    # criteria will have a corresponding attribute on the search object
+    # that can be used when building a search form.  The type of the
+    # attribute can be specified, just as with Active Model attributes,
+    # and the attribute value will be typecasted before the criteria is
+    # incorporated.  Supported types are the same as Active Model (e.g.
+    # +:string+, +:boolean+, +:integer+, etc).  The default type is
+    # +:string+.  An additional +:void+ type is also supported, which
+    # typecasts like the +:boolean+ type, but prevents the criteria
+    # from being incorporated if the typecasted value is falsey.
     #
     # Alternatively, instead of a type, an Array or Hash of +choices+
-    # can be specified, and the criteria will be evaluated only if the
-    # passed-in value matches one of the choices.
+    # can be specified, and the criteria will be incorporated only if
+    # the attribute value matches one of the choices.
     #
     # Active Model +attribute_options+ can also be specified.  Most
-    # notably, the +:default+ option provides the criteria a default
-    # value to operate on.
-    #
-    # Each criteria can specify a block which recieves its corresponding
-    # typecasted value as an argument.  If the corresponding value is
-    # not set on the search object, and no default value is defined,
-    # the criteria will not be evaluated.  Like an Active Record
-    # +scope+ block, a criteria block is evaluated in the context of an
-    # +ActiveRecord::Relation+, and should return an
-    # +ActiveRecord::Relation+.  A criteria block may also return nil,
-    # in which case the criteria will be skipped.  If no criteria block
-    # is specified, the criteria will be evaluated as a +where+ clause
-    # using the criteria name and typecasted value.
+    # notably, the +:default+ option can specify a default value for the
+    # criteria to operate on.  If a default value is not specified, the
+    # criteria will be incorporated only if the attribute value is set.
+    #
+    # If no block is given, the criteria will be incorporated as a
+    # +where+ clause using the criteria name and typecasted attribute
+    # value.
+    #
+    # If a block is given, it will be passed the typecasted attribute
+    # value, and it will be evaluated in the context of an
+    # +ActiveRecord::Relation+, like Active Record +scope+ blocks are.
+    # The block should return an +ActiveRecord::Relation+.  The block
+    # may also return nil, in which case the criteria will not be
+    # incorporated.
     #
     # As a convenient shorthand, Active Record scopes which have been
     # defined on the {model_class} can be used directly as criteria
@@ -115,7 +114,7 @@ module TalentScout
     # the criteria block.
     #
     #
-    # @example Implicit block
+    # @example Without a block
     #   class PostSearch < TalentScout::ModelSearch
     #     criteria :title
     #   end
@@ -123,7 +122,7 @@ module TalentScout
     #   PostSearch.new(title: "FOO").results  # == Post.where(title: "FOO")
     #
     #
-    # @example Explicit block
+    # @example With a block
     #   class PostSearch < TalentScout::ModelSearch
     #     criteria :title do |string|
     #       where("title LIKE ?", "%#{string}%")
@@ -209,33 +208,33 @@ module TalentScout
     #   PostSearch.new(within_days: 2).results  # == Post.where("created_at >= ?", 2.days.ago)
     #
     #
-    # @overload criteria(names, type = :string, **attribute_options, &block)
-    #   @param names [String, Symbol, Array<String>, Array<Symbol>]
+    # @overload criteria(name, type = :string, **attribute_options)
+    #   @param name [String, Symbol]
     #   @param type [Symbol, ActiveModel::Type]
     #   @param attribute_options [Hash]
     #   @option attribute_options :default [Object]
-    #   @yieldparam value [Object]
-    #   @yieldreturn [ActiveRecord::Relation, nil]
     #
-    # @overload criteria(names, type = :string, **attribute_options)
-    #   @param names [String, Symbol, Array<String>, Array<Symbol>]
+    # @overload criteria(name, type = :string, **attribute_options, &block)
+    #   @param name [String, Symbol]
     #   @param type [Symbol, ActiveModel::Type]
     #   @param attribute_options [Hash]
     #   @option attribute_options :default [Object]
+    #   @yieldparam value [Object]
+    #   @yieldreturn [ActiveRecord::Relation, nil]
     #
-    # @overload criteria(names, choices:, **attribute_options, &block)
-    #   @param names [String, Symbol, Array<String>, Array<Symbol>]
-    #   @param choices [Array<String>, Array<Symbol>, Hash<String, Object>, Hash<Symbol, Object>]
+    # @overload criteria(name, choices:, **attribute_options)
+    #   @param name [String, Symbol]
+    #   @param choices [Array<String>, Array<Symbol>, Hash{String => Object}, Hash{Symbol => Object}]
     #   @param attribute_options [Hash]
     #   @option attribute_options :default [Object]
-    #   @yieldparam value [Object]
     #   @yieldreturn [ActiveRecord::Relation, nil]
     #
-    # @overload criteria(names, choices:, **attribute_options)
-    #   @param names [String, Symbol, Array<String>, Array<Symbol>]
-    #   @param choices [Array<String>, Array<Symbol>, Hash<String, Object>, Hash<Symbol, Object>]
+    # @overload criteria(name, choices:, **attribute_options, &block)
+    #   @param name [String, Symbol]
+    #   @param choices [Array<String>, Array<Symbol>, Hash{String => Object}, Hash{Symbol => Object}]
     #   @param attribute_options [Hash]
     #   @option attribute_options :default [Object]
+    #   @yieldparam value [Object]
     #   @yieldreturn [ActiveRecord::Relation, nil]
     #
     # @return [void]
@@ -260,7 +259,7 @@ module TalentScout
       criteria_list << crit
 
       crit.names.each do |name|
-        attribute name, type, attribute_options
+        attribute name, type, **attribute_options
 
         # HACK FormBuilder#select uses normal attribute readers instead
         # of `*_before_type_cast` attribute readers.  This breaks value
@@ -273,24 +272,24 @@ module TalentScout
       end
     end
 
-    # Defines an order that the search can apply to its results.  Only
-    # one order can be applied at a time, but an order can be defined
-    # over multiple columns.  If no columns are specified, the order's
-    # +name+ is taken as its column.
-    #
-    # Each order can be applied in an ascending or descending direction
-    # by appending a corresponding suffix to the order value.  By
-    # default, these suffixes are +".asc"+ and +".desc"+, but they can
-    # be overridden in the order definition using the +:asc_suffix+ and
-    # +:desc_suffix+ options, respectively.
-    #
-    # Order direction affects all columns of an order defintion, unless
+    # Defines a result order that can be incorporated into a search.
+    # Only one order can be incorporated at a time, but an order can
+    # comprise multiple columns.  If no columns are specified, the
+    # order's +name+ is taken as its column.
+    #
+    # An order can be incorporated in either ascending or descending
+    # direction by appending an appropriate suffix to the order value.
+    # By default, these suffixes are +".asc"+ and +".desc"+, but they
+    # can be overridden in the order definition using the +:asc_suffix+
+    # and +:desc_suffix+ options, respectively.
+    #
+    # The order direction will affect all columns of the order, unless
     # a column explicitly specifies +"ASC"+ or +"DESC"+, in which case
     # that column will stay fixed in its specified direction.
     #
-    # To apply an order to the search results by default, use the
-    # +:default+ option in the order definition.  (Note that only one
-    # order can be designated as the default order.)
+    # To designate the order as the default result order, use the
+    # +:default+ option.  (Note that only one order can be designated as
+    # the default order.)
     #
     # @see toggle_order
     #
@@ -350,20 +349,21 @@ module TalentScout
     #   PostSearch.new(order: :title).results            # == Post.order("title")
     #
     #
-    # @param name [String, Symbol]
-    # @param columns [Array<String>, Array<Symbol>, nil]
-    # @param options [Hash]
-    # @option options :default [Boolean, :asc, :desc] (false)
-    # @option options :asc_suffix [String] (".asc")
-    # @option options :desc_suffix [String] (".desc")
-    # @return [void]
+    # @overload order(name, columns = [name], **options)
+    #   @param name [String, Symbol]
+    #   @param columns [Array<String>, Array<Symbol>]
+    #   @param options [Hash]
+    #   @option options :default [Boolean, :asc, :desc] (false)
+    #   @option options :asc_suffix [String] (".asc")
+    #   @option options :desc_suffix [String] (".desc")
+    #   @return [void]
     def self.order(name, columns = nil, default: false, **options)
-      definition = OrderDefinition.new(name, columns, options)
+      definition = OrderDefinition.new(name, columns, **options)
 
       if !attribute_types.fetch("order", nil).equal?(order_type) || default
         criteria_options = default ? { default: definition.choice_for_direction(default) } : {}
         criteria_list.reject!{|crit| crit.names == ["order"] }
-        criteria "order", order_type, criteria_options, &:order
+        criteria "order", order_type, **criteria_options, &:order
       end
 
       order_type.add_definition(definition)
@@ -376,7 +376,7 @@ module TalentScout
     # ignored.  This behavior prevents empty search form fields from
     # affecting search results.
     #
-    # @param params [Hash<String, Object>, Hash<Symbol, Object>, ActionController::Parameters]
+    # @param params [Hash{String => Object}, Hash{Symbol => Object}, ActionController::Parameters]
     # @raise [ActiveModel::UnknownAttributeError]
     #   if +params+ is a Hash, and it contains an unrecognized key
     def initialize(params = {})
@@ -416,8 +416,8 @@ module TalentScout
       end
     end
 
-    # Builds a new model search object with +criteria_values+ merged on
-    # top of the subject search object's criteria values.
+    # Builds a new search object with +criteria_values+ merged on top of
+    # the subject search object's criteria values.
     #
     # Does not modify the subject search object.
     #
@@ -433,7 +433,7 @@ module TalentScout
     #   search.with(category: "tech").results  # == Post.where(category: "tech")
     #   search.results                         # == Post.where(category: "math")
     #
-    # @param criteria_values [Hash<String, Object>, Hash<Symbol, Object>]
+    # @param criteria_values [Hash{String => Object}, Hash{Symbol => Object}]
     # @return [TalentScout::ModelSearch]
     # @raise [ActiveModel::UnknownAttributeError]
     #   if one or more +criteria_values+ keys are invalid
@@ -441,7 +441,7 @@ module TalentScout
       self.class.new(attributes.merge!(criteria_values.stringify_keys))
     end
 
-    # Builds a new model search object with the subject search object's
+    # Builds a new search object with the subject search object's
     # criteria values, excluding values specified by +criteria_names+.
     # Default criteria values will still be applied.
     #
@@ -471,12 +471,12 @@ module TalentScout
       self.class.new(attributes.except!(*criteria_names))
     end
 
-    # Builds a new model search object with the specified order applied
-    # on top of the subject search object's criteria values.  If the
-    # subject search object already has the specified order applied, the
-    # order's direction will be toggled from +:asc+ to +:desc+ or from
-    # +:desc+ to +:asc+.  Otherwise, the specified order will be applied
-    # with an +:asc+ direction, overriding any previously applied order.
+    # Builds a new search object with the specified order applied on top
+    # of the subject search object's criteria values.  If the subject
+    # search object already has the specified order applied, the order's
+    # direction will be toggled from +:asc+ to +:desc+ or from +:desc+
+    # to +:asc+.  Otherwise, the specified order will be applied with an
+    # +:asc+ direction, overriding any previously applied order.
     #
     # If +direction+ is explicitly specified, that direction will be
     # applied regardless of previously applied direction.
@@ -510,9 +510,9 @@ module TalentScout
     # Iterates over a specified {criteria}'s defined choices.  If the
     # given block accepts a 2nd argument, a boolean will be passed
     # indicating whether that choice is currently assigned to the
-    # specified criteria.
+    # specified criteria attribute.
     #
-    # An Enumerator is returned if no block is given.
+    # If no block is given, an Enumerator is returned instead.
     #
     # @example With block
     #   class PostSearch < TalentScout::ModelSearch
@@ -577,9 +577,9 @@ module TalentScout
 
     # Returns a +HashWithIndifferentAccess+ with a key for each defined
     # {order}.  Each key's associated value indicates that order's
-    # currently applied direction -- +:asc+, +:desc+, or +nil+ if the
+    # currently applied direction -- +:asc+, +:desc+, or nil if the
     # order is not applied.  Note that only one order can be applied at
-    # a time, so, at most, one value in the Hash will be non-+nil+.
+    # a time, so, at most, one value in the Hash will be non-nil.
     #
     # @example
     #   class PostSearch < TalentScout::ModelSearch

data/lib/talent_scout/version.rb

@@ -1,3 +1,3 @@
 module TalentScout
-  VERSION = "1.0.1"
+  VERSION = "2.0.0"
 end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: talent_scout
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 2.0.0
 platform: ruby
 authors:
 - Jonathan Hefner
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-11-08 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -16,91 +15,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '5.2'
+        version: '8.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '5.2'
-- !ruby/object:Gem::Dependency
-  name: sqlite3
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: capybara
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '2.15'
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: '4.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '2.15'
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: '4.0'
-- !ruby/object:Gem::Dependency
-  name: webdrivers
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: yard
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.9'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.9'
-- !ruby/object:Gem::Dependency
-  name: simple_form
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '4.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '4.0'
-description: 
+        version: '8.1'
 email:
 - jonathan@hefner.pro
 executables: []
@@ -131,8 +53,9 @@ files:
 homepage: https://github.com/jonathanhefner/talent_scout
 licenses:
 - MIT
-metadata: {}
-post_install_message: 
+metadata:
+  source_code_uri: https://github.com/jonathanhefner/talent_scout
+  changelog_uri: https://github.com/jonathanhefner/talent_scout/blob/master/CHANGELOG.md
 rdoc_options: []
 require_paths:
 - lib
@@ -140,15 +63,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '3.4'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.1
-signing_key: 
+rubygems_version: 4.0.10
 specification_version: 4
 summary: Model-backed searches in Rails
 test_files: []