shoulda-context 2.0.0 → 3.0.0.rc1

data/MAINTAINING.md

@@ -0,0 +1,104 @@
+# Maintaining Shoulda Context
+
+Although Shoulda Context doesn't receive feature updates these days, you may
+need to update the gem for new versions of Ruby or Rails. Here's what you need
+to know in order to do that.
+
+## Getting started
+
+First, run the setup script:
+
+    bin/setup
+
+Then run all the tests to make sure everything is green:
+
+    bundle exec rake
+
+## Running tests
+
+This project uses Minitest for tests and Appraisal to create environments
+attuned for different versions of Rails. To run a single test in a single test
+file, you will need to use a combination of Appraisal and the [`m`][m] gem. For
+instance:
+
+[m]: https://github.com/qrush/m
+
+    bundle exec appraisal rails_6_0 m test/shoulda/context_test.rb:39
+
+## Updating the changelog
+
+After every user-facing change makes it into master, we make a note of it in the
+changelog, kept in `CHANGELOG.md`. The changelog is sorted in reverse order by
+release version, with the topmost version as the next release (tagged as
+"(Unreleased)").
+
+Within each version, there are five available categories you can divide changes
+into. They are all optional but they should appear in this order:
+
+1. Backward-compatible changes
+1. Deprecations
+1. Bug fixes
+1. Features
+1. Improvements
+
+Within each category section, the changes relevant to that category are listed
+in chronological order.
+
+For each change, provide a human-readable description of the change as well as a
+linked reference to the PR where that change emerged (or the commit ID if no
+such PR is available). This helps users cross-reference changes if they need to.
+
+## Versioning
+
+### Naming a new version
+
+As designated in the README, we follow [SemVer 2.0][semver]. This offers a
+meaningful baseline for deciding how to name versions. Generally speaking:
+
+[semver]: https://semver.org/spec/v2.0.0.html
+
+* We bump the "major" part of the version if we're introducing
+  backward-incompatible changes (e.g. changing the API or core behavior,
+  removing parts of the API, or dropping support for a version of Ruby).
+* We bump the "minor" part if we're adding a new feature (e.g. adding a new
+  matcher or adding a new qualifier to a matcher).
+* We bump the "patch" part if we're merely including bugfixes.
+
+In addition to major, minor, and patch levels, you can also append a
+suffix to the version for pre-release versions. We usually use this to issue
+release candidates prior to an actual release. A version number in this case
+might look like `4.0.0.rc1`.
+
+### Preparing and releasing a new version
+
+In order to release any versions at all, you will need to have been added as
+an owner of the Ruby gem. If you want to give someone else these permissions,
+then run:
+
+```bash
+gem owner shoulda-context -a <email address>
+```
+
+Assuming you have permission to publish a new version to RubyGems, then this is
+how you release a version:
+
+1. First, you'll want to [make sure that the changelog is up to
+   date](#updating-the-changelog).
+
+2. Next, you'll want to update the `VERSION` constant in
+   `lib/shoulda/context/version.rb`. This constant is referenced in the
+   gemspec and is used in the Rake tasks to publish the gem on RubyGems.
+
+3. Assuming that everything looks good, place your changes to the changelog,
+   `version.rb`, and README in their own commit titled "Bump version to
+   *X.Y.Z*". Push this to GitHub (you can use `[ci skip]`) in the body of the
+   commit message to skip CI for this commit if you so choose). **There is no
+   going back after this point!**
+
+6. Once GitHub has the version-change commit, you will run:
+
+   ```bash
+   rake release
+   ```
+
+   This will push the gem to RubyGems and make it available for download.

data/README.md

@@ -1,7 +1,7 @@
 # Shoulda Context [![Gem Version][version-badge]][rubygems] [![Build Status][travis-badge]][travis] ![Downloads][downloads-badge] [![Hound][hound-badge]][hound]
 
 [version-badge]: https://img.shields.io/gem/v/shoulda-context.svg
-[rubygems]: https://rubygems.org/gems/shoulda-matchers
+[rubygems]: https://rubygems.org/gems/shoulda-context
 [travis-badge]: https://img.shields.io/travis/thoughtbot/shoulda-context/master.svg
 [travis]: https://travis-ci.org/thoughtbot/shoulda-context
 [downloads-badge]: https://img.shields.io/gem/dtv/shoulda-context.svg
@@ -14,13 +14,34 @@ fully compatible with your existing tests and requires no retooling to use.
 
 ## Quick links
 
-📖 **[Read the documentation for the latest version.][rubydocs]**  
+📖 **[Read the documentation for the latest version.][rubydocs]**
 📢 **[See what's changed in recent versions.][changelog]**
 
 [rubydocs]: http://rubydoc.info/github/thoughtbot/shoulda-context/master/frames
 [changelog]: CHANGELOG.md
 
-## Usage
+[shoulda-context]: https://github.com/thoughtbot/shoulda-context
+
+## Getting started
+
+If you're working on a Rails app, then make sure to add this gem to the `test`
+group in your Gemfile:
+
+``` ruby
+group :test do
+  gem 'shoulda-context', '~> 3.0.0.rc1'
+end
+```
+
+If you're not working on a Rails app, then you can simply add:
+
+``` ruby
+gem 'shoulda-context', '~> 3.0.0.rc1'
+```
+
+Then run `bundle install`.
+
+## Overview
 
 Instead of writing Ruby methods with `lots_of_underscores`, Shoulda Context lets
 you name your tests and group them together using English.
@@ -138,41 +159,54 @@ may be of use:
 * `assert_reject` — what `should_not` uses internally; asserts that a matcher
   object does not match against a value
 
-## Note on running tests
+## Compatibility
 
-Normally, you will run a single test like this:
+Shoulda Context is [tested][travis] and supported against Ruby 2.7+, Rails 6.0+,
+Minitest 4.x, and Test::Unit 3.x.
 
-    ruby -I lib -I test path_to_test.rb -n name_of_test_method
+## Versioning
 
-When using Shoulda Context, however, you'll need to put a space after the test
-name:
+Shoulda Context follows Semantic Versioning 2.0 as defined at
+<http://semver.org>.
 
-    ruby -I lib -I test path_to_test.rb -n "test_: a calculator should add two numbers for the sum. "
+## Team
 
-If this is too cumbersome, consider using the [m] gem to run tests instead:
+Shoulda Context is currently maintained by [Pedro Paiva][VSPPedro]. Previous
+maintainers include [Elliot Winkler][mcmire], [Travis Jeffery][travisjeffery],
+[Gabe Berke-Williams][gabebw], [Ryan McGeary][rmm5t], [Joe Ferris][jferris], [Dan
+Croaky][croaky], and [Tammer Saleh][tammersaleh].
 
-    m path_to_test.rb:39
+[VSPPedro]: https://github.com/VSPPedro
+[mcmire]: https://github.com/mcmire
+[travisjeffery]: https://github.com/travisjeffery
+[gabebw]: https://github.com/gabebw
+[rmm5t]: https://github.com/rmm5t
+[jferris]: https://github.com/jferris
+[croaky]: https://github.com/croaky
+[tammersaleh]: https://github.com/tammersaleh
 
-[m]: https://github.com/qrush/m
+## Copyright/License
 
-## Compatibility
+Shoulda Context is copyright © Tammer Saleh and [thoughtbot,
+inc][thoughtbot-website]. It is free and opensource software and may be
+redistributed under the terms specified in the [LICENSE](LICENSE) file.
+
+[thoughtbot-website]: https://thoughtbot.com?utm_source=github
 
-Shoulda Context is tested and supported against Rails 4.x+, Minitest 4.x,
-Test::Unit 3.x, and Ruby 2.4+.
+<!-- START /templates/footer.md -->
+## About thoughtbot
 
-## Credits
+![thoughtbot](https://thoughtbot.com/thoughtbot-logo-for-readmes.svg)
 
-Shoulda Context is maintained by [Elliot Winkler][elliot-winkler], [Travis
-Jeffery][travis-jeffery], and thoughtbot. Thank you to all the [contributors].
+This repo is maintained and funded by thoughtbot, inc.
+The names and logos for thoughtbot are trademarks of thoughtbot, inc.
 
-[elliot-winkler]: https://github.com/mcmire
-[travis-jeffery]: https://github.com/travisjeffery
-[contributors]: https://github.com/thoughtbot/shoulda-context/contributors
+We love open source software!
+See [our other projects][community].
+We are [available for hire][hire].
 
-## License
+[community]: https://thoughtbot.com/community?utm_source=github
+[hire]: https://thoughtbot.com/hire-us?utm_source=github
 
-Shoulda Context is copyright © 2006-2020 [thoughtbot, inc][thoughtbot-website].
-It is free software, and may be redistributed under the terms specified in the
-[MIT-LICENSE](MIT-LICENSE) file.
 
-[thoughtbot-website]: https://thoughtbot.com
+<!-- END /templates/footer.md -->

data/bin/supported_ruby_versions

@@ -2,6 +2,6 @@
 
 require 'yaml'
 
-travis_config_path = File.expand_path('../../.travis.yml', __FILE__)
-travis_config = YAML.load_file(travis_config_path)
-puts travis_config.fetch('rvm').join(' ')
+ci_config_path = File.expand_path('../../.github//workflows/ci.yml', __FILE__)
+ci_config = YAML.load_file(ci_config_path)
+puts ci_config.dig('jobs', 'build', 'strategy', 'matrix', 'ruby').join(' ')

data/exe/convert_to_should_syntax

@@ -31,7 +31,7 @@ usage("Temp directory '#{TMP}' is not valid. Set TMPDIR environment variable to
 
 file = ARGV.shift
 tmpfile = File.join(TMP, File.basename(file))
-usage("File '#{file}' doesn't exist") unless File.exists?(file)
+usage("File '#{file}' doesn't exist") unless File.exist?(file)
 
 FileUtils.cp(file, tmpfile)
 contents = File.read(tmpfile)

data/gemfiles/rails_6_0.gemfile.lock

@@ -6,179 +6,199 @@ PATH
 GEM
   remote: https://rubygems.org/
   specs:
-    actioncable (6.0.2.2)
-      actionpack (= 6.0.2.2)
+    actioncable (6.0.6.1)
+      actionpack (= 6.0.6.1)
       nio4r (~> 2.0)
       websocket-driver (>= 0.6.1)
-    actionmailbox (6.0.2.2)
-      actionpack (= 6.0.2.2)
-      activejob (= 6.0.2.2)
-      activerecord (= 6.0.2.2)
-      activestorage (= 6.0.2.2)
-      activesupport (= 6.0.2.2)
+    actionmailbox (6.0.6.1)
+      actionpack (= 6.0.6.1)
+      activejob (= 6.0.6.1)
+      activerecord (= 6.0.6.1)
+      activestorage (= 6.0.6.1)
+      activesupport (= 6.0.6.1)
       mail (>= 2.7.1)
-    actionmailer (6.0.2.2)
-      actionpack (= 6.0.2.2)
-      actionview (= 6.0.2.2)
-      activejob (= 6.0.2.2)
+    actionmailer (6.0.6.1)
+      actionpack (= 6.0.6.1)
+      actionview (= 6.0.6.1)
+      activejob (= 6.0.6.1)
       mail (~> 2.5, >= 2.5.4)
       rails-dom-testing (~> 2.0)
-    actionpack (6.0.2.2)
-      actionview (= 6.0.2.2)
-      activesupport (= 6.0.2.2)
+    actionpack (6.0.6.1)
+      actionview (= 6.0.6.1)
+      activesupport (= 6.0.6.1)
       rack (~> 2.0, >= 2.0.8)
       rack-test (>= 0.6.3)
       rails-dom-testing (~> 2.0)
       rails-html-sanitizer (~> 1.0, >= 1.2.0)
-    actiontext (6.0.2.2)
-      actionpack (= 6.0.2.2)
-      activerecord (= 6.0.2.2)
-      activestorage (= 6.0.2.2)
-      activesupport (= 6.0.2.2)
+    actiontext (6.0.6.1)
+      actionpack (= 6.0.6.1)
+      activerecord (= 6.0.6.1)
+      activestorage (= 6.0.6.1)
+      activesupport (= 6.0.6.1)
       nokogiri (>= 1.8.5)
-    actionview (6.0.2.2)
-      activesupport (= 6.0.2.2)
+    actionview (6.0.6.1)
+      activesupport (= 6.0.6.1)
       builder (~> 3.1)
       erubi (~> 1.4)
       rails-dom-testing (~> 2.0)
       rails-html-sanitizer (~> 1.1, >= 1.2.0)
-    activejob (6.0.2.2)
-      activesupport (= 6.0.2.2)
+    activejob (6.0.6.1)
+      activesupport (= 6.0.6.1)
       globalid (>= 0.3.6)
-    activemodel (6.0.2.2)
-      activesupport (= 6.0.2.2)
-    activerecord (6.0.2.2)
-      activemodel (= 6.0.2.2)
-      activesupport (= 6.0.2.2)
-    activestorage (6.0.2.2)
-      actionpack (= 6.0.2.2)
-      activejob (= 6.0.2.2)
-      activerecord (= 6.0.2.2)
-      marcel (~> 0.3.1)
-    activesupport (6.0.2.2)
+    activemodel (6.0.6.1)
+      activesupport (= 6.0.6.1)
+    activerecord (6.0.6.1)
+      activemodel (= 6.0.6.1)
+      activesupport (= 6.0.6.1)
+    activestorage (6.0.6.1)
+      actionpack (= 6.0.6.1)
+      activejob (= 6.0.6.1)
+      activerecord (= 6.0.6.1)
+      marcel (~> 1.0)
+    activesupport (6.0.6.1)
       concurrent-ruby (~> 1.0, >= 1.0.2)
       i18n (>= 0.7, < 2)
       minitest (~> 5.1)
       tzinfo (~> 1.1)
-      zeitwerk (~> 2.2)
-    addressable (2.7.0)
-      public_suffix (>= 2.0.2, < 5.0)
+      zeitwerk (~> 2.2, >= 2.2.2)
+    addressable (2.8.1)
+      public_suffix (>= 2.0.2, < 6.0)
     ansi (1.5.0)
-    appraisal (2.2.0)
+    appraisal (2.4.1)
       bundler
       rake
       thor (>= 0.14.0)
-    ast (2.4.0)
-    bcrypt (3.1.13)
-    bootsnap (1.4.6)
-      msgpack (~> 1.0)
+    ast (2.4.2)
+    bcrypt (3.1.18)
+    bootsnap (1.13.0)
+      msgpack (~> 1.2)
     builder (3.2.4)
     byebug (10.0.2)
-    capybara (3.32.0)
+    capybara (3.35.3)
       addressable
       mini_mime (>= 0.1.3)
       nokogiri (~> 1.8)
       rack (>= 1.6.0)
       rack-test (>= 0.6.3)
-      regexp_parser (~> 1.5)
+      regexp_parser (>= 1.5, < 3.0)
       xpath (~> 3.2)
     childprocess (3.0.0)
-    coderay (1.1.2)
-    concurrent-ruby (1.1.6)
+    coderay (1.1.3)
+    concurrent-ruby (1.2.2)
     crass (1.0.6)
-    erubi (1.9.0)
-    ffi (1.12.2)
-    globalid (0.4.2)
-      activesupport (>= 4.2.0)
-    i18n (1.8.2)
+    digest (3.1.1)
+    erubi (1.12.0)
+    ffi (1.15.5)
+    globalid (1.1.0)
+      activesupport (>= 5.0)
+    i18n (1.12.0)
       concurrent-ruby (~> 1.0)
+    io-wait (0.3.0)
     jaro_winkler (1.5.4)
-    jbuilder (2.10.0)
+    jbuilder (2.11.5)
+      actionview (>= 5.0.0)
       activesupport (>= 5.0.0)
     listen (3.1.5)
       rb-fsevent (~> 0.9, >= 0.9.4)
       rb-inotify (~> 0.9, >= 0.9.7)
       ruby_dep (~> 1.2)
-    loofah (2.4.0)
+    loofah (2.19.1)
       crass (~> 1.0.2)
       nokogiri (>= 1.5.9)
-    m (1.5.1)
+    m (1.6.1)
       method_source (>= 0.6.7)
       rake (>= 0.9.2.2)
-    mail (2.7.1)
+    mail (2.8.1)
       mini_mime (>= 0.1.1)
-    marcel (0.3.3)
-      mimemagic (~> 0.3.2)
+      net-imap
+      net-pop
+      net-smtp
+    marcel (1.0.2)
     method_source (0.9.2)
-    mimemagic (0.3.4)
-    mini_mime (1.0.2)
-    mini_portile2 (2.4.0)
-    minitest (5.14.0)
-    minitest-reporters (1.4.2)
+    mini_mime (1.1.2)
+    mini_portile2 (2.6.1)
+    minitest (5.15.0)
+    minitest-reporters (1.6.0)
       ansi
       builder
       minitest (>= 5.0)
       ruby-progressbar
-    mocha (1.11.2)
-    msgpack (1.3.3)
-    nio4r (2.5.2)
-    nokogiri (1.10.9)
-      mini_portile2 (~> 2.4.0)
-    parallel (1.19.1)
-    parser (2.7.1.0)
-      ast (~> 2.4.0)
-    pg (1.2.3)
-    power_assert (1.1.7)
+    mocha (2.0.2)
+      ruby2_keywords (>= 0.0.5)
+    msgpack (1.6.0)
+    net-imap (0.2.2)
+      digest
+      net-protocol
+      strscan
+    net-pop (0.1.2)
+      net-protocol
+    net-protocol (0.1.2)
+      io-wait
+      timeout
+    net-smtp (0.3.0)
+      digest
+      net-protocol
+      timeout
+    nio4r (2.5.8)
+    nokogiri (1.12.5)
+      mini_portile2 (~> 2.6.1)
+      racc (~> 1.4)
+    parallel (1.22.1)
+    parser (3.2.1.0)
+      ast (~> 2.4.1)
+    pg (1.4.6)
+    power_assert (2.0.3)
     pry (0.12.2)
       coderay (~> 1.1.0)
       method_source (~> 0.9.0)
     pry-byebug (3.6.0)
       byebug (~> 10.0)
       pry (~> 0.10)
-    public_suffix (4.0.3)
-    puma (4.3.3)
+    public_suffix (4.0.7)
+    puma (4.3.12)
       nio4r (~> 2.0)
-    rack (2.2.2)
-    rack-proxy (0.6.5)
+    racc (1.6.2)
+    rack (2.2.6.2)
+    rack-proxy (0.7.6)
       rack
-    rack-test (1.1.0)
-      rack (>= 1.0, < 3)
-    rails (6.0.2.2)
-      actioncable (= 6.0.2.2)
-      actionmailbox (= 6.0.2.2)
-      actionmailer (= 6.0.2.2)
-      actionpack (= 6.0.2.2)
-      actiontext (= 6.0.2.2)
-      actionview (= 6.0.2.2)
-      activejob (= 6.0.2.2)
-      activemodel (= 6.0.2.2)
-      activerecord (= 6.0.2.2)
-      activestorage (= 6.0.2.2)
-      activesupport (= 6.0.2.2)
+    rack-test (2.0.2)
+      rack (>= 1.3)
+    rails (6.0.6.1)
+      actioncable (= 6.0.6.1)
+      actionmailbox (= 6.0.6.1)
+      actionmailer (= 6.0.6.1)
+      actionpack (= 6.0.6.1)
+      actiontext (= 6.0.6.1)
+      actionview (= 6.0.6.1)
+      activejob (= 6.0.6.1)
+      activemodel (= 6.0.6.1)
+      activerecord (= 6.0.6.1)
+      activestorage (= 6.0.6.1)
+      activesupport (= 6.0.6.1)
       bundler (>= 1.3.0)
-      railties (= 6.0.2.2)
+      railties (= 6.0.6.1)
       sprockets-rails (>= 2.0.0)
-    rails-controller-testing (1.0.4)
-      actionpack (>= 5.0.1.x)
-      actionview (>= 5.0.1.x)
-      activesupport (>= 5.0.1.x)
+    rails-controller-testing (1.0.5)
+      actionpack (>= 5.0.1.rc1)
+      actionview (>= 5.0.1.rc1)
+      activesupport (>= 5.0.1.rc1)
     rails-dom-testing (2.0.3)
       activesupport (>= 4.2.0)
       nokogiri (>= 1.6)
-    rails-html-sanitizer (1.3.0)
-      loofah (~> 2.3)
-    railties (6.0.2.2)
-      actionpack (= 6.0.2.2)
-      activesupport (= 6.0.2.2)
+    rails-html-sanitizer (1.5.0)
+      loofah (~> 2.19, >= 2.19.1)
+    railties (6.0.6.1)
+      actionpack (= 6.0.6.1)
+      activesupport (= 6.0.6.1)
       method_source
       rake (>= 0.8.7)
       thor (>= 0.20.3, < 2.0)
-    rainbow (3.0.0)
-    rake (13.0.1)
-    rb-fsevent (0.10.3)
+    rainbow (3.1.1)
+    rake (13.0.6)
+    rb-fsevent (0.11.2)
     rb-inotify (0.10.1)
       ffi (~> 1.0)
-    regexp_parser (1.7.0)
+    regexp_parser (2.7.0)
     rubocop (0.71.0)
       jaro_winkler (~> 1.5.1)
       parallel (~> 1.10)
@@ -186,12 +206,13 @@ GEM
       rainbow (>= 2.2.2, < 4.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 1.4.0, < 1.7)
-    ruby-progressbar (1.10.1)
+    ruby-progressbar (1.12.0)
+    ruby2_keywords (0.0.5)
     ruby_dep (1.5.0)
-    rubyzip (2.3.0)
+    rubyzip (2.3.2)
     sass-rails (6.0.0)
       sassc-rails (~> 2.1, >= 2.1.1)
-    sassc (2.2.1)
+    sassc (2.4.0)
       ffi (~> 1.9)
     sassc-rails (2.1.2)
       railties (>= 4.0.0)
@@ -203,46 +224,48 @@ GEM
       childprocess (>= 0.5, < 4.0)
       rubyzip (>= 1.2.2)
     snowglobe (0.3.0)
-    spring (2.1.0)
+    spring (2.1.1)
     spring-commands-rspec (1.0.4)
       spring (>= 0.9.1)
     spring-watcher-listen (2.0.1)
       listen (>= 2.7, < 4.0)
       spring (>= 1.2, < 3.0)
-    sprockets (4.0.0)
+    sprockets (4.2.0)
       concurrent-ruby (~> 1.0)
-      rack (> 1, < 3)
-    sprockets-rails (3.2.1)
-      actionpack (>= 4.0)
-      activesupport (>= 4.0)
+      rack (>= 2.2.4, < 4)
+    sprockets-rails (3.4.2)
+      actionpack (>= 5.2)
+      activesupport (>= 5.2)
       sprockets (>= 3.0.0)
-    sqlite3 (1.4.2)
-    test-unit (3.3.5)
+    sqlite3 (1.4.4)
+    strscan (3.0.6)
+    test-unit (3.5.7)
       power_assert
-    thor (1.0.1)
+    thor (1.2.1)
     thread_safe (0.3.6)
-    tilt (2.0.10)
+    tilt (2.1.0)
+    timeout (0.3.2)
     turbolinks (5.2.1)
       turbolinks-source (~> 5.2)
     turbolinks-source (5.2.0)
-    tzinfo (1.2.7)
+    tzinfo (1.2.11)
       thread_safe (~> 0.1)
     unicode-display_width (1.6.1)
-    warnings_logger (0.1.0)
-    webdrivers (4.2.0)
+    warnings_logger (0.1.1)
+    webdrivers (4.6.1)
       nokogiri (~> 1.6)
       rubyzip (>= 1.3.0)
       selenium-webdriver (>= 3.0, < 4.0)
-    webpacker (4.2.2)
+    webpacker (4.3.0)
       activesupport (>= 4.2)
       rack-proxy (>= 0.6.1)
       railties (>= 4.2)
-    websocket-driver (0.7.1)
+    websocket-driver (0.7.5)
       websocket-extensions (>= 0.1.0)
-    websocket-extensions (0.1.4)
+    websocket-extensions (0.1.5)
     xpath (3.2.0)
       nokogiri (~> 1.8)
-    zeitwerk (2.3.0)
+    zeitwerk (2.6.7)
 
 PLATFORMS
   ruby