Bug #51270 for Test-Group: wish: example output in Synopsis

Tue Nov 10 08:52:23 2009 MARKSTOS [...] cpan.org - Ticket created

Subject:

wish: example output in Synopsis

Thanks for contributing this module. I suggest adding an example of the output in the Synposis. The Test::More subtest feature un-intuitively places the summary test name *after* the subtests. Adding an example of the output to the synopsis would clarify this point, and well as other questions prospective users might have about the formatting.

Tue Nov 10 09:56:27 2009 domq [...] cpan.org - Correspondence added 20 min

On Tue Nov 10 08:52:23 2009, MARKSTOS wrote: Show quoted text

> Thanks for contributing this module.

This is an honor, thanks! Show quoted text

> I suggest adding an example of the output in the Synposis. The Test::More > subtest feature un-intuitively places the summary test name *after* the > subtests.

I just pushed a new version to our Git depot, let me know if this is what you had in mind (line 58): http://kilimandjaro.dyndns.org/git/gitweb.cgi?p=Test-Group;a=blob;f=lib/Test/Group.pm;h=c177d2111225640fc47d821e63868a2a3144eb78;hb=e79eb40058e4cf91db64de6f496d19847c9499cb Cheers!

Tue Nov 10 09:56:28 2009 The RT System itself - Status changed from 'new' to 'open'

Tue Nov 10 09:56:29 2009 domq [...] cpan.org - Status changed from 'open' to 'patched'

Tue Nov 10 09:56:29 2009 domq [...] cpan.org - Given to DOMQ

Tue Nov 10 10:11:23 2009 mark [...] summersault.com - Correspondence added

Subject:	Re: [rt.cpan.org #51270] wish: example output in Synopsis
Date:	Tue, 10 Nov 2009 10:10:22 -0500
To:	bug-Test-Group [...] rt.cpan.org
From:	Mark Stosberg <mark [...] summersault.com>

Show quoted text

> > http://kilimandjaro.dyndns.org/git/gitweb.cgi?p=Test-Group;a=blob;f=lib/Test/Group.pm;h=c177d2111225640fc47d821e63868a2a3144eb78;hb=e79eb40058e4cf91db64de6f496d19847c9499cb

That's helpful, thanks. So all of the subtest output is hidden, and you just get a single line of output for the test group summary? That seems like a fine way to do it, I just want to confirm that it's different than how Test::More::subtest() works, which includes output for every sub-test, as well as the summary. Both approaches seem useful. If this line had a label, would it also be included in the output? is "foo", "bar"; Thanks again for the contribution. Mark

Tue Nov 10 10:11:23 2009 The RT System itself - Status changed from 'patched' to 'open'

Tue Nov 10 10:21:53 2009 domq [...] cpan.org - Correspondence added 10 min

On Tue Nov 10 10:11:23 2009, mark@summersault.com wrote: Show quoted text

> So all of the subtest output is hidden, and you just get a single line > of output for the test group summary?

Exactly. Show quoted text

> Test::More::subtest()

Yeah, I started this module back in the times, when TAP format would not allow for this. Show quoted text

> If this line had a label, would it also be included in the output? > > is "foo", "bar";

Yes. I pushed another change to clarify these points (the latter is now part of the synopsis as well): http://kilimandjaro.dyndns.org/git/gitweb.cgi?p=Test-Group;a=summary

Tue Nov 10 11:02:38 2009 mark [...] summersault.com - Correspondence added

Subject:	Re: [rt.cpan.org #51270] wish: example output in Synopsis
Date:	Tue, 10 Nov 2009 11:02:23 -0500
To:	bug-Test-Group [...] rt.cpan.org
From:	Mark Stosberg <mark [...] summersault.com>

Show quoted text

> I pushed another change to clarify these points (the latter is now part > of the synopsis as well): > > http://kilimandjaro.dyndns.org/git/gitweb.cgi?p=Test-Group;a=summary

That's great. Thanks! Mark -- . . . . . . . . . . . . . . . . . . . . . . . . . . . Mark Stosberg Principal Developer mark@summersault.com Summersault, LLC 765-939-9301 ext 202 database driven websites . . . . . http://www.summersault.com/ . . . . . . . .

Fri Nov 13 01:05:00 2009 NCLEATON [...] cpan.org - Correspondence added

These fixes are in the 0.16 release.

Fri Nov 13 01:05:02 2009 NCLEATON [...] cpan.org - Status changed from 'open' to 'resolved'