Upload a Local Repo to GitHub

Usage

repo2github(password, project.dir = getwd(), repo = basename(getwd()), github.user = getOption("github.user"), gitpath = NULL, readme = TRUE)

Arguments

password
GitHub user password (character string). If this is not supplied the user will be prompted to enter a password.
project.dir
The path to the root directory of the report/presentation.
repo
A character string naming the repo; default attempts to use the report project directory name.
github.user
GitHub user name (character string).
gitpath
Path to the location of Git. If NULL repo2github will attempt to locate the path if necessary.
readme
logical. If TRUE repo initializes with a README.md file.

Value

Creates GitHub repository.

Description

Allows uploading a local repository to GitHub without first creating the repository in the clouds. repo2github is designed for the initial push to GitHub. Future pushes can be handled via RStudio or other Git interface.

Details

The arguments project.dir and repo use getwd. This assumes is the current working directory is the root directory and is done for convenience. The user should ensure that either their working directory is the root directory or supply the correct root directory/name to these arguments.

Note

The user will need to have a GitHub account established.

Warning

For Windows users this function creates a temporary _netrc file in the home directory and attempts to delete this file. The _netrc contains username and password information for GitHub. repo2github attempts to delete this file but care should be taken. The file is created in: file.path(Sys.getenv()["HOME"], "DELETE_ME_REPORTS_PACKAGE/_nectrc").

Suggestion

The user may want to set options for github.user in the user's primary .Rprofile.

Examples

## <strong>Not run</strong>: # repo2github() # ## <strong>End(Not run)</strong>

Author

Simon O'Hanlon, Daniel Chaffiol, and Tyler Rinker