Extended RuboCop::Lts config shims for the RSpec-related Cop rules,
back to Ruby version 1.8. Part of the rubocop-lts gem family.
Use the rules standard gives you, and then add more, to increase your code's compatibility across multiple versions of Ruby.
Only reach as far back as you need to go!
The RuboCop LTS family of gems is the distillation of 20+ years of my own Ruby expertise and source code diving, built on the shoulders of the expertise of many others; organizing that expertise into per-Ruby-version sets of configurations.
Although the situation has improved somewhat, it remains unsafe to upgrade RuboCop, or Standard, in a project that supports EOL Rubies.
I hope it helps others avoid some of the challenges I've had with library maintenance, and supporting decade-old mission-critical applications.
Avoid bike-shedding, use rubocop-lts in every project, and
let it manage your linting complexity!
If the rubocop-lts stack of libraries has helped you, or your organization,
please support my efforts by making a donation, or becoming a sponsor.
The rubocop-lts family of gems has a version supporting any version of Ruby you need.
They can be used as development dependencies for libraries or applications.
Only two of them sit at the top level, and this gem is one of them.
| Gem Name | Version | Downloads | Activity |
|---|---|---|---|
rubocop-lts |
 |
  |
|
rubocop-lts-rspec |
 |
  |
|
Nested Dependencies
Add a badge to your project's README.md!
[](https://github.com/rubocop-lts/rubocop-lts)
[](https://github.com/rubocop-lts/rubocop-lts)All releases of this gem are stable releases.
We do not release new versions for every release of rubocop,
as this gem is part of rubocop-lts, which is tied to standard (Standard Ruby).
Eventually analysis support for an old version of Ruby will no longer be sustainable.
When that happens releases of the rubocop-lts gem for that version of Ruby will (mostly) cease.
For now though, in Q2 2025, RuboCop, via RuboCop-LTS, can still be used with code targeting Ruby v1.8.7, and newer.
| Tokens to Remember |   |
|---|---|
| Works with MRI Ruby 3.2+ |     |
| Source |    |
| Documentation |     |
| Compliance |         |
| Expert 1:1 Support |  or  |
| Enterprise Support |  💡Subscribe for support guarantees covering all FLOSS dependencies! 💡Tidelift is part of Sonar! 💡Tidelift pays maintainers to maintain the software you depend on! 📊 @Pointy Haired Boss: An enterprise support subscription is "never gonna let you down", and supports open source maintainers! |
| Comrade BDFL 🎖️ |      |
... 💖 |
    🧊 🐙 🛖 🧪 |
Install the gem and add to the application's Gemfile by executing:
$ bundle add rubocop-lts-rspec
If bundler is not being used to manage dependencies, install the gem by executing:
$ gem install rubocop-lts-rspec
NOTE: You can use this gem standalone, but it is recommended to use together with rubocop-lts.
Starting with rubocop-lts's Epoch v1 series (i.e. SemVer major versions 1_0XX) each config in rubocop-lts
has an alternate rspec version that depends on this gem.
If you want to use them, you must add the dependency on this gem to your gemfile/gemspec separately.
It will enable your RSpec style rules to be integrated with your Ruby style rules,
and for the entire suite of rules to target, with an explicit goal of compatibility,
whatever version of Ruby your project happens to be on!
rubocop-lts-rspec is cryptographically signed, and has verifiable SHA-256 and SHA-512 checksums by
stone_checksums. Be sure the gem you install hasn’t been tampered with
by following the instructions below.
Add my public key (if you haven’t already, expires 2045-04-29) as a trusted certificate:
gem cert --add <(curl -Ls https://raw.github.com/rubocop-lts/rubocop-lts-rspec/main/certs/pboling.pem)You only need to do that once. Then proceed to install with:
gem install rubocop-lts-rspec -P MediumSecurityThe MediumSecurity trust profile will verify signed gems, but allow the installation of unsigned dependencies.
This is necessary because not all of rubocop-lts-rspec’s dependencies are signed, so we cannot use HighSecurity.
If you want to up your security game full-time:
bundle config set --global trust-policy MediumSecurityNOTE: Be prepared to track down certs for signed gems and add them the same way you added mine.
After adding both this gem and rubocop-lts to your Gemfile or gemspec,
utilize a config provided by rubocop-lts.
The configs that end in *_rspec.yml will pull in all the config from this gem,
specifically for the version of Ruby indicated by the version of rubocop-lts you are on.
inherit_gem:
rubocop-lts: config/ruby_rspec.ymlinherit_gem:
rubocop-lts: config/rubygem_rspec.ymlinherit_gem:
rubocop-lts: config/rails_rspec.ymlAfter adding both this gem and rubocop-ruby#_# to your Gemfile or gemspec,
utilize a config provided by rubocop-ruby#_#.
The configs that end in *_rspec.yml will pull in all the config from this gem,
specifically for the version of Ruby indicated by the version of rubocop-ruby#_# you are on.
For this example we will use the rubocop-ruby3_2 gem.
Replace only the gem name key if you are using a different one:
inherit_gem:
rubocop-ruby3_2: rubocop-lts/ruby_rspec.ymlinherit_gem:
rubocop-ruby3_2: rubocop-lts/rubygem_rspec.ymlinherit_gem:
rubocop-ruby3_2: rubocop-lts/rails_rspec.ymlIf you are using this gem standalone, add to the top of your project's .rubocop.yml configuration file:
inherit_gem:
# Replace {RUBY_MAJOR_VERSION} with the minimum major version of ruby you want to target.
# Replace {RUBY_MINOR_VERSION} with the minimum minor version of ruby you want to target.
rubocop-lts-rspec: config/ruby-{RUBY_MAJOR_VERSION}-{RUBY_MINOR_VERSION}.ymlWhat will this do for me?
Among other potential settings specific to your chosen minimum version of ruby, the above effectively results in the following config (& more):
inherit_mode:
merge:
- Exclude
- Include
require:
- rubocop-lts-rspec
- rubocop-rspec-extra
- rubocop-env
- rubocop-rspec
inherit_gem:
rubocop-env: config/default.yml
rubocop-rspec-extra: config/default.yml
RSpec/Focus: # run ALL tests on CI
Enabled: true
Exclude: []
Lint/Debugger: # don't leave binding.pry
Enabled: true
Exclude: [ ]It will be set up for you, when you follow any of the above setup instructions.
See CONTRIBUTING.md.
See SECURITY.md.
If you need some ideas of where to help, you could work on adding more code coverage, or if it is already 💯 (see below) then check issues, or PRs, or use the gem and think about how it could be better.
We
See CONTRIBUTING.md for more detailed instructions.
Everyone interacting in this project's codebases, issue trackers,
chat rooms and mailing lists is expected to follow the
Made with contributors-img.
Also see GitLab Contributors: https://gitlab.com/rubocop-lts/rubocop-lts-rspec/-/graphs/main
This Library adheres to
Yes. But I'm obligated to include notes...
SemVer should, but doesn't explicitly, say that dropping support for specific Platforms is a breaking change to an API. It is obvious to many, but not all, and since the spec is silent, the bike shedding is endless.
dropping support for a platform is both obviously and objectively a breaking change
- Jordan Harband (@ljharb, maintainer of SemVer) in SemVer issue 716
To get a better understanding of how SemVer is intended to work over a project's lifetime, read this article from the creator of SemVer:
As a result of this policy, and the interpretive lens used by the maintainer, you can (and should) specify a dependency on these libraries using the Pessimistic Version Constraint with two digits of precision.
For example:
spec.add_dependency("rubocop-lts-rspec", "~> 1.0")See CHANGELOG.md for list of releases.
The gem is available as open source under the terms of
the MIT License
Project Logos (rubocop-lts-rspec)
Organization Logo (rubocop-lts)
- Author: Yusuf Evli
- Source: Unsplash
- License: Unsplash License
Copyright (c) 2025 Peter H. Boling,
RailsBling.com
You made it to the bottom of the page, so perhaps you'll indulge me for another 20 seconds. I maintain many dozens of gems, including this one, because I want Ruby to be a great place for people to solve problems, big and small. Please consider supporting my efforts via the giant yellow link below, or one of the others at the head of this README.
