module RSpec::Core::Subject::ClassMethods

def explicit_subject
  group = self
  while group.respond_to?(:explicit_subject_block)
    return group.explicit_subject_block if group.explicit_subject_block
    group = group.superclass
  end
end

def implicit_subject
  described = describes || description
  Class === described ? proc { described.new } : proc { described }
end

end
its(:count) { should == 2 }
its(:keys) { should include(:max_users) }
# You can still access to its regular methods this way:

its(['admin']) { should == :all_permissions }
its([:max_users]) { should == 3 }

end
'admin' => :all_permissions }
{ :max_users => 3,
subject do
describe "a configuration Hash" do

specifying a +Symbol+ or +String+ in an array.
When the subject is a +Hash+, you can refer to the Hash keys by

end
its("phone_numbers.first") { should == "555-1212" }

end
end
person.phone_numbers << "555-1212"
Person.new.tap do |person|
subject do
describe Person do

onto the subject in an expression.
with dots, the result is as though you concatenated that +String+
The attribute can be a +Symbol+ or a +String+. Given a +String+

end
end
end
subject.size.should == 0
it "should == 0" do
describe "size" do
describe Array do
# ... generates the same runtime structure as this:

end
its(:size) { should == 0 }
describe Array do
# This ...

and then generates an example using the submitted block.
Creates a nested example group named by the submitted +attribute+,

def its(attribute, &block)
  describe(attribute) do
    example do
      self.class.class_eval do
        define_method(:subject) do
          @_subject ||= if attribute.is_a?(Array)
                          super()[*attribute]
                        else
                          attribute.to_s.split('.').inject(super()) do |target, method|
                            target.send(method)
                          end
                        end
        end
      end
      instance_eval(&block)
    end
  end
end

See +ExampleMethods#should+ for more information about this approach.

end
it { should_not be_overdrawn }
it { should have_a_balance_of(50, :USD) }
subject { CheckingAccount.new(:amount => 50, :currency => :USD) }
describe CheckingAccount, "with $50" do

== Examples

implicit receiver (through delegation) of calls to +should+.
Defines an explicit subject for an example group which can then be the

def subject(&block)
  block ? @explicit_subject_block = block : explicit_subject || implicit_subject
end