[rspec-users] How do you use pending in RSpec?

2009-03-12 Thread Bill Venners
Hi All,

I've been working on BDD support in a test framework for Scala
imaginatively called ScalaTest, and I want to add support for the
notion of pending examples. I see three different "forms" of pending
in RSpec, and I'm curious to hear which ones RSpec users find most
useful. The three forms are:

# 1. With no block you get a PENDING (Not Yet Implemented) in the report
it "should say foo"

# 2. Passing a string, but no block, to pending. You get the PENDING
(get the vocal chords working) in the report.
it "should say foo" do
  pending("get the vocal chords working")
  subject.should say("foo")
end

# 3. Pass a string and a block to pending. If the pending code raises
an exception, then you get PENDING (get the vocal chords working)k
# but if not, I believe the whole tests fails to let you know you need
to drop the pending stuff now that it works (I may be wrong).
it "should say foo" do
  pending("get the vocal chords working") do
subject.should say("foo")
  end
end

Which of these forms do you find the most useful in practice, and are
there any that you think would be better left out?

Thanks.

Bill

Bill Venners
Artima, Inc.
http://www.artima.com
___
rspec-users mailing list
rspec-users@rubyforge.org
http://rubyforge.org/mailman/listinfo/rspec-users


Re: [rspec-users] How do you use pending in RSpec?

2009-03-12 Thread Bill Venners
Hi Aslak and Scott,

Thanks for your replies. I have a couple quick follow up questions.

On Thu, Mar 12, 2009 at 3:05 PM, aslak hellesoy
 wrote:
>
>
> On Thu, Mar 12, 2009 at 10:50 PM, Bill Venners  wrote:
>>
>> Hi All,
>>
>> I've been working on BDD support in a test framework for Scala
>> imaginatively called ScalaTest, and I want to add support for the
>
> Very cool!
>
>> notion of pending examples. I see three different "forms" of pending
>> in RSpec, and I'm curious to hear which ones RSpec users find most
>> useful. The three forms are:
>>
>> # 1. With no block you get a PENDING (Not Yet Implemented) in the report
>> it "should say foo"
>
> I rarely use this, as I don't write a lot of specs up front.
>
OK. One use case I see for pending is writing the spec text before the
example code. No one yet has said they actually do this in practice.
Anyone care to admit this feature is important to them?

>>
>> # 2. Passing a string, but no block, to pending. You get the PENDING
>> (get the vocal chords working) in the report.
>> it "should say foo" do
>>  pending("get the vocal chords working")
>>  subject.should say("foo")
>> end
>
> I find myself using #2 the most. I use it when I want to reduce noise diring
> a refactoring that breaks a lot.
>
You know there's already an "ignore" feature in ScalaTest's Spec,
which I think is probably like xit in RSpec. You just select "it" and
change it to "ignore". That means temporarily ignore this test, which
most likely broke because I'm doing refactoring. What's missing is
that there's no way with ignore to specify a string like you can with
pending #2. What do you usually put in that string?

>>
>> # 3. Pass a string and a block to pending. If the pending code raises
>> an exception, then you get PENDING (get the vocal chords working)k
>> # but if not, I believe the whole tests fails to let you know you need
>> to drop the pending stuff now that it works (I may be wrong).
>> it "should say foo" do
>>  pending("get the vocal chords working") do
>>subject.should say("foo")
>>  end
>> end
>
> I sometimes use this when I'm not sure why the example is failing, but don't
> want to look into it right now.
>
I guess I'm curious:

1) How important is it to you to be able to just "strike out" the
lines of code within an example that are failing (as you can with
RSpec's #3 pending form), versus just "striking out" the entire
example as you can with ignore in ScalaTest.

2) How important is it to you to be able to add a string message to
your stricken code, as you can with either #2 or #3 in RSpec? How does
that string help you?

Thanks.

Bill

Bill Venners
Artima, Inc.
http://www.artima.com/
___
rspec-users mailing list
rspec-users@rubyforge.org
http://rubyforge.org/mailman/listinfo/rspec-users


Re: [rspec-users] How do you use pending in RSpec?

2009-03-13 Thread Bill Venners
Hi Matt and others,

Thanks for your replies. I think I've settled on just using two of
RSpec's pending forms in ScalaTest. If you want to write out a few
spec texts before writing the examples, you'd put pending in parens
where you'd normally put the block of example code:

it("should do something") (pending)

it("should do something else") (pending)

If something breaks during refactoring, you can either ignore the
whole thing by changing it to ignore like this (which already is
supported):

ignore("should do something") {
  // ...
}

Or by puttting a pending with a string inside the example block of code:

it("should do something") {
  // ...
  pending("this won't start working again until I...")
  // ...
}

But I'll leave out the pending form that takes a block.

I appreciate the feedback.

Thanks.

Bill


On Fri, Mar 13, 2009 at 8:07 AM, Matt Wynne  wrote:
>
> On 12 Mar 2009, at 23:23, Bill Venners wrote:
>
>> I guess I'm curious:
>>
>> 1) How important is it to you to be able to just "strike out" the
>> lines of code within an example that are failing (as you can with
>> RSpec's #3 pending form), versus just "striking out" the entire
>> example as you can with ignore in ScalaTest.
>
> I don't personally ever strike out parts of an example - all or nothing
>
>> 2) How important is it to you to be able to add a string message to
>> your stricken code, as you can with either #2 or #3 in RSpec? How does
>> that string help you?
>
> Very important - it's like a TODO.
>
> Matt Wynne
> http://blog.mattwynne.net
> http://www.songkick.com
>
> ___
> rspec-users mailing list
> rspec-users@rubyforge.org
> http://rubyforge.org/mailman/listinfo/rspec-users
>
___
rspec-users mailing list
rspec-users@rubyforge.org
http://rubyforge.org/mailman/listinfo/rspec-users