transpec 1.12.0 → 1.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 9028442bbb2a56a7ad1ef1a0205980d1f460ca95
-  data.tar.gz: 136e4e0450ee5747ac17922275b1b1dad1b1991a
+  metadata.gz: 1380a29e5d1d69345538ed009fee77b52c9c1476
+  data.tar.gz: 76891cd865379b4e43d55e890bf076e6be404777
 SHA512:
-  metadata.gz: 401af30bd4fdfb1144dd5d1d9577b12e2d043c9800b0b0a23edc973c7be6af3da89b426e900b4d31f5ea827e594a4203243c9437b9194715453386b9a49b9688
-  data.tar.gz: 3722e2241be35ef86e5b2df35e777322c63759a994c84fb4066813650521c7d05cf27526005d2320ba341d9447798a183215cbd112c863e42ce952f7349faa3e
+  metadata.gz: 6b6f75a2ea40fa95e6cb8d7eba12ac63e6ea3d7c03bc3b8b2e0cd85b39d5a4a0215a3139aad09e980c89eaaccc8d5880392d8f4793ef5e314d37d25a755ec5f9
+  data.tar.gz: df0ecc276f65e263cf1c0fe53275ef84d8d884e159a4ade6d92f83a3348b8d2f35829fc98b29ae6d87609a0c0d8b5d8cba66e5331e3c22aed94689473db255df

data/CHANGELOG.md

@@ -2,251 +2,255 @@
 
 ## Development
 
+## v1.13.0
+
+* Improve the conversion performance.
+
 ## v1.12.0
 
-* Support conversion of hook scope names ([#53](https://github.com/yujinakayama/transpec/issues/53))
+* Support conversion of hook scope names. ([#53](https://github.com/yujinakayama/transpec/issues/53))
 
 ## v1.11.1
 
-* Add missing description of `example_group` for `-v/--convert` option in the `-h/--help` text
+* Add missing description of `example_group` for `-v/--convert` option in the `-h/--help` text.
 
 ## v1.11.0
 
-* Support conversion to non-monkey-patch example groups ([#22](https://github.com/yujinakayama/transpec/issues/22))
-* Support conversion of `unstub` ([#49](https://github.com/yujinakayama/transpec/issues/49))
-* Modify `yield_receiver_to_any_instance_implementation_blocks` configuration in `RSpec.configure` only when necessary ([#56](https://github.com/yujinakayama/transpec/issues/56))
-* Modify only the main `RSpec.configure` when there are multiple ones ([#56](https://github.com/yujinakayama/transpec/issues/56))
-* Add `-v/--convert` option that allows to enable conversions that are disabled by default
-* Deprecate `-t/--convert-stub-with-hash` option
+* Support conversion to non-monkey-patch example groups. ([#22](https://github.com/yujinakayama/transpec/issues/22))
+* Support conversion of `unstub`. ([#49](https://github.com/yujinakayama/transpec/issues/49))
+* Modify `yield_receiver_to_any_instance_implementation_blocks` configuration in `RSpec.configure` only when necessary. ([#56](https://github.com/yujinakayama/transpec/issues/56))
+* Modify only the main `RSpec.configure` when there are multiple ones. ([#56](https://github.com/yujinakayama/transpec/issues/56))
+* Add `-v/--convert` option that allows to enable conversions that are disabled by default.
+* Deprecate `-t/--convert-stub-with-hash` option.
 
 ## v1.10.4
 
-* Avoid confusing methods defined with `#let` or `#subject` by user with RSpec built-in methods ([#55](https://github.com/yujinakayama/transpec/issues/55))
-* Add experimental support for Ruby 2.2 (development version) by falling back to Ruby 2.1 parser
+* Avoid confusing methods defined with `#let` or `#subject` by user with RSpec built-in methods. ([#55](https://github.com/yujinakayama/transpec/issues/55))
+* Add experimental support for Ruby 2.2 (development version) by falling back to Ruby 2.1 parser.
 
 ## v1.10.3
 
-* Suggest using `-c/--rspec-command` option and exit gracefully when dynamic analysis failed ([#52](https://github.com/yujinakayama/transpec/issues/52))
+* Suggest using `-c/--rspec-command` option and exit gracefully when dynamic analysis failed. ([#52](https://github.com/yujinakayama/transpec/issues/52))
 
 ## v1.10.2
 
-* Fix a bug where `expect(an_array + another_array).to have(2).items` was converted to `expect(an_array +(another_array).size).to eq(2)`
+* Fix a bug where `expect(an_array + another_array).to have(2).items` was converted to `expect(an_array +(another_array).size).to eq(2)`.
 
 ## v1.10.1
 
-* Fix a bug where `expect(hash['some_key']).to have(2).items` was converted to `expect(hash[().size).to eq(2)` ([#51](https://github.com/yujinakayama/transpec/issues/51))
+* Fix a bug where `expect.(hash['some_key']).to have(2).items` was converted to `expect(hash[().size).to eq(2)` ([#51](https://github.com/yujinakayama/transpec/issues/51))
 
 ## v1.10.0
 
-* Support conversion of pending examples
-* Display cautions for less-accurate conversions caused by a lack of runtime information ([#42](https://github.com/yujinakayama/transpec/issues/42))
+* Support conversion of pending examples.
+* Display cautions for less-accurate conversions caused by a lack of runtime information. ([#42](https://github.com/yujinakayama/transpec/issues/42))
 
 ## v1.9.3
 
-* Handle `variable.any_instance` ([#46](https://github.com/yujinakayama/transpec/issues/46))
-* Fix a bug where the DSL `example` (an alias of `it`) was confused with current example object (e.g. `example 'it does something' do ... end` was converted to `example 'it does something' do |example| ... end`)
+* Handle `variable.any_instance`. ([#46](https://github.com/yujinakayama/transpec/issues/46))
+* Fix a bug where the DSL `example`. (an alias of `it`) was confused with current example object (e.g. `example 'it does something' do ... end` was converted to `example 'it does something' do |example| ... end`)
 
 ## v1.9.2
 
-* Fix a bug where `expect(method_returns_collection :some_arg).to have(2).items` was converted to `expect(method_returns_collection :some_arg.size).to eq(2)` ([#43](https://github.com/yujinakayama/transpec/issues/43))
-* Fix false positive conversion of `raise_error` with `with_message` ([#41](https://github.com/yujinakayama/transpec/issues/41))
+* Fix a bug where `expect.(method_returns_collection :some_arg).to have(2).items` was converted to `expect(method_returns_collection :some_arg.size).to eq(2)` ([#43](https://github.com/yujinakayama/transpec/issues/43))
+* Fix false positive conversion of `raise_error` with `with_message`. ([#41](https://github.com/yujinakayama/transpec/issues/41))
 
 ## v1.9.1
 
-* Fix crash on `expect(obj).to non_matcher_object` in dynamic analysis ([#39](https://github.com/yujinakayama/transpec/issues/39))
+* Fix crash on `expect.(obj).to non_matcher_object` in dynamic analysis ([#39](https://github.com/yujinakayama/transpec/issues/39))
 
 ## v1.9.0
 
-* Support conversion of `and_return { value }` and `and_return` without arguments
-* Fix a bug where conversion of `.any_number_of_times` and `at_least(0)` with `obj.stub(:message)` weren't reported in the final summary
-* Fix a bug where arguments of `any_instance` implementation blocks weren't converted when a `receive` matcher was chained by the fluent interface (e.g. `expect_any_instance_of(Klass).to receive(:message).once { |arg| }`)
+* Support conversion of `and_return { value }` and `and_return` without arguments.
+* Fix a bug where conversion of `.any_number_of_times` and `at_least(0)` with `obj.stub(:message)` weren't reported in the final summary.
+* Fix a bug where arguments of `any_instance` implementation blocks weren't converted when a `receive` matcher was chained by the fluent interface. (e.g. `expect_any_instance_of(Klass).to receive(:message).once { |arg| }`)
 
 ## v1.8.0
 
-* Conversion of `obj.stub(:message => value)` to `allow(obj).to receive(:message).and_return(value)` is now opt-in with `-t/--convert-stub-with-hash` option when `receive_messages` is unavailable
+* Conversion of `obj.stub(:message => value)` to `allow(obj).to receive(:message).and_return(value)` is now opt-in with `-t/--convert-stub-with-hash` option when `receive_messages` is unavailable.
 
 ## v1.7.0
 
-* Support conversion of `any_instance` block
+* Support conversion of `any_instance` block.
 
 ## v1.6.1
 
-* Handle deprecation messages from `rainbow` gem
+* Handle deprecation messages from `rainbow` gem.
 
 ## v1.6.0
 
-* Native support for Ruby 2.1 syntax with Parser 2.1
-* Support conversion of the custom matcher DSL ([#30](https://github.com/yujinakayama/transpec/issues/30))
-* Support Capybara DSL in static context analysis (the logic used with `-s/--skip-dynamic-analysis`)
+* Native support for Ruby 2.1 syntax with Parser 2.1.
+* Support conversion of the custom matcher DSL. ([#30](https://github.com/yujinakayama/transpec/issues/30))
+* Support Capybara DSL in static context analysis. (the logic used with `-s/--skip-dynamic-analysis`)
 
 ## v1.5.1
 
-* Check whether a `stub` is RSpec's one or not with a static whitelist when there's no runtime data ([#33](https://github.com/yujinakayama/transpec/issues/33))
-* Fix a bug where one-liner `should` was converted to `is_expected.to` on RSpec 3.0.0.beta1 (available since 2.99.0.beta2 and 3.0.0.beta2)
+* Check whether a `stub` is RSpec's one or not with a static whitelist when there's no runtime data. ([#33](https://github.com/yujinakayama/transpec/issues/33))
+* Fix a bug where one-liner `should` was converted to `is_expected.to` on RSpec 3.0.0.beta1. (available since 2.99.0.beta2 and 3.0.0.beta2)
 
 ## v1.5.0
 
-* Mention the project's RSpec version in the auto-generated commit message
-* Deprecate `-m/--generate-commit-message` option (A commit message will always be generated)
-* Display actual `Proc` constructor names in the summary of expectations on block
+* Mention the project's RSpec version in the auto-generated commit message.
+* Deprecate `-m/--generate-commit-message` option. (A commit message will always be generated)
+* Display actual `Proc` constructor names in the summary of expectations on block.
 
 ## v1.4.1
 
-* Support Ruby 2.1 runtime by falling back to Ruby 2.0 parser
+* Support Ruby 2.1 runtime by falling back to Ruby 2.0 parser.
 
 ## v1.4.0
 
-* Support conversion of `RSpec::Core::ExampleGroup#example` ([#23](https://github.com/yujinakayama/transpec/issues/23))
-* Support conversion of one-liner syntax ([#25](https://github.com/yujinakayama/transpec/issues/25))
-* Support conversion of one-liner syntax with `have(n).items` matcher
-* Support conversion of `stub_chain`
-* Fix a bug where `-p/--no-parentheses-matcher-arg` was not applied to the conversion of `have(n).items` with `expect`
-* Fix a bug where conversion summaries of `have(n).item` with negative expectation were reported as positive expectations
+* Support conversion of `RSpec::Core::ExampleGroup#example`. ([#23](https://github.com/yujinakayama/transpec/issues/23))
+* Support conversion of one-liner syntax. ([#25](https://github.com/yujinakayama/transpec/issues/25))
+* Support conversion of one-liner syntax with `have(n).items` matcher.
+* Support conversion of `stub_chain`.
+* Fix a bug where `-p/--no-parentheses-matcher-arg` was not applied to the conversion of `have(n).items` with `expect`.
+* Fix a bug where conversion summaries of `have(n).item` with negative expectation were reported as positive expectations.
 
 ## v1.3.1
 
-* Proceed to conversion even if `rspec` didn't pass in dynamic analysis
+* Proceed to conversion even if `rspec` didn't pass in dynamic analysis.
 
 ## v1.3.0
 
-* Handle singular collection names like `have(n).item` ([#18](https://github.com/yujinakayama/transpec/issues/18))
-* Handle collection accessors with arguments like `have(n).errors_on(...)` ([#18](https://github.com/yujinakayama/transpec/issues/18))
-* Handle `described_class.any_instance` ([#18](https://github.com/yujinakayama/transpec/issues/18))
-* Handle indirect `any_instance` subject with runtime information  (e.g. `variable = SomeClass.any_instance; variable.stub(:message)`)
-* Disable conversion of `have(n).items` automatically if `rspec-rails` or `rspec-collection_matchers` is loaded in the target project
-* Disable conversion of `its` automatically if `rspec-its` is loaded in the target project
+* Handle singular collection names like `have.(n).item` ([#18](https://github.com/yujinakayama/transpec/issues/18))
+* Handle collection accessors with arguments like `have.(n).errors_on(...)` ([#18](https://github.com/yujinakayama/transpec/issues/18))
+* Handle `described_class.any_instance`. ([#18](https://github.com/yujinakayama/transpec/issues/18))
+* Handle indirect `any_instance` subject with runtime information.  (e.g. `variable = SomeClass.any_instance; variable.stub(:message)`)
+* Disable conversion of `have(n).items` automatically if `rspec-rails` or `rspec-collection_matchers` is loaded in the target project.
+* Disable conversion of `its` automatically if `rspec-its` is loaded in the target project.
 
 ## v1.2.2
 
-* Fix error `singleton can't be dumped (TypeError)` at the end of dynamic analysis ([#17](https://github.com/yujinakayama/transpec/issues/17))
-* Do not copy pseudo files (device, socket, etc.) in dynamic analysis ([#17](https://github.com/yujinakayama/transpec/issues/17))
-* Fix error `undefined method receive_messages_available?` while conversion ([#17](https://github.com/yujinakayama/transpec/issues/17))
+* Fix error `singleton can't be dumped. (TypeError)` at the end of dynamic analysis ([#17](https://github.com/yujinakayama/transpec/issues/17))
+* Do not copy pseudo files. (device, socket, etc.) in dynamic analysis ([#17](https://github.com/yujinakayama/transpec/issues/17))
+* Fix error `undefined method receive_messages_available?` while conversion. ([#17](https://github.com/yujinakayama/transpec/issues/17))
 
 ## v1.2.1
 
-* Apply `-p/--no-parentheses-matcher-arg` to the conversion of `have(n).items` (`obj.should have(n).items` is now converted to `expect(obj.size).to eq n` with `-p/--no-parentheses-matcher-arg`)
+* Apply `-p/--no-parentheses-matcher-arg` to the conversion of `have.(n).items` (`obj.should have(n).items` is now converted to `expect(obj.size).to eq n` with `-p/--no-parentheses-matcher-arg`)
 
 ## v1.2.0
 
-* Transpec is now ready for RSpec 2.99 and 3.0 beta!
-* Support conversion to `allow(obj).to receive_messages(:message => value)` ([#6](https://github.com/yujinakayama/transpec/issues/6))
-* Support conversion to `be_truthy` / `be_falsey` ([#8](https://github.com/yujinakayama/transpec/issues/8))
-* Add `-b/--boolean-matcher` option that allows to specify matcher type that `be_true` and `be_false` will be converted to
-* Abort if a target project's `rspec` gem dependency is older than the version required by Transpec
+* Transpec is now ready for RSpec 2.99 and 3.0 beta!.
+* Support conversion to `allow.(obj).to receive_messages(:message => value)` ([#6](https://github.com/yujinakayama/transpec/issues/6))
+* Support conversion to `be_truthy` / `be_falsey`. ([#8](https://github.com/yujinakayama/transpec/issues/8))
+* Add `-b/--boolean-matcher` option that allows to specify matcher type that `be_true` and `be_false` will be converted to.
+* Abort if a target project's `rspec` gem dependency is older than the version required by Transpec.
 
 ## v1.1.2
 
-* Allow use of non monkey patch syntaxes in non example group contexts by including `RSpec::Matchers` ([#15](https://github.com/yujinakayama/transpec/issues/15))
+* Allow use of non monkey patch syntaxes in non example group contexts by including `RSpec::Matchers`. ([#15](https://github.com/yujinakayama/transpec/issues/15))
 
 ## v1.1.1
 
-* Fix failure of dynamic analysis when cwd was changed at exit of rspec
+* Fix failure of dynamic analysis when cwd was changed at exit of rspec.
 
 ## v1.1.0
 
-* Support conversion of `its` ([#9](https://github.com/yujinakayama/transpec/issues/9))
+* Support conversion of `its`. ([#9](https://github.com/yujinakayama/transpec/issues/9))
 
 ## v1.0.0
 
-* Now Transpec does dynamic code analysis!
-* Support conversion of `have(n).items` matcher ([#5](https://github.com/yujinakayama/transpec/issues/5))
-* Add `-s/--skip-dynamic-analysis` option that allows to skip dynamic analysis and convert with only static analysis
-* Add `-c/--rspec-command` option that allows to specify command to run RSpec that is used for dynamic analysis
-* Check contexts correctly with runtime information
-* Detect same name but non-RSpec methods with runtime information ([#4](https://github.com/yujinakayama/transpec/issues/4))
-* Consider runtime type information when converting `=~` to `match_array`
-* Rename `-d/--disable` option to `-k/--keep` and change its syntax types
-* Rename `--commit-message` option to `--generate-commit-message`
+* Now Transpec does dynamic code analysis!.
+* Support conversion of `have.(n).items` matcher ([#5](https://github.com/yujinakayama/transpec/issues/5))
+* Add `-s/--skip-dynamic-analysis` option that allows to skip dynamic analysis and convert with only static analysis.
+* Add `-c/--rspec-command` option that allows to specify command to run RSpec that is used for dynamic analysis.
+* Check contexts correctly with runtime information.
+* Detect same name but non-RSpec methods with runtime information. ([#4](https://github.com/yujinakayama/transpec/issues/4))
+* Consider runtime type information when converting `=~` to `match_array`.
+* Rename `-d/--disable` option to `-k/--keep` and change its syntax types.
+* Rename `--commit-message` option to `--generate-commit-message`.
 
 ## v0.2.6
 
-* Fix a bug where `Node#each_descendent_node` enumerates only within depth 2
+* Fix a bug where `Node#each_descendent_node` enumerates only within depth 2.
 
 ## v0.2.5
 
-* Do not touch file if the source does not need to be rewritten
+* Do not touch file if the source does not need to be rewritten.
 
 ## v0.2.4
 
-* Improve context detection
+* Improve context detection.
 
 ## v0.2.3
 
-* Fix a bug where arguments of positive error expectation with block were removed (e.g. `expect { }.to raise_error(SpecificErrorClass) { |e| ... }` was converted to `expect { }.to raise_error { |e| ... }` unintentionally)
+* Fix a bug where arguments of positive error expectation with block were removed. (e.g. `expect { }.to raise_error(SpecificErrorClass) { |e| ... }` was converted to `expect { }.to raise_error { |e| ... }` unintentionally)
 
 ## v0.2.2
 
-* Fix a crash on syntax configuration with variable in `RSpec.configure` (e.g. `RSpec.configure { |config| config.expect_with { |c| c.syntax = some_syntax } }`)
+* Fix a crash on syntax configuration with variable in `RSpec.configure`. (e.g. `RSpec.configure { |config| config.expect_with { |c| c.syntax = some_syntax } }`)
 
 ## v0.2.1
 
-* Fix a crash on operator matcher that have `__FILE__` in its arguments
+* Fix a crash on operator matcher that have `__FILE__` in its arguments.
 
 ## v0.2.0
 
-* Display conversion summary at the end
-* Add `-m/--commit-message` option that allows to generate commit message automatically
+* Display conversion summary at the end.
+* Add `-m/--commit-message` option that allows to generate commit message automatically.
 
 ## v0.1.3
 
-* Avoid confusing `Excon.stub` with RSpec's `stub` ([#4](https://github.com/yujinakayama/transpec/issues/4))
-* Fix a bug where `be == 1` was converted into `be eq(1)` (now it's converted into `eq(1)`)
-* Fix a bug where `obj.should==1` was converted into `obj.toeq1` (now it's converted into `obj.to eq(1)`)
+* Avoid confusing `Excon.stub` with RSpec's `stub`. ([#4](https://github.com/yujinakayama/transpec/issues/4))
+* Fix a bug where `be == 1` was converted into `be eq.(1)` (now it's converted into `eq(1)`)
+* Fix a bug where `obj.should==1` was converted into `obj.toeq1`. (now it's converted into `obj.to eq(1)`)
 
 ## v0.1.2
 
-* Continue processing files even if a file has invalid syntax
-* Fix a crash on source `variable::Const`
-* Fix generating invalid code with here document followed by method
-* Fix generating invalid code when converting `obj.should() == 1`
+* Continue processing files even if a file has invalid syntax.
+* Fix a crash on source `variable::Const`.
+* Fix generating invalid code with here document followed by method.
+* Fix generating invalid code when converting `obj.should() == 1`.
 
 ## v0.1.1
 
-* Fix a bug where `be > 1` was converted into `be be > 1`
+* Fix a bug where `be > 1` was converted into `be be > 1`.
 
 ## v0.1.0
 
-* Highlight source in console when warning conversion error
-* Add `--no-color` option
+* Highlight source in console when warning conversion error.
+* Add `--no-color` option.
 
 ## v0.0.10
 
-* Support conversion of `at_least(0)`
-* Add `-f` shorthand for `--force` option
+* Support conversion of `at_least(0)`.
+* Add `-f` shorthand for `--force` option.
 
 ## v0.0.9
 
-* Use `--disable allow_to_receive` to disable conversion from `obj.should_receive(:foo).any_number_of_times` to `allow(obj).to receive(:foo)` (Previously it was `--disable expect_to_receive`)
+* Use `--disable allow_to_receive` to disable conversion from `obj.should_receive.(:foo).any_number_of_times` to `allow(obj).to receive(:foo)` (Previously it was `--disable expect_to_receive`)
 
 ## v0.0.8
 
-* Support conversion from `not_to raise_error(SpecificErrorClass)` to `not_to raise_error`
+* Support conversion from `not_to raise_error(SpecificErrorClass)` to `not_to raise_error`.
 
 ## v0.0.7
 
-* Avoid confusing `Typhoeus.stub` with RSpec's `stub` ([#4](https://github.com/yujinakayama/transpec/issues/4))
+* Avoid confusing `Typhoeus.stub` with RSpec's `stub`. ([#4](https://github.com/yujinakayama/transpec/issues/4))
 
 ## v0.0.6
 
-* Fix a bug where `SomeClass.any_instance.should_receive(:message).any_number_of_times` was converted into `expect_any_instance_of(SomeClass).to receive(:message)` unintentionally (now it's converted into `allow_any_instance_of(SomeClass).to receive(:message)`)
+* Fix a bug where `SomeClass.any_instance.should_receive.(:message).any_number_of_times` was converted into `expect_any_instance_of(SomeClass).to receive(:message)` unintentionally (now it's converted into `allow_any_instance_of(SomeClass).to receive(:message)`)
 
 ## v0.0.5
 
-* Support conversion of `any_number_of_times`
+* Support conversion of `any_number_of_times`.
 
 ## v0.0.4
 
-* Fix a bug where necessary parentheses were not added when converting operator matcher to non-operator matcher in some cases (e.g. `== (2 - 1) + (1 + 2)` was converted into `eq(2 - 1) + (1 + 2)` unintentionally)
+* Fix a bug where necessary parentheses were not added when converting operator matcher to non-operator matcher in some cases. (e.g. `== (2 - 1) + (1 + 2)` was converted into `eq(2 - 1) + (1 + 2)` unintentionally)
 
 ## v0.0.3
 
-* Suppress addition of superfluous parentheses when converting operator matcher that have argument in parentheses to non-operator matcher (e.g. from `== (2 - 1)` to `eq(2 - 1)`)
-* Support auto-modification of syntax configuration in `RSpec.configure`
+* Suppress addition of superfluous parentheses when converting operator matcher that have argument in parentheses to non-operator matcher. (e.g. from `== (2 - 1)` to `eq(2 - 1)`)
+* Support auto-modification of syntax configuration in `RSpec.configure`.
 
 ## v0.0.2
 
-* Support conversion from `be_close(expected, delta)` to `be_within(delta).of(expected)`
+* Support conversion from `be_close(expected, delta)` to `be_within(delta).of(expected)`.
 
 ## v0.0.1
 
-* Initial release
+* Initial release.

data/README.md

@@ -133,6 +133,8 @@ Running dynamic analysis with command "bundle exec rspec"...
 Finished in 13.07 seconds
 100 examples, 0 failures
 
+Aggregating spec suite data...
+
 Converting spec/spec_helper.rb
 Converting spec/support/cache_helper.rb
 Converting spec/support/file_helper.rb
@@ -275,6 +277,7 @@ but the new syntaxes provide more modern and clear ways.
 Type             | Target Syntax                  | Converted Syntax
 -----------------|--------------------------------|----------------------------------------------------
 `example_group`  | `describe 'something' { }`     | `RSpec.describe 'something' { }`
+`hook_scope`     | `before(:all) { }`             | `before(:context) { }`
 `stub_with_hash` | `obj.stub(:message => value)`  | `allow(obj).to receive(:message).and_return(value)`
 
 Note: Specifying `stub_with_hash` enables conversion of `obj.stub(:message => value)`
@@ -476,7 +479,8 @@ The one-liner (implicit receiver) `should`:
 * [Pending examples](#pending-examples)
 * [Current example object](#current-example-object)
 * [Custom matcher DSL](#custom-matcher-dsl)
-* [Example Groups](#example-groups)
+* [Example groups](#example-groups)
+* [Hook scope aliases](#hook-scope-aliases)
 
 ### Standard expectations
 
@@ -527,7 +531,7 @@ feel free to disable this conversion and continue using the one-liner `should`.
 See [Two Types of `should`](#two-types-of-should) also.
 
 * This conversion can be disabled by: `--keep oneliner`
-* Deprecation: Not deprecated
+* Deprecation: not deprecated
 * See also: [Add `is_expected` for expect-based one-liner syntax. by myronmarston · rspec/rspec-core](https://github.com/rspec/rspec-core/pull/1180)
 
 ### Operator matchers
@@ -625,6 +629,7 @@ expect(collection).to have(3).items
 expect(collection).to have_exactly(3).items
 expect(collection).to have_at_least(3).items
 expect(collection).to have_at_most(3).items
+
 collection.should have(3).items
 
 # Assume `team` responds to #players.
@@ -638,9 +643,12 @@ Will be converted to:
 
 ```ruby
 expect(collection.size).to eq(3)
+expect(collection.size).to eq(3)
 expect(collection.size).to be >= 3
 expect(collection.size).to be <= 3
-collection.size.should == 3  # with `--keep should`
+
+ # With `--keep should`
+collection.size.should == 3
 
 expect(team.players.size).to eq(3)
 
@@ -887,7 +895,7 @@ allow(obj).to receive_messages(:foo => 1, :bar => 2)
 obj.stub(:foo => 1, :bar => 2) # No conversion
 
 # If the target project's RSpec is prior to 3.0.0.beta1
-# and `--convert-stub-with-hash` is specified
+# and `--convert stub-with-hash` is specified
 allow(obj).to receive(:foo).and_return(1)
 allow(obj).to receive(:bar).and_return(2)
 ```
@@ -919,8 +927,9 @@ obj.unstub!(:message)
 Will be converted to:
 
 ```ruby
-obj.stub(:message) # with `--keep stub`
-obj.unstub(:message) # with `--keep stub`
+# With `--keep stub`
+obj.stub(:message)
+obj.unstub(:message)
 ```
 
 * This conversion can be disabled by: `--keep deprecated`
@@ -1229,7 +1238,7 @@ end
 * Deprecation: deprecated since RSpec 3.0
 * See also: [Expectations: Matcher protocol and custom matcher API changes - The Plan for RSpec 3](http://myronmars.to/n/dev-blog/2013/07/the-plan-for-rspec-3#expectations_matcher_protocol_and_custom_matcher_api_changes)
 
-### Example Groups
+### Example groups
 
 **This conversion is disabled by default and available only if your project's RSpec is `3.0.0.beta2` or later.**
 
@@ -1265,9 +1274,44 @@ end
 ```
 
 * This conversion can be enabled by: `--convert example_group`
-* Deprecation: Not deprecated
+* Deprecation: not deprecated
 * See also: [Zero Monkey Patching Mode! - The Plan for RSpec 3](http://myronmars.to/n/dev-blog/2013/07/the-plan-for-rspec-3#zero_monkey_patching_mode)
 
+### Hook scope aliases
+
+**This conversion is disabled by default and available only if your project's RSpec is `3.0.0.beta2` or later.**
+
+Targets:
+
+```ruby
+describe 'example' do
+  before { do_something }
+  before(:each) { do_something }
+  before(:all) { do_something }
+end
+
+RSpec.configure do |config|
+  before(:suite) { do_something }
+end
+```
+
+Will be converted to:
+
+```ruby
+describe 'example' do
+  before { do_something }
+  before(:example) { do_something }
+  before(:context) { do_something }
+end
+
+RSpec.configure do |config|
+  before(:suite) { do_something }
+end
+```
+
+* This conversion can be enabled by: `--convert hook_scope`
+* Deprecation: not deprecated
+* See also: [Adds hook scope aliases `example` and `context` · rspec/rspec-core](https://github.com/rspec/rspec-core/pull/1174)
 
 ## Compatibility