transpec 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: e89b721e834bdcbbc84616c93aeb74dcdcd69d29
-  data.tar.gz: 5678c00ce5a1bcc36e55cdcc41233fc0bd24d075
+  metadata.gz: 977f1d1608ec0a3279e492d25b71f6d89406d6c8
+  data.tar.gz: 6e66591a69cf5ac38b5d0591ce999f70461d462a
 SHA512:
-  metadata.gz: b71de56cdff03743ced725d67478c80be77a2772421dd73c1bdc8d8d4a67fc17f6b1907f819b421feb40de91960afa64cf71ab5a9e5dbe3193924fd49ba8289c
-  data.tar.gz: 39ca211fe213c2d6858ac2fbd669953d363de542443ceb85c4c0f7d8dc578cde12be976e94eb0a578d718e29cfeb65e29bba1516060f1f1c57279c2563e3f95f
+  metadata.gz: 2255fba8e8680c8dd0bcaf41375f4f189092c7eec52c50776b6cbb4eac0b714d726db8609385729dcdb3831cd1e7f973da84a6f488b2630a57e4fe2cd09dd5b3
+  data.tar.gz: 6e7c92b6b6305ac0b9afc00c5101f5bff45b582241bedb306dae75d7f449d0f2013abff19d372fcb8c3aa075e7ea263bd575eab816d358bfe9a009650b0f5c73

data/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## Master
 
+## v1.1.0
+
+* Support conversion of `its` (#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

data/README.md

@@ -133,7 +133,7 @@ Converting spec/support/shared_context.rb
 Converting spec/transpec/ast/node_spec.rb
 ```
 
-This will run your specs, convert them, and overwrite all spec files in the `spec` directory.
+This will run the specs, convert them, and overwrite all spec files in the `spec` directory.
 
 After the conversion, run `rspec` again and check whether all pass:
 
@@ -162,9 +162,8 @@ $ git status --short
 $ transpec
 The current Git repository is not clean. Aborting.
 $ transpec --force
-Processing spec/spec_helper.rb
-Processing spec/spec_spec.rb
-Processing spec/support/file_helper.rb
+Copying project for dynamic analysis...
+Running dynamic analysis with command "bundle exec rspec"...
 ```
 
 ### `-s/--skip-dynamic-analysis`
@@ -210,8 +209,11 @@ Type             | Target Syntax                    | Converted Syntax
 `should_receive` | `obj.should_receive`             | `expect(obj).to receive`
 `stub`           | `obj.stub`                       | `allow(obj).to receive`
 `have_items`     | `expect(obj).to have(x).items`   | `expect(obj.size).to eq(x)`
+`its`            | `its(:attr) { }`                 | `describe { subject { } it { } }`
 `deprecated`     | `obj.stub!`, `mock('foo')`, etc. | `obj.stub`, `double('foo')`
 
+See [Supported Conversions](#supported-conversions) for more details.
+
 ### `-n/--negative-form`
 
 Specify negative form of `to` that is used in `expect` syntax.
@@ -292,8 +294,8 @@ end
 
 ### Reason
 
-* `should` is defined on `Kernel` module that is included by `Object` class, so you can use `should` almost everywhere.
-* `expect` is defined on `RSpec::Matchers` module that is included by `RSpec::Core::ExampleGroup` class, so you can use `expect` only where `self` is an instance of `RSpec::Core::ExampleGroup` (i.e. in `it` blocks, `:each` hook blocks or included methods).
+* `should` is defined on `BasicObject` class, so you can use `should` everywhere.
+* `expect` is defined on `RSpec::Matchers` module that is included by `RSpec::Core::ExampleGroup` class, so you can use `expect` only where `self` is an instance of `RSpec::Core::ExampleGroup` (i.e. in `it` blocks, `:each` hook blocks or included module methods).
 
 With the above example, in the context of `1.should == 1`, the `self` is an instance of `MyAwesomeTestRunner`.
 Transpec tracks contexts and skips conversion if the target syntax cannot be converted in a case like this.
@@ -380,7 +382,7 @@ expect(team.players.size).to eq(3)
 expect(team.send(:players).size).to eq(3)
 ```
 
-You have the option to continue using `have(n).items` matcher with [rspec-collection_matchers](https://github.com/rspec/rspec-collection_matchers) that is an external gem extracted from `rspec-expectations`.
+There's the option to continue using `have(n).items` matcher with [rspec-collection_matchers](https://github.com/rspec/rspec-collection_matchers) that is an external gem extracted from `rspec-expectations`.
 If you choose so, disable this conversion with `--keep have_items`.
 
 * Disabled by: `--keep have_items`
@@ -524,6 +526,47 @@ double('something')
 * Disabled by: `--keep deprecated`
 * See also: [Deprecate "stub" for doubles · rspec/rspec-mocks](https://github.com/rspec/rspec-mocks/issues/214)
 
+### Expectations on attribute of subject with `its`
+
+```ruby
+# Targets
+describe 'example' do
+  subject { { foo: 1, bar: 2 } }
+  its(:size) { should == 2 }
+  its([:foo]) { should == 1 }
+  its('keys.first') { should == :foo }
+end
+
+# Converted
+describe 'example' do
+  subject { { foo: 1, bar: 2 } }
+
+  describe '#size' do
+    subject { super().size }
+    it { should == 2 }
+  end
+
+  describe '[:foo]' do
+    subject { super()[:foo] }
+    it { should == 1 }
+  end
+
+  describe '#keys' do
+    subject { super().keys }
+    describe '#first' do
+      subject { super().first }
+      it { should == :foo }
+    end
+  end
+end
+```
+
+There's the option to continue using `its` with [rspec-its](https://github.com/rspec/rspec-its) that is an external gem extracted from `rspec-core`.
+If you choose so, disable this conversion with `--keep its`.
+
+* Disabled by: `--keep its`
+* See also: [Core: its will be moved into an external gem - The Plan for RSpec 3](http://myronmars.to/n/dev-blog/2013/07/the-plan-for-rspec-3#core__will_be_moved_into_an_external_gem)
+
 ## Compatibility
 
 Tested on MRI 1.9, MRI 2.0 and JRuby in 1.9 mode.

data/README.md.erb

@@ -106,7 +106,7 @@ Converting spec/support/shared_context.rb
 Converting spec/transpec/ast/node_spec.rb
 ```
 
-This will run your specs, convert them, and overwrite all spec files in the `spec` directory.
+This will run the specs, convert them, and overwrite all spec files in the `spec` directory.
 
 After the conversion, run `rspec` again and check whether all pass:
 
@@ -135,9 +135,8 @@ $ git status --short
 $ transpec
 The current Git repository is not clean. Aborting.
 $ transpec --force
-Processing spec/spec_helper.rb
-Processing spec/spec_spec.rb
-Processing spec/support/file_helper.rb
+Copying project for dynamic analysis...
+Running dynamic analysis with command "bundle exec rspec"...
 ```
 
 ### `-s/--skip-dynamic-analysis`
@@ -185,6 +184,7 @@ conversion_type_table = <<END
 `should_receive` | `obj.should_receive`             | `expect(obj).to receive`
 `stub`           | `obj.stub`                       | `allow(obj).to receive`
 `have_items`     | `expect(obj).to have(x).items`   | `expect(obj.size).to eq(x)`
+`its`            | `its(:attr) { }`                 | `describe { subject { } it { } }`
 `deprecated`     | `obj.stub!`, `mock('foo')`, etc. | `obj.stub`, `double('foo')`
 END
 
@@ -203,6 +203,8 @@ end
 conversion_type_table
 -%>
 
+See [Supported Conversions](#supported-conversions) for more details.
+
 ### `-n/--negative-form`
 
 Specify negative form of `to` that is used in `expect` syntax.
@@ -288,8 +290,8 @@ end
 
 ### Reason
 
-* `should` is defined on `Kernel` module that is included by `Object` class, so you can use `should` almost everywhere.
-* `expect` is defined on `RSpec::Matchers` module that is included by `RSpec::Core::ExampleGroup` class, so you can use `expect` only where `self` is an instance of `RSpec::Core::ExampleGroup` (i.e. in `it` blocks, `:each` hook blocks or included methods).
+* `should` is defined on `BasicObject` class, so you can use `should` everywhere.
+* `expect` is defined on `RSpec::Matchers` module that is included by `RSpec::Core::ExampleGroup` class, so you can use `expect` only where `self` is an instance of `RSpec::Core::ExampleGroup` (i.e. in `it` blocks, `:each` hook blocks or included module methods).
 
 With the above example, in the context of `1.should == 1`, the `self` is an instance of `MyAwesomeTestRunner`.
 Transpec tracks contexts and skips conversion if the target syntax cannot be converted in a case like this.
@@ -376,7 +378,7 @@ expect(team.players.size).to eq(3)
 expect(team.send(:players).size).to eq(3)
 ```
 
-You have the option to continue using `have(n).items` matcher with [rspec-collection_matchers](https://github.com/rspec/rspec-collection_matchers) that is an external gem extracted from `rspec-expectations`.
+There's the option to continue using `have(n).items` matcher with [rspec-collection_matchers](https://github.com/rspec/rspec-collection_matchers) that is an external gem extracted from `rspec-expectations`.
 If you choose so, disable this conversion with `--keep have_items`.
 
 * Disabled by: `--keep have_items`
@@ -520,6 +522,31 @@ double('something')
 * Disabled by: `--keep deprecated`
 * See also: [Deprecate "stub" for doubles · rspec/rspec-mocks](https://github.com/rspec/rspec-mocks/issues/214)
 
+### Expectations on attribute of subject with `its`
+
+```ruby
+# Targets
+<%=
+its_target = <<END
+describe 'example' do
+  subject { { foo: 1, bar: 2 } }
+  its(:size) { should == 2 }
+  its([:foo]) { should == 1 }
+  its('keys.first') { should == :foo }
+end
+END
+-%>
+
+# Converted
+<%= Transpec::Converter.new.convert(its_target) -%>
+```
+
+There's the option to continue using `its` with [rspec-its](https://github.com/rspec/rspec-its) that is an external gem extracted from `rspec-core`.
+If you choose so, disable this conversion with `--keep its`.
+
+* Disabled by: `--keep its`
+* See also: [Core: its will be moved into an external gem - The Plan for RSpec 3](http://myronmars.to/n/dev-blog/2013/07/the-plan-for-rspec-3#core__will_be_moved_into_an_external_gem)
+
 ## Compatibility
 
 Tested on MRI 1.9, MRI 2.0 and JRuby in 1.9 mode.

data/lib/transpec/configuration.rb

@@ -9,6 +9,7 @@ module Transpec
       [:convert_should_receive,    true],
       [:convert_stub,              true],
       [:convert_have_items,        true],
+      [:convert_its,               true],
       [:convert_deprecated_method, true],
       [:parenthesize_matcher_arg,  true],
       [:forced,                    false],

data/lib/transpec/converter.rb

@@ -8,6 +8,7 @@ require 'transpec/syntax'
 require 'transpec/syntax/be_close'
 require 'transpec/syntax/double'
 require 'transpec/syntax/expect'
+require 'transpec/syntax/its'
 require 'transpec/syntax/method_stub'
 require 'transpec/syntax/raise_error'
 require 'transpec/syntax/rspec_configure'
@@ -115,6 +116,10 @@ module Transpec
       end
     end
 
+    def process_its(its)
+      its.convert_to_describe_subject_it! if @configuration.convert_its?
+    end
+
     def process_rspec_configure(rspec_configure)
       if need_to_modify_expectation_syntax_configuration?(rspec_configure)
         rspec_configure.modify_expectation_syntaxes!(:expect)

data/lib/transpec/option_parser.rb

@@ -13,6 +13,7 @@ module Transpec
       should_receive: :convert_should_receive=,
                 stub: :convert_stub=,
           have_items: :convert_have_items=,
+                 its: :convert_its=,
           deprecated: :convert_deprecated_method=
     }
 
@@ -131,6 +132,7 @@ module Transpec
           "  #{'should_receive'.bright} (to #{'expect(obj).to receive'.underline})",
           "  #{'stub'.bright}  (to #{'allow(obj).to receive'.underline})",
           "  #{'have_items'.bright} (to #{'expect(obj.size).to eq(x)'.underline})",
+          "  #{'its'.bright} (to #{'describe { subject { } it { } }'.underline})",
           "  #{'deprecated'.bright} (e.g. from #{'mock'.underline} to #{'double'.underline})",
           'These are all converted by default.'
         ],

data/lib/transpec/syntax/its.rb

@@ -0,0 +1,165 @@
+# coding: utf-8
+
+require 'transpec/syntax'
+require 'transpec/syntax/mixin/send'
+require 'transpec/util'
+
+module Transpec
+  class Syntax
+    class Its < Syntax
+      include Mixin::Send, Util
+
+      def self.target_method?(receiver_node, method_name)
+        receiver_node.nil? && method_name == :its
+      end
+
+      def convert_to_describe_subject_it!
+        front, rear = build_wrapper_codes
+
+        insert_before(beginning_of_line_range, front)
+        replace(expression_range, 'it')
+        insert_after(block_node.loc.expression, rear)
+
+        register_record
+      end
+
+      def attribute_expression
+        @attribute_expression ||= AttributeExpression.new(attribute_node)
+      end
+
+      def attributes
+        attribute_expression.attributes
+      end
+
+      alias_method :attribute_node, :arg_node
+
+      def block_node
+        @node.parent_node
+      end
+
+      private
+
+      def build_wrapper_codes
+        front = ''
+        rear = ''
+
+        front << "\n" if !previous_line_is_blank? &&
+                         previous_and_current_line_are_same_indentation_level?
+
+        attributes.each_with_index do |attribute, index|
+          indentation = base_indentation + '  ' * index
+
+          front << indentation + "describe #{attribute.description} do\n"
+          front << indentation + "  subject { super()#{attribute.selector} }\n"
+
+          rear = "\n#{indentation}end" + rear
+        end
+
+        front << '  ' * attributes.size
+
+        [front, rear]
+      end
+
+      def previous_line_is_blank?
+        return false unless previous_line_source
+        previous_line_source.empty? || !previous_line_source.match(/\A\s*\Z/).nil?
+      end
+
+      def previous_and_current_line_are_same_indentation_level?
+        indentation_of_line(previous_line_source) == base_indentation
+      end
+
+      def previous_line_source
+        expression_range.source_buffer.source_line(expression_range.line - 1)
+      rescue IndexError
+        nil
+      end
+
+      def base_indentation
+        @base_indentation ||= indentation_of_line(@node)
+      end
+
+      def beginning_of_line_range
+        block_range = block_node.loc.expression
+        begin_pos = block_range.begin_pos - block_range.column
+        Parser::Source::Range.new(block_range.source_buffer, begin_pos, begin_pos)
+      end
+
+      def register_record
+        @report.records << Record.new(original_syntax, converted_syntax)
+      end
+
+      def original_syntax
+        if attribute_expression.brackets?
+          'its([:key]) { }'
+        else
+          'its(:attr) { }'
+        end
+      end
+
+      def converted_syntax
+        if attribute_expression.brackets?
+          "describe '[:key]' do subject { super()[:key] } it { } end"
+        else
+          "describe 'attr' do subject { super().attr } it { } end"
+        end
+      end
+
+      class AttributeExpression
+        def initialize(node)
+          @node = node
+        end
+
+        def brackets?
+          @node.type == :array
+        end
+
+        def literal?
+          Util.literal?(@node)
+        end
+
+        def attributes
+          @attributes ||= if brackets?
+                            brackets_attributes
+                          else
+                            non_brackets_attributes
+                          end
+        end
+
+        private
+
+        def brackets_attributes
+          selector = @node.loc.expression.source
+          description = literal? ? quote(selector) : selector
+          [Attribute.new(selector, description)]
+        end
+
+        def non_brackets_attributes
+          if literal?
+            expression = @node.children.first.to_s
+            chained_names = expression.split('.')
+            chained_names.map do |name|
+              Attribute.new(".#{name}", quote("##{name}"))
+            end
+          else
+            source = @node.loc.expression.source
+            selector = ".send(#{source})"
+            [Attribute.new(selector, source)]
+          end
+        end
+
+        def quote(string)
+          if string.include?("'")
+            '"' + string + '"'
+          elsif string.include?('"')
+            string.inspect
+          else
+            "'" + string + "'"
+          end
+        end
+      end
+
+      Attribute = Struct.new(:selector, :description)
+    end
+  end
+end

data/lib/transpec/util.rb

@@ -2,6 +2,12 @@
 
 module Transpec
   module Util
+    LITERAL_TYPES = %w(
+      true false nil
+      int float
+      str sym regexp
+    ).map(&:to_sym).freeze
+
     module_function
 
     def proc_literal?(node)
@@ -55,15 +61,30 @@ module Transpec
     end
 
     def indentation_of_line(arg)
-      range = case arg
-              when AST::Node             then arg.loc.expression
-              when Parser::Source::Range then arg
-              else fail ArgumentError, "Invalid argument #{arg}"
-              end
+      line = case arg
+             when AST::Node             then arg.loc.expression.source_line
+             when Parser::Source::Range then arg.source_line
+             when String                then arg
+             else fail ArgumentError, "Invalid argument #{arg}"
+            end
 
-      line = range.source_line
       /^(?<indentation>\s*)\S/ =~ line
       indentation
     end
+
+    def literal?(node)
+      case node.type
+      when *LITERAL_TYPES
+        true
+      when :array, :irange, :erange
+        node.children.all? { |n| literal?(n) }
+      when :hash
+        node.children.all? do |pair_node|
+          pair_node.children.all? { |n| literal?(n) }
+        end
+      else
+        false
+      end
+    end
   end
 end

data/lib/transpec/version.rb

@@ -4,7 +4,7 @@ module Transpec
   # http://semver.org/
   module Version
     MAJOR = 1
-    MINOR = 0
+    MINOR = 1
     PATCH = 0
 
     def self.to_s

data/spec/transpec/configuration_spec.rb

@@ -13,6 +13,7 @@ module Transpec
         [:convert_should_receive?,    true],
         [:convert_stub?,              true],
         [:convert_have_items?,        true],
+        [:convert_its?,               true],
         [:convert_deprecated_method?, true],
         [:parenthesize_matcher_arg?,  true],
         [:forced?,                    false],

data/spec/transpec/converter_spec.rb

@@ -528,6 +528,28 @@ module Transpec
       end
     end
 
+    describe '#process_its' do
+      let(:its_object) { double('its_object').as_null_object }
+
+      context 'when Configuration#convert_its? is true' do
+        before { configuration.convert_its = true }
+
+        it 'invokes Its#convert_to_describe_subject_it!' do
+          its_object.should_receive(:convert_to_describe_subject_it!)
+          converter.process_its(its_object)
+        end
+      end
+
+      context 'when Configuration#convert_its? is true' do
+        before { configuration.convert_its = false }
+
+        it 'does not invoke Its#convert_to_describe_subject_it!' do
+          its_object.should_not_receive(:convert_to_describe_subject_it!)
+          converter.process_its(its_object)
+        end
+      end
+    end
+
     describe '#process_rspec_configure' do
       let(:rspec_configure) { double('rspec_configure').as_null_object }
 

data/spec/transpec/option_parser_spec.rb

@@ -66,6 +66,7 @@ module Transpec
           ['should_receive', :convert_should_receive?],
           ['stub',           :convert_stub?],
           ['have_items',     :convert_have_items],
+          ['its',            :convert_its],
           ['deprecated',     :convert_deprecated_method?]
         ].each do |cli_type, config_attr|
           context "when #{cli_type.inspect} is specified" do

data/spec/transpec/syntax/its_spec.rb

@@ -0,0 +1,390 @@
+# coding: utf-8
+
+require 'spec_helper'
+require 'transpec/syntax/its'
+
+module Transpec
+  class Syntax
+    describe Its do
+      include_context 'parsed objects'
+
+      subject(:its_object) do
+        AST::Scanner.scan(ast) do |node, ancestor_nodes|
+          next unless Its.target_node?(node)
+          return Its.new(
+            node,
+            ancestor_nodes,
+            source_rewriter
+          )
+        end
+        fail 'No #its node is found!'
+      end
+
+      let(:record) { its_object.report.records.last }
+
+      describe '#convert_to_describe_subject_it!' do
+        before do
+          its_object.convert_to_describe_subject_it!
+        end
+
+        context 'when it is `its(:size) { ... }` form' do
+          let(:source) do
+            <<-END
+              describe 'example' do
+                subject { ['foo'] }
+
+                its(:size) { should == 1 }
+              end
+            END
+          end
+
+          let(:expected_source) do
+            <<-END
+              describe 'example' do
+                subject { ['foo'] }
+
+                describe '#size' do
+                  subject { super().size }
+                  it { should == 1 }
+                end
+              end
+            END
+          end
+
+          it "converts into `describe '#size' do subject { super().size } it { ... } end` form" do
+            rewritten_source.should == expected_source
+          end
+
+          it "adds record \"`its(:attr) { }` -> `describe 'attr' do subject { super().attr } it { } end`\"" do
+            record.original_syntax.should  == 'its(:attr) { }'
+            record.converted_syntax.should == "describe 'attr' do subject { super().attr } it { } end"
+          end
+
+          context 'and there is no blank line before #its' do
+            context 'and the indentation level of the previous line is same as the target line' do
+              let(:source) do
+                <<-END
+                  describe 'example' do
+                    subject { ['foo'] }
+                    its(:size) { should == 1 }
+                  end
+                END
+              end
+
+              let(:expected_source) do
+                <<-END
+                  describe 'example' do
+                    subject { ['foo'] }
+
+                    describe '#size' do
+                      subject { super().size }
+                      it { should == 1 }
+                    end
+                  end
+                END
+              end
+
+              it 'inserts a blank line before #its' do
+                rewritten_source.should == expected_source
+              end
+            end
+
+            context 'and the indentation level of the previous line is lower than the target line' do
+              let(:source) do
+                <<-END
+                  describe 'example' do
+                    subject { ['foo'] }
+
+                    context 'in some case' do
+                      its(:size) { should == 1 }
+                    end
+                  end
+                END
+              end
+
+              let(:expected_source) do
+                <<-END
+                  describe 'example' do
+                    subject { ['foo'] }
+
+                    context 'in some case' do
+                      describe '#size' do
+                        subject { super().size }
+                        it { should == 1 }
+                      end
+                    end
+                  end
+                END
+              end
+
+              it 'does not insert blank line before #its' do
+                rewritten_source.should == expected_source
+              end
+            end
+          end
+        end
+
+        context "when it is `its('size') { ... }` form" do
+          let(:source) do
+            <<-END
+              describe 'example' do
+                subject { ['foo'] }
+
+                its('size') { should == 1 }
+              end
+            END
+          end
+
+          let(:expected_source) do
+            <<-END
+              describe 'example' do
+                subject { ['foo'] }
+
+                describe '#size' do
+                  subject { super().size }
+                  it { should == 1 }
+                end
+              end
+            END
+          end
+
+          it "converts into `describe '#size' do subject { super().size } it { ... } end` form" do
+            rewritten_source.should == expected_source
+          end
+
+          it "adds record \"`its(:attr) { }` -> `describe 'attr' do subject { super().attr } it { } end`\"" do
+            record.original_syntax.should  == 'its(:attr) { }'
+            record.converted_syntax.should == "describe 'attr' do subject { super().attr } it { } end"
+          end
+        end
+
+        context "when it is `its('size.odd?') { ... }` form" do
+          let(:source) do
+            <<-END
+              describe 'example' do
+                subject { ['foo'] }
+
+                its('size.odd?') { should be_true }
+              end
+            END
+          end
+
+          let(:expected_source) do
+            <<-END
+              describe 'example' do
+                subject { ['foo'] }
+
+                describe '#size' do
+                  subject { super().size }
+                  describe '#odd?' do
+                    subject { super().odd? }
+                    it { should be_true }
+                  end
+                end
+              end
+            END
+          end
+
+          it 'converts into nested #describe' do
+            rewritten_source.should == expected_source
+          end
+
+          it "adds record \"`its(:attr) { }` -> `describe 'attr' do subject { super().attr } it { } end`\"" do
+            record.original_syntax.should  == 'its(:attr) { }'
+            record.converted_syntax.should == "describe 'attr' do subject { super().attr } it { } end"
+          end
+        end
+
+        context 'when it is `its([:foo]) { ... }` form' do
+          let(:source) do
+            <<-END
+              describe 'example' do
+                subject { { foo: 'bar' } }
+
+                its([:foo]) { should == 'bar' }
+              end
+            END
+          end
+
+          let(:expected_source) do
+            <<-END
+              describe 'example' do
+                subject { { foo: 'bar' } }
+
+                describe '[:foo]' do
+                  subject { super()[:foo] }
+                  it { should == 'bar' }
+                end
+              end
+            END
+          end
+
+          it "converts into `describe '[:foo]' do subject { super()[:foo] } it { ... } end` form" do
+            rewritten_source.should == expected_source
+          end
+
+          it "adds record \"`its([:key]) { }` -> `describe '[:key]' do subject { super()[:key] } it { } end`\"" do
+            record.original_syntax.should  == 'its([:key]) { }'
+            record.converted_syntax.should == "describe '[:key]' do subject { super()[:key] } it { } end"
+          end
+        end
+
+        context "when it is `its(['foo']) { ... }` form" do
+          let(:source) do
+            <<-END
+              describe 'example' do
+                subject { { 'foo' => 'bar' } }
+
+                its(['foo']) { should == 'bar' }
+              end
+            END
+          end
+
+          let(:expected_source) do
+            <<-END
+              describe 'example' do
+                subject { { 'foo' => 'bar' } }
+
+                describe "['foo']" do
+                  subject { super()['foo'] }
+                  it { should == 'bar' }
+                end
+              end
+            END
+          end
+
+          it "converts into `describe \"['foo']\" do subject { super()['foo'] } it { ... } end` form" do
+            rewritten_source.should == expected_source
+          end
+
+          it "adds record \"`its([:key]) { }` -> `describe '[:key]' do subject { super()[:key] } it { } end`\"" do
+            record.original_syntax.should  == 'its([:key]) { }'
+            record.converted_syntax.should == "describe '[:key]' do subject { super()[:key] } it { } end"
+          end
+        end
+
+        context 'when it is `its([3, 2]) { ... }` form' do
+          let(:source) do
+            <<-END
+              describe 'example' do
+                subject { %w(a b c d r f g) }
+
+                its([3, 2]) { should == %w(d r) }
+              end
+            END
+          end
+
+          let(:expected_source) do
+            <<-END
+              describe 'example' do
+                subject { %w(a b c d r f g) }
+
+                describe '[3, 2]' do
+                  subject { super()[3, 2] }
+                  it { should == %w(d r) }
+                end
+              end
+            END
+          end
+
+          it "converts into `describe '[3, 2]' do subject { super()[3, 2] } it { ... } end` form" do
+            rewritten_source.should == expected_source
+          end
+
+          it "adds record \"`its([:key]) { }` -> `describe '[:key]' do subject { super()[:key] } it { } end`\"" do
+            record.original_syntax.should  == 'its([:key]) { }'
+            record.converted_syntax.should == "describe '[:key]' do subject { super()[:key] } it { } end"
+          end
+        end
+
+        context 'when it is `its(attribute) { ... }` form' do
+          let(:source) do
+            <<-END
+              describe 'example' do
+                subject { 'foo' }
+
+                [
+                  [:size,       3],
+                  [:upcase, 'FOO']
+                ].each do |attribute, expected_value|
+                  its(attribute) { should == expected_value }
+                end
+              end
+            END
+          end
+
+          let(:expected_source) do
+            <<-END
+              describe 'example' do
+                subject { 'foo' }
+
+                [
+                  [:size,       3],
+                  [:upcase, 'FOO']
+                ].each do |attribute, expected_value|
+                  describe attribute do
+                    subject { super().send(attribute) }
+                    it { should == expected_value }
+                  end
+                end
+              end
+            END
+          end
+
+          it 'converts into `describe attribute do subject { super().send(attribute) } it { ... } end` form' do
+            rewritten_source.should == expected_source
+          end
+
+          it "adds record \"`its(:attr) { }` -> `describe 'attr' do subject { super().attr } it { } end`\"" do
+            record.original_syntax.should  == 'its(:attr) { }'
+            record.converted_syntax.should == "describe 'attr' do subject { super().attr } it { } end"
+          end
+        end
+
+        context 'when it is `its([1, length]) { ... }` form' do
+          let(:source) do
+            <<-END
+              describe 'example' do
+                subject { 'foobar' }
+
+                [
+                  [2, 'oo'],
+                  [3, 'oob']
+                ].each do |length, expected_value|
+                  its([1, length]) { should == expected_value }
+                end
+              end
+            END
+          end
+
+          let(:expected_source) do
+            <<-END
+              describe 'example' do
+                subject { 'foobar' }
+
+                [
+                  [2, 'oo'],
+                  [3, 'oob']
+                ].each do |length, expected_value|
+                  describe [1, length] do
+                    subject { super()[1, length] }
+                    it { should == expected_value }
+                  end
+                end
+              end
+            END
+          end
+
+          it 'converts into `describe [1, length] do subject { super()[1, length] } it { ... } end` form' do
+            rewritten_source.should == expected_source
+          end
+
+          it "adds record \"`its([:key]) { }` -> `describe '[:key]' do subject { super()[:key] } it { } end`\"" do
+            record.original_syntax.should  == 'its([:key]) { }'
+            record.converted_syntax.should == "describe '[:key]' do subject { super()[:key] } it { } end"
+          end
+        end
+      end
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: transpec
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Yuji Nakayama
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-10-27 00:00:00.000000000 Z
+date: 2013-10-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: parser
@@ -207,6 +207,7 @@ files:
 - lib/transpec/syntax/double.rb
 - lib/transpec/syntax/expect.rb
 - lib/transpec/syntax/have.rb
+- lib/transpec/syntax/its.rb
 - lib/transpec/syntax/method_stub.rb
 - lib/transpec/syntax/mixin/allow_no_message.rb
 - lib/transpec/syntax/mixin/any_instance.rb
@@ -244,6 +245,7 @@ files:
 - spec/transpec/syntax/double_spec.rb
 - spec/transpec/syntax/expect_spec.rb
 - spec/transpec/syntax/have_spec.rb
+- spec/transpec/syntax/its_spec.rb
 - spec/transpec/syntax/method_stub_spec.rb
 - spec/transpec/syntax/operator_matcher_spec.rb
 - spec/transpec/syntax/raise_error_spec.rb
@@ -306,6 +308,7 @@ test_files:
 - spec/transpec/syntax/double_spec.rb
 - spec/transpec/syntax/expect_spec.rb
 - spec/transpec/syntax/have_spec.rb
+- spec/transpec/syntax/its_spec.rb
 - spec/transpec/syntax/method_stub_spec.rb
 - spec/transpec/syntax/operator_matcher_spec.rb
 - spec/transpec/syntax/raise_error_spec.rb