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  -  TEST2::TOOLS::EXPORTS (3)

.ds Aq ’

NAME

Test2::Tools::Exports - Tools for validating exporters.

CONTENTS

DESCRIPTION

These are tools for checking that symbols have been imported into your namespace.

SYNOPSIS



    use Test2::Tools::Exports

    use Data::Dumper;
    imported_ok qw/Dumper/;
    not_imported_ok qw/dumper/;



EXPORTS

All subs are exported by default.
imported_ok(@SYMBOLS) Check that the specified symbols exist in the current package. This will not find inherited subs. This will only find symbols in the current packages symbol table. This <B>WILL NOTB> confirm that the symbols were defined outside of the package itself.



    imported_ok( $scalar, @array, %hash, &sub, also_a_sub );



@SYMBOLS can contain any number of symbols. Each item in the array must be a string. The string should be the name of a symbol. If a sigil is present then it will search for that specified type, if no sigil is specified it will be used as a sub name.

not_imported_ok(@SYMBOLS) Check that the specified symbols do not exist in the current package. This will not find inherited subs. This will only look at symbols in the current packages symbol table.



    not_imported_ok( $scalar, @array, %hash, &sub, also_a_sub );



@SYMBOLS can contain any number of symbols. Each item in the array must be a string. The string should be the name of a symbol. If a sigil is present then it will search for that specified type, if no sigil is specified it will be used as a sub name.

CAVEATS

Before perl 5.10 it is very difficult to distinguish between a package scalar that is undeclared vs declared and undefined. Currently imported_ok and not_imported_ok cannot see package scalars declared using our $var unless the variable has been assigned a defined value.

This will pass on recent perls, but fail on perls older than 5.10:



    use Test2::Tools::Exports;

    our $foo;

    # Fails on perl onlder than 5.10
    imported_ok(qw/$foo/);



If $foo is imported from another module, or imported using use vars qw/$foo/; then it will work on all supported perl versions.



    use Test2::Tools::Exports;

    use vars qw/$foo/;
    use Some::Module qw/$bar/;

    # Always works
    imported_ok(qw/$foo $bar/);



SOURCE

The source code repository for Test2-Suite can be found at http://github.com/Test-More/Test2-Suite/.

MAINTAINERS

Chad Granum <exodist@cpan.org>

AUTHORS

Chad Granum <exodist@cpan.org>

COPYRIGHT

Copyright 2015 Chad Granum <exodist7@gmail.com>.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

See http://dev.perl.org/licenses/

Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 TEST2::TOOLS::EXPORTS (3) 2016-03-20

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