#! @PERL@ #-*- perl -*- ## Copyright (C) 2000-2008 R Development Core Team ## ## This program 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 2, or (at your option) ## any later version. ## ## This program 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. ## ## A copy of the GNU General Public License is available at ## http://www.r-project.org/Licenses/ ## Send any bug reports to r-bugs@r-project.org use Cwd; use File::Basename; use File::Compare; use File::Find; use File::Path; use File::Copy; use Getopt::Long; use IO::File; use R::Dcf; use R::Logfile; use R::Utils; use Text::Wrap; ## Don't buffer output. $| = 1; my $revision = ' $Rev$ '; my $version; my $name; $revision =~ / ([\d\.]*) /; $version = $1; ($name = $0) =~ s|.*/||; R::Vars::error("R_HOME", "R_EXE"); my $WINDOWS = ($R::Vars::OSTYPE eq "windows"); my @exclude_patterns = R::Utils::get_exclude_patterns(); my @known_options = ("help|h", "version|v", "binary", "no-docs", "use-zip-data", "force", "no-vignettes"); if($WINDOWS) { die "Please set TMPDIR to a valid temporary directory\n" unless (-d ${R::Vars::TMPDIR}); @known_options = ("help|h", "version|v", "binary", "no-docs", "auto-zip", "use-zip-data", "force", "no-vignettes"); } GetOptions(@known_options) or usage(); R_version("R add-on package builder", $version) if $opt_version; usage() if $opt_help; ## Use system default unless explicitly specified otherwise. $ENV{"R_DEFAULT_PACKAGES"} = ""; my $startdir = R_cwd(); my $R_platform = R_getenv("R_PLATFORM", "unknown-binary"); my $gzip = R_getenv("R_GZIPCMD", "gzip"); ## The tar.exe in Rtools has --force-local by default, but this ## enables people to use Cygwin or MSYS tar. my $tar_default = "tar"; $tar_default = "tar --force-local" if $WINDOWS; my $tar = R_getenv("TAR", $tar_default); my $libdir = R_tempfile("Rinst"); my $INSTALL_opts = ""; $INSTALL_opts .= " --use-zip-data" if $opt_use_zip_data; $INSTALL_opts .= " --no-docs" if $opt_no_docs; if($WINDOWS) { $INSTALL_opts .= " --auto-zip" if $opt_auto_zip; } ## ## Once we have a 'global' log file, use $log->warning() instead of just ## print(). if(!$opt_binary && $INSTALL_opts ne "") { print "** Options '$INSTALL_opts' only for '--binary' ignored\n"; } ## ## This is the main loop over all packages to be packaged. foreach my $pkg (@ARGV) { my $is_bundle = 0; $pkg =~ s/\/$//; ## Older versions used $pkg as absolute or relative to $startdir. ## This does not easily work if $pkg is a symbolic link. ## Hence, we now convert to absolute paths. chdir($startdir); chdir($pkg) or die "Error: cannot change to directory '$pkg'\n"; ## (We could be nicer ...) my $pkgdir = R_cwd(); my $pkgname = basename($pkgdir); my $intname; ## chdir($startdir); ## (Does not hurt, but should no longer be necessary.) my $log = new R::Logfile(); my $description; $log->checking("for file '$pkg/DESCRIPTION'"); if(-r &file_path($pkgdir, "DESCRIPTION")) { $description = new R::Dcf(&file_path($pkgdir, "DESCRIPTION")); $log->result("OK"); } else { $log->result("NO"); exit(1); } my @bundlepkgs; if($description->{"Contains"}) { $log->message("looks like '${pkgname}' is a package bundle"); $is_bundle = 1; $intname = $description->{"Bundle"}; @bundlepkgs = split(/\s+/, $description->{"Contains"}); foreach my $ppkg (@bundlepkgs) { $log->message("cleaning '$ppkg' in bundle '$pkgname'"); $log->setstars("**"); ## chdir($startdir); cleanup_pkg(&file_path("$pkgdir", "$ppkg"), $log); $log->setstars("*"); } foreach my $ppkg (@bundlepkgs) { $log->message("preparing '$ppkg' in bundle '$pkgname':"); $log->setstars("**"); ## chdir($startdir); prepare_pkg(&file_path("$pkgdir", "$ppkg"), $is_bundle, $description, $log); $log->setstars("*"); } foreach my $ppkg (@bundlepkgs) { $log->message("cleaning '$ppkg' in bundle '$pkgname'"); $log->setstars("**"); ## chdir($startdir); cleanup_pkg(&file_path("$pkgdir", "$ppkg"), $log); $log->setstars("*"); } rmtree("$libdir") if (-d "$libdir"); } else { $is_bundle = 0; ## chdir($startdir); $log->message("preparing '$pkg':"); $intname = $description->{"Package"}; prepare_pkg($pkgdir, $is_bundle, $description, $log); } ## chdir($startdir); $log->message("removing junk files"); find(\&unlink_junk_files, $pkgdir); chdir(dirname($pkgdir)); my $filename = "${intname}_" . $description->{"Version"} . ".tar"; my $filepath = &file_path($startdir, $filename); R_system(join(" ", ("$tar -chf", &shell_quote_file_path($filepath), "$pkgname"))); my $tmpdir = R_tempfile("Rbuild"); rmtree($tmpdir) if(-d $tmpdir); mkdir("$tmpdir", 0755) or die "Error: cannot create directory '$tmpdir'\n"; chdir($tmpdir); ## was xhf, but there are no symbolic links here and that is invalid ## on FreeBSD, see http://www.freebsd.org/cgi/man.cgi?query=tar&apropos=0&sektion=0&manpath=FreeBSD+5.4-RELEASE+and+Ports&format=html R_system(join(" ", ("$tar -xf", &shell_quote_file_path($filepath)))); my $exclude = R_tempfile("Rbuild-exclude"); open(EXCLUDE, "> $exclude") or die "Error: cannot open file '$exclude' for writing\n"; binmode EXCLUDE if $WINDOWS; ## ## For bundles, the .Rbuildignore mechanism is not consistent ## between build and check: the latter always works on a per ## package basis. if(-f &file_path($pkgdir, ".Rbuildignore")) { open(RBUILDIGNORE, &file_path($pkgdir, ".Rbuildignore")); while() { chomp; s/\r$//; # careless people get Windows files on other OSes push(@exclude_patterns, $_) if $_; } close(RBUILDIGNORE); } ## sub find_exclude_files { print EXCLUDE "$File::Find::name\n" if(-d $_ && /^check$/); print EXCLUDE "$File::Find::name\n" if(-d $_ && /^chm$/); print EXCLUDE "$File::Find::name\n" if(-d $_ && /[Oo]ld$/); print EXCLUDE "$File::Find::name\n" if(-d $_ && /^CVS$/); print EXCLUDE "$File::Find::name\n" if(-d $_ && /^\.svn$/); print EXCLUDE "$File::Find::name\n" if(-d $_ && /^\.arch-ids$/); print EXCLUDE "$File::Find::name\n" if(-d $_ && /^\.bzr$/); print EXCLUDE "$File::Find::name\n" if(-d $_ && /^\.git$/); ## some authors managed to create ..Rcheck as well as pkgname.Rcheck print EXCLUDE "$File::Find::name\n" if(-d $_ && /\.Rcheck$/); ## some authors have problems with 'Read-and-delete-me' print EXCLUDE "$File::Find::name\n" if /^Read-and-delete-me$/; print EXCLUDE "$File::Find::name\n" if /^GNUMakefile$/; ## Mac resource forks print EXCLUDE "$File::Find::name\n" if(/^\._/); ## Mac Finder files print EXCLUDE "$File::Find::name\n" if(/^\.DS_Store$/); ## Windows DLL resource file push(@exclude_patterns, "^src/" . $pkgname . "_res\\.rc"); my $filename = $File::Find::name; $filename =~ s/^[^\/]*\///; foreach my $p (@exclude_patterns) { if($WINDOWS) { ## Argh: Windows is case-honoring but not ## case-insensitive ... print EXCLUDE "$File::Find::name\n" if($filename =~ /$p/i); } else { if($filename =~ /$p/) { ## Seems that the Tar '-X' option uses exclude ## *shell* patterns, where '*', '?', and '[...]' ## are the usual shell wildcards and '\' escapes ## them. Hence we need to escape the wildcard ## characters in file names. On Windows, the ## first two are invalid (and hence rejected by ## R CMD check), and the last two do not need ## escaping. $filename = "$File::Find::name"; $filename =~ s/\[/\\\[/g; $filename =~ s/\]/\\\]/g; print EXCLUDE "$filename\n"; } } } } find(\&find_exclude_files, "$pkgname"); close(EXCLUDE); ## Remove exclude files. open(EXCLUDE, "< $exclude"); while() { rmtree(glob($_)); } close(EXCLUDE); unlink($exclude); unlink($filepath); ## Now correct the package name (PR#9266) if($pkgname ne $intname) { rename $pkgname, $intname or die "Error: cannot rename directory to '$intname'\n"; $pkgname = $intname; } ## Fix up man, R, demo inst/doc directories (in each package for a bundle) sub find_invalid_files { my ($dpath) = @_; my $Rcmd = "tools:::.check_package_subdirs(\"$dpath\", TRUE)\n"; ## We don't run this in the C locale, as we only require ## certain filenames to start with ASCII letters/digits, and not ## to be entirely ASCII. my @out = R_runR($Rcmd, "--vanilla --slave", "R_DEFAULT_PACKAGES=NULL"); @out = grep(!/^\>/, @out); if(scalar(@out) > 0) { $log->message("excluding invalid files from '$dpath'"); $log->print(join("\n", @out) . "\n"); } } if($is_bundle) { foreach $ppkg (@bundlepkgs) { &find_invalid_files(&file_path($pkgname, $ppkg)); chdir($tmpdir); } } else { &find_invalid_files($pkgname); chdir($tmpdir); } ## Fix permissions. sub fix_permissions { ## Note that when called via File::Find::find, $_ holds the ## file name within the current directory. if(-d $_) { ## Directories should really be mode 00755 if possible. chmod(00755, $_); } elsif(-f $_) { ## Files should be readable by everyone, and writable ## only for user. This leaves a bit of uncertainty ## about the execute bits. chmod(((stat $_)[2] | 00644) & 00755, $_); } } find(\&fix_permissions, "${pkgname}") if(!$WINDOWS); ## Add build stamp to the DESCRIPTION file. &add_build_stamp_to_description_file(&file_path($pkgname, "DESCRIPTION")); $log->message("checking for LF line-endings in source and make files"); if($is_bundle) { foreach my $ppkg (@bundlepkgs) { &fix_nonLF_in_source_files(&file_path($pkgname, $ppkg), $log); &fix_nonLF_in_make_files(&file_path($pkgname, $ppkg), $log); } } else { &fix_nonLF_in_source_files($pkgname, $log); &fix_nonLF_in_make_files($pkgname, $log); } sub empty_dir_check { if(-d $_) { opendir(DIR, $_) or die "cannot open dir $File::Find::name: $!"; my @files = readdir(DIR); closedir(DIR); if (@files <= 2) { $log->print("WARNING: directory '$File::Find::name' is empty\n"); } } } $log->message("checking for empty or unneeded directories"); find(\&empty_dir_check, "${pkgname}"); sub fix_unneeded_dirs { my ($path) = @_; my $dir; foreach my $system_dir ("Meta", "R-ex", "chtml", "help", "html", "latex") { $dir = &file_path($path, $system_dir); if(-d "$dir") { $log->print(wrap("", " ", ("WARNING: Removing directory '$dir'", "which should only occur", "in an installed package\n") )); rmtree("$dir"); } } } if($is_bundle) { foreach my $ppkg (@bundlepkgs) { &fix_unneeded_dirs(&file_path($pkgname, $ppkg)); } } else { &fix_unneeded_dirs($pkgname); } ## Finalize. if($opt_binary) { $log->message("building binary distribution"); chdir($startdir); if (!-d "$libdir") { mkdir("$libdir", 0755) or die "Error: cannot create directory '$libdir'\n"; } my $srcdir = &file_path($tmpdir, $pkgname); my $cmd; if($WINDOWS) { $log->print("WARNING: some HTML links may not be found\n"); $cmd = join(" ", ("Rcmd.exe INSTALL -l", &shell_quote_file_path($libdir), "--build $INSTALL_opts", &shell_quote_file_path($srcdir))); if(R_system($cmd)) { $log->error("installation failed"); } } elsif($is_bundle) { $binfilename = "${pkgname}_" . $description->{"Version"} . "_R_${R_platform}.tar"; my $filepath = &file_path($startdir, $binfilename); $cmd = join(" ", (&shell_quote_file_path(${R::Vars::R_EXE}), "CMD INSTALL -l", &shell_quote_file_path($libdir), "$INSTALL_opts", &shell_quote_file_path($srcdir))); if(R_system($cmd)) { $log->error("installation failed"); } chdir("$libdir"); copy(&file_path($pkgdir, "DESCRIPTION"), "DESCRIPTION"); ## precaution for Mac OS X to omit resource forks $ENV{COPYFILE_DISABLE} = 1; # Leopard $ENV{COPY_EXTENDED_ATTRIBUTES_DISABLE} = 1; # Tiger R_system(join(" ", ("$tar -chf ", &shell_quote_file_path($filepath), @bundlepkgs, "DESCRIPTION"))); R_system(join(" ", ("$gzip -9f ", &shell_quote_file_path($filepath)))); chdir($startdir); $log->message("packaged bundle '$pkgname' as '$binfilename.gz'"); } else { $cmd = join(" ", (&shell_quote_file_path(${R::Vars::R_EXE}), "CMD INSTALL -l", &shell_quote_file_path($libdir), "--build $INSTALL_opts", &shell_quote_file_path($srcdir))); if(R_system($cmd)) { $log->error("installation failed"); } } } else { ## precaution for Mac OS X to omit resource forks $ENV{COPYFILE_DISABLE} = 1; # Leopard $ENV{COPY_EXTENDED_ATTRIBUTES_DISABLE} = 1; # Tiger $log->message("building '$filename.gz'"); R_system(join(" ", ("$tar -chf", &shell_quote_file_path($filepath), "$pkgname"))); R_system(join(" ", ("$gzip -9f", &shell_quote_file_path($filepath)))); } chdir($startdir); rmtree($tmpdir); $log->close(); print("\n"); } sub add_build_stamp_to_description_file { my ($dpath) = @_; my @lines = &read_lines($dpath); @lines = grep(!/^\s*$/, @lines); # Remove blank lines. my $user_name; if($WINDOWS) { $user_name = Win32::LoginName(); } else { $user_name = (getpwuid($<))[0]; } my $fh = new IO::File($dpath, "w") or die "Error: cannot open file '$dpath' for writing\n"; ## Do not keep previous build stamps. @lines = grep(!/^Packaged:/, @lines); $fh->print(join("\n", @lines), "\n"); my @dt = R_runR("cat(format(Sys.time(), '', tz='UTC', usetz=TRUE))", "--vanilla --slave", "R_DEFAULT_PACKAGES=NULL"); $fh->print("Packaged: ", @dt, "; ", $user_name, "\n"); $fh->close(); } sub prepare_pkg { my ($pkgdir, $in_bundle, $description, $log) = @_; my $pkgname = basename($pkgdir); &R::Utils::check_package_description($pkgdir, $pkgname, $log, $in_bundle, 0, 1); &cleanup_pkg($pkgdir, $log) if(!$in_bundle); ## Only update existing INDEX files. &update_Rd_index("INDEX", "man", $log) if(-f "INDEX"); if((-d &file_path("inst", "doc")) && &list_files_with_type(&file_path("inst", "doc"), "vignette")) { if(!$opt_no_vignettes) { my $doit = 1; ## if we are in a bundle, need to install the whole bundle ## once. my $pkg_or_bundle_dir; if ($in_bundle) { $pkg_or_bundle_dir = dirname($pkgdir); if(-d "$libdir") { $doit = 0; } else { $log->message("installing the *bundle* to re-build vignettes"); mkdir("$libdir", 0755) or die "Error: cannot create directory '$libdir'\n"; } } else { $pkg_or_bundle_dir = $pkgdir; $log->message("installing the package to re-build vignettes"); mkdir("$libdir", 0755) or die "Error: cannot create directory '$libdir'\n"; } my $cmd; if($WINDOWS) { $cmd = join(" ", ("Rcmd.exe INSTALL -l", &shell_quote_file_path($libdir), &shell_quote_file_path($pkg_or_bundle_dir))); } else { $cmd = join(" ", (&shell_quote_file_path(${R::Vars::R_EXE}), "CMD INSTALL -l", &shell_quote_file_path($libdir), &shell_quote_file_path($pkg_or_bundle_dir))); } if($doit && R_system($cmd)) { $log->error(); $log->print("Installation failed.\n"); $log->print("Removing '$libdir'\n"); rmtree($libdir); exit(1); } my $R_LIBS = $ENV{'R_LIBS'}; $ENV{'R_LIBS'} = env_path("$libdir", $R_LIBS); $log->creating("vignettes"); my $Rcmd = "library(tools)\n"; $Rcmd .= "buildVignettes(dir = '.')\n"; my %result = R_run_R($Rcmd, "--vanilla --no-save --quiet"); rmtree("$libdir") unless $in_bundle; $ENV{'R_LIBS'} = $R_LIBS; if($result{"status"}) { my @out = grep(!/^\>/, @{$result{"out"}}); $log->error(); $log->print(join("\n", @out) . "\n"); exit(1); } else { $log->result("OK"); } ## And finally, clean up again (if not in a bundle). &cleanup_pkg($pkgdir, $log) if(!$in_bundle); } } 1; } sub cleanup_pkg { my ($pkgdir, $log) = @_; my $pkgname = basename($pkgdir); if(-d "src") { chdir("src"); $log->message("cleaning src"); if($WINDOWS) { ## A Windows Makefile.win might use ## $(RHOME)/src/gnuwin32/MkRules. $ENV{RHOME} = $ENV{R_HOME}; if(-r "Makefile.win") { ## FIXME: why not use 'Makefile' if Makefile.win does not exist? R_system("${R::Vars::MAKE} -f Makefile.win clean"); } else { if(-r "Makevars.win") { my $makefiles = " -f " . &shell_quote_file_path(&file_path(${R::Vars::R_SHARE_DIR}, "make", "clean.mk")); $makefiles .= " -f Makevars.win"; R_system("${R::Vars::MAKE} $makefiles clean"); } elsif (-r "Makevars") { my $makefiles = " -f " . &shell_quote_file_path(&file_path(${R::Vars::R_SHARE_DIR}, "make", "clean.mk")); $makefiles .= " -f Makevars"; R_system("${R::Vars::MAKE} $makefiles clean"); } foreach my $file (<*.o $pkgname.a $pkgname.dll $pkgname.def>) { unlink($file); } rmtree("_libs") if (-d "_libs"); } } else { my $makefiles = "-f " . &shell_quote_file_path(&file_path(${R::Vars::R_HOME}, "etc".$ENV{"R_ARCH"}, "Makeconf")); if(-r "Makefile") { $makefiles .= " -f Makefile"; R_system("${R::Vars::MAKE} $makefiles clean"); } else { if(-r "Makevars") { ## ensure we do have a 'clean' target. $makefiles .= " -f " . &shell_quote_file_path(&file_path(${R::Vars::R_SHARE_DIR}, "make", "clean.mk")); $makefiles .= " -f Makevars"; R_system("${R::Vars::MAKE} $makefiles clean"); } ## Also cleanup possible Windows leftovers ... unlink((<*.o *.s[lo] *.dylib>, "$pkgname.a", "$pkgname.dll", "$pkgname.def")); rmtree(".libs") if (-d ".libs"); rmtree("_libs") if (-d "_libs"); } } } chdir($pkgdir); if(!$WINDOWS && -x "./cleanup") { $log->message("running cleanup"); R_system("./cleanup"); } 1; } sub unlink_junk_files { unlink($_) if /^(\.RData|\.Rhistory)$/; if(/^DESCRIPTION$/) { unlink($_) if (-f "DESCRIPTION.in"); } } sub update_index { my ($oldindex, $newindex, $log) = @_; $log->checking("whether '$oldindex' is up-to-date"); if(-r $oldindex) { if(compare($oldindex, $newindex) != 0) { $log->result("NO"); if($opt_force) { $log->message("overwriting '${oldindex}' as " . "'--force' was given"); unlink($oldindex); rename($newindex, $oldindex); } else { $log->message("use '--force' to overwrite " . "the existing '${oldindex}'"); unlink($newindex); } } else { $log->result("OK"); unlink($newindex); } } else { $log->result("NO"); $log->message("creating new '$oldindex'"); unlink($oldindex); rename($newindex, $oldindex); } 1; } sub update_Rd_index { my ($oldindex, $Rd_files, $log) = @_; my $newindex = ".Rbuildindex.$$"; my $Rcmd = "Rdindex(\"${Rd_files}\", \"${newindex}\")\n"; my %result = R_run_R($Rcmd, "--vanilla --quiet", "R_DEFAULT_PACKAGES=tools"); if($result{"status"}) { ## This is a bit silly ... but just in case this fails, we want ## a decent error message. my @out = grep(!/^\>/, @{$result{"out"}}); $log->message("computing Rd index"); $log->error(); $log->print(join("\n", @out) . "\n"); exit(1); } update_index($oldindex, $newindex, $log); 1; } sub fix_nonLF_in_source_files { my ($pkgname, $log) = @_; if(-d "$pkgname/src") { my @src_files = &list_files_with_type("$pkgname/src", "src_no_CRLF"); foreach my $file (@src_files) { my $has_nonLF = 0; open(FILE, "< $file") or die "Error: cannot open '$file' for reading\n"; open(TFILE, "> $file.tmp") or die "Error: cannot open '$file.tmp' for writing\n"; binmode(FILE); binmode(TFILE); # for Windows while() { chomp; $has_nonLF = 1 if $_ =~ /\r/; $_ =~ s/\r$//; # any remaining CRs are internal and so line endings. $_ =~ s/\r/\n/g; print TFILE "$_\n"; } close(TFILE); close(FILE); if ($has_nonLF) { $log->print(" file '$file' had non-LF line endings\n"); unlink($file); # should not be necessary, but is on Windows rename("$file.tmp", $file) or die "Error: cannot rename '$file.tmp'\n"; } else { unlink("$file.tmp"); } } } } sub fix_nonLF_in_make_files { my ($pkgname, $log) = @_; if(-d "$pkgname/src") { my $file; foreach my $f ("Makefile", "Makefile.in", "Makevars", "Makevars.in") { $file = "$pkgname/src/$f"; next unless -f "$file"; my $has_nonLF = 0; open(FILE, "< $file") or die "Error: cannot open '$file' for reading\n"; open(TFILE, "> $file.tmp") or die "Error: cannot open '$file.tmp' for writing\n"; binmode(FILE); binmode(TFILE); # for Windows while() { chomp; $has_nonLF = 1 if $_ =~ /\r/; $_ =~ s/\r$//; # any remaining CRs are internal and so line endings. $_ =~ s/\r/\n/g; print TFILE "$_\n"; } close(TFILE); close(FILE); if ($has_nonLF) { $log->print(" file '$file' had non-LF line endings\n"); unlink("$file"); # should not be necessary, but is on Windows rename("$file.tmp", $file) or die "Error: cannot rename '$file.tmp'\n"; } else { unlink("$file.tmp"); } } } } sub usage { print <. END exit 0; }