/ 
CPAN-Smoker-Utils-v1.0.1
River stage zero No dependents
/ bin/dblock

dblock

dblock - program to create a distribution preferences file to prevent the smoker from testing it

SYNOPSIS

dblock --distro='ARFREITAS/Siebel-Srvrmgr'

OPTIONS

--distro

This parameter expects a string describing the Perl distribution to be disabled regarding testing on the smoker. The string must have the format AUTHOR/DISTRIBUTION.

This is a required parameter: not providing it will cause the program to abort with an error.

--help

This help message.

--comment

Adds a customized comment to the distroprefs file. It's entirely optional, and if not given, the default text will be the string Tests hang smoker.

Sometimes you want to add an distroprefs when, for example, the distribution uses too much disk space, and an different message will help to identify that.

--version

Prints the version number and exits.

DESCRIPTION

This program creates a YAML file that describes a Perl distribution preferences specifically to disable CPAN::Reporter to skip trying to test the distribution itself.

Sometimes this is required to be included for CPAN Smokers (see CPAN::Reporter::Smoker) because some distributions just cannot be tested automatically and makes a smoker to hang during the tests, one will need to manually terminate the related processes.

The YAML file will be created on the respective home directory of the user, followed by .cpan and prefs.

See CPAN::Reporter for details. You can check examples of those files on this project webpage at Github. Those preferences files were created during several tests executed.

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 Smoker Utils.

CPAN Smoker Utils 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 Smoker Utils 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 Smoker Utils. If not, see http://www.gnu.org/licenses/.