GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  TEST::METASYNTACTIC (3)

.ds Aq ’

NAME

Test::MetaSyntactic - Common tests for Acme::MetaSyntactic themes

CONTENTS

SYNOPSIS



   # add this as t/meta.t
   use Test::MetaSyntatic;
   all_themes_ok();



DESCRIPTION

This module provides the minimum set of tests that any Acme::MetaSyntactic theme should pass.

The goal is to make is easier for theme creators build a distribution and ensure theirs themes will work as expected when installed.

EXPORTED FUNCTIONS

all_themes_ok( CW@lib )

Will find all themes under the directories listed in @lib, and run theme_ok() on them.

@lib is optional (it will try to find themes in blib/lib or lib if not provided).

theme_ok( CW$theme, CW$source )

Will run all tests on the given $theme. Some tests require access to the source, but they will be skipped if $source is not provided.

If the subtest_load() test fails, no further test will be run.

SUBTESTS

The individual tests are run as subtests. All substests but subtest_load() assume that the module can be successfully loaded.

subtest_fixme( CW$theme, CW$source )

Checks that the theme source file does not contain the word FIXME.

subtest_encoding( CW$theme, CW$source )

Checks that the theme source files contains an =encoding line if it contains some non us-ascii characters.

subtest_load( CW$theme )

Tries to load the theme module.

First in the currently running process, and then in isolation inside its own environment.

subtest_version( CW$theme )

Checks that the theme has a $VERSION.

subtest_format( CW$theme )

Checks that each metasyntactic name in the theme is a valid Perl variable name.

subtest_length( CW$theme )

Checks that each name in the theme has valid length.

subtest_data( CW$theme, CW$source )

Checks that the __DATA__ section (if any) of the theme source is properly formatted.

subtest_import( CW$theme )

Checks that the exported meta$theme function returns an item from $theme.

subtest_noimport( CW$theme )

Checks that use Acme::MetaSyntactic::$theme () does not export the meta$theme function.

subtest_theme( CW$theme )

Checks that the theme() function returns the theme name.

subtest_remote( CW$theme )

For themes with a remote list, checks that the remote list (if any) is identical to the current list of items in the theme.

This subtest will only be run if RELEASE_TESTING (or AUTHOR_TESTING, for backward compatibility reasons) is true and AUTOMATED_TESTING is false. Requires LWP::UserAgent.

AUTHOR

Philippe Bruhat (BooK), <book@cpan.org>

COPYRIGHT

Copyright 2012 Philippe Bruhat (BooK), All Rights Reserved.

LICENSE

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 TEST::METASYNTACTIC (3) 2013-10-14

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.