The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
 / 
CPAN-Reporter-Smoker-OpenBSD-0.017
River stage zero No dependents
++
/ CPAN::Reporter::Smoker::OpenBSD

NAME

CPAN::Reporter::Smoker::OpenBSD - set of scripts to manage a CPAN::Reporter::Smoker on OpenBSD

DESCRIPTION

This module exports some functions used to manage a smoker testing machine based CPAN::Reporter.

EXPORTS

Only the sub is_distro_ok is exported, if explicit requested.

is_distro_ok

Expects as parameter a string in the format <AUTHOR>/<DISTRIBUTION>.

It executes some very basic testing against the string.

Returns true or false depending if the string passes the tests. It will also warn if things are not going OK.

block_distro

Blocks a distribution to be tested under the smoker by using a distroprefs file.

Expects as parameters:

  1. a distribution name (for example, "JOHNDOE/Some-Distro-Name").

  2. The perl interpreter which is in execution, for example, "perl-5.24.3".

  3. An comment to include in the distroprefs file.

It returns a hash reference containing keys/values that could be directly serialized to YAML (or other format) but the full_path key, that contains a suggest complete path to the distroprefs file (based on the CPAN prefs_dir configuration client.

If there is an already file created as defined in full_path key, it will warn and return undef.

SEE ALSO

For more details about those programs interact with the smoker and CPAN::Reporter, be sure to read the documentation about CPAN client, especially the part about DistroPrefs.

You will also want to take a look at the following programs documentation:

  • perldoc send_reports

  • perldoc dblock

  • perldoc mirror_cleanup

AUTHOR

Alceu Rodrigues de Freitas Junior, <arfreitas@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2017 of Alceu Rodrigues de Freitas Junior, arfreitas@cpan.org

This file is part of CPAN OpenBSD Smoker.

CPAN OpenBSD Smoker is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

CPAN OpenBSD Smoker is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with CPAN OpenBSD Smoker. If not, see <http://www.gnu.org/licenses/>.