- DISCLAIMER OF WARRANTY
Git::Reduce::Tests - Create a branch with fewer test files for faster development
use Git::Reduce::Tests; my $self = Git::Reduce::Tests->new($params); my $reduced_branch = $self->prepare_reduced_branch(); $self->push_to_remote($reduced_branch);
Git::Reduce::Tests holds the implementation for command-line utility reduce-tests, which is stored in this distribution's scripts/ directory. See that program's documentation (available after installation via
perldoc reduce-tests) or the README for an explanation of that program's functionality.
This package exports no functions.
Git::Reduce::Tests is currently structured as three publicly available methods intended to be called in sequence.
Git::Reduce::Tests constructor. Checks that the directory passed to the
--diroption is a git repository and that there are no files there with a modified status.
$self = Git::Reduce::Tests->new($params);
Reference to a hash of parameters, typically that provided by
Git::Reduce::Tests::Opts::process_options(). See that package's documentation for a description of those parameters.
Creates a new branch whose name is that of the starting branch either (a) prepended with the value of the
--prefixoption or (b) appended with the value of the
--suffixoption -- but not both (a) and (b).
--prefixis given preference and defaults to
The method then reduces the size of that branch's test suite either by specifying a limited number of files to be included in the test suite -- the comma-delimited argument to the
--includeoption -- or by specifying those files to be excluded from the test suite -- the comma-delimited argument to the
$reduced_branch = $self->prepare_reduced_branch();
String containing the name of the new branch with smaller test suite.
Push the reduced branch to the remote specified in the
--remoteoption, which defaults to
origin. This, of course, assumes that the user has permission to perform that action, has proper credentials such as SSH keys, etc.
String holding name of branch with reduced test suite -- typically the return value of the
Implicitly returns a true value upon success.
There are no bug reports outstanding as of the most recent CPAN upload date of this distribution.
Please report any bugs by mail to
bug-Git-Reduce-Tests@rt.cpan.org or through the web interface at http://rt.cpan.org.
James E. Keenan (firstname.lastname@example.org). When sending correspondence, please include 'reduce-tests' or 'Git-Reduce-Tests' in your subject line.
Creation date: August 03 2014. Last modification date: August 04 2014.
Development repository: https://github.com/jkeenan/git-reduce-tests
Copyright (c) 2014 James E. Keenan. United States. All rights reserved. This is free software and may be distributed under the same terms as Perl itself.
BECAUSE THIS SOFTWARE IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE SOFTWARE, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE SOFTWARE ''AS IS'' WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE SOFTWARE IS WITH YOU. SHOULD THE SOFTWARE PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR, OR CORRECTION.
IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE SOFTWARE AS PERMITTED BY THE ABOVE LICENCE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE SOFTWARE (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE SOFTWARE TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.