Beefy Boxes and Bandwidth Generously Provided by pair Networks
Your skill will accomplish
what the force of many cannot
 
PerlMonks  

Re: Author tests or standard tests?

by eyepopslikeamosquito (Archbishop)
on Nov 06, 2018 at 19:37 UTC ( [id://1225324]=note: print w/replies, xml ) Need Help??


in reply to Author tests or standard tests?

Some historical background, in case it is of some use.

The Oslo Consensus (May 2008)

  • $ENV{AUTOMATED_TESTING} - not $ENV{PERL_AUTOMATED_TESTING}
  • $ENV{RELEASE_TESTING} - not $ENV{AUTHOR_TESTING} or $ENV{PERL_AUTHOR_TESTING}
  • xt/ directory for release and other non-install-time tests (subdirectories optional)
  • Support 'requires => { perl => 5.xxx }' and extend to to all 'requires' types
  • *.PL should generate META_LOCAL.yml with requirements after dynamic configuration

The Lancaster Consensus (April 2013)

See The Lancaster Consensus and The Annotated Lancaster Consensus for full details.

Historically, AUTOMATED_TESTING has been confusing, used for a number of different purposes:

  1. I don't want the user to interact with this test.
  2. This is a long-running test.
  3. This test depends on an external website (say) and I don't want to stop the user installing if it fails, but I want to see what CPAN smokers experienced.

The Lancaster Consensus clarifies the semantics of AUTOMATED_TESTING and RELEASE_TESTING and adds three new environment variables, making a total of five:

  • AUTOMATED_TESTING
  • NONINTERACTIVE_TESTING
  • EXTENDED_TESTING
  • RELEASE_TESTING
  • AUTHOR_TESTING

To run module tests after installation, use new target "make test-installed", equivalent to "make test" but without adding blib to @INC.

Some Related CPAN Modules

See also: Perl CPAN test metadata in addition to The Oslo Consensus and The Lancaster Consensus covers The Berlin Consensus (2015) and PTS Oslo (2018)

Replies are listed 'Best First'.
Re^2: Author tests or standard tests?
by stevieb (Canon) on Nov 06, 2018 at 21:37 UTC

    I'm glad this thread got posted. I'd never heard of this "Lancaster Consensus" before. Took a brief glance before going into a meeting here, but it definitely looks interesting enough to read later today.

Log In?
Username:
Password:

What's my password?
Create A New User
Domain Nodelet?
Node Status?
node history
Node Type: note [id://1225324]
help
Chatterbox?
and the web crawler heard nothing...

How do I use this?Last hourOther CB clients
Other Users?
Others chanting in the Monastery: (7)
As of 2024-04-18 07:56 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    No recent polls found