rgithub

KO | EN

gitlite — search

#javascript #react #ai #llm #machine-learning #rust #docker #macos #nodejs #kubernetes #pytorch #mcp #ios #openai

(★ 69)

R bindings for the github API

File Explorer

Download Latest Version (.zip)

- add.emails.Rd
- add.issue.labels.Rd
- add.member.to.team.Rd
- add.repository.collaborator.Rd
- add.repository.to.team.Rd
- am.following.user.Rd
- conceal.member.of.organization.Rd
- create.blob.Rd
- create.commit.comment.Rd
- create.commit.Rd
- create.fork.Rd
- create.gist.comment.Rd
- create.gist.Rd
- create.github.context.Rd
- create.hook.Rd
- create.issue.comment.Rd
- create.issue.Rd
- create.key.Rd
- create.milestone.Rd
- create.organization.repository.Rd
- create.pull.request.comment.Rd
- create.pull.request.Rd
- create.reference.Rd
- create.repository.key.Rd
- create.repository.label.Rd
- create.repository.Rd
- create.repository.status.Rd
- create.tag.Rd
- create.team.Rd
- create.tree.Rd
- delete.all.issue.labels.Rd
- delete.commit.comment.Rd
- delete.emails.Rd
- delete.gist.comment.Rd
- delete.gist.Rd
- delete.hook.Rd
- delete.issue.comment.Rd
- delete.issue.label.Rd
- delete.key.Rd
- delete.member.from.organization.Rd
- delete.member.from.team.Rd
- delete.milestone.Rd
- delete.pull.request.comment.Rd
- delete.reference.Rd
- delete.repository.collaborator.Rd
- delete.repository.download.Rd
- delete.repository.from.team.Rd
- delete.repository.key.Rd
- delete.repository.label.Rd
- delete.repository.path.Rd
- delete.repository.Rd
- delete.team.Rd
- follow.user.Rd
- fork.gist.Rd
- get.all.my.issues.Rd
- get.all.references.Rd
- get.all.repositories.Rd
- get.all.repository.issues.comments.Rd
- get.assignees.Rd
- get.blob.Rd
- get.commit.comment.Rd
- get.commit.Rd
- get.gist.comment.Rd
- get.gist.comments.Rd
- get.gist.forks.Rd
- get.gist.Rd
- get.github.context.Rd
- get.issue.comment.Rd
- get.issue.comments.Rd
- get.issue.events.Rd
- get.issue.labels.Rd
- get.key.Rd
- get.milestone.labels.Rd
- get.milestone.Rd
- get.milestones.Rd
- get.my.emails.Rd
- get.my.followers.Rd
- get.my.following.Rd
- get.my.gists.Rd
- get.my.issues.Rd
- get.my.keys.Rd
- get.my.notifications.Rd
- get.my.organization.events.Rd
- get.my.organizations.Rd
- get.my.repositories.Rd
- get.my.repository.notifications.Rd
- get.myself.Rd
- get.network.public.events.Rd
- get.organization.issues.Rd
- get.organization.members.Rd
- get.organization.public.events.Rd
- get.organization.public.members.Rd
- get.organization.Rd
- get.organization.repositories.Rd
- get.organization.teams.Rd
- get.public.events.Rd
- get.pull.request.comments.Rd
- get.pull.request.commits.Rd
- get.pull.request.files.Rd
- get.pull.request.Rd
- get.pull.requests.comment.Rd
- get.pull.requests.comments.Rd
- get.pull.requests.Rd
- get.reference.Rd
- get.repositories.starred.by.me.Rd
- get.repositories.starred.by.user.Rd
- get.repositories.watched.by.me.Rd
- get.repositories.watched.by.user.Rd
- get.repository.archive.Rd
- get.repository.branch.Rd
- get.repository.branches.Rd
- get.repository.collaborators.Rd
- get.repository.comments.Rd
- get.repository.commit.comments.Rd
- get.repository.commit.Rd
- get.repository.commits.Rd
- get.repository.contributors.Rd
- get.repository.contributors.stats.Rd
- get.repository.diff.Rd
- get.repository.download.Rd
- get.repository.downloads.Rd
- get.repository.events.Rd
- get.repository.forks.Rd
- get.repository.hook.Rd
- get.repository.hooks.Rd
- get.repository.issue.event.Rd
- get.repository.issue.events.Rd
- get.repository.issues.Rd
- get.repository.key.Rd
- get.repository.keys.Rd
- get.repository.label.Rd
- get.repository.labels.Rd
- get.repository.languages.Rd
- get.repository.path.Rd
- get.repository.Rd
- get.repository.readme.Rd
- get.repository.status.Rd
- get.repository.statuses.Rd
- get.repository.subscription.Rd
- get.repository.tags.Rd
- get.repository.teams.Rd
- get.stargazers.Rd
- get.tag.Rd
- get.team.members.Rd
- get.team.Rd
- get.team.repositories.Rd
- get.thread.notifications.Rd
- get.thread.notifications.subscription.Rd
- get.tree.Rd
- get.user.followers.Rd
- get.user.following.Rd
- get.user.gists.Rd
- get.user.keys.Rd
- get.user.organizations.Rd
- get.user.performed.events.Rd
- get.user.public.performed.events.Rd
- get.user.public.received.events.Rd
- get.user.Rd
- get.user.received.events.Rd
- get.user.repositories.Rd
- get.users.Rd
- get.watchers.Rd
- github.Rd
- interactive.login.Rd
- is.assignee.Rd
- is.member.in.team.Rd
- is.member.of.organization.Rd
- is.public.member.of.organization.Rd
- is.pull.request.merged.Rd
- is.repository.collaborator.Rd
- is.repository.starred.by.me.Rd
- is.starred.Rd
- mark.my.notifications.Rd
- mark.my.repository.notifications.Rd
- mark.thread.notifications.Rd
- modify.commit.comment.Rd
- modify.gist.comment.Rd
- modify.gist.Rd
- modify.hook.Rd
- modify.issue.comment.Rd
- modify.issue.Rd
- modify.key.Rd
- modify.milestone.Rd
- modify.myself.Rd
- modify.organization.Rd
- modify.pull.request.comment.Rd
- modify.pull.request.Rd
- modify.reference.Rd
- modify.repository.key.Rd
- modify.repository.label.Rd
- modify.repository.Rd
- modify.team.Rd
- perform.merge.pull.request.Rd
- perform.repository.merge.Rd
- publicize.member.of.organization.Rd
- replace.issue.labels.Rd
- search.code.Rd
- search.issues.Rd
- search.repositories.Rd
- search.users.Rd
- set.repository.subscription.Rd
- set.thread.notifications.subscription.Rd
- star.gist.Rd
- star.repository.Rd
- test.hook.Rd
- unfollow.user.Rd
- unset.repository.subscription.Rd
- unset.thread.notifications.subscription.Rd
- unstar.gist.Rd
- unstar.repository.Rd
- update.repository.path.Rd
- srch.r
- activity.R
- data.R
- gists.R
- github.R
- issues.R
- orgs.R
- pulls.R
- repositories.R
- S3methods.R
- search.R
- users.R
- - test_basic.r
- testthat.R
.gitignore
.Rbuildignore
.travis.yml
DESCRIPTION
LICENSE
NAMESPACE
README.md
todo.org

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[![Build Status](https://travis-ci.org/cscheid/rgithub.png)](https://travis-ci.org/cscheid/rgithub)

# R Bindings for the Github v3 API

## This project is essentially abandoned

Hello there - unfortunately I don't have time to maintain this project anymore. If you're interested in taking over, send me an email and I'm happy to help with the transition.

If you're a user of this library, consider switching to [gh](https://github.com/r-lib/gh/) or [ghapi3](https://github.com/coatless/ghapi3), which are both newer and more actively maintained.

## Intro

These are bindings for the Github web service API as of version 3. For
full documentation, please refer to the [Github developer
API](http://developer.github.com/v3).

### Quickie

> ctx = interactive.login(client.id, client.secret)
    > me = get.myself(ctx)
    > me$content$public_repos
    [1] 17
    > star.repository("cscheid", "guitar", ctx)
    > unstar.repository("cscheid", "guitar", ctx)

### Setting up

In order to use most of their API, Github requires you to register an
[application](https://github.com/settings/applications/). You'll need
to do this if you want to change information, repositories, post
gists, etc.

#### Interactive use

If you will authenticate your Github account interactively (using the
OAuth dance, for example), you should point the Callback URL to
"http://localhost:1410". This is so that `interactive.login` works:
the interactive OAuth login dancing involves redirection to a URL that
is specified in advance. [httr](https://github.com/hadley/httr)
creates a web server on port 1410 to catch the redirection request and
the token that comes with it.

To log in, you will need the Application Client ID and Secret, and you
will call the following function in your R script:

> ctx = interactive.login(client.id, client.secret, scopes=c("gist"))

This will open a web browser where the caller of the R script
(presumably, you) will be asked to type their Github username and
password. Give more scopes to allow the bindings to do more things ([more
on oAuth scopes](http://developer.github.com/v3/oauth/#scopes)).

#### Noninteractive use

If you have obtained an
[OAuth access token](http://developer.github.com/v3/oauth/) by some
other method, you can pass it directly to `create.github.context`. In
fact, `interactive.login` does little else than securing access to a
token interactively, and then calling `create.github.context`.

In other words, you should use `create.github.context` if some other
part of your application is in charge of obtaining the OAuth access
token.

You can also use `create.github.context` to create anonymous access
contexts. You will be able to make some calls into the API, but not
all of them, and you will be much more severely rate-limited. See the
[documentation](http://developer.github.com/v3/#rate-limiting) for details.

#### About the Github client secret

DO NOT PUT THE CLIENT SECRET ON A PUBLICLY VISIBLE LOCATION. This is
equivalent to an application-wide password. It is used by Github to
track API usage, and could be used to impersonate your app. Store it
in a safe location (like a locally-encrypted file in your local
filesystem), ask the user to type it, or pass it via environment
variables from the shell.

### API naming and style

All API entry points are very shallow wrappers around Github's
API. Once you logged in, all calls to the API take the result of
web.login. Examples:

> repos = get.my.repositories(ctx)
    > repos = get.my.repositories(ctx, type="owner")

The result of all calls to the API is the request from httr. Most of
the time you will want the response contents, accessible through httr's
`content()`. This is automatically parsed into JSON, the message
format used throughout's the api:

> me = get.myself(ctx)
    > me$content$public_repos
    [1] 17

The naming of the function calls is always meant to evoke an
order. It starts with a verb and follows with the appropriate
objects:

> evts = get.public.events(ctx)
    > result = is.repository.starred.by.me("cscheid", "facet")
    > star.repository("cscheid", "guitar", ctx)
    > unstar.repository("cscheid", "guitar", ctx)

When the Github API specifies "inputs", such as with [blob
creation](http://developer.github.com/v3/git/blobs/#create-a-blob),
you will send the JSON content as the last parameter, named `content`:

> create.blob(ctx, "cscheid", "guitar", list(content="This is a new blob", encoding="utf-8"))

When the Github API specifies extra parameters, such as when [listing repositories](http://developer.github.com/v3/repos/#list-your-repositories), you will pass parameters directly to the API call, like you've already seen above:

# Get all my repositories, sorted by when I last pushed to them
    > repos = get.my.repositories(ctx, type="owner", sort="pushed")

### TODO

* Keep track of rate limits
* Honor event API `X-Poll-Interval` query rate limits automatically

rgithub

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

rgithub

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

Download README