http://www.perlmonks.org?node_id=1054046

shantanu_bhadoria has asked for the wisdom of the Perl Monks concerning the following question:

What goes in a /corpus folder of a cpan module

I read through this thread http://www.perlmonks.org/?node_id=1009586 but found no mention of the /corpus folder. Funny though that Test::Kwalitee::Extra seems to look for it, (although it doesn't fail if the folder is not found). I found very few modules containing a /corpus folder and I am struggling to understand what goes in there. Maybe it should be added to the aforementioned thread but I can't post to it myself as its under perl meditation section.
  • Comment on What is the use of /corpus folder in a CPAN distribution

Replies are listed 'Best First'.
Re: What is the use of /corpus folder in a CPAN distribution (body)
by Anonymous Monk on Sep 14, 2013 at 07:11 UTC

    What goes in a /corpus folder of a cpan module

    Nothing:) anything you want :)

    Funny though that Test::Kwalitee::Extra seems to look for it, (although it doesn't fail if the folder is not found).

    Funny, "corpus" doesn't occur anywhere inside that module

    OTOH, corpus/corpus, corpus http://grep.cpan.me/?q=corpus, https://metacpan.org/source/RJBS/Dist-Zilla-4.300038/corpus/README

    This directory contains a set of distributions used by testing. Since the distributions contain *.t files, it's easier to put them outside of ./t so that recursive test harnesses do not try running their dists.

    So you have the tests convention of t/ and xt/ for extra/author tests,

    and now , instead of using https://metacpan.org/module/ExtUtils::MakeMaker#test option,

    one guy, created a corpus directory instead of having a body or nottest or notsharedir or junk or stuff or extraextradatafiles namedliketest-butshouldntberun-or-installed

    I am struggling to understand what goes in there

    chilax :) give up :)

    Maybe it should be added to the aforementioned thread but I can't post to it myself as its under perl meditation section.

    Nah, its a unicorn like ./meta/ in What are the files in a CPAN distribution? , its not a convention

      chilax :) give up :)
      Hah!! No way!!

      but thanks for the explanation on corpus!
      it seems it was lying in my dzil dist.ini and the dzil extension for kwalitee picked it up.