The git2r package gives you programmatic access to Git repositories
from R. Internally the package uses the libgit2 library which is a
pure C implementation of the Git core methods. For more information
about libgit2, check out libgit2's website
(http://libgit2.github.com).
Suggestions, bugs, forks and pull requests are appreciated. Get in touch.
To install the version available on CRAN:
install.packages("git2r")
To install the development version of git2r, it's easiest to use the
devtools package:
# install.packages("remotes") library(remotes) install_github("ropensci/git2r")
The central object in the git2r package is the S3 class
git_repository. The following three methods can instantiate a
repository; init, repository and clone.
Create a new repository in a temporary directory using init
library(git2r)#> Loading required package: methods
## Create a temporary directory to hold the repository path <- tempfile(pattern="git2r-") dir.create(path) ## Initialize the repository repo <- init(path) ## Display a brief summary of the new repository repo
#> Local: /tmp/Rtmp7CXPlx/git2r-1ae2305c0e8d/
#> Head: nothing commited (yet)
## Check if repository is bare is_bare(repo)
#> [1] FALSE
## Check if repository is empty is_empty(repo)
#> [1] TRUE
## Create a temporary directory to hold the repository path <- tempfile(pattern="git2r-") dir.create(path) ## Initialize the repository repo <- init(path, bare=TRUE) ## Check if repository is bare is_bare(repo)
#> [1] TRUE
## Create a temporary directory to hold the repository path <- file.path(tempfile(pattern="git2r-"), "git2r") dir.create(path, recursive=TRUE) ## Clone the git2r repository repo <- clone("https://github.com/ropensci/git2r", path)
#> cloning into '/tmp/Rtmp7CXPlx/git2r-1ae27d811539/git2r'...
#> Receiving objects: 1% (24/2329), 12 kb
#> Receiving objects: 11% (257/2329), 60 kb
#> Receiving objects: 21% (490/2329), 100 kb
#> Receiving objects: 31% (722/2329), 125 kb
#> Receiving objects: 41% (955/2329), 237 kb
#> Receiving objects: 51% (1188/2329), 574 kb
#> Receiving objects: 61% (1421/2329), 1014 kb
#> Receiving objects: 71% (1654/2329), 1350 kb
#> Receiving objects: 81% (1887/2329), 1733 kb
#> Receiving objects: 91% (2120/2329), 2614 kb
#> Receiving objects: 100% (2329/2329), 2641 kb, done.
## Summary of repository summary(repo)
#> Remote: @ origin (https://github.com/ropensci/git2r)
#> Local: master /tmp/Rtmp7CXPlx/git2r-1ae27d811539/git2r/
#>
#> Branches: 1
#> Tags: 0
#> Commits: 320
#> Contributors: 3
#> Ignored files: 0
#> Untracked files: 0
#> Unstaged files: 0
#> Staged files: 0
## List all references in repository references(repo)
#> $`refs/heads/master`
#> [6fb440] master
#>
#> $`refs/remotes/origin/master`
#> [6fb440] origin/master
## List all branches in repository branches(repo)
#> [[1]]
#> [6fb440] (Local) (HEAD) master
#>
#> [[2]]
#> [6fb440] (origin @ https://github.com/ropensci/git2r) master
## Open an existing repository repo <- repository(path) ## Workdir of repository workdir(repo)
#> [1] "/tmp/Rtmp7CXPlx/git2r-1ae27d811539/git2r/"
## List all commits in repository commits(repo)[[1]] # Truncated here for readability
#> Commit: 6fb440133765e80649de8d714eaea17b114bd0a7
#> Author: Stefan Widgren <[email protected]>
#> When: 2014-04-22 21:43:19
#> Summary: Fixed clone progress to end line with newline
## Get HEAD of repository repository_head(repo)
#> [6fb440] (Local) (HEAD) master
## Check if HEAD is head is_head(repository_head(repo))
#> [1] TRUE
## Check if HEAD is local is_local(repository_head(repo))
#> [1] TRUE
## List all tags in repository tags(repo)
#> list()
config(repo, user.name="Git2r Readme", user.email="[email protected]") ## Display configuration config(repo)
#> global:
#> core.autocrlf=input
#> local:
#> branch.master.merge=refs/heads/master
#> branch.master.remote=origin
#> core.bare=false
#> core.filemode=true
#> core.logallrefupdates=true
#> core.repositoryformatversion=0
#> remote.origin.fetch=+refs/heads/*:refs/remotes/origin/*
#> remote.origin.url=https://github.com/ropensci/git2r
#> [email protected]
#> user.name=Git2r Readme
## Create a new file writeLines("Hello world!", file.path(path, "test.txt")) ## Add file and commit add(repo, "test.txt") commit(repo, "Commit message")
#> Commit: 0a6af48cedf43208bde34230662280514e0956eb
#> Author: Git2r Readme <[email protected]>
#> When: 2014-04-22 21:44:57
#> Summary: Commit message
The git2r package is licensed under the GPLv2.