// Copyright 2013 The go-github AUTHORS. All rights reserved.

//

// Use of this source code is governed by a BSD-style

// license that can be found in the LICENSE file.

package github

import (

"context"

"encoding/json"

"errors"

"fmt"

"net/http"

"net/url"

"strings"

)

const githubBranchNotProtected string = "Branch not protected"

var ErrBranchNotProtected = errors.New("branch is not protected")

// RepositoriesService handles communication with the repository related

// methods of the GitHub API.

//

// GitHub API docs: https://docs.github.com/rest/repos/

type RepositoriesService service

// Repository represents a GitHub repository.

type Repository struct {

ID *int64 `json:"id,omitempty"`

NodeID *string `json:"node_id,omitempty"`

Owner *User `json:"owner,omitempty"`

Name *string `json:"name,omitempty"`

FullName *string `json:"full_name,omitempty"`

Description *string `json:"description,omitempty"`

Homepage *string `json:"homepage,omitempty"`

CodeOfConduct *CodeOfConduct `json:"code_of_conduct,omitempty"`

DefaultBranch *string `json:"default_branch,omitempty"`

MasterBranch *string `json:"master_branch,omitempty"`

CreatedAt *Timestamp `json:"created_at,omitempty"`

PushedAt *Timestamp `json:"pushed_at,omitempty"`

UpdatedAt *Timestamp `json:"updated_at,omitempty"`

HTMLURL *string `json:"html_url,omitempty"`

CloneURL *string `json:"clone_url,omitempty"`

GitURL *string `json:"git_url,omitempty"`

MirrorURL *string `json:"mirror_url,omitempty"`

SSHURL *string `json:"ssh_url,omitempty"`

SVNURL *string `json:"svn_url,omitempty"`

Language *string `json:"language,omitempty"`

Fork *bool `json:"fork,omitempty"`

ForksCount *int `json:"forks_count,omitempty"`

NetworkCount *int `json:"network_count,omitempty"`

OpenIssuesCount *int `json:"open_issues_count,omitempty"`

OpenIssues *int `json:"open_issues,omitempty"` // Deprecated: Replaced by OpenIssuesCount. For backward compatibility OpenIssues is still populated.

StargazersCount *int `json:"stargazers_count,omitempty"`

SubscribersCount *int `json:"subscribers_count,omitempty"`

WatchersCount *int `json:"watchers_count,omitempty"` // Deprecated: Replaced by StargazersCount. For backward compatibility WatchersCount is still populated.

Watchers *int `json:"watchers,omitempty"` // Deprecated: Replaced by StargazersCount. For backward compatibility Watchers is still populated.

Size *int `json:"size,omitempty"`

AutoInit *bool `json:"auto_init,omitempty"`

Parent *Repository `json:"parent,omitempty"`

Source *Repository `json:"source,omitempty"`

TemplateRepository *Repository `json:"template_repository,omitempty"`

Organization *Organization `json:"organization,omitempty"`

Permissions map[string]bool `json:"permissions,omitempty"`

AllowRebaseMerge *bool `json:"allow_rebase_merge,omitempty"`

AllowUpdateBranch *bool `json:"allow_update_branch,omitempty"`

AllowSquashMerge *bool `json:"allow_squash_merge,omitempty"`

AllowMergeCommit *bool `json:"allow_merge_commit,omitempty"`

AllowAutoMerge *bool `json:"allow_auto_merge,omitempty"`

AllowForking *bool `json:"allow_forking,omitempty"`

WebCommitSignoffRequired *bool `json:"web_commit_signoff_required,omitempty"`

DeleteBranchOnMerge *bool `json:"delete_branch_on_merge,omitempty"`

UseSquashPRTitleAsDefault *bool `json:"use_squash_pr_title_as_default,omitempty"`

SquashMergeCommitTitle *string `json:"squash_merge_commit_title,omitempty"` // Can be one of: "PR_TITLE", "COMMIT_OR_PR_TITLE"

SquashMergeCommitMessage *string `json:"squash_merge_commit_message,omitempty"` // Can be one of: "PR_BODY", "COMMIT_MESSAGES", "BLANK"

MergeCommitTitle *string `json:"merge_commit_title,omitempty"` // Can be one of: "PR_TITLE", "MERGE_MESSAGE"

MergeCommitMessage *string `json:"merge_commit_message,omitempty"` // Can be one of: "PR_BODY", "PR_TITLE", "BLANK"

Topics []string `json:"topics,omitempty"`

CustomProperties map[string]interface{} `json:"custom_properties,omitempty"`

Archived *bool `json:"archived,omitempty"`

Disabled *bool `json:"disabled,omitempty"`

// Only provided when using RepositoriesService.Get while in preview

License *License `json:"license,omitempty"`

// Additional mutable fields when creating and editing a repository

Private *bool `json:"private,omitempty"`

HasIssues *bool `json:"has_issues,omitempty"`

HasWiki *bool `json:"has_wiki,omitempty"`

HasPages *bool `json:"has_pages,omitempty"`

HasProjects *bool `json:"has_projects,omitempty"`

HasDownloads *bool `json:"has_downloads,omitempty"`

HasDiscussions *bool `json:"has_discussions,omitempty"`

IsTemplate *bool `json:"is_template,omitempty"`

LicenseTemplate *string `json:"license_template,omitempty"`

GitignoreTemplate *string `json:"gitignore_template,omitempty"`

// Options for configuring Advanced Security and Secret Scanning

SecurityAndAnalysis *SecurityAndAnalysis `json:"security_and_analysis,omitempty"`

// Creating an organization repository. Required for non-owners.

TeamID *int64 `json:"team_id,omitempty"`

// API URLs

URL *string `json:"url,omitempty"`

ArchiveURL *string `json:"archive_url,omitempty"`

AssigneesURL *string `json:"assignees_url,omitempty"`

BlobsURL *string `json:"blobs_url,omitempty"`

BranchesURL *string `json:"branches_url,omitempty"`

CollaboratorsURL *string `json:"collaborators_url,omitempty"`

CommentsURL *string `json:"comments_url,omitempty"`

CommitsURL *string `json:"commits_url,omitempty"`

CompareURL *string `json:"compare_url,omitempty"`

ContentsURL *string `json:"contents_url,omitempty"`

ContributorsURL *string `json:"contributors_url,omitempty"`

DeploymentsURL *string `json:"deployments_url,omitempty"`

DownloadsURL *string `json:"downloads_url,omitempty"`

EventsURL *string `json:"events_url,omitempty"`

ForksURL *string `json:"forks_url,omitempty"`

GitCommitsURL *string `json:"git_commits_url,omitempty"`

GitRefsURL *string `json:"git_refs_url,omitempty"`

GitTagsURL *string `json:"git_tags_url,omitempty"`

HooksURL *string `json:"hooks_url,omitempty"`

IssueCommentURL *string `json:"issue_comment_url,omitempty"`

IssueEventsURL *string `json:"issue_events_url,omitempty"`

IssuesURL *string `json:"issues_url,omitempty"`

KeysURL *string `json:"keys_url,omitempty"`

LabelsURL *string `json:"labels_url,omitempty"`

LanguagesURL *string `json:"languages_url,omitempty"`

MergesURL *string `json:"merges_url,omitempty"`

MilestonesURL *string `json:"milestones_url,omitempty"`

NotificationsURL *string `json:"notifications_url,omitempty"`

PullsURL *string `json:"pulls_url,omitempty"`

ReleasesURL *string `json:"releases_url,omitempty"`

StargazersURL *string `json:"stargazers_url,omitempty"`

StatusesURL *string `json:"statuses_url,omitempty"`

SubscribersURL *string `json:"subscribers_url,omitempty"`

SubscriptionURL *string `json:"subscription_url,omitempty"`

TagsURL *string `json:"tags_url,omitempty"`

TreesURL *string `json:"trees_url,omitempty"`

TeamsURL *string `json:"teams_url,omitempty"`

// TextMatches is only populated from search results that request text matches

// See: search.go and https://docs.github.com/rest/search/#text-match-metadata

TextMatches []*TextMatch `json:"text_matches,omitempty"`

// Visibility is only used for Create and Edit endpoints. The visibility field

// overrides the field parameter when both are used.

// Can be one of public, private or internal.

Visibility *string `json:"visibility,omitempty"`

// RoleName is only returned by the API 'check team permissions for a repository'.

// See: teams.go (IsTeamRepoByID) https://docs.github.com/rest/teams/teams#check-team-permissions-for-a-repository

RoleName *string `json:"role_name,omitempty"`

}

func (r Repository) String() string {

return Stringify(r)

}

// BranchListOptions specifies the optional parameters to the

// RepositoriesService.ListBranches method.

type BranchListOptions struct {

// Setting to true returns only protected branches.

// When set to false, only unprotected branches are returned.

// Omitting this parameter returns all branches.

// Default: nil

Protected *bool `url:"protected,omitempty"`

ListOptions

}

// RepositoryListOptions specifies the optional parameters to the

// RepositoriesService.List method.

type RepositoryListOptions struct {

// See RepositoryListByAuthenticatedUserOptions.Visibility

Visibility string `url:"visibility,omitempty"`

// See RepositoryListByAuthenticatedUserOptions.Affiliation

Affiliation string `url:"affiliation,omitempty"`

// See RepositoryListByUserOptions.Type or RepositoryListByAuthenticatedUserOptions.Type

Type string `url:"type,omitempty"`

// See RepositoryListByUserOptions.Sort or RepositoryListByAuthenticatedUserOptions.Sort

Sort string `url:"sort,omitempty"`

// See RepositoryListByUserOptions.Direction or RepositoryListByAuthenticatedUserOptions.Direction

Direction string `url:"direction,omitempty"`

ListOptions

}

// SecurityAndAnalysis specifies the optional advanced security features

// that are enabled on a given repository.

type SecurityAndAnalysis struct {

AdvancedSecurity *AdvancedSecurity `json:"advanced_security,omitempty"`

SecretScanning *SecretScanning `json:"secret_scanning,omitempty"`

SecretScanningPushProtection *SecretScanningPushProtection `json:"secret_scanning_push_protection,omitempty"`

DependabotSecurityUpdates *DependabotSecurityUpdates `json:"dependabot_security_updates,omitempty"`

SecretScanningValidityChecks *SecretScanningValidityChecks `json:"secret_scanning_validity_checks,omitempty"`

}

func (s SecurityAndAnalysis) String() string {

return Stringify(s)

}

// AdvancedSecurity specifies the state of advanced security on a repository.

//

// GitHub API docs: https://docs.github.com/github/getting-started-with-github/learning-about-github/about-github-advanced-security

type AdvancedSecurity struct {

Status *string `json:"status,omitempty"`

}

func (a AdvancedSecurity) String() string {

return Stringify(a)

}

// SecretScanning specifies the state of secret scanning on a repository.

//

// GitHub API docs: https://docs.github.com/code-security/secret-security/about-secret-scanning

type SecretScanning struct {

Status *string `json:"status,omitempty"`

}

func (s SecretScanning) String() string {

return Stringify(s)

}

// SecretScanningPushProtection specifies the state of secret scanning push protection on a repository.

//

// GitHub API docs: https://docs.github.com/code-security/secret-scanning/about-secret-scanning#about-secret-scanning-for-partner-patterns

type SecretScanningPushProtection struct {

Status *string `json:"status,omitempty"`

}

func (s SecretScanningPushProtection) String() string {

return Stringify(s)

}

// DependabotSecurityUpdates specifies the state of Dependabot security updates on a repository.

//

// GitHub API docs: https://docs.github.com/code-security/dependabot/dependabot-security-updates/about-dependabot-security-updates

type DependabotSecurityUpdates struct {

Status *string `json:"status,omitempty"`

}

func (d DependabotSecurityUpdates) String() string {

return Stringify(d)

}

// SecretScanningValidityChecks represents the state of secret scanning validity checks on a repository.

//

// GitHub API docs: https://docs.github.com/en/enterprise-cloud@latest/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-security-and-analysis-settings-for-your-repository#allowing-validity-checks-for-partner-patterns-in-a-repository

type SecretScanningValidityChecks struct {

Status *string `json:"status,omitempty"`

}

// List calls either RepositoriesService.ListByUser or RepositoriesService.ListByAuthenticatedUser

// depending on whether user is empty.

//

// Deprecated: Use RepositoriesService.ListByUser or RepositoriesService.ListByAuthenticatedUser instead.

//

// GitHub API docs: https://docs.github.com/rest/repos/repos#list-repositories-for-a-user

// GitHub API docs: https://docs.github.com/rest/repos/repos#list-repositories-for-the-authenticated-user

//

//meta:operation GET /user/repos

//meta:operation GET /users/{username}/repos

func (s *RepositoriesService) List(ctx context.Context, user string, opts *RepositoryListOptions) ([]*Repository, *Response, error) {

if opts == nil {

opts = &RepositoryListOptions{}

}

if user != "" {

return s.ListByUser(ctx, user, &RepositoryListByUserOptions{

Type: opts.Type,

Sort: opts.Sort,

Direction: opts.Direction,

ListOptions: opts.ListOptions,

})

}

return s.ListByAuthenticatedUser(ctx, &RepositoryListByAuthenticatedUserOptions{

Visibility: opts.Visibility,

Affiliation: opts.Affiliation,

Type: opts.Type,

Sort: opts.Sort,

Direction: opts.Direction,

ListOptions: opts.ListOptions,

})

}

// RepositoryListByUserOptions specifies the optional parameters to the

// RepositoriesService.ListByUser method.

type RepositoryListByUserOptions struct {

// Limit results to repositories of the specified type.

// Default: owner

// Can be one of: all, owner, member

Type string `url:"type,omitempty"`

// The property to sort the results by.

// Default: full_name

// Can be one of: created, updated, pushed, full_name

Sort string `url:"sort,omitempty"`

// The order to sort by.

// Default: asc when using full_name, otherwise desc.

// Can be one of: asc, desc

Direction string `url:"direction,omitempty"`

ListOptions

}

// ListByUser lists public repositories for the specified user.

//

// GitHub API docs: https://docs.github.com/rest/repos/repos#list-repositories-for-a-user

//

//meta:operation GET /users/{username}/repos

func (s *RepositoriesService) ListByUser(ctx context.Context, user string, opts *RepositoryListByUserOptions) ([]*Repository, *Response, error) {

u := fmt.Sprintf("users/%v/repos", user)

u, err := addOptions(u, opts)

if err != nil {

return nil, nil, err

}

req, err := s.client.NewRequest("GET", u, nil)

if err != nil {

return nil, nil, err

}

var repos []*Repository

resp, err := s.client.Do(ctx, req, &repos)

if err != nil {

return nil, resp, err

}

return repos, resp, nil

}

// RepositoryListByAuthenticatedUserOptions specifies the optional parameters to the

// RepositoriesService.ListByAuthenticatedUser method.

type RepositoryListByAuthenticatedUserOptions struct {

// Limit results to repositories with the specified visibility.

// Default: all

// Can be one of: all, public, private

Visibility string `url:"visibility,omitempty"`

// List repos of given affiliation[s].

// Comma-separated list of values. Can include:

// * owner: Repositories that are owned by the authenticated user.

// * collaborator: Repositories that the user has been added to as a

// collaborator.

// * organization_member: Repositories that the user has access to through

// being a member of an organization. This includes every repository on

// every team that the user is on.

// Default: owner,collaborator,organization_member

Affiliation string `url:"affiliation,omitempty"`

// Limit results to repositories of the specified type. Will cause a 422 error if

// used in the same request as visibility or affiliation.

// Default: all

// Can be one of: all, owner, public, private, member

Type string `url:"type,omitempty"`

// The property to sort the results by.

// Default: full_name

// Can be one of: created, updated, pushed, full_name

Sort string `url:"sort,omitempty"`

// Direction in which to sort repositories. Can be one of asc or desc.

// Default: when using full_name: asc; otherwise desc

Direction string `url:"direction,omitempty"`

ListOptions

}

// ListByAuthenticatedUser lists repositories for the authenticated user.

//

// GitHub API docs: https://docs.github.com/rest/repos/repos#list-repositories-for-the-authenticated-user

//

//meta:operation GET /user/repos

func (s *RepositoriesService) ListByAuthenticatedUser(ctx context.Context, opts *RepositoryListByAuthenticatedUserOptions) ([]*Repository, *Response, error) {

u := "user/repos"

u, err := addOptions(u, opts)

if err != nil {

return nil, nil, err

}

req, err := s.client.NewRequest("GET", u, nil)

if err != nil {

return nil, nil, err

}

var repos []*Repository

resp, err := s.client.Do(ctx, req, &repos)

if err != nil {

return nil, resp, err

}

return repos, resp, nil

}

// RepositoryListByOrgOptions specifies the optional parameters to the

// RepositoriesService.ListByOrg method.

type RepositoryListByOrgOptions struct {

// Type of repositories to list. Possible values are: all, public, private,

// forks, sources, member. Default is "all".

Type string `url:"type,omitempty"`

// How to sort the repository list. Can be one of created, updated, pushed,

// full_name. Default is "created".

Sort string `url:"sort,omitempty"`

// Direction in which to sort repositories. Can be one of asc or desc.

// Default when using full_name: asc; otherwise desc.

Direction string `url:"direction,omitempty"`

ListOptions

}

// ListByOrg lists the repositories for an organization.

//

// GitHub API docs: https://docs.github.com/rest/repos/repos#list-organization-repositories

//

//meta:operation GET /orgs/{org}/repos

func (s *RepositoriesService) ListByOrg(ctx context.Context, org string, opts *RepositoryListByOrgOptions) ([]*Repository, *Response, error) {

u := fmt.Sprintf("orgs/%v/repos", org)

u, err := addOptions(u, opts)

if err != nil {

return nil, nil, err

}

req, err := s.client.NewRequest("GET", u, nil)

if err != nil {

return nil, nil, err

}

// TODO: remove custom Accept headers when APIs fully launch.

acceptHeaders := []string{mediaTypeTopicsPreview, mediaTypeRepositoryVisibilityPreview}

req.Header.Set("Accept", strings.Join(acceptHeaders, ", "))

var repos []*Repository

resp, err := s.client.Do(ctx, req, &repos)

if err != nil {

return nil, resp, err

}

return repos, resp, nil

}

// RepositoryListAllOptions specifies the optional parameters to the

// RepositoriesService.ListAll method.

type RepositoryListAllOptions struct {

// ID of the last repository seen

Since int64 `url:"since,omitempty"`

}

// ListAll lists all GitHub repositories in the order that they were created.

//

// GitHub API docs: https://docs.github.com/rest/repos/repos#list-public-repositories

//

//meta:operation GET /repositories

func (s *RepositoriesService) ListAll(ctx context.Context, opts *RepositoryListAllOptions) ([]*Repository, *Response, error) {

u, err := addOptions("repositories", opts)

if err != nil {

return nil, nil, err

}

req, err := s.client.NewRequest("GET", u, nil)

if err != nil {

return nil, nil, err

}

var repos []*Repository

resp, err := s.client.Do(ctx, req, &repos)

if err != nil {

return nil, resp, err

}

return repos, resp, nil

}

// createRepoRequest is a subset of Repository and is used internally

// by Create to pass only the known fields for the endpoint.

//

// See https://github.com/google/go-github/issues/1014 for more

// information.

type createRepoRequest struct {

// Name is required when creating a repo.

Name *string `json:"name,omitempty"`

Description *string `json:"description,omitempty"`

Homepage *string `json:"homepage,omitempty"`

Private *bool `json:"private,omitempty"`

Visibility *string `json:"visibility,omitempty"`

HasIssues *bool `json:"has_issues,omitempty"`

HasProjects *bool `json:"has_projects,omitempty"`

HasWiki *bool `json:"has_wiki,omitempty"`

HasDiscussions *bool `json:"has_discussions,omitempty"`

IsTemplate *bool `json:"is_template,omitempty"`

// Creating an organization repository. Required for non-owners.

TeamID *int64 `json:"team_id,omitempty"`

AutoInit *bool `json:"auto_init,omitempty"`

GitignoreTemplate *string `json:"gitignore_template,omitempty"`

LicenseTemplate *string `json:"license_template,omitempty"`

AllowSquashMerge *bool `json:"allow_squash_merge,omitempty"`

AllowMergeCommit *bool `json:"allow_merge_commit,omitempty"`

AllowRebaseMerge *bool `json:"allow_rebase_merge,omitempty"`

AllowUpdateBranch *bool `json:"allow_update_branch,omitempty"`

AllowAutoMerge *bool `json:"allow_auto_merge,omitempty"`

AllowForking *bool `json:"allow_forking,omitempty"`

DeleteBranchOnMerge *bool `json:"delete_branch_on_merge,omitempty"`

UseSquashPRTitleAsDefault *bool `json:"use_squash_pr_title_as_default,omitempty"`

SquashMergeCommitTitle *string `json:"squash_merge_commit_title,omitempty"`

SquashMergeCommitMessage *string `json:"squash_merge_commit_message,omitempty"`

MergeCommitTitle *string `json:"merge_commit_title,omitempty"`

MergeCommitMessage *string `json:"merge_commit_message,omitempty"`

}

// Create a new repository. If an organization is specified, the new

// repository will be created under that org. If the empty string is

// specified, it will be created for the authenticated user.

//

// Note that only a subset of the repo fields are used and repo must

// not be nil.

//

// Also note that this method will return the response without actually

// waiting for GitHub to finish creating the repository and letting the

// changes propagate throughout its servers. You may set up a loop with

// exponential back-off to verify repository's creation.

//

// GitHub API docs: https://docs.github.com/rest/repos/repos#create-a-repository-for-the-authenticated-user

// GitHub API docs: https://docs.github.com/rest/repos/repos#create-an-organization-repository

//

//meta:operation POST /orgs/{org}/repos

//meta:operation POST /user/repos

func (s *RepositoriesService) Create(ctx context.Context, org string, repo *Repository) (*Repository, *Response, error) {

var u string

if org != "" {

u = fmt.Sprintf("orgs/%v/repos", org)

} else {

u = "user/repos"

}

repoReq := &createRepoRequest{

Name: repo.Name,

Description: repo.Description,

Homepage: repo.Homepage,

Private: repo.Private,

Visibility: repo.Visibility,

HasIssues: repo.HasIssues,

HasProjects: repo.HasProjects,

HasWiki: repo.HasWiki,

HasDiscussions: repo.HasDiscussions,

IsTemplate: repo.IsTemplate,

TeamID: repo.TeamID,

AutoInit: repo.AutoInit,

GitignoreTemplate: repo.GitignoreTemplate,

LicenseTemplate: repo.LicenseTemplate,

AllowSquashMerge: repo.AllowSquashMerge,

AllowMergeCommit: repo.AllowMergeCommit,

AllowRebaseMerge: repo.AllowRebaseMerge,

AllowUpdateBranch: repo.AllowUpdateBranch,

AllowAutoMerge: repo.AllowAutoMerge,

AllowForking: repo.AllowForking,

DeleteBranchOnMerge: repo.DeleteBranchOnMerge,

UseSquashPRTitleAsDefault: repo.UseSquashPRTitleAsDefault,

SquashMergeCommitTitle: repo.SquashMergeCommitTitle,

SquashMergeCommitMessage: repo.SquashMergeCommitMessage,

MergeCommitTitle: repo.MergeCommitTitle,

MergeCommitMessage: repo.MergeCommitMessage,

}

req, err := s.client.NewRequest("POST", u, repoReq)

if err != nil {

return nil, nil, err

}

acceptHeaders := []string{mediaTypeRepositoryTemplatePreview, mediaTypeRepositoryVisibilityPreview}

req.Header.Set("Accept", strings.Join(acceptHeaders, ", "))

r := new(Repository)

resp, err := s.client.Do(ctx, req, r)

if err != nil {

return nil, resp, err

}

return r, resp, nil

}

// TemplateRepoRequest represents a request to create a repository from a template.

type TemplateRepoRequest struct {

// Name is required when creating a repo.

Name *string `json:"name,omitempty"`

Owner *string `json:"owner,omitempty"`

Description *string `json:"description,omitempty"`

IncludeAllBranches *bool `json:"include_all_branches,omitempty"`

Private *bool `json:"private,omitempty"`

}

// CreateFromTemplate generates a repository from a template.

//

// GitHub API docs: https://docs.github.com/rest/repos/repos#create-a-repository-using-a-template

//

//meta:operation POST /repos/{template_owner}/{template_repo}/generate

func (s *RepositoriesService) CreateFromTemplate(ctx context.Context, templateOwner, templateRepo string, templateRepoReq *TemplateRepoRequest) (*Repository, *Response, error) {

u := fmt.Sprintf("repos/%v/%v/generate", templateOwner, templateRepo)

req, err := s.client.NewRequest("POST", u, templateRepoReq)

if err != nil {

return nil, nil, err

}

req.Header.Set("Accept", mediaTypeRepositoryTemplatePreview)

r := new(Repository)

resp, err := s.client.Do(ctx, req, r)

if err != nil {

return nil, resp, err

}

return r, resp, nil

}

// Get fetches a repository.

//

// GitHub API docs: https://docs.github.com/rest/repos/repos#get-a-repository

//

//meta:operation GET /repos/{owner}/{repo}

func (s *RepositoriesService) Get(ctx context.Context, owner, repo string) (*Repository, *Response, error) {

u := fmt.Sprintf("repos/%v/%v", owner, repo)

req, err := s.client.NewRequest("GET", u, nil)

if err != nil {

return nil, nil, err

}

// TODO: remove custom Accept header when the license support fully launches

// https://docs.github.com/rest/licenses/#get-a-repositorys-license

acceptHeaders := []string{

mediaTypeCodesOfConductPreview,

mediaTypeTopicsPreview,

mediaTypeRepositoryTemplatePreview,

mediaTypeRepositoryVisibilityPreview,

}

req.Header.Set("Accept", strings.Join(acceptHeaders, ", "))

repository := new(Repository)

resp, err := s.client.Do(ctx, req, repository)

if err != nil {

return nil, resp, err

}

return repository, resp, nil

}

// GetCodeOfConduct gets the contents of a repository's code of conduct.

// Note that https://docs.github.com/rest/codes-of-conduct#about-the-codes-of-conduct-api

// says to use the GET /repos/{owner}/{repo} endpoint.

//

// GitHub API docs: https://docs.github.com/rest/repos/repos#get-a-repository

//

//meta:operation GET /repos/{owner}/{repo}

func (s *RepositoriesService) GetCodeOfConduct(ctx context.Context, owner, repo string) (*CodeOfConduct, *Response, error) {

u := fmt.Sprintf("repos/%v/%v", owner, repo)

req, err := s.client.NewRequest("GET", u, nil)

if err != nil {

return nil, nil, err

}

// TODO: remove custom Accept header when this API fully launches.

req.Header.Set("Accept", mediaTypeCodesOfConductPreview)

r := new(Repository)

resp, err := s.client.Do(ctx, req, r)

if err != nil {

return nil, resp, err

}

return r.GetCodeOfConduct(), resp, nil

}

// GetByID fetches a repository.

//

// Note: GetByID uses the undocumented GitHub API endpoint "GET /repositories/{repository_id}".

//

//meta:operation GET /repositories/{repository_id}

func (s *RepositoriesService) GetByID(ctx context.Context, id int64) (*Repository, *Response, error) {

u := fmt.Sprintf("repositories/%d", id)

req, err := s.client.NewRequest("GET", u, nil)

if err != nil {

return nil, nil, err

}

repository := new(Repository)

resp, err := s.client.Do(ctx, req, repository)

if err != nil {

return nil, resp, err

}

return repository, resp, nil

}

// Edit updates a repository.

//

// GitHub API docs: https://docs.github.com/rest/repos/repos#update-a-repository

//

//meta:operation PATCH /repos/{owner}/{repo}

func (s *RepositoriesService) Edit(ctx context.Context, owner, repo string, repository *Repository) (*Repository, *Response, error) {

u := fmt.Sprintf("repos/%v/%v", owner, repo)

req, err := s.client.NewRequest("PATCH", u, repository)

if err != nil {

return nil, nil, err

}

acceptHeaders := []string{mediaTypeRepositoryTemplatePreview, mediaTypeRepositoryVisibilityPreview}

req.Header.Set("Accept", strings.Join(acceptHeaders, ", "))

r := new(Repository)

resp, err := s.client.Do(ctx, req, r)

if err != nil {

return nil, resp, err

}

return r, resp, nil

}

// Delete a repository.

//

// GitHub API docs: https://docs.github.com/rest/repos/repos#delete-a-repository

//

//meta:operation DELETE /repos/{owner}/{repo}

func (s *RepositoriesService) Delete(ctx context.Context, owner, repo string) (*Response, error) {

u := fmt.Sprintf("repos/%v/%v", owner, repo)

req, err := s.client.NewRequest("DELETE", u, nil)

if err != nil {

return nil, err

}

return s.client.Do(ctx, req, nil)

}

// Contributor represents a repository contributor.

type Contributor struct {

Login *string `json:"login,omitempty"`

ID *int64 `json:"id,omitempty"`

NodeID *string `json:"node_id,omitempty"`

AvatarURL *string `json:"avatar_url,omitempty"`

GravatarID *string `json:"gravatar_id,omitempty"`

URL *string `json:"url,omitempty"`

HTMLURL *string `json:"html_url,omitempty"`

FollowersURL *string `json:"followers_url,omitempty"`

FollowingURL *string `json:"following_url,omitempty"`

GistsURL *string `json:"gists_url,omitempty"`

StarredURL *string `json:"starred_url,omitempty"`

SubscriptionsURL *string `json:"subscriptions_url,omitempty"`

OrganizationsURL *string `json:"organizations_url,omitempty"`

ReposURL *string `json:"repos_url,omitempty"`

EventsURL *string `json:"events_url,omitempty"`

ReceivedEventsURL *string `json:"received_events_url,omitempty"`

Type *string `json:"type,omitempty"`

SiteAdmin *bool `json:"site_admin,omitempty"`

Contributions *int `json:"contributions,omitempty"`

Name *string `json:"name,omitempty"`

Email *string `json:"email,omitempty"`

}

// ListContributorsOptions specifies the optional parameters to the

// RepositoriesService.ListContributors method.

type ListContributorsOptions struct {

// Include anonymous contributors in results or not

Anon string `url:"anon,omitempty"`

ListOptions

}

// GetVulnerabilityAlerts checks if vulnerability alerts are enabled for a repository.

//

// GitHub API docs: https://docs.github.com/rest/repos/repos#check-if-vulnerability-alerts-are-enabled-for-a-repository

//

//meta:operation GET /repos/{owner}/{repo}/vulnerability-alerts

func (s *RepositoriesService) GetVulnerabilityAlerts(ctx context.Context, owner, repository string) (bool, *Response, error) {

u := fmt.Sprintf("repos/%v/%v/vulnerability-alerts", owner, repository)

req, err := s.client.NewRequest("GET", u, nil)

if err != nil {

return false, nil, err

}

// TODO: remove custom Accept header when this API fully launches

req.Header.Set("Accept", mediaTypeRequiredVulnerabilityAlertsPreview)

resp, err := s.client.Do(ctx, req, nil)

vulnerabilityAlertsEnabled, err := parseBoolResponse(err)

return vulnerabilityAlertsEnabled, resp, err

}

// EnableVulnerabilityAlerts enables vulnerability alerts and the dependency graph for a repository.

//

// GitHub API docs: https://docs.github.com/rest/repos/repos#enable-vulnerability-alerts

//

//meta:operation PUT /repos/{owner}/{repo}/vulnerability-alerts

func (s *RepositoriesService) EnableVulnerabilityAlerts(ctx context.Context, owner, repository string) (*Response, error) {

u := fmt.Sprintf("repos/%v/%v/vulnerability-alerts", owner, repository)

req, err := s.client.NewRequest("PUT", u, nil)

if err != nil {

return nil, err

}

// TODO: remove custom Accept header when this API fully launches

req.Header.Set("Accept", mediaTypeRequiredVulnerabilityAlertsPreview)

return s.client.Do(ctx, req, nil)

}

// DisableVulnerabilityAlerts disables vulnerability alerts and the dependency graph for a repository.

//

// GitHub API docs: https://docs.github.com/rest/repos/repos#disable-vulnerability-alerts

//

//meta:operation DELETE /repos/{owner}/{repo}/vulnerability-alerts

func (s *RepositoriesService) DisableVulnerabilityAlerts(ctx context.Context, owner, repository string) (*Response, error) {

u := fmt.Sprintf("repos/%v/%v/vulnerability-alerts", owner, repository)

req, err := s.client.NewRequest("DELETE", u, nil)

if err != nil {

return nil, err

}

// TODO: remove custom Accept header when this API fully launches

req.Header.Set("Accept", mediaTypeRequiredVulnerabilityAlertsPreview)

return s.client.Do(ctx, req, nil)

}

// GetAutomatedSecurityFixes checks if the automated security fixes for a repository are enabled.

//

// GitHub API docs: https://docs.github.com/rest/repos/repos#check-if-automated-security-fixes-are-enabled-for-a-repository

//

//meta:operation GET /repos/{owner}/{repo}/automated-security-fixes

func (s *RepositoriesService) GetAutomatedSecurityFixes(ctx context.Context, owner, repository string) (*AutomatedSecurityFixes, *Response, error) {

u := fmt.Sprintf("repos/%v/%v/automated-security-fixes", owner, repository)

req, err := s.client.NewRequest("GET", u, nil)

if err != nil {

return nil, nil, err

}

p := new(AutomatedSecurityFixes)

resp, err := s.client.Do(ctx, req, p)

if err != nil {

return nil, resp, err

}

return p, resp, nil

}

// EnableAutomatedSecurityFixes enables the automated security fixes for a repository.

//

// GitHub API docs: https://docs.github.com/rest/repos/repos#enable-automated-security-fixes

//

//meta:operation PUT /repos/{owner}/{repo}/automated-security-fixes

func (s *RepositoriesService) EnableAutomatedSecurityFixes(ctx context.Context, owner, repository string) (*Response, error) {

u := fmt.Sprintf("repos/%v/%v/automated-security-fixes", owner, repository)

req, err := s.client.NewRequest("PUT", u, nil)

if err != nil {

return nil, err

}

return s.client.Do(ctx, req, nil)

}

// DisableAutomatedSecurityFixes disables vulnerability alerts and the dependency graph for a repository.

//

// GitHub API docs: https://docs.github.com/rest/repos/repos#disable-automated-security-fixes

//

//meta:operation DELETE /repos/{owner}/{repo}/automated-security-fixes

func (s *RepositoriesService) DisableAutomatedSecurityFixes(ctx context.Context, owner, repository string) (*Response, error) {

u := fmt.Sprintf("repos/%v/%v/automated-security-fixes", owner, repository)

req, err := s.client.NewRequest("DELETE", u, nil)

if err != nil {

return nil, err

}

return s.client.Do(ctx, req, nil)

}

// ListContributors lists contributors for a repository.

//

// GitHub API docs: https://docs.github.com/rest/repos/repos#list-repository-contributors

//

//meta:operation GET /repos/{owner}/{repo}/contributors

func (s *RepositoriesService) ListContributors(ctx context.Context, owner string, repository string, opts *ListContributorsOptions) ([]*Contributor, *Response, error) {

u := fmt.Sprintf("repos/%v/%v/contributors", owner, repository)

u, err := addOptions(u, opts)

if err != nil {

return nil, nil, err

}

req, err := s.client.NewRequest("GET", u, nil)

if err != nil {

return nil, nil, err

}

var contributor []*Contributor

resp, err := s.client.Do(ctx, req, &contributor)

if err != nil {

return nil, resp, err

}

return contributor, resp, nil

}

// ListLanguages lists languages for the specified repository. The returned map

// specifies the languages and the number of bytes of code written in that

// language. For example:

//

// {

// "C": 78769,

// "Python": 7769

// }

//

// GitHub API docs: https://docs.github.com/rest/repos/repos#list-repository-languages

//

//meta:operation GET /repos/{owner}/{repo}/languages

func (s *RepositoriesService) ListLanguages(ctx context.Context, owner string, repo string) (map[string]int, *Response, error) {

u := fmt.Sprintf("repos/%v/%v/languages", owner, repo)

req, err := s.client.NewRequest("GET", u, nil)

if err != nil {

return nil, nil, err

}

languages := make(map[string]int)

resp, err := s.client.Do(ctx, req, &languages)

if err != nil {

return nil, resp, err

}

return languages, resp, nil

}

// ListTeams lists the teams for the specified repository.

//

// GitHub API docs: https://docs.github.com/rest/repos/repos#list-repository-teams

//

//meta:operation GET /repos/{owner}/{repo}/teams

func (s *RepositoriesService) ListTeams(ctx context.Context, owner string, repo string, opts *ListOptions) ([]*Team, *Response, error) {

u := fmt.Sprintf("repos/%v/%v/teams", owner, repo)

u, err := addOptions(u, opts)

if err != nil {

return nil, nil, err

}

req, err := s.client.NewRequest("GET", u, nil)

if err != nil {

return nil, nil, err

}

var teams []*Team

resp, err := s.client.Do(ctx, req, &teams)

if err != nil {

return nil, resp, err

}

return teams, resp, nil

}

// RepositoryTag represents a repository tag.

type RepositoryTag struct {

Name *string `json:"name,omitempty"`

Commit *Commit `json:"commit,omitempty"`

ZipballURL *string `json:"zipball_url,omitempty"`

TarballURL *string `json:"tarball_url,omitempty"`

}

// ListTags lists tags for the specified repository.

//

// GitHub API docs: https://docs.github.com/rest/repos/repos#list-repository-tags

//

//meta:operation GET /repos/{owner}/{repo}/tags

func (s *RepositoriesService) ListTags(ctx context.Context, owner string, repo string, opts *ListOptions) ([]*RepositoryTag, *Response, error) {

u := fmt.Sprintf("repos/%v/%v/tags", owner, repo)

u, err := addOptions(u, opts)

if err != nil {

return nil, nil, err

}

req, err := s.client.NewRequest("GET", u, nil)

if err != nil {

return nil, nil, err

}

var tags []*RepositoryTag

resp, err := s.client.Do(ctx, req, &tags)

if err != nil {

return nil, resp, err

}

return tags, resp, nil

}