installr v0.21.3

0

Monthly downloads

0th

Percentile

Using R to Install Stuff (Such As: R, 'Rtools', 'RStudio', 'Git', and More!)

R is great for installing software. Through the 'installr' package you can automate the updating of R (on Windows, using updateR()) and install new software. Software installation is initiated through a GUI (just run installr()), or through functions such as: install.Rtools(), install.pandoc(), install.git(), and many more. The updateR() command performs the following: finding the latest R version, downloading it, running the installer, deleting the installation file, copy and updating old packages to the new R installation.

Readme

Build Status CRAN_Status_Badge

installr

Introduction

The installr package offers a set of R functions for the installation and updating of software (currently, only on Windows OS), with a special focus on R itself. This package has two main goals:

  1. To make updating R (on windows) as easy as running a function.
  2. To make it as easy as possible to install all of the needed software for R development (such as git, RTools, etc), as well as for reproducible research using R (such as MikTeX, pandoc, etc).

Motivation

While for Linux users, the installation process of new software may be just running a short line of code, for the regular Windows user it often includes browsing online, finding the latest version, downloading it, running the installer, and deleting the installation file. All of these steps are automatically done using functions in this package.

Installation

To install the stable version on CRAN:

install.packages('installr')

To install the latest installr version from GitHub use:

if (!require('devtools')) install.packages('devtools'); # make sure you have Rtools installed first! if not, then run:
#install.packages('installr')
#install.Rtools()
devtools::install_github('talgalili/installr')

Usage

If you are using the Rgui, you will see a new menu added on your top right (just by "help"), giving you the option to update R, or install new software.

For command line use you can update R by running:

if(!require("installr")) install.packages('installr')
library("installr")
updateR() # this will open dialog boxes to take you through the steps.
# OR use:
# updateR(TRUE) # this will use common defaults and will be the safest/fastest option

Or install a new software simply by running:

library("installr")
installr() #  user can easily select (via a GUI interface) a software to install.

Troubleshooting

If you get either of the following errors from some commands:

Error in download.file(URL, destfile = ...) : 
  unsupported URL scheme

Or:

install.RStudio()
Error in file(con, "r") : cannot open the connection
updateR()
Error in file(con, "r") : cannot open the connection

Try running:

setInternet2(TRUE)

Sources:

Contact

You are welcome to:

Available functions are:

You can see the most recent changes to the package in the NEWS.md file:

https://github.com/talgalili/installr/blob/master/NEWS.md

  • R install/update/uninstall related functions:

    * updateR() - serves as a "check for updates" function of R itself.  Running the function will check for a newer version of R than the one currently used.  If one exists, the function will download the most updated R version and run its installer.  Once done, the function will offer to copy (or move) all of the packages from the old R library to the new R library. It will then offer to update the moved packages, offer to open the new Rgui, and lastely, it will quit the old R.
    * uninstall.R
    * require2 - just like "require", only makes sure to download and install the package in case it is not present on the system (useful for examples...)
    * restart_RGui - a function to restart Rgui from Rgui
    * check.for.updates.R
    * install.R
    * install.Rdevel - usefull for when developing R packages (as this version contains the latest checks.)
    
  • Installing software from withing R:

    * install.RStudio() - download and runs the installer for RStudio.
    * install.Rtools() - download and runs the installer for Rtools (allowing the user to choose which version to download)    
    * install.pandoc() - download and runs the installer for pandoc.
    * install.MikTeX() - download and runs the installer for MikTeX.
    * install.git() - download and runs the installer for git-gui.
    * install.packages.zip() - for installing package from a url of a ZIP file.  Currently, it is the only option I know of for downloading+installing a direct ZIP of an R package.
    * install.URL() - gets a URL of a zipped file, and makes sure to download and run it.
    * install.LyX()
    * install.LaTeX2RTF()
    * install.GitHub()
    * install.ImageMagick()
    * install.GraphicsMagick()
    * install.SWFTools()
    * install.FFmpeg()
    * install.7zip()
    * install.notepadpp()
    * install.npptor()
    * install.Cygwin()
    
  • Operation system managing functions

    * manage.os() - for shutdown/sleep of a Windows computer (useful for running at the end of a simulation).  Controls all the following functions.
    * os.hibernate()
    * os.lock()
    * os.restart()
    * os.shutdown()
    * os.sleep()
    * is.Rgui()
    * is.RStudio()
    * is.windows()
    
  • CRAN and network related functions:

    * cranometer - Estimates the speed of each CRAN mirror by measuring the time it takes to download the NEWS file.
    * myip - return your ip address.
    * freegeoip - Geolocate IP addresses in R (contributed by Heuristic Andrew)
    * download_RStudio_CRAN_data
    * read_RStudio_CRAN_data
    * barplot_package_users_per_day
    * lineplot_package_downloads
    * format_RStudio_CRAN_data
    * most_downloaded_packages
    
  • Misc functions:

    * is.empty - function added for checking if an object is empty (e.g: of zero length)
    
  • There are a few more functions that you could see in the help files...

Code of conduct

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.

Functions in installr

Name Description
install.GitHub Downloads and installs GitHub for windows
install.SWFTools Downloads and installs SWFTools for windows
install.packages.zip Downloads and installs a ZIP R package Binary (for Windows) from a URL
install.Cygwin Downloads and installs Cygwin for windows
create.global.library Creates a global library folder
install.FFmpeg Downloads and installs FFmpeg for windows
add_remove_installr_from_startup_menu Add menu item for having installr NOT load on startup
install.Texmaker Downloads and installs Texmaker for windows
install.pandoc Downloads and installs pandoc
download_RStudio_CRAN_data Download RStudio CRAN mirror data files into a folder
copy.packages.between.libraries Copies all packages from one library folder to another
check.integer Check if a number is integer
install.git Downloads and installs git and git-gui for windows
install.Rdevel Downloads and installs the latest Rdevel version
installr Installing software from R
kill_pid kill (i.e.: stop) running processes by there pid
kill_all_Rscript_s kill (i.e.: stop) all running "Rscript" processes
install.GraphicsMagick Downloads and installs GraphicsMagick for windows
install.inno Downloads and installs Inno Setup
is.RStudio Checks if the R session is running within RStudio
install.Rtools Downloads and installs Rtools
pkgDNLs_worldmapcolor Worldmap colored by the number of downloads for a given package
cranometer Measures the speed of downloading from different CRAN mirrors
get.installed.R.folders Returns folder names with R installations
get_Rscript_PID Get the running "Rscript" processes PID
install.RStudio Downloads and installs RStudio for windows
install.R Downloads and installs the latest R version
install.LyX Downloads and installs LyX for windows
get_pid Find the pid of a process by name
get_tasklist Get the running processes in windows task manager
checkMD5sums2 Check and Create MD5 Checksum Files
format_RStudio_CRAN_data Format the RStudio CRAN mirror data into the data.table format
file.name.from.url Extract the file name from some URL
fetch_tag_from_Rd Access tag elements from R's Rd file
remove.installr.GUI Removes the menu based GUI for updating R within Rgui
myip What is my IP
os.hibernate Hibernate the operating system (Windows) through a shell command
install.conda Downloads and installs miniconda
install.MikTeX Downloads and installs MikTeX for windows
install.URL Downloads and runs a .exe installer file for some software from a URL
is.x64 Checks if the running OS is x64
remove_from_.First_in_Rprofile.site Remove a code line from Rprofile.site .First
is_in_.First_in_Rprofile.site Remove a code line from Rprofile.site .First
kill_process kill (i.e.: stop) running processes by there process name
is.windows Checks if the running OS is windows
is.exe.installed Checks if some .exe is available in on the Windows machine search PATH
read_RStudio_CRAN_data Reads RStudio CRAN mirror data files from a folder
uninstall.R Uninstall an R version
turn.version.to.number1 Turns version to number (for 1 value only)
updateR Checks for the latest R version, and if there is a newer version of R - downloads and installs it.
source.https Read R Code from a File in an https URL
system.PATH Returns the search path for executable files
xlsx2csv Converts xls(x) to csv using VB
install.LaTeX2RTF Downloads and installs LaTeX2RTF for windows
install.ImageMagick Downloads and installs ImageMagick for windows
install.java Install Java - downloads and set path openjdk
lineplot_package_downloads barplot for the number of users installation of a package
os.sleep Sleeps the operating system (Windows) through a shell command
install.7zip Downloads and installs 7-Zip for windows
freegeoip Geolocate IP addresses in R
install.CMake Downloads and installs CMake for windows
turn.number.version Turns a vector of version-numbers back to version-character
turn.version.to.number Turns version to number (for a vector of values)
package_authors Access (and clean) author elements from R's Rd file
install.npptor Downloads and installs NppToR for windows
install.notepadpp Downloads and installs Notepad++ for windows
install.python Downloads and installs python 2 or 3
os.manage Gives managing option to the current OS (shutdown, restart, sleep, hibernate, etc...)
os.restart Restarts the operating system (Windows) through a shell command
os.lock Locks the operating system (Windows) through a shell command
installr-package Using R to Install Stuff (Such As: R, Rtools, RStudio, Git, and More!)
os.shutdown Shut down the operating system with the command `shutdown'
install.nodejs Downloads and installs nodejs LTS or Current
is.empty Checks if an object is empty (e.g: of zero length)
is.Rgui Checks if the R session is running within Rgui (Windows OS)
restart_RGui Restart RGui from RGui
rm_installr_from_startup Remove installr from startup
most_downloaded_packages Most downloaded packages
load_installr_on_startup Have the installr package load on startup
rename_r_to_R Rename files' extensions in a folder from .r to .R
require2 Loading Packages (and Installing them if they are missing)
uninstall.packages uninstalls (removes) Installed Packages
up_folder Performs "up-level" on a folder string
add_to_.First_in_Rprofile.site Add a code line to Rprofile.site .First
browse.latest.R.NEWS See the NEWS file for the latest R release
barplot_package_users_per_day barplot for the number of users installation of a package
add_load_installr_on_startup_menu Add menu item for having installr load on startup
ask.user.yn.question Asks the user for one yes/no question.
add.installr.GUI Adds a menu based GUI for updating R within Rgui
R_version_in_a_folder Get the version of the R installed in a folder
check.for.updates.R Checks if there is a newer version of R
ask.user.for.a.row Asks the user for a row number from a data.frame table
No Results!

Last month downloads

Details

Include our badge in your README

[![Rdoc](http://www.rdocumentation.org/badges/version/installr)](http://www.rdocumentation.org/packages/installr)