The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

NAME

Test::PAUSE::Permissions - tests module permissions in your distribution

SYNOPSIS

    # in your xt/perms.t

    use Test::PAUSE::Permissions;
    
    all_permissions_ok();

DESCRIPTION

This module is to test if modules in your distribution have proper permissions or not. You need to set RELEASE_TESTING to test this.

You might also want to prepare .pause file (you should have one to release distributions anyway).

FUNCTION

This module exports only one function (yet):

all_permissions_ok

Looks for packages with Parse::LocalDistribution, and tests if you (or the registered author) have proper permissions for them by PAUSE::Permissions, which downloads 06perms.txt from CPAN before testing.

By default, all_permissions_ok looks into .pause file to find who is releasing the distribution.

You can also pass the author as an argument, though this is only useful when you generate this test every time you release a distribution.

    use Test::PAUSE::Permissions;
    
    # assumes ISHIGAKI is going to release the distribution
    all_permissions_ok('ISHIGAKI');

all_permissions_ok also looks into META files for <x_authority>, and each .pm file for $AUTHORITY variable, for your information.

SEE ALSO

PAUSE::Permissions, App::PAUSE::CheckPerms

AUTHOR

Kenichi Ishigaki, <ishigaki@cpan.org>

COPYRIGHT AND LICENSE

Copyright (C) 2014 by Kenichi Ishigaki.

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