use_github

0th

Percentile

Connect a local repo with GitHub.

If the current repo does not use git, calls use_git automatically. use_github_links is called to populate the URL and BugReports fields of DESCRIPTION.

Usage
use_github(auth_token = github_pat(), private = FALSE, pkg = ".",
  protocol = c("ssh", "https"), credentials = NULL)
Arguments
auth_token
Provide a personal access token (PAT) from https://github.com/settings/tokens. Defaults to the GITHUB_PAT environment variable.
private
If TRUE, creates a private repository.
pkg
Path to package. See as.package for more information.
protocol
transfer protocol, either "ssh" (the default) or "https"
credentials
A cred_ssh_key specifying specific ssh credentials or NULL for default ssh key and ssh-agent behaviour. Default is NULL.
Authentication

A new GitHub repo will be created via the GitHub API, therefore you must provide a GitHub personal access token (PAT) via the argument auth_token, which defaults to the value of the GITHUB_PAT environment variable. Obtain a PAT from https://github.com/settings/tokens. The "repo" scope is required which is one of the default scopes for a new PAT.

The argument protocol reflects how you wish to authenticate with GitHub for this repo in the long run. For either protocol, a remote named "origin" is created, an initial push is made using the specified protocol, and a remote tracking branch is set. The URL of the "origin" remote has the form git@github.com:/.git (protocol = "ssh", the default) or https://github.com//.git (protocol = "https"). For protocol = "ssh", it is assumed that public and private keys are in the default locations, ~/.ssh/id_rsa.pub and ~/.ssh/id_rsa, respectively, and that ssh-agent is configured to manage any associated passphrase. Alternatively, specify a cred_ssh_key object via the credentials parameter.

See Also

Other git infrastructure: use_git_hook, use_github_links, use_git

Aliases
  • use_github
Examples
## to use default ssh protocol
create("testpkg")
use_github(pkg = "testpkg")

## or use https
create("testpkg2")
use_github(pkg = "testpkg2", protocol = "https")
Documentation reproduced from package devtools, version 1.11.1, License: GPL (>= 2)

Community examples

Looks like there are no examples yet.