push: Push

In git2r: Provides Access to Git Repositories

Description

Push

Usage

push(
  object = ".",
  name = NULL,
  refspec = NULL,
  force = FALSE,
  credentials = NULL,
  set_upstream = FALSE
)

Arguments

object	path to repository, or a git_repository or git_branch.
name	The remote's name. Default is NULL.
refspec	The refspec to be pushed. Default is NULL.
force	Force your local revision to the remote repo. Use it with care. Default is FALSE.
credentials	The credentials for remote repository access. Default is NULL. To use and query an ssh-agent for the ssh key credentials, let this parameter be NULL (the default).
set_upstream	Set the current local branch to track the remote branch. Default is FALSE.

Value

invisible(NULL)

See Also

cred_user_pass, cred_ssh_key

Examples

## Not run: 
## Initialize two temporary repositories
path_bare <- tempfile(pattern="git2r-")
path_repo <- tempfile(pattern="git2r-")
dir.create(path_bare)
dir.create(path_repo)
repo_bare <- init(path_bare, bare = TRUE)

## Clone the bare repository. This creates remote-tracking
## branches for each branch in the cloned repository.
repo <- clone(path_bare, path_repo)

## Config user and commit a file
config(repo, user.name = "Alice", user.email = "[e-mail]")

## Write to a file and commit
lines <- "Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do"
writeLines(lines, file.path(path_repo, "example.txt"))
add(repo, "example.txt")
commit(repo, "First commit message")

## Push commits from repository to bare repository
push(repo, "origin", "refs/heads/master")

## Now, unset the remote-tracking branch to NULL to demonstrate
## the 'set_upstream' argument. Then push with 'set_upstream = TRUE'
## to add the upstream tracking branch to branch 'master' again.
branch_get_upstream(repository_head(repo))
branch_set_upstream(repository_head(repo), NULL)
branch_get_upstream(repository_head(repo))
push(repo, "origin", "refs/heads/master", set_upstream = TRUE)
branch_get_upstream(repository_head(repo))

## Change file and commit
lines <- c(
  "Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do",
  "eiusmod tempor incididunt ut labore et dolore magna aliqua.")
writeLines(lines, file.path(path_repo, "example.txt"))
add(repo, "example.txt")
commit(repo, "Second commit message")

## Push commits from repository to bare repository
push(repo)

## List commits in repository and bare repository
commits(repo)
commits(repo_bare)

## End(Not run)

Example output

cloning into '/work/tmp/tmp/RtmppanAIY/git2r-6f991107db32'...
[26fd8fc] 2020-10-13: First commit message
[26fd8f] (origin @ /work/tmp/tmp/RtmppanAIY/git2r-6f99b6c0093) master
NULL
[26fd8f] (origin @ /work/tmp/tmp/RtmppanAIY/git2r-6f99b6c0093) master
[cc36baa] 2020-10-13: Second commit message
[[1]]
[cc36baa] 2020-10-13: Second commit message

[[2]]
[26fd8fc] 2020-10-13: First commit message

[[1]]
[cc36baa] 2020-10-13: Second commit message

[[2]]
[26fd8fc] 2020-10-13: First commit message

git2r documentation built on Nov. 22, 2021, 9:08 a.m.