pursuit 0.1.0

data/pursuit.gemspec

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+lib = File.expand_path('lib', __dir__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+require 'pursuit/constants'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'pursuit'
+  spec.version       = Pursuit::VERSION
+  spec.authors       = ['Nialto Services']
+  spec.email         = ['support@nialtoservices.co.uk']
+
+  spec.summary       = 'Advanced key-based searching for ActiveRecord objects.'
+  spec.homepage      = 'https://github.com/nialtoservices/pursuit'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ['lib']
+
+  spec.metadata['yard.run'] = 'yri'
+
+  spec.add_runtime_dependency 'activerecord',  '>= 5.2.0', '< 6.1.0'
+  spec.add_runtime_dependency 'activesupport', '>= 5.2.0', '< 6.1.0'
+
+  spec.add_development_dependency 'bundler',     '~> 2.0'
+  spec.add_development_dependency 'combustion',  '~> 1.1'
+  spec.add_development_dependency 'guard-rspec', '~> 4.7'
+  spec.add_development_dependency 'rake',        '~> 13.0'
+  spec.add_development_dependency 'rspec',       '~> 3.8'
+  spec.add_development_dependency 'rspec-rails', '~> 3.8'
+  spec.add_development_dependency 'rubocop',     '~> 0.77.0'
+  spec.add_development_dependency 'yard',        '~> 0.9.20'
+  spec.add_development_dependency 'sqlite3',     '~> 1.4'
+end

data/spec/internal/app/models/product.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+class Product < ActiveRecord::Base
+  has_many :variations, class_name: 'ProductVariation', inverse_of: :product
+
+  has_search relationships: { variations: %i[title stock_status] },
+             keyed_attributes: %i[title description rating],
+             unkeyed_attributes: %i[title description]
+
+  validates :title, presence: true
+end

data/spec/internal/app/models/product_variation.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+class ProductVariation < ActiveRecord::Base
+  belongs_to :product
+
+  enum stock_status: { in_stock: 1, low_stock: 2, out_of_stock: 3 }
+
+  validates :title, presence: true
+
+  validates :currency, presence: true
+  validates :amount, presence: true, numericality: true
+end

data/spec/internal/config/database.yml

@@ -0,0 +1,3 @@
+test:
+  adapter: sqlite3
+  database: db/test.sqlite3

data/spec/internal/db/schema.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+ActiveRecord::Schema.define do
+  create_table :products, force: true do |t|
+    t.string :title, null: false
+
+    t.text :description
+
+    t.integer :rating, limit: 1
+
+    t.timestamps null: false
+  end
+
+  create_table :product_variations, force: true do |t|
+    t.belongs_to :product, null: false, foreign_key: true
+
+    t.string :title, null: false
+
+    t.string :currency, null: false, default: 'USD'
+    t.integer :amount, null: false, default: 0
+
+    t.integer :stock_status, limit: 1
+
+    t.timestamps null: false
+  end
+end

data/spec/pursuit/active_record_dsl_spec.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+RSpec.describe Pursuit::ActiveRecordDSL do
+  subject(:product) { Product.new }
+
+  it { is_expected.to respond_to(:search) }
+end

data/spec/pursuit/active_record_search_spec.rb

@@ -0,0 +1,442 @@
+# frozen_string_literal: true
+
+RSpec.describe Pursuit::ActiveRecordSearch do
+  subject(:active_record_search) do
+    described_class.new(
+      Product,
+      relationships: { variations: %i[title stock_status] },
+      keyed_attributes: %i[title description rating],
+      unkeyed_attributes: %i[title description]
+    )
+  end
+
+  describe '#search' do
+    subject(:search) { active_record_search.search(query) }
+
+    context 'when passed a blank query' do
+      let(:query) { '' }
+
+      let(:product_a) { Product.create!(title: 'Alpha') }
+      let(:product_b) { Product.create!(title: 'Beta') }
+
+      before do
+        product_a
+        product_b
+      end
+
+      it 'is expected to contain all records' do
+        expect(search).to contain_exactly(product_a, product_b)
+      end
+    end
+
+    context 'when passed an unkeyed query' do
+      let(:query) { 'shirt' }
+
+      let(:product_a) { Product.create!(title: 'Plain Shirt') }
+      let(:product_b) { Product.create!(title: 'Funky Shirt') }
+      let(:product_c) { Product.create!(title: 'Socks') }
+
+      before do
+        product_a
+        product_b
+        product_c
+      end
+
+      it 'is expected to contain the matching records' do
+        expect(search).to contain_exactly(product_a, product_b)
+      end
+    end
+
+    context 'when passed an `equal to` keyed attribute query' do
+      let(:query) { 'title=="Funky Shirt"' }
+
+      let(:product_a) { Product.create!(title: 'Plain Shirt', rating: 2) }
+      let(:product_b) { Product.create!(title: 'Funky Shirt', rating: 4) }
+      let(:product_c) { Product.create!(title: 'Socks - Pack of 4') }
+
+      before do
+        product_a
+        product_b
+        product_c
+      end
+
+      it 'is expected to contain the matching records' do
+        expect(search).to contain_exactly(product_b)
+      end
+    end
+
+    context 'when passed a `not equal to` keyed attribute query' do
+      let(:query) { 'title!="Funky Shirt"' }
+
+      let(:product_a) { Product.create!(title: 'Plain Shirt', rating: 2) }
+      let(:product_b) { Product.create!(title: 'Funky Shirt', rating: 4) }
+      let(:product_c) { Product.create!(title: 'Socks - Pack of 4') }
+
+      before do
+        product_a
+        product_b
+        product_c
+      end
+
+      it 'is expected to contain the matching records' do
+        expect(search).to contain_exactly(product_a, product_c)
+      end
+    end
+
+    context 'when passed a `match` keyed attribute query' do
+      let(:query) { 'title*=shirt' }
+
+      let(:product_a) { Product.create!(title: 'Plain Shirt', rating: 2) }
+      let(:product_b) { Product.create!(title: 'Funky Shirt', rating: 4) }
+      let(:product_c) { Product.create!(title: 'Socks - Pack of 4') }
+
+      before do
+        product_a
+        product_b
+        product_c
+      end
+
+      it 'is expected to contain the matching records' do
+        expect(search).to contain_exactly(product_a, product_b)
+      end
+    end
+
+    context 'when passed a `not match` keyed attribute query' do
+      let(:query) { 'title!*=socks' }
+
+      let(:product_a) { Product.create!(title: 'Plain Shirt', rating: 2) }
+      let(:product_b) { Product.create!(title: 'Funky Shirt', rating: 4) }
+      let(:product_c) { Product.create!(title: 'Socks - Pack of 4') }
+
+      before do
+        product_a
+        product_b
+        product_c
+      end
+
+      it 'is expected to contain the matching records' do
+        expect(search).to contain_exactly(product_a, product_b)
+      end
+    end
+
+    context 'when passed a `not equal to` keyed attribute query' do
+      let(:query) { 'rating!=2' }
+
+      let(:product_a) { Product.create!(title: 'Plain Shirt', rating: 2) }
+      let(:product_b) { Product.create!(title: 'Funky Shirt', rating: 4) }
+      let(:product_c) { Product.create!(title: 'Socks - Pack of 4', rating: 5) }
+
+      before do
+        product_a
+        product_b
+        product_c
+      end
+
+      it 'is expected to contain the matching records' do
+        expect(search).to contain_exactly(product_b, product_c)
+      end
+    end
+
+    context 'when passed a `greater than` keyed attribute query' do
+      let(:query) { 'rating>2' }
+
+      let(:product_a) { Product.create!(title: 'Plain Shirt', rating: 2) }
+      let(:product_b) { Product.create!(title: 'Funky Shirt', rating: 4) }
+      let(:product_c) { Product.create!(title: 'Socks - Pack of 4', rating: 5) }
+
+      before do
+        product_a
+        product_b
+        product_c
+      end
+
+      it 'is expected to contain the matching records' do
+        expect(search).to contain_exactly(product_b, product_c)
+      end
+    end
+
+    context 'when passed a `greater than or equal to` keyed attribute query' do
+      let(:query) { 'rating>=4' }
+
+      let(:product_a) { Product.create!(title: 'Plain Shirt', rating: 2) }
+      let(:product_b) { Product.create!(title: 'Funky Shirt', rating: 4) }
+      let(:product_c) { Product.create!(title: 'Socks - Pack of 4', rating: 5) }
+
+      before do
+        product_a
+        product_b
+        product_c
+      end
+
+      it 'is expected to contain the matching records' do
+        expect(search).to contain_exactly(product_b, product_c)
+      end
+    end
+
+    context 'when passed a `less than` keyed attribute query' do
+      let(:query) { 'rating<5' }
+
+      let(:product_a) { Product.create!(title: 'Plain Shirt', rating: 2) }
+      let(:product_b) { Product.create!(title: 'Funky Shirt', rating: 4) }
+      let(:product_c) { Product.create!(title: 'Socks - Pack of 4', rating: 5) }
+
+      before do
+        product_a
+        product_b
+        product_c
+      end
+
+      it 'is expected to contain the matching records' do
+        expect(search).to contain_exactly(product_a, product_b)
+      end
+    end
+
+    context 'when passed a `less than or equal to` keyed attribute query' do
+      let(:query) { 'rating<=4' }
+
+      let(:product_a) { Product.create!(title: 'Plain Shirt', rating: 2) }
+      let(:product_b) { Product.create!(title: 'Funky Shirt', rating: 4) }
+      let(:product_c) { Product.create!(title: 'Socks - Pack of 4', rating: 5) }
+
+      before do
+        product_a
+        product_b
+        product_c
+      end
+
+      it 'is expected to contain the matching records' do
+        expect(search).to contain_exactly(product_a, product_b)
+      end
+    end
+
+    context 'when passed a `greater than` and `less than` keyed attribute query' do
+      let(:query) { 'rating>2 rating<5' }
+
+      let(:product_a) { Product.create!(title: 'Plain Shirt', rating: 2) }
+      let(:product_b) { Product.create!(title: 'Funky Shirt', rating: 4) }
+      let(:product_c) { Product.create!(title: 'Socks - Pack of 4', rating: 5) }
+
+      before do
+        product_a
+        product_b
+        product_c
+      end
+
+      it 'is expected to contain the matching records' do
+        expect(search).to contain_exactly(product_b)
+      end
+    end
+
+    context 'when passed a `match` relationship search query' do
+      let(:query) { 'variations*=green' }
+
+      let(:product_a) { Product.create!(title: 'Plain Shirt') }
+      let(:product_b) { Product.create!(title: 'Funky Shirt') }
+
+      let(:product_variation_a) { ProductVariation.create!(product: product_a, title: 'Red') }
+      let(:product_variation_b) { ProductVariation.create!(product: product_b, title: 'Green') }
+      let(:product_variation_c) { ProductVariation.create!(product: product_b, title: 'Blue') }
+
+      before do
+        product_a
+        product_b
+
+        product_variation_a
+        product_variation_b
+        product_variation_c
+      end
+
+      it 'is expected to contain the matching records' do
+        expect(search).to contain_exactly(product_b)
+      end
+    end
+
+    context 'when passed an `equal to` relationship count query' do
+      let(:query) { 'variations==1' }
+
+      let(:product_a) { Product.create!(title: 'Plain Shirt') }
+      let(:product_b) { Product.create!(title: 'Funky Shirt') }
+      let(:product_c) { Product.create!(title: 'Socks') }
+
+      let(:product_variation_a) { ProductVariation.create!(product: product_b, title: 'Red') }
+      let(:product_variation_b) { ProductVariation.create!(product: product_b, title: 'Green') }
+      let(:product_variation_c) { ProductVariation.create!(product: product_b, title: 'Blue') }
+      let(:product_variation_d) { ProductVariation.create!(product: product_c, title: 'White') }
+
+      before do
+        product_a
+        product_b
+        product_c
+
+        product_variation_a
+        product_variation_b
+        product_variation_c
+        product_variation_d
+      end
+
+      it 'is expected to contain the matching records' do
+        expect(search).to contain_exactly(product_c)
+      end
+    end
+
+    context 'when passed a `greater than` relationship count query' do
+      let(:query) { 'variations>1' }
+
+      let(:product_a) { Product.create!(title: 'Plain Shirt') }
+      let(:product_b) { Product.create!(title: 'Funky Shirt') }
+      let(:product_c) { Product.create!(title: 'Socks') }
+
+      let(:product_variation_a) { ProductVariation.create!(product: product_b, title: 'Red') }
+      let(:product_variation_b) { ProductVariation.create!(product: product_b, title: 'Green') }
+      let(:product_variation_c) { ProductVariation.create!(product: product_b, title: 'Blue') }
+      let(:product_variation_d) { ProductVariation.create!(product: product_c, title: 'White') }
+      let(:product_variation_e) { ProductVariation.create!(product: product_a, title: 'Black') }
+      let(:product_variation_f) { ProductVariation.create!(product: product_a, title: 'Gray') }
+
+      before do
+        product_a
+        product_b
+        product_c
+
+        product_variation_a
+        product_variation_b
+        product_variation_c
+        product_variation_d
+        product_variation_e
+        product_variation_f
+      end
+
+      it 'is expected to contain the matching records' do
+        expect(search).to contain_exactly(product_a, product_b)
+      end
+    end
+
+    context 'when passed a `greater than or equal to` relationship count query' do
+      let(:query) { 'variations>=2' }
+
+      let(:product_a) { Product.create!(title: 'Plain Shirt') }
+      let(:product_b) { Product.create!(title: 'Funky Shirt') }
+      let(:product_c) { Product.create!(title: 'Socks') }
+
+      let(:product_variation_a) { ProductVariation.create!(product: product_b, title: 'Red') }
+      let(:product_variation_b) { ProductVariation.create!(product: product_b, title: 'Green') }
+      let(:product_variation_c) { ProductVariation.create!(product: product_b, title: 'Blue') }
+      let(:product_variation_d) { ProductVariation.create!(product: product_c, title: 'White') }
+      let(:product_variation_e) { ProductVariation.create!(product: product_a, title: 'Black') }
+      let(:product_variation_f) { ProductVariation.create!(product: product_a, title: 'Gray') }
+
+      before do
+        product_a
+        product_b
+        product_c
+
+        product_variation_a
+        product_variation_b
+        product_variation_c
+        product_variation_d
+        product_variation_e
+        product_variation_f
+      end
+
+      it 'is expected to contain the matching records' do
+        expect(search).to contain_exactly(product_a, product_b)
+      end
+    end
+
+    context 'when passed a `less than` relationship count query' do
+      let(:query) { 'variations<3' }
+
+      let(:product_a) { Product.create!(title: 'Plain Shirt') }
+      let(:product_b) { Product.create!(title: 'Funky Shirt') }
+      let(:product_c) { Product.create!(title: 'Socks') }
+
+      let(:product_variation_a) { ProductVariation.create!(product: product_b, title: 'Red') }
+      let(:product_variation_b) { ProductVariation.create!(product: product_b, title: 'Green') }
+      let(:product_variation_c) { ProductVariation.create!(product: product_b, title: 'Blue') }
+      let(:product_variation_d) { ProductVariation.create!(product: product_c, title: 'White') }
+      let(:product_variation_e) { ProductVariation.create!(product: product_a, title: 'Black') }
+      let(:product_variation_f) { ProductVariation.create!(product: product_a, title: 'Gray') }
+
+      before do
+        product_a
+        product_b
+        product_c
+
+        product_variation_a
+        product_variation_b
+        product_variation_c
+        product_variation_d
+        product_variation_e
+        product_variation_f
+      end
+
+      it 'is expected to contain the matching records' do
+        expect(search).to contain_exactly(product_a, product_c)
+      end
+    end
+
+    context 'when passed a `less than or equal to` relationship count query' do
+      let(:query) { 'variations<=2' }
+
+      let(:product_a) { Product.create!(title: 'Plain Shirt') }
+      let(:product_b) { Product.create!(title: 'Funky Shirt') }
+      let(:product_c) { Product.create!(title: 'Socks') }
+
+      let(:product_variation_a) { ProductVariation.create!(product: product_b, title: 'Red') }
+      let(:product_variation_b) { ProductVariation.create!(product: product_b, title: 'Green') }
+      let(:product_variation_c) { ProductVariation.create!(product: product_b, title: 'Blue') }
+      let(:product_variation_d) { ProductVariation.create!(product: product_c, title: 'White') }
+      let(:product_variation_e) { ProductVariation.create!(product: product_a, title: 'Black') }
+      let(:product_variation_f) { ProductVariation.create!(product: product_a, title: 'Gray') }
+
+      before do
+        product_a
+        product_b
+        product_c
+
+        product_variation_a
+        product_variation_b
+        product_variation_c
+        product_variation_d
+        product_variation_e
+        product_variation_f
+      end
+
+      it 'is expected to contain the matching records' do
+        expect(search).to contain_exactly(product_a, product_c)
+      end
+    end
+
+    context 'when passed a `greater than` and `less than` relationship count query' do
+      let(:query) { 'variations>1 variations<3' }
+
+      let(:product_a) { Product.create!(title: 'Plain Shirt') }
+      let(:product_b) { Product.create!(title: 'Funky Shirt') }
+      let(:product_c) { Product.create!(title: 'Socks') }
+
+      let(:product_variation_a) { ProductVariation.create!(product: product_b, title: 'Red') }
+      let(:product_variation_b) { ProductVariation.create!(product: product_b, title: 'Green') }
+      let(:product_variation_c) { ProductVariation.create!(product: product_b, title: 'Blue') }
+      let(:product_variation_d) { ProductVariation.create!(product: product_c, title: 'White') }
+      let(:product_variation_e) { ProductVariation.create!(product: product_a, title: 'Black') }
+      let(:product_variation_f) { ProductVariation.create!(product: product_a, title: 'Gray') }
+
+      before do
+        product_a
+        product_b
+        product_c
+
+        product_variation_a
+        product_variation_b
+        product_variation_c
+        product_variation_d
+        product_variation_e
+        product_variation_f
+      end
+
+      it 'is expected to contain the matching records' do
+        expect(search).to contain_exactly(product_a)
+      end
+    end
+  end
+end

data/spec/pursuit/constants_spec.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+RSpec.describe Pursuit do
+  describe '::VERSION' do
+    subject { described_class::VERSION }
+
+    it 'is semantic' do
+      expect(subject).to match(/[0-9]+\.[0-9]+\.[0-9]+/)
+    end
+  end
+end

data/spec/pursuit/term_parser_spec.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+RSpec.describe Pursuit::TermParser do
+  subject(:term_parser) { described_class.new(query, keys: keys) }
+
+  let(:keys)  { %i[title description rating stock_status] }
+  let(:query) do
+    "plain title!='Socks' description*=\"green\" stock_status==in_stock shirt rating>=2 other*=thing rating<5"
+  end
+
+  describe '#unkeyed_term' do
+    subject(:unkeyed_term) { term_parser.unkeyed_term }
+
+    it 'is expected to eq the correct unkeyed term' do
+      expect(unkeyed_term).to eq('plain shirt other*=thing')
+    end
+  end
+
+  describe '#keyed_terms' do
+    subject(:keyed_terms) { term_parser.keyed_terms }
+
+    it 'is expected to eq the correct keyed terms' do
+      expect(keyed_terms).to eq([
+        Pursuit::TermParser::KeyedTerm.new('title', '!=', 'Socks'),
+        Pursuit::TermParser::KeyedTerm.new('description', '*=', 'green'),
+        Pursuit::TermParser::KeyedTerm.new('stock_status', '==', 'in_stock'),
+        Pursuit::TermParser::KeyedTerm.new('rating', '>=', '2'),
+        Pursuit::TermParser::KeyedTerm.new('rating', '<', '5')
+      ])
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,95 @@
+# frozen_string_literal: true
+
+# Conventionally, all specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# The `.rspec` file contains `--require spec_helper` which will cause this file to always be loaded,
+# without a need to explicitly require it in any files.
+#
+# Given that it is always loaded, you are encouraged to keep this file as light-weight as possible.
+# Requiring heavyweight dependencies from this file will add to the boot time of your test suite on EVERY test run,
+# even for an individual file that may not need all of that loaded. Instead, consider making a separate helper file
+# that requires the additional dependencies and performs the additional setup, and require it from the spec files
+# that actually need it.
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+
+require 'combustion'
+Combustion.initialize! :active_record
+
+require 'bundler'
+Bundler.require :default, :development
+
+require 'rspec/rails'
+
+RSpec.configure do |config|
+  # rspec-expectations config goes here. You can use an alternate assertion/expectation library such as wrong or the
+  # stdlib/minitest assertions if you prefer.
+  config.expect_with :rspec do |expectations|
+    # This option will default to `true` in RSpec 4.
+    # It makes the `description` and `failure_message` of custom matchers include text for helper methods defined using
+    # `chain`, e.g.:
+    #   be_bigger_than(2).and_smaller_than(4).description
+    #   # => "be bigger than 2 and smaller than 4"
+    # ...rather than:
+    #   # => "be bigger than 2"
+    expectations.include_chain_clauses_in_custom_matcher_descriptions = true
+  end
+
+  # rspec-mocks config goes here. You can use an alternate test double library (such as bogus or mocha) by changing the
+  # `mock_with` option here.
+  config.mock_with :rspec do |mocks|
+    # Prevents you from mocking or stubbing a method that does not exist on a real object.
+    # This is generally recommended, and will default to `true` in RSpec 4.
+    mocks.verify_partial_doubles = true
+  end
+
+  # This option will default to `:apply_to_host_groups` in RSpec 4 (and will have no way to turn it off -- the option
+  # exists only for backwards compatibility in RSpec 3).
+  # It causes shared context metadata to be inherited by the metadata hash of host groups and examples, rather than
+  # triggering implicit auto-inclusion in groups with matching metadata.
+  config.shared_context_metadata_behavior = :apply_to_host_groups
+
+  # This allows you to limit a spec run to individual examples or groups you care about by tagging them with `:focus`
+  # metadata. When nothing is tagged with `:focus`, all examples get run.
+  # RSpec also provides aliases for `it`, `describe`, and `context` that include `:focus` metadata: `fit`, `fdescribe`
+  # and `fcontext`, respectively.
+  config.filter_run_when_matching :focus
+
+  # Allows RSpec to persist some state between runs in order to support the `--only-failures` and `--next-failure` CLI
+  # options. We recommend you configure your source control system to ignore this file.
+  config.example_status_persistence_file_path = 'spec/examples.txt'
+
+  # Limits the available syntax to the non-monkey patched syntax that is recommended. For more details, see:
+  #   - http://rspec.info/blog/2012/06/rspecs-new-expectation-syntax/
+  #   - http://www.teaisaweso.me/blog/2013/05/27/rspecs-new-message-expectation-syntax/
+  #   - http://rspec.info/blog/2014/05/notable-changes-in-rspec-3/#zero-monkey-patching-mode
+  config.disable_monkey_patching!
+
+  # Retrieve the default formatter from the current environment.
+  default_formatter = ENV['RSPEC_DEFAULT_FORMATTER']
+
+  if default_formatter.is_a?(String) && !default_formatter.empty?
+    config.default_formatter = default_formatter
+  elsif config.files_to_run.one?
+    # Use the documentation formatter for detailed output when running an individual spec file, unless a formatter has
+    # already been configured (e.g. via a command-line flag or using the RSPEC_DEFAULT_FORMAT environment variable).
+    config.default_formatter = 'doc'
+  end
+
+  config.use_transactional_fixtures = true
+
+  # Print the 10 slowest examples and example groups at the end of the spec run, to help surface which specs are
+  # running particularly slow.
+  # config.profile_examples = 10
+
+  # Run specs in random order to surface order dependencies. If you find an order dependency and want to debug it, you
+  # can fix the order by providing the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = :random
+
+  # Seed global randomization in this process using the `--seed` CLI option.
+  # Setting this allows you to use `--seed` to deterministically reproduce test failures related to randomization by
+  # passing the same `--seed` value as the one that triggered the failure.
+  Kernel.srand config.seed
+end
+
+Dir[File.expand_path('support/**/*.rb', __dir__)].each { |path| require(path) }