rspec-expectations 2.11.1 → 2.11.2

data/Changelog.md

@@ -1,7 +1,16 @@
+### 2.11.2 / 2012-07-25
+[full changelog](http://github.com/rspec/rspec-expectations/compare/v2.11.1...v2.11.2)
+
+Bug fixes
+
+* Define `should` and `should_not` on `Object` rather than `BasicObject`
+  on MacRuby. On MacRuby, `BasicObject` is defined but is not the root
+  of the object hierarchy. (Gabriel Gilder)
+
 ### 2.11.1 / 2012-07-08
 [full changelog](http://github.com/rspec/rspec-expectations/compare/v2.11.0...v2.11.1)
 
-Bug fix
+Bug fixes
 
 * Constrain `actual` in `be_within` matcher to values that respond to `-` instead
   of requiring a specific type.

data/README.md

@@ -33,7 +33,7 @@ describe Order do
       :price => Money.new(2.22, :USD),
       :quantity => 2
     )))
-    order.total.should eq(Money.new(5.55, :USD))
+    expect(order.total).to eq(Money.new(5.55, :USD))
   end
 end
 ```
@@ -163,23 +163,15 @@ actual.should end_with(expected)
 "this string".should end_with("ring")
 ```
 
-## Syntax Options
+## `expect` syntax
 
 In addition to the `should` syntax, rspec-expectations supports
-an additional `expect` syntax:
+a new `expect` syntax as of version 2.11.0:
 
 ```ruby
-# rather than:
-[1, 2, 3].should include(1)
-
-#...you can use:
-expect([1, 2, 3]).to include(1)
-
-# rather than:
-foo.should_not eq(bar)
-
-#...you can use:
-expect(foo).not_to eq(bar)
+expect(actual).to eq expected
+expect(actual).to be > 3
+expect([1, 2, 3]).to_not include 4
 ```
 
 If you want your project to only use one of these syntaxes, you can
@@ -197,6 +189,34 @@ RSpec.configure do |config|
 end
 ```
 
+See
+[RSpec::Expectations::Syntax#expect](http://rubydoc.info/gems/rspec-expectations/RSpec/Expectations/Syntax:expect)
+for more information.
+
+### Motivation for `expect`
+
+We added the `expect` syntax to resolve some edge case issues, most notably
+that objects whose definitions wipe out all but a few methods were throwing
+`should` and `should_not` away. `expect` solves that by not monkey patching
+those methods onto `Kernel` (or any global object).
+
+See
+[http://myronmars.to/n/dev-blog/2012/06/rspecs-new-expectation-syntax](http://myronmars.to/n/dev-blog/2012/06/rspecs-new-expectation-syntax)
+for a detailed explanation.
+
+### One-liners
+
+The one-liner syntax supported by
+[rspec-core](http://rubydoc.info/gems/rspec-core)  uses `should` even when
+`config.syntax = :expect`. It reads better than the alternative, and does not
+require a global monkey patch:
+
+```ruby
+describe User do
+  it { should validate_presence_of :email }
+end
+```
+
 ## Also see
 
 * [http://github.com/rspec/rspec](http://github.com/rspec/rspec)

data/lib/rspec/expectations/expectation_target.rb

@@ -3,6 +3,12 @@ module RSpec
     # Wraps the target of an expectation.
     # @example
     #   expect(something) # => ExpectationTarget wrapping something
+    #
+    #   # used with `to`
+    #   expect(actual).to eq(3)
+    #
+    #   # with `to_not`
+    #   expect(actual).to_not eq(3)
     class ExpectationTarget
       # @api private
       def initialize(target)

data/lib/rspec/expectations/syntax.rb

@@ -28,14 +28,19 @@ module RSpec
       # @see RSpec::Matchers
 
       # @method expect
-      # Wraps `target` in an `ExpectationTarget`
+      # Supports `expect(actual).to matcher` syntax by wrapping `actual` in an
+      # `ExpectationTarget`.
+      # @example
+      #   expect(actual).to eq(expected)
+      #   expect(actual).to_not eq(expected)
       # @return [ExpectationTarget]
+      # @see ExpectationTarget#to
+      # @see ExpectationTarget#to_not
 
       # @api private
       # Determines where we add `should` and `should_not`.
       def default_should_host
-        @default_should_host ||= defined?(::BasicObject) ?
-                                 ::BasicObject : ::Kernel
+        @default_should_host ||= ::Object.ancestors.last
       end
 
       # @api private

data/lib/rspec/expectations/version.rb

@@ -2,7 +2,7 @@ module RSpec
   module Expectations
     # @private
     module Version
-      STRING = '2.11.1'
+      STRING = '2.11.2'
     end
   end
 end

metadata

@@ -1,87 +1,96 @@
---- !ruby/object:Gem::Specification
+--- !ruby/object:Gem::Specification 
 name: rspec-expectations
-version: !ruby/object:Gem::Version
-  version: 2.11.1
+version: !ruby/object:Gem::Version 
+  hash: 39
   prerelease: 
+  segments: 
+  - 2
+  - 11
+  - 2
+  version: 2.11.2
 platform: ruby
-authors:
+authors: 
 - Steven Baker
 - David Chelimsky
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-07-08 00:00:00.000000000 Z
-dependencies:
-- !ruby/object:Gem::Dependency
+
+date: 2012-07-26 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
   name: diff-lcs
-  requirement: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ~>
-      - !ruby/object:Gem::Version
-        version: 1.1.3
   type: :runtime
   prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
+  version_requirements: &id001 !ruby/object:Gem::Requirement 
     none: false
-    requirements:
+    requirements: 
     - - ~>
-      - !ruby/object:Gem::Version
+      - !ruby/object:Gem::Version 
+        hash: 21
+        segments: 
+        - 1
+        - 1
+        - 3
         version: 1.1.3
-- !ruby/object:Gem::Dependency
+  requirement: *id001
+- !ruby/object:Gem::Dependency 
   name: rake
-  requirement: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ~>
-      - !ruby/object:Gem::Version
-        version: 0.9.2
   type: :development
   prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
+  version_requirements: &id002 !ruby/object:Gem::Requirement 
     none: false
-    requirements:
+    requirements: 
     - - ~>
-      - !ruby/object:Gem::Version
+      - !ruby/object:Gem::Version 
+        hash: 63
+        segments: 
+        - 0
+        - 9
+        - 2
         version: 0.9.2
-- !ruby/object:Gem::Dependency
+  requirement: *id002
+- !ruby/object:Gem::Dependency 
   name: cucumber
-  requirement: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ~>
-      - !ruby/object:Gem::Version
-        version: 1.1.9
   type: :development
   prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
+  version_requirements: &id003 !ruby/object:Gem::Requirement 
     none: false
-    requirements:
+    requirements: 
     - - ~>
-      - !ruby/object:Gem::Version
+      - !ruby/object:Gem::Version 
+        hash: 1
+        segments: 
+        - 1
+        - 1
+        - 9
         version: 1.1.9
-- !ruby/object:Gem::Dependency
+  requirement: *id003
+- !ruby/object:Gem::Dependency 
   name: aruba
-  requirement: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ~>
-      - !ruby/object:Gem::Version
-        version: 0.4.11
   type: :development
   prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
+  version_requirements: &id004 !ruby/object:Gem::Requirement 
     none: false
-    requirements:
+    requirements: 
     - - ~>
-      - !ruby/object:Gem::Version
+      - !ruby/object:Gem::Version 
+        hash: 25
+        segments: 
+        - 0
+        - 4
+        - 11
         version: 0.4.11
+  requirement: *id004
 description: rspec expectations (should[_not] and matchers)
 email: rspec-users@rubyforge.org
 executables: []
+
 extensions: []
+
 extra_rdoc_files: []
-files:
+
+files: 
 - lib/rspec-expectations.rb
 - lib/rspec/expectations.rb
 - lib/rspec/expectations/deprecation.rb
@@ -209,38 +218,39 @@ files:
 - spec/support/matchers.rb
 - spec/support/ruby_version.rb
 homepage: http://github.com/rspec/rspec-expectations
-licenses:
+licenses: 
 - MIT
 post_install_message: 
-rdoc_options:
+rdoc_options: 
 - --charset=UTF-8
-require_paths:
+require_paths: 
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement
+required_ruby_version: !ruby/object:Gem::Requirement 
   none: false
-  requirements:
-  - - ! '>='
-    - !ruby/object:Gem::Version
-      version: '0'
-      segments:
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
       - 0
-      hash: 4256634287402574449
-required_rubygems_version: !ruby/object:Gem::Requirement
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
   none: false
-  requirements:
-  - - ! '>='
-    - !ruby/object:Gem::Version
-      version: '0'
-      segments:
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
       - 0
-      hash: 4256634287402574449
+      version: "0"
 requirements: []
+
 rubyforge_project: rspec
-rubygems_version: 1.8.24
+rubygems_version: 1.8.6
 signing_key: 
 specification_version: 3
-summary: rspec-expectations-2.11.1
-test_files:
+summary: rspec-expectations-2.11.2
+test_files: 
 - features/README.md
 - features/Upgrade.md
 - features/built_in_matchers/README.md