package
3.0.0+incompatible
Repository: https://github.com/improbable-io/go-github.git
Documentation: pkg.go.dev
# Functions
Bool is a helper routine that allocates a new bool value to store v and returns a pointer to it.
CheckResponse checks the API response for errors, and returns them if present.
Int is a helper routine that allocates a new int value to store v and returns a pointer to it.
NewClient returns a new GitHub API client.
ParseWebHook parses the event payload.
String is a helper routine that allocates a new string value to store v and returns a pointer to it.
Stringify attempts to create a reasonable string representation of types in the GitHub library.
ValidatePayload validates an incoming GitHub Webhook event request and returns the (JSON) payload.
WebHookType returns the event type of webhook request r.
# Constants
Diff format.
Patch format.
This is the set of scopes for GitHub API V3.
This is the set of scopes for GitHub API V3.
This is the set of scopes for GitHub API V3.
This is the set of scopes for GitHub API V3.
This is the set of scopes for GitHub API V3.
This is the set of scopes for GitHub API V3.
This is the set of scopes for GitHub API V3.
REVISIT: is this actually returned, or just a documentation artifact?.
This is the set of scopes for GitHub API V3.
This is the set of scopes for GitHub API V3.
This is the set of scopes for GitHub API V3.
This is the set of scopes for GitHub API V3.
This is the set of scopes for GitHub API V3.
This is the set of scopes for GitHub API V3.
This is the set of scopes for GitHub API V3.
This is the set of scopes for GitHub API V3.
This is the set of scopes for GitHub API V3.
This is the set of scopes for GitHub API V3.
This is the set of scopes for GitHub API V3.
This is the set of scopes for GitHub API V3.
This is the set of scopes for GitHub API V3.
This is the set of scopes for GitHub API V3.
This is the set of scopes for GitHub API V3.
This is the set of scopes for GitHub API V3.
StatusUnprocessableEntity is the status code returned when sending a request with invalid fields.
Tarball specifies an archive in gzipped tar format.
Zipball specifies an archive in zip format.
# Structs
AbuseRateLimitError occurs when GitHub returns 403 Forbidden response with the "documentation_url" field value equal to "https://developer.github.com/v3#abuse-rate-limits".
AcceptedError occurs when GitHub returns 202 Accepted response with an empty body, which means a job was scheduled on the GitHub side to process the information needed and cache it.
ActivityListStarredOptions specifies the optional parameters to the ActivityService.ListStarred method.
APIMeta represents metadata about the GitHub API.
Authorization represents an individual GitHub authorization.
AuthorizationApp represents an individual GitHub app (in the context of authorization).
AuthorizationRequest represents a request to create an authorization.
AuthorizationUpdateRequest represents a request to update an authorization.
BasicAuthTransport is an http.RoundTripper that authenticates all requests using HTTP Basic Authentication with the provided username and password.
Blob represents a blob object.
Branch represents a repository branch.
BranchRestrictions represents the restriction that only certain users or teams may push to a branch.
BranchRestrictionsRequest represents the request to create/edit the restriction that only certain users or teams may push to a branch.
A Client manages communication with the GitHub API.
CodeResult represents a single search result.
CodeSearchResult represents the result of a code search.
CombinedStatus represents the combined status of a repository at a particular reference.
Commit represents a GitHub commit.
CommitAuthor represents the author or committer of a commit.
CommitCommentEvent is triggered when a commit comment is created.
CommitFile represents a file modified in a commit.
CommitResult represents a commit object as returned in commit search endpoint response.
CommitsComparison is the result of comparing two commits.
CommitsListOptions specifies the optional parameters to the RepositoriesService.ListCommits method.
CommitsSearchResult represents the result of a commits search.
CommitStats represents the number of additions / deletions from a file in a given RepositoryCommit or GistCommit.
Contributor represents a repository contributor.
ContributorStats represents a contributor to a repository and their weekly contributions to a given repo.
CreateEvent represents a created repository, branch, or tag.
DeleteEvent represents a deleted branch or tag.
Deployment represents a deployment in a repo.
DeploymentEvent represents a deployment.
DeploymentRequest represents a deployment request.
DeploymentsListOptions specifies the optional parameters to the RepositoriesService.ListDeployments method.
DeploymentStatus represents the status of a particular deployment.
DeploymentStatusEvent represents a deployment status.
DeploymentStatusRequest represents a deployment request.
DraftReviewComment represents a comment part of the review.
EditChange represents the changes when an issue, pull request, or comment has been edited.
An Error reports more details on an individual error in an ErrorResponse.
An ErrorResponse reports one or more errors caused by an API request.
Event represents a GitHub event.
FeedLink represents a link to a related resource.
Feeds represents timeline resources in Atom format.
ForkEvent is triggered when a user forks a repository.
Gist represents a GitHub's gist.
GistComment represents a Gist comment.
GistCommit represents a commit on a gist.
GistFile represents a file on a gist.
GistFork represents a fork of a gist.
GistListOptions specifies the optional parameters to the GistsService.List, GistsService.ListAll, and GistsService.ListStarred methods.
Gitignore represents a .gitignore file as returned by the GitHub API.
GitObject represents a Git object.
GollumEvent is triggered when a Wiki page is created or updated.
GPGEmail represents an email address associated to a GPG key.
GPGKey represents a GitHub user's public GPG key used to verify GPG signed commits and tags.
Grant represents an OAuth application that has been granted access to an account.
Hook represents a GitHub (web and service) hook for a repository.
Import represents a repository import request.
Installation represents a GitHub integration installation.
IntegrationInstallationEvent is triggered when an integration is created or deleted.
IntegrationInstallationRepositoriesEvent is triggered when an integration repository is added or removed.
Invitation represents a team member's invitation status.
Issue represents a GitHub issue on a repository.
IssueActivityEvent represents the payload delivered by Issue webhook.
IssueComment represents a comment left on an issue.
IssueCommentEvent is triggered when an issue comment is created on an issue or pull request.
IssueEvent represents an event that occurred around an Issue or Pull Request.
IssueListByRepoOptions specifies the optional parameters to the IssuesService.ListByRepo method.
IssueListCommentsOptions specifies the optional parameters to the IssuesService.ListComments method.
IssueListOptions specifies the optional parameters to the IssuesService.List and IssuesService.ListByOrg methods.
IssueRequest represents a request to create/edit an issue.
IssuesEvent is triggered when an issue is assigned, unassigned, labeled, unlabeled, opened, closed, or reopened.
IssuesSearchResult represents the result of an issues search.
Key represents a public SSH key used to authenticate a user or deploy script.
Label represents a GitHub label on an Issue.
LabelEvent is triggered when a repository's label is created, edited, or deleted.
LargeFile identifies a file larger than 100MB found during a repository import.
License represents an open source license.
ListContributorsOptions specifies the optional parameters to the RepositoriesService.ListContributors method.
ListMembersOptions specifies optional parameters to the OrganizationsService.ListMembers method.
ListOptions specifies the optional parameters to various List methods that support pagination.
ListOrgMembershipsOptions specifies optional parameters to the OrganizationsService.ListOrgMemberships method.
MarkdownOptions specifies optional parameters to the Markdown method.
Match represents a single text match.
MemberEvent is triggered when a user is added as a collaborator to a repository.
Membership represents the status of a user's membership in an organization or team.
MembershipEvent is triggered when a user is added or removed from a team.
Migration represents a GitHub migration (archival).
MigrationOptions specifies the optional parameters to Migration methods.
Milestone represents a Github repository milestone.
MilestoneEvent is triggered when a milestone is created, closed, opened, edited, or deleted.
MilestoneListOptions specifies the optional parameters to the IssuesService.ListMilestones method.
NewPullRequest represents a new pull request to be created.
Notification identifies a GitHub notification for a user.
NotificationListOptions specifies the optional parameters to the ActivityService.ListNotifications method.
NotificationSubject identifies the subject of a notification.
Organization represents a GitHub organization account.
OrganizationAddTeamMembershipOptions does stuff specifies the optional parameters to the OrganizationsService.AddTeamMembership method.
OrganizationAddTeamRepoOptions specifies the optional parameters to the OrganizationsService.AddTeamRepo method.
OrganizationEvent is triggered when a user is added, removed, or invited to an organization.
OrganizationListTeamMembersOptions specifies the optional parameters to the OrganizationsService.ListTeamMembers method.
OrganizationsListOptions specifies the optional parameters to the OrganizationsService.ListAll method.
Page represents a single Wiki page.
PageBuildEvent represents an attempted build of a GitHub Pages site, whether successful or not.
Pages represents a GitHub Pages site configuration.
PagesBuild represents the build information for a GitHub Pages site.
PagesError represents a build error for a GitHub Pages site.
PingEvent is triggered when a Webhook is added to GitHub.
Plan represents the payment plan for an account.
Project represents a GitHub Project.
ProjectCard represents a card in a column of a GitHub Project.
ProjectCardMoveOptions specifies the parameters to the ProjectsService.MoveProjectCard method.
ProjectCardOptions specifies the parameters to the ProjectsService.CreateProjectCard and ProjectsService.UpdateProjectCard methods.
ProjectColumn represents a column of a GitHub Project.
ProjectColumnMoveOptions specifies the parameters to the ProjectsService.MoveProjectColumn method.
ProjectColumnOptions specifies the parameters to the ProjectsService.CreateProjectColumn and ProjectsService.UpdateProjectColumn methods.
ProjectOptions specifies the parameters to the RepositoriesService.CreateProject and ProjectsService.UpdateProject methods.
Protection represents a repository branch's protection.
ProtectionRequest represents a request to create/edit a branch's protection.
PublicEvent is triggered when a private repository is open sourced.
PullRequest represents a GitHub pull request on a repository.
PullRequestBranch represents a base or head branch in a GitHub pull request.
PullRequestComment represents a comment left on a pull request.
PullRequestEvent is triggered when a pull request is assigned, unassigned, labeled, unlabeled, opened, closed, reopened, or synchronized.
PullRequestLinks object is added to the Issue object when it's an issue included in the IssueCommentEvent webhook payload, if the webhooks is fired by a comment on a PR.
PullRequestListCommentsOptions specifies the optional parameters to the PullRequestsService.ListComments method.
PullRequestListOptions specifies the optional parameters to the PullRequestsService.List method.
PullRequestMergeResult represents the result of merging a pull request.
PullRequestOptions lets you define how a pull request will be merged.
PullRequestReview represents a review of a pull request.
PullRequestReviewCommentEvent is triggered when a comment is created on a portion of the unified diff of a pull request.
PullRequestReviewDismissalRequest represents a request to dismiss a review.
PullRequestReviewEvent is triggered when a review is submitted on a pull request.
PullRequestReviewRequest represents a request to create a review.
PunchCard represents the number of commits made during a given hour of a day of thew eek.
PushEvent represents a git push to a GitHub repository.
PushEventCommit represents a git commit in a GitHub PushEvent.
PushEventRepoOwner is a basic representation of user/org in a PushEvent payload.
PushEventRepository represents the repo object in a PushEvent payload.
Rate represents the rate limit for the current client.
RateLimitError occurs when GitHub returns 403 Forbidden response with a rate limit remaining value of 0, and error message starts with "API rate limit exceeded for ".
RateLimits represents the rate limits for the current client.
RawOptions specifies parameters when user wants to get raw format of a response instead of JSON.
Reaction represents a GitHub reaction.
Reactions represents a summary of GitHub reactions.
Reference represents a GitHub reference.
ReferenceListOptions specifies optional parameters to the GitService.ListRefs method.
ReleaseAsset represents a Github release asset in a repository.
ReleaseEvent is triggered when a release is published.
Rename contains details for 'renamed' events.
RepositoriesSearchResult represents the result of a repositories search.
Repository represents a GitHub repository.
RepositoryAddCollaboratorOptions specifies the optional parameters to the RepositoriesService.AddCollaborator method.
RepositoryComment represents a comment for a commit, file, or line in a repository.
RepositoryCommit represents a commit in a repo.
RepositoryContent represents a file or directory in a github repository.
RepositoryContentFileOptions specifies optional parameters for CreateFile, UpdateFile, and DeleteFile.
RepositoryContentGetOptions represents an optional ref parameter, which can be a SHA, branch, or tag.
RepositoryContentResponse holds the parsed response from CreateFile, UpdateFile, and DeleteFile.
RepositoryCreateForkOptions specifies the optional parameters to the RepositoriesService.CreateFork method.
RepositoryEvent is triggered when a repository is created.
RepositoryInvitation represents an invitation to collaborate on a repo.
RepositoryLicense represents the license for a repository.
RepositoryListAllOptions specifies the optional parameters to the RepositoriesService.ListAll method.
RepositoryListByOrgOptions specifies the optional parameters to the RepositoriesService.ListByOrg method.
RepositoryListForksOptions specifies the optional parameters to the RepositoriesService.ListForks method.
RepositoryListOptions specifies the optional parameters to the RepositoriesService.List method.
RepositoryMergeRequest represents a request to merge a branch in a repository.
RepositoryParticipation is the number of commits by everyone who has contributed to the repository (including the owner) as well as the number of commits by the owner themself.
RepositoryPermissionLevel represents the permission level an organization member has for a given repository.
RepositoryRelease represents a GitHub release in a repository.
RepositoryTag represents a repository tag.
RepoStatus represents the status of a repository at a particular reference.
RequiredPullRequestReviews represents the protection configuration for pull requests.
RequiredStatusChecks represents the protection status of a individual branch.
Response is a GitHub API response.
SearchOptions specifies optional parameters to the SearchService methods.
ServiceHook represents a hook that has configuration settings, a list of available events, and default events.
SignatureVerification represents GPG signature verification.
Source represents a reference's source.
SourceImportAuthor identifies an author imported from a source repository.
Stargazer represents a user that has starred a repository.
StarredRepository is returned by ListStarred.
StatusEvent is triggered when the status of a Git commit changes.
Subscription identifies a repository or thread subscription.
Tag represents a tag object.
Team represents a team within a GitHub organization.
TeamAddEvent is triggered when a repository is added to a team.
TeamLDAPMapping represents the mapping between a GitHub team and an LDAP group.
TextMatch represents a text match for a SearchResult.
Timeline represents an event that occurred around an Issue or Pull Request.
Timestamp represents a time that can be unmarshalled from a JSON string formatted as either an RFC3339 or Unix timestamp.
TrafficBreakdownOptions specifies the parameters to methods that support breakdown per day or week.
TrafficClones represent information about the number of clones in the last 14 days.
TrafficData represent information about a specific timestamp in views or clones list.
TrafficPath represent information about the traffic on a path of the repo.
TrafficReferrer represent information about traffic from a referrer .
TrafficViews represent information about the number of views in the last 14 days.
Tree represents a GitHub tree.
TreeEntry represents the contents of a tree structure.
UnauthenticatedRateLimitedTransport allows you to make unauthenticated calls
that need to use a higher rate limit associated with your OAuth application.
UploadOptions specifies the parameters to methods that support uploads.
User represents a GitHub user.
UserEmail represents user's email address.
UserLDAPMapping represents the mapping between a GitHub user and an LDAP user.
UserListOptions specifies optional parameters to the UsersService.ListAll method.
UsersSearchResult represents the result of a users search.
WatchEvent is related to starring a repository, not watching.
WebHookAuthor represents the author or committer of a commit, as specified in a WebHookCommit.
WebHookCommit represents the commit variant we receive from GitHub in a WebHookPayload.
WebHookPayload represents the data that is received from GitHub when a push event hook is triggered.
WeeklyCommitActivity represents the weekly commit activity for a repository.
WeeklyStats represents the number of additions, deletions and commits a Contributor made in a given week.
# Type aliases
ActivityService handles communication with the activity related methods of the GitHub API.
AdminService handles communication with the admin related methods of the GitHub API.
AuthorizationsService handles communication with the authorization related methods of the GitHub API.
GistFilename represents filename on a gist.
GistsService handles communication with the Gist related methods of the GitHub API.
GitignoresService provides access to the gitignore related functions in the GitHub API.
GitService handles communication with the git data related methods of the GitHub API.
IntegrationsService provides access to the installation related functions in the GitHub API.
IssuesService handles communication with the issue related methods of the GitHub API.
LicensesService handles communication with the license related methods of the GitHub API.
MigrationService provides access to the migration related functions in the GitHub API.
OrganizationsService provides access to the organization related functions in the GitHub API.
ProjectsService provides access to the projects functions in the GitHub API.
PullRequestsService handles communication with the pull request related methods of the GitHub API.
RawType represents type of raw format of a request instead of JSON.
ReactionsService provides access to the reactions-related functions in the GitHub API.
RepositoriesService handles communication with the repository related methods of the GitHub API.
Scope models a GitHub authorization scope.
SearchService provides access to the search related functions in the GitHub API.
TwoFactorAuthError occurs when using HTTP Basic Authentication for a user that has two-factor authentication enabled.
UsersService handles communication with the user related methods of the GitHub API.