fastererer 0.12.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: ee0a8fc9f430360ccef546a4f391fdb3112801f6fb2c56204900f0dca8214063
+  data.tar.gz: a477c6a7b4b9f19011ea89bee00aa193d562f91981dd38e5136cd88fd7ebca14
+SHA512:
+  metadata.gz: 4d239a4233228c45cc0c0ea28ef00110a8d2ea6476c258ef8f68d3f5b443a66cc48724f47529bb6eb787857843a3c7a4d84aed4aeda09c3a2266880c65ccb14a
+  data.tar.gz: 6ac88eca14ca854edc0e549b4ddbd6cd9b39796fb9658c10e3c16399b65a7341cea039c0d18fbb9e243406fe8503072ec25ba1a9671dba35d77f0549995bc7ea

data/.fastererer.yml

@@ -0,0 +1,27 @@
+speedups:
+  rescue_vs_respond_to: true
+  module_eval: true
+  shuffle_first_vs_sample: true
+  for_loop_vs_each: true
+  each_with_index_vs_while: false
+  map_flatten_vs_flat_map: true
+  reverse_each_vs_reverse_each: true
+  select_first_vs_detect: true
+  select_last_vs_reverse_detect: true
+  sort_vs_sort_by: true
+  fetch_with_argument_vs_block: true
+  keys_each_vs_each_key: true
+  hash_merge_bang_vs_hash_brackets: true
+  block_vs_symbol_to_proc: true
+  proc_call_vs_yield: true
+  gsub_vs_tr: true
+  getter_vs_attr_reader: true
+  setter_vs_attr_writer: true
+
+exclude_paths:
+  - 'spec/support/analyzer/*.rb'
+  - 'spec/support/binary_call/*.rb'
+  - 'spec/support/method_call/*.rb'
+  - 'spec/support/method_definition/*.rb'
+  - 'spec/support/rescue_call/*.rb'
+  - 'vendor/**/*.rb'

data/.ruby-version

@@ -0,0 +1 @@
+4.0.4

data/CHANGELOG.md

@@ -0,0 +1,113 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+
+The format is based on [Keep a Changelog] and this project adheres to [Semantic Versioning].
+
+Versions 0.11.0 and earlier were released as [`fasterer`](https://github.com/DamirSvrtan/fasterer), prior to the fork. From 0.12.0 onward, this is `fastererer`, maintained by ExtractableMedia.
+
+## [Unreleased]
+
+## [0.12.0] - 2026-05-18
+
+### Added
+
+- [#2]: Explicit support for Ruby 4.0.
+- [#42]: `NO_COLOR` env var and `--no-color` flag to suppress ANSI color output. Color also
+  auto-disables when STDOUT isn't a TTY (piped output, CI logs, editor integrations).
+- [#42]: `--help`/`-h` and `--version`/`-v` CLI flags.
+
+### Changed
+
+- [#1]: Rename the gem from `fasterer` to `fastererer`:
+  - Config filename: `.fasterer.yml` → `.fastererer.yml`.
+  - Executable: `fasterer` → `fastererer`.
+  - Top-level module: `Fasterer` → `Fastererer`.
+
+### Removed
+
+- [#2]: Support for EOL Ruby versions (2.x, 3.0, 3.1, 3.2). Minimum required Ruby is now 3.3.
+
+### Fixed
+
+- `select_last_vs_reverse_detect` no longer reports a false positive when `.last` is called with
+  arguments. `.last(n)` can return multiple elements, so `detect` (which only returns the first
+  match) isn't an equivalent replacement. Mirrors the same fix for `select_first_vs_detect`
+  shipped in 0.10.1.
+
+## 0.11.0
+
+- There have been multiple issues filed with the colorize gem, such as licencing, gem versions etc. Due to the easy implementation, fasterer will now leverage an internal implementation of this so we don't need to get issues tracked bc of colorize. There might be other issues that arise (perhaps somebody leveraging Windows might have issues), but that's okay, we'll solve it.
+
+- There has been a [bug report #102](https://github.com/DamirSvrtan/fasterer/issues/102) that the Redis `#keys` method shouldn't trigger `Hash#each_key` recommendation. It's not possible to detect that what is the receiver of the keys method call, but the keys method called on the Hash doesn't accept arguments while the redis one does. So not an ideal solution, but should fix any issues for now.
+
+
+## 0.10.1
+
+- There has been a [bug report #99](https://github.com/DamirSvrtan/fasterer/issues/99) that the `select_first_vs_detect` reports false positives when first gets an argument passed in. If there is an argument passed in, the detect method is not suitable, since it always returns the first element matching (can't return multiple items).
+
+## 0.10.0
+
+- Due to issues while setting up builds with Github Actions, I have dropped Ruby 2.2
+  support. It's EOL date was 2018-03-31, and I don't have the bandwidth to support
+  deprecated Ruby versions. The only reason at this point why Ruby versions 2.3, 2.4
+  and 2.5 are supported is because they still work with other dependencies, so it's
+  no effort currently to support them. Once they become issues, they'll probably be
+  dropped.
+- Upgrade to ruby_parser 3.19.1 that fully supports Ruby 3.1
+
+## 0.9.0
+
+- Ruby 3 support! Merged in [#85](https://github.com/DamirSvrtan/fasterer/pull/85), a PR that relaxed Ruby version constraints and added a minor change to support Ruby 3.0. Thanks to [swiknaba](https://github.com/swiknaba).
+
+## 0.8.3
+
+- Merged in [#79](https://github.com/DamirSvrtan/fasterer/pull/79), a PR that makes sure the output is green when there are no failures.
+
+## 0.8.2
+
+- Fixes [#77](https://github.com/DamirSvrtan/fasterer/issues/77). An error occurs on the symbol to proc check when somebody invokes a method with no arguments on an array or range inside of the inspected block. Seems like a bug in the inspected code, but nevertheless it is a code path we need to support.
+
+## 0.8.1
+
+- Ignore lambda literals when checking symbol to proc. Thanks to [kiyot](https://github.com/kiyot) for his fix in PR [#74](https://github.com/DamirSvrtan/fasterer/pull/74).
+
+## 0.8.0
+
+- Dropped support for ruby versions below 2.2.0 and locks ruby_parser to be above or equal to 1.14.1. The new ruby_parser version 1.14.1 explicitly [requires ruby versions above 2.2.0](https://github.com/seattlerb/ruby_parser/issues/298#issuecomment-539795933), so this affects fasterer as well.
+
+## 0.7.1
+
+- Fix `check_symbol_to_proc` rule from crashing when there is no receiver [#67](https://github.com/DamirSvrtan/fasterer/pull/67)
+
+## 0.7.0
+
+- More inclusive `check_symbol_to_proc` rule - don't only look at #each but any method that could leverage the symbol to proc rule. Merged through [#41](https://github.com/DamirSvrtan/fasterer/pull/41)
+
+## 0.6.0
+
+- Enable placing the `.fasterer.yml` file not just in the current dir, but in any parent directory as well.
+
+## 0.5.1
+
+- Upgrade to ruby_parser 3.13.0 that fully supports Ruby 2.6
+
+## 0.5.0
+
+- New style of outputting offenses: `spec/support/output/sample_code.rb:1 For loop is slower than using each.`
+
+## 0.4.1
+- Upgrade ruby parser version to 3.11.0 (to stop warnings)
+
+## 0.4.0
+- Better error message on each_key
+- Update Ruby Parser to ~> 3.9
+- Support Ruby 2.3
+
+[Keep a Changelog]: https://keepachangelog.com
+[Semantic Versioning]: https://semver.org/spec/v2.0.0.html
+[Unreleased]: https://github.com/ExtractableMedia/fastererer/compare/v0.12.0...HEAD
+[0.12.0]: https://github.com/ExtractableMedia/fastererer/compare/v0.11.0...v0.12.0
+[#1]: https://github.com/ExtractableMedia/fastererer/pull/1
+[#2]: https://github.com/ExtractableMedia/fastererer/pull/2
+[#42]: https://github.com/ExtractableMedia/fastererer/pull/42

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,18 @@
+# Code of Conduct
+
+Fastererer follows [The Ruby Community Conduct Guideline][ruby-conduct] in all "collaborative
+space", which is defined as community communications channels (such as mailing lists, submitted
+patches, commit comments, etc.):
+
+* Participants will be tolerant of opposing views.
+* Participants must ensure that their language and actions are free of personal attacks and
+  disparaging personal remarks.
+* When interpreting the words and actions of others, participants should always assume good
+  intentions.
+* Behaviour which can be reasonably considered harassment will not be tolerated.
+
+If you have any concerns about behaviour within this project, please contact us at
+[matt.menefee@extractablemedia.com][email].
+
+[email]: mailto:matt.menefee@extractablemedia.com
+[ruby-conduct]: https://www.ruby-lang.org/en/conduct

data/CONTRIBUTING.md

@@ -0,0 +1,63 @@
+# Contributing to fastererer
+
+Thanks for your interest in improving `fastererer`. This document explains how to report issues
+and submit code.
+
+## Reporting Issues
+
+Before opening a new issue:
+
+1. Check the [existing issues][issues] to avoid duplicates.
+2. Confirm the bug reproduces on the latest release.
+
+When opening an issue, include:
+
+- The output of `fastererer --version`
+- Your Ruby version (`ruby --version`)
+- A minimal reproduction — the smallest Ruby snippet that triggers the behavior
+- The expected behavior and the actual behavior
+
+## Pull Requests
+
+1. Fork the repository and create a topic branch off `main`.
+2. Run `bin/setup` to install dependencies (or `bundle install` directly).
+3. Add tests that cover the change. Bug fixes should include a regression spec.
+4. Run the test suite with `bin/rspec` and make sure it passes.
+5. Update [CHANGELOG.md][changelog] under an unreleased heading describing the change.
+6. Submit the PR with a clear description of what changed and why.
+
+For non-trivial changes, consider opening an issue first to discuss the approach.
+
+## Local Development
+
+After cloning:
+
+```bash
+bin/setup            # installs dependencies
+bin/console          # opens an IRB session with the gem loaded
+bin/rake             # runs the test suite and rubocop (the default task)
+bin/rspec            # runs just the test suite
+bin/rubocop          # runs just the linter
+```
+
+To try the executable against a Ruby file:
+
+```bash
+bundle exec exe/fastererer path/to/file.rb
+```
+
+## Code Style
+
+- Follow the [Ruby Style Guide][ruby-style-guide].
+- Run `bin/rubocop` before submitting — CI runs the default rake task on every PR.
+- New Ruby files should start with `# frozen_string_literal: true`.
+- Tests use RSpec — see existing specs in `spec/` for examples and conventions.
+
+## Code of Conduct
+
+By participating in this project, you agree to abide by its [Code of Conduct][code-of-conduct].
+
+[changelog]: CHANGELOG.md
+[code-of-conduct]: CODE_OF_CONDUCT.md
+[issues]: https://github.com/ExtractableMedia/fastererer/issues
+[ruby-style-guide]: https://rubystyle.guide

data/LICENSE.txt

@@ -0,0 +1,23 @@
+Copyright (c) 2015 Damir Svrtan
+Copyright (c) 2026 ExtractableMedia (fork modifications)
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,169 @@
+# Fastererer
+
+[![CI](https://github.com/ExtractableMedia/fastererer/actions/workflows/ci.yml/badge.svg)](https://github.com/ExtractableMedia/fastererer/actions/workflows/ci.yml)
+[![Gem Version](https://badge.fury.io/rb/fastererer.svg)](https://badge.fury.io/rb/fastererer)
+[![Gem Downloads](https://img.shields.io/gem/dt/fastererer.svg)](https://rubygems.org/gems/fastererer)
+
+[Roadmap][roadmap-project] |
+[Changelog](./CHANGELOG.md) |
+[Contributing](./CONTRIBUTING.md)
+
+`fastererer` is a static analyzer that suggests speed improvements for Ruby code, inspired by
+[fast-ruby][fast-ruby] and [Sferik's talk at Baruco Conf][sferik-talk]. It's a maintained fork of
+[fasterer][fasterer] with Ruby 3.3+ support and native [Prism][prism] parsing.
+
+Suggestions aren't gospel — many trade clarity for marginal speed gains. Use judgment,
+especially in non-performance-critical Rails code; the wins matter most in hot paths like web
+frameworks and request middleware.
+
+## Installation
+
+Add to your `Gemfile`:
+
+```ruby
+group :development do
+  gem 'fastererer', require: false
+end
+```
+
+Then run `bundle install`. Or install directly:
+
+```shell
+gem install fastererer
+```
+
+Fastererer requires Ruby 3.3 or higher.
+
+## Usage
+
+Run from the root of your project to scan everything:
+
+```shell
+bundle exec fastererer
+```
+
+Pass a path to scan a specific file or directory:
+
+```shell
+bundle exec fastererer app/models
+bundle exec fastererer app/models/post.rb
+```
+
+Fastererer exits with status `1` when offenses are found, making it suitable for CI.
+
+## Example output
+
+```text
+app/models/post.rb:57 Array#select.first is slower than Array#detect.
+app/models/post.rb:61 Array#select.first is slower than Array#detect.
+
+db/seeds/cities.rb:15 Hash#keys.each is slower than Hash#each_key.
+db/seeds/cities.rb:33 Hash#keys.each is slower than Hash#each_key.
+
+test/options_test.rb:84 Hash#merge! with one argument is slower than Hash#[].
+
+test/module_test.rb:272 Don't rescue NoMethodError, rather check with respond_to?.
+
+spec/cache/mem_cache_store_spec.rb:161 Using tr is faster than gsub when replacing a single character in a string with another single character.
+```
+
+## Configuration
+
+Configuration lives in a `.fastererer.yml` file at the root of your project (or any ancestor
+directory). It supports two options:
+
+* Turn individual speedup checks off
+* Exclude files or directories
+
+Example:
+
+```yaml
+speedups:
+  rescue_vs_respond_to: true
+  module_eval: true
+  shuffle_first_vs_sample: true
+  for_loop_vs_each: true
+  each_with_index_vs_while: false
+  map_flatten_vs_flat_map: true
+  reverse_each_vs_reverse_each: true
+  select_first_vs_detect: true
+  sort_vs_sort_by: true
+  fetch_with_argument_vs_block: true
+  keys_each_vs_each_key: true
+  hash_merge_bang_vs_hash_brackets: true
+  block_vs_symbol_to_proc: true
+  proc_call_vs_yield: true
+  gsub_vs_tr: true
+  select_last_vs_reverse_detect: true
+  getter_vs_attr_reader: true
+  setter_vs_attr_writer: true
+  include_vs_cover_on_range: true
+
+exclude_paths:
+  - 'vendor/**/*.rb'
+  - 'db/schema.rb'
+```
+
+## CI integration
+
+Fastererer's non-zero exit status on offenses makes it drop-in for CI. A minimal GitHub Actions
+step:
+
+```yaml
+- name: Run fastererer
+  run: bundle exec fastererer
+```
+
+Color output is auto-disabled when STDOUT isn't a TTY, when `NO_COLOR` is set (see
+[no-color.org](https://no-color.org/)), or when `--no-color` is passed — so CI logs, piped output
+(`fastererer | grep`), and editor integrations get plain text without configuration.
+
+## Migrating from fasterer
+
+`fastererer` is a hard fork of [fasterer][fasterer] at v0.11.0. To migrate an existing project:
+
+1. Replace `gem 'fasterer'` with `gem 'fastererer'` in your `Gemfile`
+2. Rename `.fasterer.yml` to `.fastererer.yml`
+3. Update CI commands from `fasterer` to `fastererer`
+
+## Roadmap
+
+Roadmap items are tracked in the [Fastererer Roadmap][roadmap-project] project.
+
+## Questions?
+
+Have a question? Start a [discussion][discussions] — questions, ideas, and show-and-tell are all
+welcome there.
+
+## Bugs?
+
+Found a bug? [Open an issue][issues] or send a pull request.
+
+## Development
+
+Clone the repo and run `bin/setup` to install dependencies. Run tests with `bin/rspec`. See
+[CONTRIBUTING.md](./CONTRIBUTING.md) for the full development workflow.
+
+## License
+
+Fastererer is released under the [MIT License](./LICENSE.txt).
+
+## Code of Conduct
+
+Everyone interacting in this project's codebases, issue trackers, and discussions is expected to
+follow the [Code of Conduct](./CODE_OF_CONDUCT.md).
+
+## Special Thanks
+
+Fastererer carries forward [Damir Svrtan][damir-svrtan]'s [fasterer][fasterer] (v0.11.0 was the
+fork point). Thanks to Damir for the original work, and to the [fast-ruby][fast-ruby] community
+for the idiom catalog that drives the speed checks.
+
+[damir-svrtan]: https://github.com/DamirSvrtan
+[discussions]: https://github.com/ExtractableMedia/fastererer/discussions
+[fast-ruby]: https://github.com/fastruby/fast-ruby
+[fasterer]: https://github.com/DamirSvrtan/fasterer
+[issues]: https://github.com/ExtractableMedia/fastererer/issues
+[prism]: https://github.com/ruby/prism
+[roadmap-project]: https://github.com/orgs/ExtractableMedia/projects/1
+[sferik-talk]: https://speakerdeck.com/sferik/writing-fast-ruby

data/Rakefile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+require 'rubocop/rake_task'
+
+desc 'Run all RSpec tests'
+RSpec::Core::RakeTask.new(:spec)
+
+RuboCop::RakeTask.new
+
+task default: %i[spec rubocop]

data/SECURITY.md

@@ -0,0 +1,20 @@
+# Security Policy
+
+## Supported Versions
+
+Only the latest released version of `fastererer` receives security updates. Older versions are not
+supported.
+
+## Reporting a Vulnerability
+
+Please report security vulnerabilities **privately** rather than opening a public GitHub issue.
+
+The preferred channel is **GitHub Security Advisories**: [Report a vulnerability][advisory].
+
+If GitHub is unavailable, email [matt.menefee@extractablemedia.com][email].
+
+We will acknowledge receipt within a few business days and work with you on a coordinated disclosure
+timeline. Credit will be given in the release notes unless you prefer to remain anonymous.
+
+[advisory]: https://github.com/ExtractableMedia/fastererer/security/advisories/new
+[email]: mailto:matt.menefee@extractablemedia.com

data/exe/fastererer

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+$LOAD_PATH << File.expand_path('../lib', __dir__)
+require 'fastererer/cli'
+
+Fastererer::CLI.execute

data/lib/fastererer/analyzer.rb

@@ -0,0 +1,94 @@
+# frozen_string_literal: true
+
+require 'fastererer/method_definition'
+require 'fastererer/method_call'
+require 'fastererer/rescue_call'
+require 'fastererer/offense_collector'
+require 'fastererer/parser'
+require 'fastererer/scanners/method_call_scanner'
+require 'fastererer/scanners/rescue_call_scanner'
+require 'fastererer/scanners/method_definition_scanner'
+
+module Fastererer
+  class Analyzer
+    attr_reader :file_path
+    alias path file_path
+
+    def initialize(file_path)
+      @file_path = file_path.to_s
+      @file_content = File.read(file_path)
+    end
+
+    def scan
+      sexp_tree = Fastererer::Parser.parse(@file_content)
+      traverse_sexp_tree(sexp_tree)
+    end
+
+    def errors
+      @errors ||= Fastererer::OffenseCollector.new
+    end
+
+    private
+
+    def traverse_sexp_tree(sexp_tree)
+      return unless sexp_tree.is_a?(Sexp)
+
+      token = sexp_tree.first
+      scan_by_token(token, sexp_tree)
+
+      if %i[call iter].include?(token)
+        descend_into_call(sexp_tree)
+      else
+        sexp_tree.each { |element| traverse_sexp_tree(element) }
+      end
+    end
+
+    def descend_into_call(sexp_tree)
+      method_call = MethodCall.new(sexp_tree)
+      traverse_sexp_tree(method_call.receiver_element) if method_call.receiver_element
+      traverse_sexp_tree(method_call.arguments_element)
+      traverse_sexp_tree(method_call.block_body) if method_call.block?
+    end
+
+    def scan_by_token(token, element)
+      case token
+      when :defn
+        scan_method_definitions(element)
+      when :call, :iter
+        scan_method_calls(element)
+      when :for
+        scan_for_loop(element)
+      when :resbody
+        scan_rescue(element)
+      end
+    end
+
+    def scan_method_definitions(element)
+      method_definition_scanner = MethodDefinitionScanner.new(element)
+
+      return unless method_definition_scanner.offense_detected?
+
+      errors.push(method_definition_scanner.offense)
+    end
+
+    def scan_method_calls(element)
+      method_call_scanner = MethodCallScanner.new(element)
+
+      return unless method_call_scanner.offense_detected?
+
+      errors.push(method_call_scanner.offense)
+    end
+
+    def scan_for_loop(element)
+      errors.push(Fastererer::Offense.new(:for_loop_vs_each, element.line))
+    end
+
+    def scan_rescue(element)
+      rescue_call_scanner = RescueCallScanner.new(element)
+
+      return unless rescue_call_scanner.offense_detected?
+
+      errors.push(rescue_call_scanner.offense)
+    end
+  end
+end

data/lib/fastererer/cli.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+require 'optparse'
+require_relative 'file_traverser'
+require_relative 'painter'
+require_relative 'version'
+
+module Fastererer
+  class CLI
+    def self.execute
+      options = parse_options(ARGV.dup)
+      Painter.disable! if options[:no_color]
+      file_traverser = Fastererer::FileTraverser.new(options[:path])
+      file_traverser.traverse
+      abort if file_traverser.offenses_found?
+    end
+
+    def self.parse_options(argv)
+      options = {}
+      options[:path] = build_parser(options).parse(argv).first
+      options
+    end
+
+    def self.build_parser(options)
+      OptionParser.new do |opts|
+        opts.banner = 'Usage: fastererer [options] [path]'
+        opts.on('--no-color', 'Disable ANSI color in output') { options[:no_color] = true }
+        opts.on('-h', '--help', 'Show this help') { show_help_and_exit(opts) }
+        opts.on('-v', '--version', 'Show version') { show_version_and_exit }
+      end
+    end
+
+    def self.show_help_and_exit(opts)
+      puts opts
+      exit
+    end
+
+    def self.show_version_and_exit
+      puts Fastererer::VERSION
+      exit
+    end
+  end
+end

data/lib/fastererer/config.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+require 'yaml'
+require 'pathname'
+
+module Fastererer
+  class Config
+    FILE_NAME         = '.fastererer.yml'
+    SPEEDUPS_KEY      = 'speedups'
+    EXCLUDE_PATHS_KEY = 'exclude_paths'
+
+    def ignored_speedups
+      @ignored_speedups ||=
+        file[SPEEDUPS_KEY].select { |_, value| value == false }.keys.map(&:to_sym)
+    end
+
+    def ignored_files
+      @ignored_files ||=
+        file[EXCLUDE_PATHS_KEY].flat_map { |path| Dir[path] }
+    end
+
+    def file
+      return @file if defined?(@file)
+
+      @file = load_file
+    end
+
+    def file_location
+      @file_location ||=
+        Pathname(Dir.pwd)
+        .enum_for(:ascend)
+        .map { |dir| File.join(dir.to_s, FILE_NAME) }
+        .find { |f| File.exist?(f) }
+    end
+
+    def nil_file
+      { SPEEDUPS_KEY => {}, EXCLUDE_PATHS_KEY => [] }
+    end
+
+    private
+
+    def load_file
+      return nil_file if file_location.nil?
+
+      # YAML.load_file returns false if the content is blank, so coerce to nil_file.
+      loaded = YAML.load_file(file_location) || nil_file
+      loaded.merge!(nil_file) { |_k, v1, v2| v1 || v2 }
+    end
+  end
+end