module name for test data?

2009-09-28 Thread Jerome Quelin
hi,

i'm the maintainer of audio::mpd and poe::component::client::mpd, 2
modules that connect to a mpd server. there are 2 different modules to
fit the poe environment, and take advantage of the evenement framework
it provides.

those 2 modules already share part of the code, with audio::mpd::common
which provides them with common classes used by both modules.

both audio::mpd and pococm are shipping with an extensive test
suite which embeds some small ogg files. those test files weight 112k.

now, 112k is not that much, but:
 - they are duplicated in 2 modules, which is bad
 - they are uploaded everytime i upload a new version of one of the
   modules, which is also bad

therefore, i'm considering splitting the test data in a module of its
own. i don't think embedding them in audio::mpd::common would be the
best, since audio::mpd::common is needed at runtime, while this data is
only needed during build (test) time.

knowing that the new module will also provide some basic functions
to start / stop associated mpd server for the tests, what module name do
you suggest?

- audio::mpd::common? (even if i don't think that's the best)
- audio::mpd::test? this one is already used by a module in audio::mpd,
  but that's not a problem (i plan to move audio::mpd::test somewhere in
  t/lib/, so namespace would be free)
- audio::mpd::testdata?
- audio::mpd::common::test?
- data::audio::mpd?
- data::audio::mpd::test?
- test::audio::mpd?
- is there a namespace for bulk data? test data?

== any insight welcome...

thanks,
jérôme 
-- 
jque...@gmail.com


Re: module name for test data?

2009-09-28 Thread Smylers
Jerome Quelin writes:

 - audio::mpd::common? (even if i don't think that's the best)
 - audio::mpd::test? this one is already used by a module in audio::mpd,
   but that's not a problem (i plan to move audio::mpd::test somewhere in
   t/lib/, so namespace would be free)
 - audio::mpd::testdata?
 - audio::mpd::common::test?
 - data::audio::mpd?
 - data::audio::mpd::test?
 - test::audio::mpd?

I'd go for the latter (well, with some capital letters!) cos people are
used to the idea that Test:: modules are used for testing rather than
being part of the 'main function' of your program.

But none of those names sound bad -- they're all pretty self-
explanatory, so any of them would do.

Smylers


Re: module name for test data?

2009-09-28 Thread Paul LeoNerd Evans
On Mon, Sep 28, 2009 at 05:37:17PM +0100, Smylers wrote:
 Jerome Quelin writes:
 
  - audio::mpd::common? (even if i don't think that's the best)
  - audio::mpd::test? this one is already used by a module in audio::mpd,
but that's not a problem (i plan to move audio::mpd::test somewhere in
t/lib/, so namespace would be free)
  - audio::mpd::testdata?
  - audio::mpd::common::test?
  - data::audio::mpd?
  - data::audio::mpd::test?
  - test::audio::mpd?
 
 I'd go for the latter (well, with some capital letters!) cos people are
 used to the idea that Test:: modules are used for testing rather than
 being part of the 'main function' of your program.
 
 But none of those names sound bad -- they're all pretty self-
 explanatory, so any of them would do.

If the module is for use purely during testing, and serves no other
useful purpose, I'd make sure to include the word Test (capitalised)
somewhere in its distribution name. The variations on common without
test would imply it's some sort of shared useful code to use in
production use.

-- 
Paul LeoNerd Evans

leon...@leonerd.org.uk
ICQ# 4135350   |  Registered Linux# 179460
http://www.leonerd.org.uk/


signature.asc
Description: Digital signature


Re: module name for test data?

2009-09-28 Thread Jerome Quelin
On 09/09/28 20:08 +0100, Paul LeoNerd Evans wrote:
 If the module is for use purely during testing, and serves no other
 useful purpose, I'd make sure to include the word Test (capitalised)
 somewhere in its distribution name. The variations on common without
 test would imply it's some sort of shared useful code to use in
 production use.

yes, i never capitalize when i'm writing (except code, of course). so
the proposed module names would be capitalized correctly, of course.

currently, it seems that test::audio::mpd gtes the most votes...

jérôme 
-- 
jque...@gmail.com