You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@perl.apache.org by Geoffrey Young <ge...@modperlcookbook.org> on 2003/04/01 20:16:39 UTC
[patch] TestMM generates default t/TEST
it's irked me for a while that Apache::Test does so much behind the scenes
yet I still have to write a Test.PL template to include what is essentially
one line of code. I think we should be able to provide a default harness
with minimal intervention.
the attached patch allows you to call Apache::TestMM::generate_script() with
no arguments, which creates a minimal (but sufficient for most purposes)
t/TEST script. when passed an argument it works as before.
--Geoff
Re: docs distro
Posted by Stas Bekman <st...@stason.org>.
Geoffrey Young wrote:
>
>> It's because all the docs live in the modperl-docs rep. modperl-2.0
>> gets modperl-docs/src/docs/2.0 extracted into modperl-2.0/docs.
>> testing.pod lives in modperl-docs/src/docs/general/testing/testing.pod
>> as it's not 2.0-specific.
>
>
> yes, but Apache::Test is distributed with 2.0 so whatever docs are
> appropriate ought to be as well.
Apache::Test includes all the API docs (well, not all, but it should at some
point) in its .pm files. testing.pod is a tutorial, not an API documentation.
Apache::Test/README includes a pointer to the testing doc online.
>> I'm not even sure we should carry the whole modperl-docs/src/docs/2.0
>> in the mp2 distro. Perhaps just modperl-docs/src/docs/2.0/api is what
>> we need. I've already committed the code that glues the API docs back
>> to their .pm files.
>
> I think they all should be there - software isn't much good without the
> docs :)
sure, they can stay there, but I doubt that they are very useful there, just
bloating the size of the distro. Would you read the long tutorials with
perldoc? I doubt so. They are much more useful when formatted in html and pdf.
__________________________________________________________________
Stas Bekman JAm_pH ------> Just Another mod_perl Hacker
http://stason.org/ mod_perl Guide ---> http://perl.apache.org
mailto:stas@stason.org http://use.perl.org http://apacheweek.com
http://modperlbook.org http://apache.org http://ticketmaster.com
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@perl.apache.org
For additional commands, e-mail: dev-help@perl.apache.org
Re: docs distro
Posted by Geoffrey Young <ge...@modperlcookbook.org>.
> It's because all the docs live in the modperl-docs rep. modperl-2.0 gets
> modperl-docs/src/docs/2.0 extracted into modperl-2.0/docs. testing.pod
> lives in modperl-docs/src/docs/general/testing/testing.pod as it's not
> 2.0-specific.
yes, but Apache::Test is distributed with 2.0 so whatever docs are
appropriate ought to be as well.
>
> I'm not even sure we should carry the whole modperl-docs/src/docs/2.0 in
> the mp2 distro. Perhaps just modperl-docs/src/docs/2.0/api is what we
> need. I've already committed the code that glues the API docs back to
> their .pm files.
I think they all should be there - software isn't much good without
the docs :)
just my $0.02
--Geoff
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@perl.apache.org
For additional commands, e-mail: dev-help@perl.apache.org
Re: docs distro
Posted by Stas Bekman <st...@stason.org>.
[changing subject]
Geoffrey Young wrote:
>
>> Also should probably mention it in the testing.pod doc, if it's not
>> mentioned already.
>
>
> which I couldn't find in the 2.0 distribution, BTW.
>
> [geoff@helm modperl-2.0]$ find . -name testing.pod
> [geoff@helm modperl-2.0]$
>
> is it not part of the 2.0 default document set? it probably should be
> if it isn't :)
It's because all the docs live in the modperl-docs rep. modperl-2.0 gets
modperl-docs/src/docs/2.0 extracted into modperl-2.0/docs. testing.pod lives
in modperl-docs/src/docs/general/testing/testing.pod as it's not 2.0-specific.
I'm not even sure we should carry the whole modperl-docs/src/docs/2.0 in the
mp2 distro. Perhaps just modperl-docs/src/docs/2.0/api is what we need. I've
already committed the code that glues the API docs back to their .pm files.
Those who will want the whole documentation wil be able to get it (I'll put it
on CPAN at some point) from a separate docs distro.
__________________________________________________________________
Stas Bekman JAm_pH ------> Just Another mod_perl Hacker
http://stason.org/ mod_perl Guide ---> http://perl.apache.org
mailto:stas@stason.org http://use.perl.org http://apacheweek.com
http://modperlbook.org http://apache.org http://ticketmaster.com
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@perl.apache.org
For additional commands, e-mail: dev-help@perl.apache.org
Re: [patch] TestMM generates default t/TEST
Posted by Geoffrey Young <ge...@modperlcookbook.org>.
> Also should probably mention it in the testing.pod doc, if it's not
> mentioned already.
which I couldn't find in the 2.0 distribution, BTW.
[geoff@helm modperl-2.0]$ find . -name testing.pod
[geoff@helm modperl-2.0]$
is it not part of the 2.0 default document set? it probably should be
if it isn't :)
--Geoff
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@perl.apache.org
For additional commands, e-mail: dev-help@perl.apache.org
Re: [patch] TestMM generates default t/TEST
Posted by Stas Bekman <st...@stason.org>.
Geoffrey Young wrote:
>
>> Have you looked at Apache::TestRun::generate_script? It does exactly
>> that.
>
>
> bah.
>
> thanks, that's exactly what I need.
;)
The only reason it's in TestRun, is because TestReport and TestSmoke has it as
well (to generate REPORT and SMOKE scripts). So it's a 1:1 mapping. Whereas
TestMM is for crafting your own thing.
Also should probably mention it in the testing.pod doc, if it's not mentioned
already.
__________________________________________________________________
Stas Bekman JAm_pH ------> Just Another mod_perl Hacker
http://stason.org/ mod_perl Guide ---> http://perl.apache.org
mailto:stas@stason.org http://use.perl.org http://apacheweek.com
http://modperlbook.org http://apache.org http://ticketmaster.com
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@perl.apache.org
For additional commands, e-mail: dev-help@perl.apache.org
Re: [patch] TestMM generates default t/TEST
Posted by Geoffrey Young <ge...@modperlcookbook.org>.
> Have you looked at Apache::TestRun::generate_script? It does exactly that.
bah.
thanks, that's exactly what I need.
--Geoff
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@perl.apache.org
For additional commands, e-mail: dev-help@perl.apache.org
Re: [patch] TestMM generates default t/TEST
Posted by Stas Bekman <st...@stason.org>.
Geoffrey Young wrote:
> it's irked me for a while that Apache::Test does so much behind the
> scenes yet I still have to write a Test.PL template to include what is
> essentially one line of code. I think we should be able to provide a
> default harness with minimal intervention.
>
> the attached patch allows you to call Apache::TestMM::generate_script()
> with no arguments, which creates a minimal (but sufficient for most
> purposes) t/TEST script. when passed an argument it works as before.
Have you looked at Apache::TestRun::generate_script? It does exactly that.
__________________________________________________________________
Stas Bekman JAm_pH ------> Just Another mod_perl Hacker
http://stason.org/ mod_perl Guide ---> http://perl.apache.org
mailto:stas@stason.org http://use.perl.org http://apacheweek.com
http://modperlbook.org http://apache.org http://ticketmaster.com
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@perl.apache.org
For additional commands, e-mail: dev-help@perl.apache.org