source: vendors/FCM-2017.10.0/sbin/fcm-install-svn-hook @ 13905

#!/usr/bin/perl
# ------------------------------------------------------------------------------
# (C) British Crown Copyright 2006-17 Met Office.
#
# This file is part of FCM, tools for managing and building source code.
#
# FCM 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.
#
# FCM 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 FCM. If not, see <http://www.gnu.org/licenses/>.
# ------------------------------------------------------------------------------

use strict;
use warnings;

use FindBin;
use lib "$FindBin::Bin/../lib";
use FCM::Admin::System qw{
    filter_projects
    get_projects_from_svn_live
    housekeep_svn_hook_logs
    install_svn_hook
};
use FCM::Admin::Util qw{option2config};
use Getopt::Long qw{GetOptions};
use Pod::Usage qw{pod2usage};

main();

sub main {
    my %option;
    my $result = GetOptions(
        \%option,
        q{clean},
        q{help|usage|h},
        q{svn-live-dir=s},
        q{svn-project-suffix=s},
    );
    if (!$result) {
        pod2usage(1);
    }
    if (exists($option{help})) {
        pod2usage(q{-verbose} => 1);
    }
    option2config(\%option);
    my @projects = filter_projects([get_projects_from_svn_live()], \@ARGV);
    for my $project (sort {$a->get_name() cmp $b->get_name()} @projects) {
        install_svn_hook($project, $option{clean});
        housekeep_svn_hook_logs($project);
    }
}

__END__

=head1 NAME

fcm-install-svn-hook

=head1 SYNOPSIS

    fcm-install-svn-hook [OPTIONS] [PROJECT ...]

=head1 OPTIONS

=over 4

=item --clean

Removes items (except logs) that are not in the install sources.

=item --help, -h, --usage

Prints help and exits.

=item --svn-live-dir=DIR

Specifies the root location of the live directory. See
L<FCM::Admin::Config|FCM::Admin::Config> for the current default.

=item --svn-project-suffix=NAME

Specifies the suffix added to the project name. The default is "_svn".

=back

=head1 ARGUMENTS

=over 4

=item PROJECT

Specifies one or more project requiring hooks scripts to be installed. If no
project is specified, the program install the hook scripts to all projects in
the live directory.

=back

=head1 DESCRIPTION

This program install hook scripts for Subversion repositories in the live
directory, and install/housekeep the log files for the hook scripts.

=head1 COPYRIGHT

E<169> Crown copyright Met Office. All rights reserved.

=cut