Update environment for StraBerry Perl

update_env.pl.bat

@rem = '--*-Perl-*--
@echo off
if "%OS%" == "Windows_NT" goto WinNT
%~dp0perl\bin\perl -x -S "%0" %1 %2 %3 %4 %5 %6 %7 %8 %9
goto endofperl
:WinNT
%~dp0perl\bin\perl -x -S %0 %*
goto endofperl
@rem ';
#!perl

use 5.010;
use strict;
use warnings;
use Win32::TieRegistry qw(:KEY_);
use File::Spec::Functions qw(catdir splitpath);
use English qw(-no_match_vars);
use Carp qw(carp);
use Getopt::Long qw(GetOptions);
use Pod::Usage qw(pod2usage);
use FindBin;

sub usage;
sub version;

our $STRING_VERSION = our $VERSION = '1.001';
$VERSION  =~ s/_//;

my $directory;
my $quiet = 0;
my $system = 1;

GetOptions('help|?'      => sub { pod2usage(-exitstatus => 0, -verbose => 0); }, 
		   'man'         => sub { pod2usage(-exitstatus => 0, -verbose => 2); },
		   'usage'       => sub { usage(); },
		   'version'     => sub { version(); exit(1); },
		   'directory=s' => \$directory,
		   'quiet'       => \$quiet,
		   'system!'     => \$system,
		  ) or pod2usage(-verbose => 2);

if (not defined $directory) {
	$directory = $FindBin::Bin;
	$directory =~ s{/}{\\}g;
}

if (not defined $directory) {
	carp q{Could not get the script's directory, and no --directory option was given};
}

# Get the appropriate environment entries.
my ($hklm_env, $hkcu_env); 
if ($system) {
	$hklm_env = Win32::TieRegistry->new(
		'HKEY_LOCAL_MACHINE/SYSTEM/CurrentControlSet/Control/Session Manager/Environment', 
		{ 
			Access => KEY_READ() | KEY_WRITE() | 256,
			Delimiter => '/', 
		}
	); # returns undef if SYSTEM ENV not writable
}

$hkcu_env = Win32::TieRegistry->new(
    'HKEY_CURRENT_USER/Environment', 
    { 
		Access => KEY_READ() | KEY_WRITE() | 256, 
		Delimiter => '/', 
	}
);

# If system environment is not writable (or not requested) try the user environment.
my ($env, $location);
if (defined($hklm_env)) {
	$env = $hklm_env;
	$location = 'system';
} else {
	$env = $hkcu_env;
	$location = 'user';
}

my (@items_to_add);
@items_to_add = map { catdir( $directory, $_ ); } qw{c\bin perl\site\bin perl\bin};
 
if (defined $env) {
	my $path = $env->GetValue('Path');
	foreach my $i (@items_to_add) {
		$path = "$path;$i" unless $path =~ /\Q$i\E/;
		say "Adding $i to the $location path." unless $quiet;
	}
	$env->SetValue('Path', $path);
	$env->SetValue('TERM', 'dumb');
	say "Adding TERM=dumb to the $location environment." unless $quiet;
}
else {
	if ($system) {
		carp "Cannot open either the system or the user environment registry entries for read and write access";
	} else {
		carp "Cannot open the user environment registry entries for read and write access";
	}
}

say 'Updating environment variables added.' unless $quiet;
say 'Please reboot now in order to complete installation.' unless $quiet;

exit(0);

sub version {
	my (undef, undef, $script) = splitpath( $PROGRAM_NAME );

	print <<"EOF";
This is $script, version $STRING_VERSION, which adds
Strawberry Perl to the path, and updates other environment variables.

Copyright 2010 Curtis Jewell and kmx.

This script may be copied only under the terms of either the Artistic License
or the GNU General Public License, which may be found in the Perl 5 
distribution or the distribution containing this script.
EOF

	return;
}



sub usage {
	my $error = shift;

	print "Error: $error\n\n" if (defined $error);
	my (undef, undef, $script) = splitpath( $PROGRAM_NAME );

	print <<"EOF";
This is $script, version $STRING_VERSION, which adds
Strawberry Perl to the path, and updates other environment variables.

Usage: perl $script 
    [ --help ] [ --usage ] [ --man ] [ --version ] [ -? ]
    [--directory directory] [--[no]system] [--quiet]

For more assistance, run perl $script --help.
EOF

	exit(1);	
}

__END__

=head1 NAME

update_env.pl.bat - Adds the required environment entries for Strawberry Perl.

=head1 VERSION

This document describes update_env.pl.bat version 1.001.

=head1 DESCRIPTION

This script updates the environment to add Strawberry Perl to the PATH 
permanently, and adds other environment variables that portions of 
Strawberry Perl uses.

=head1 SYNOPSIS

  update_path.pl.bat [ --help ] [ --usage ] [ --man ] [ --version ] [ -?] 
                     [--directory path] [--[no]system] [--quiet]

  Options:
    --usage         Gives a minimum amount of aid and comfort.
    --help          Gives aid and comfort.
    -?              Gives aid and comfort.
    --man           Gives maximum aid and comfort.

    --version       Gives the name, version and copyright of the script.

    --directory     The location the script is in. (used to set the path 
                    to update to.) Defaults to $FindBin::Bin.
    --[no]system    Specifies whether to attempt to update the system
                    environment first. Defaults to --system.
    --quiet         Print nothing.
	
=head1 DEPENDENCIES

Perl 5.10.0 is the mimimum version of perl that this script will run on.

Other modules that this script depends on are 
L<Getopt::Long|Getopt::Long>, L<Pod::Usage|Pod::Usage>, 
L<File::Spec::Functions|File::Spec::Functions>, and 
L<Win32::TieRegistry|Win32::TieRegistry>.

=head1 SUPPORT

Support is provided for this script on the same basis as Strawberry Perl.
See L<http://strawberryperl.com/support.html> for details.

=head1 AUTHOR

Curtis Jewell, E<lt>csjewell@cpan.orgE<gt>

kmx, E<lt>kmx@cpan.orgE<gt>

=head1 COPYRIGHT & LICENSE

Copyright 2010 kmx.

Copyright 2010 Curtis Jewell.

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

The full text of the license can be found in the
LICENSE file included with this distribution.

=cut

:endofperl