Module: Octokit::Client::Repositories
- Included in:
- Octokit::Client
- Defined in:
- lib/octokit/client/repositories.rb
Overview
Methods for the Repositories API
Instance Method Summary collapse
-
#add_collaborator(repo, collaborator, options = {}) ⇒ Boolean
(also: #add_collab)
Add collaborator to repo.
-
#add_deploy_key(repo, title, key, options = {}) ⇒ Sawyer::Resource
Add deploy key to a repo.
-
#all_repositories(options = {}) ⇒ Array<Sawyer::Resource>
List all repositories.
-
#branch(repo, branch, options = {}) ⇒ Sawyer::Resource
(also: #get_branch)
Get a single branch from a repository.
-
#branch_protection(repo, branch, options = {}) ⇒ Sawyer::Resource?
Get branch protection summary.
-
#branches(repo, options = {}) ⇒ Array<Sawyer::Resource>
List branches.
-
#check_assignee(repo, assignee, options = {}) ⇒ Boolean
Check to see if a particular user is an assignee for a repository.
-
#collaborator?(repo, collaborator, options = {}) ⇒ Boolean
Checks if a user is a collaborator for a repo.
-
#collaborators(repo, options = {}) ⇒ Array<Sawyer::Resource>
(also: #collabs)
List collaborators.
-
#contributors(repo, anon = nil, options = {}) ⇒ Array<Sawyer::Resource>
(also: #contribs)
List contributors to a repo.
-
#create_repository(name, options = {}) ⇒ Sawyer::Resource
(also: #create_repo, #create)
Create a repository for a user or organization.
-
#create_repository_from_template(repo, name, options = {}) ⇒ Sawyer::Resource
(also: #create_repo_from_template)
Create a repository for a user or organization generated from a template repository.
-
#delete_repository(repo, options = {}) ⇒ Boolean
(also: #delete_repo)
Delete repository.
-
#delete_subscription(repo, options = {}) ⇒ Boolean
Delete a repository subscription.
-
#deploy_key(repo, id, options = {}) ⇒ Sawyer::Resource
Get a single deploy key for a repo.
-
#deploy_keys(repo, options = {}) ⇒ Array<Sawyer::Resource>
(also: #list_deploy_keys)
Get deploy keys on a repo.
-
#edit_deploy_key(repo, id, options) ⇒ Sawyer::Resource
(also: #update_deploy_key)
deprecated
Deprecated.
This method is no longer supported in the API
-
#edit_repository(repo, options = {}) ⇒ Sawyer::Resource
(also: #edit, #update_repository, #update)
Edit a repository.
-
#fork(repo, options = {}) ⇒ Sawyer::Resource
Fork a repository.
-
#forks(repo, options = {}) ⇒ Array<Sawyer::Resource>
(also: #network)
List forks.
-
#languages(repo, options = {}) ⇒ Array<Sawyer::Resource>
List languages of code in the repo.
-
#permission_level(repo, collaborator, options = {}) ⇒ Sawyer::Resource
Get a user’s permission level for a repo.
-
#protect_branch(repo, branch, options = {}) ⇒ Sawyer::Resource
Lock a single branch from a repository.
-
#remove_collaborator(repo, collaborator, options = {}) ⇒ Boolean
(also: #remove_collab)
Remove collaborator from repo.
-
#remove_deploy_key(repo, id, options = {}) ⇒ Boolean
Remove deploy key from a repo.
-
#replace_all_topics(repo, names, options = {}) ⇒ Sawyer::Resource
Replace all topics for a repository.
-
#repositories(user = nil, options = {}) ⇒ Array<Sawyer::Resource>
(also: #list_repositories, #list_repos, #repos)
List user repositories.
-
#repository(repo, options = {}) ⇒ Sawyer::Resource
(also: #repo)
Get a single repository.
-
#repository?(repo, options = {}) ⇒ Boolean
Check if a repository exists.
-
#repository_assignees(repo, options = {}) ⇒ Array<Sawyer::Resource>
(also: #repo_assignees)
List users available for assigning to issues.
-
#repository_teams(repo, options = {}) ⇒ Array<Sawyer::Resource>
(also: #repo_teams, #teams)
List teams for a repo.
-
#set_private(repo, options = {}) ⇒ Sawyer::Resource
Hide a public repository.
-
#set_public(repo, options = {}) ⇒ Sawyer::Resource
Unhide a private repository.
-
#star(repo, options = {}) ⇒ Boolean
Star a repository.
-
#stargazers(repo, options = {}) ⇒ Array<Sawyer::Resource>
List stargazers of a repo.
-
#subscribers(repo, options = {}) ⇒ Array<Sawyer::Resource>
List watchers subscribing to notifications for a repo.
-
#subscription(repo, options = {}) ⇒ Sawyer::Resource
Get a repository subscription.
-
#tags(repo, options = {}) ⇒ Array<Sawyer::Resource>
List tags.
-
#topics(repo, options = {}) ⇒ Sawyer::Resource
List all topics for a repository.
-
#transfer_repository(repo, new_owner, options = {}) ⇒ Sawyer::Resource
(also: #transfer_repo)
Transfer repository.
-
#unprotect_branch(repo, branch, options = {}) ⇒ Sawyer::Resource
Unlock a single branch from a repository.
-
#unstar(repo, options = {}) ⇒ Boolean
Unstar a repository.
-
#unwatch(repo, options = {}) ⇒ Boolean
deprecated
Deprecated.
Use #unstar instead
-
#update_subscription(repo, options = {}) ⇒ Sawyer::Resource
Update repository subscription.
-
#watch(repo, options = {}) ⇒ Boolean
deprecated
Deprecated.
Use #star instead
-
#watchers(repo, options = {}) ⇒ Array<Sawyer::Resource>
deprecated
Deprecated.
Use #stargazers instead
Instance Method Details
#add_collaborator(repo, collaborator, options = {}) ⇒ Boolean Also known as: add_collab
Add collaborator to repo
This can also be used to update the permission of an existing collaborator
Requires authenticated client.
355 356 357 |
# File 'lib/octokit/client/repositories.rb', line 355 def add_collaborator(repo, collaborator, = {}) boolean_from_response :put, "#{Repository.path repo}/collaborators/#{collaborator}", end |
#add_deploy_key(repo, title, key, options = {}) ⇒ Sawyer::Resource
Add deploy key to a repo
Requires authenticated client.
276 277 278 |
# File 'lib/octokit/client/repositories.rb', line 276 def add_deploy_key(repo, title, key, = {}) post "#{Repository.path repo}/keys", .merge(:title => title, :key => key) end |
#all_repositories(options = {}) ⇒ Array<Sawyer::Resource>
List all repositories
This provides a dump of every repository, in the order that they were created.
92 93 94 |
# File 'lib/octokit/client/repositories.rb', line 92 def all_repositories( = {}) paginate 'repositories', end |
#branch(repo, branch, options = {}) ⇒ Sawyer::Resource Also known as: get_branch
Get a single branch from a repository
578 579 580 |
# File 'lib/octokit/client/repositories.rb', line 578 def branch(repo, branch, = {}) get "#{Repository.path repo}/branches/#{branch}", end |
#branch_protection(repo, branch, options = {}) ⇒ Sawyer::Resource?
Get branch protection summary
619 620 621 622 623 624 625 626 |
# File 'lib/octokit/client/repositories.rb', line 619 def branch_protection(repo, branch, = {}) opts = ensure_api_media_type(:branch_protection, ) begin get "#{Repository.path repo}/branches/#{branch}/protection", opts rescue Octokit::BranchNotProtected nil end end |
#branches(repo, options = {}) ⇒ Array<Sawyer::Resource>
List branches
Requires authenticated client for private repos.
566 567 568 |
# File 'lib/octokit/client/repositories.rb', line 566 def branches(repo, = {}) paginate "#{Repository.path repo}/branches", end |
#check_assignee(repo, assignee, options = {}) ⇒ Boolean
Check to see if a particular user is an assignee for a repository.
669 670 671 |
# File 'lib/octokit/client/repositories.rb', line 669 def check_assignee(repo, assignee, = {}) boolean_from_response :get, "#{Repository.path repo}/assignees/#{assignee}", end |
#collaborator?(repo, collaborator, options = {}) ⇒ Boolean
Checks if a user is a collaborator for a repo.
Requires authenticated client.
387 388 389 |
# File 'lib/octokit/client/repositories.rb', line 387 def collaborator?(repo, collaborator, ={}) boolean_from_response :get, "#{Repository.path repo}/collaborators/#{collaborator}", end |
#collaborators(repo, options = {}) ⇒ Array<Sawyer::Resource> Also known as: collabs
List collaborators
Requires authenticated client for private repos.
330 331 332 |
# File 'lib/octokit/client/repositories.rb', line 330 def collaborators(repo, = {}) paginate "#{Repository.path repo}/collaborators", end |
#contributors(repo, anon = nil, options = {}) ⇒ Array<Sawyer::Resource> Also known as: contribs
List contributors to a repo
Requires authenticated client for private repos.
469 470 471 472 |
# File 'lib/octokit/client/repositories.rb', line 469 def contributors(repo, anon = nil, = {}) [:anon] = 1 if anon.to_s[/1|true/] paginate "#{Repository.path repo}/contributors", end |
#create_repository(name, options = {}) ⇒ Sawyer::Resource Also known as: create_repo, create
Create a repository for a user or organization
159 160 161 162 163 164 165 166 167 168 169 170 171 172 |
# File 'lib/octokit/client/repositories.rb', line 159 def create_repository(name, = {}) opts = .dup organization = opts.delete :organization opts.merge! :name => name if opts.include? :is_template opts = ensure_api_media_type(:template_repositories, opts) end if organization.nil? post 'user/repos', opts else post "#{Organization.path organization}/repos", opts end end |
#create_repository_from_template(repo, name, options = {}) ⇒ Sawyer::Resource Also known as: create_repo_from_template
Create a repository for a user or organization generated from a template repository
212 213 214 215 216 |
# File 'lib/octokit/client/repositories.rb', line 212 def create_repository_from_template(repo, name, = {}) .merge! :name => name = ensure_api_media_type(:template_repositories, ) post "#{Repository.path repo}/generate", end |
#delete_repository(repo, options = {}) ⇒ Boolean Also known as: delete_repo
Delete repository
Note: If OAuth is used, ‘delete_repo’ scope is required
183 184 185 |
# File 'lib/octokit/client/repositories.rb', line 183 def delete_repository(repo, = {}) boolean_from_response :delete, Repository.path(repo), end |
#delete_subscription(repo, options = {}) ⇒ Boolean
Delete a repository subscription
720 721 722 |
# File 'lib/octokit/client/repositories.rb', line 720 def delete_subscription(repo, = {}) boolean_from_response :delete, "#{Repository.path repo}/subscription", end |
#deploy_key(repo, id, options = {}) ⇒ Sawyer::Resource
Get a single deploy key for a repo
261 262 263 |
# File 'lib/octokit/client/repositories.rb', line 261 def deploy_key(repo, id, ={}) get "#{Repository.path repo}/keys/#{id}", end |
#deploy_keys(repo, options = {}) ⇒ Array<Sawyer::Resource> Also known as: list_deploy_keys
Get deploy keys on a repo
Requires authenticated client.
248 249 250 |
# File 'lib/octokit/client/repositories.rb', line 248 def deploy_keys(repo, = {}) paginate "#{Repository.path repo}/keys", end |
#edit_deploy_key(repo, id, options) ⇒ Sawyer::Resource Also known as: update_deploy_key
This method is no longer supported in the API
Edit a deploy key
295 296 297 |
# File 'lib/octokit/client/repositories.rb', line 295 def edit_deploy_key(repo, id, ) patch "#{Repository.path repo}/keys/#{id}", end |
#edit_repository(repo, options = {}) ⇒ Sawyer::Resource Also known as: edit, update_repository, update
Edit a repository
48 49 50 51 52 53 54 55 |
# File 'lib/octokit/client/repositories.rb', line 48 def edit_repository(repo, = {}) repo = Repository.new(repo) if .include? :is_template = ensure_api_media_type(:template_repositories, ) end [:name] ||= repo.name patch "repos/#{repo}", end |
#fork(repo, options = {}) ⇒ Sawyer::Resource
Fork a repository
139 140 141 |
# File 'lib/octokit/client/repositories.rb', line 139 def fork(repo, = {}) post "#{Repository.path repo}/forks", end |
#forks(repo, options = {}) ⇒ Array<Sawyer::Resource> Also known as: network
List forks
Requires authenticated client for private repos.
520 521 522 |
# File 'lib/octokit/client/repositories.rb', line 520 def forks(repo, = {}) paginate "#{Repository.path repo}/forks", end |
#languages(repo, options = {}) ⇒ Array<Sawyer::Resource>
List languages of code in the repo.
Requires authenticated client for private repos.
536 537 538 |
# File 'lib/octokit/client/repositories.rb', line 536 def languages(repo, = {}) paginate "#{Repository.path repo}/languages", end |
#permission_level(repo, collaborator, options = {}) ⇒ Sawyer::Resource
Get a user’s permission level for a repo.
Requires authenticated client
399 400 401 |
# File 'lib/octokit/client/repositories.rb', line 399 def (repo, collaborator, ={}) get "#{Repository.path repo}/collaborators/#{collaborator}/permission", end |
#protect_branch(repo, branch, options = {}) ⇒ Sawyer::Resource
Lock a single branch from a repository
Requires authenticated client
603 604 605 606 607 608 |
# File 'lib/octokit/client/repositories.rb', line 603 def protect_branch(repo, branch, = {}) opts = ensure_api_media_type(:branch_protection, ) opts[:restrictions] ||= nil opts[:required_status_checks] ||= nil put "#{Repository.path repo}/branches/#{branch}/protection", opts end |
#remove_collaborator(repo, collaborator, options = {}) ⇒ Boolean Also known as: remove_collab
Remove collaborator from repo.
Requires authenticated client.
372 373 374 |
# File 'lib/octokit/client/repositories.rb', line 372 def remove_collaborator(repo, collaborator, = {}) boolean_from_response :delete, "#{Repository.path repo}/collaborators/#{collaborator}", end |
#remove_deploy_key(repo, id, options = {}) ⇒ Boolean
Remove deploy key from a repo
Requires authenticated client.
310 311 312 |
# File 'lib/octokit/client/repositories.rb', line 310 def remove_deploy_key(repo, id, = {}) boolean_from_response :delete, "#{Repository.path repo}/keys/#{id}", end |
#replace_all_topics(repo, names, options = {}) ⇒ Sawyer::Resource
Replace all topics for a repository
Requires authenticated client.
450 451 452 453 |
# File 'lib/octokit/client/repositories.rb', line 450 def replace_all_topics(repo, names, = {}) opts = ensure_api_media_type(:topics, ) put "#{Repository.path repo}/topics", opts.merge(:names => names) end |
#repositories(user = nil, options = {}) ⇒ Array<Sawyer::Resource> Also known as: list_repositories, list_repos, repos
If the user provided is a GitHub organization, only the organization’s public repositories will be listed. For retrieving organization repositories the Organizations#organization_repositories method should be used instead.
List user repositories
If user is not supplied, repositories for the current
authenticated user are returned.
74 75 76 |
# File 'lib/octokit/client/repositories.rb', line 74 def repositories(user=nil, = {}) paginate "#{User.path user}/repos", end |
#repository(repo, options = {}) ⇒ Sawyer::Resource Also known as: repo
Get a single repository
28 29 30 |
# File 'lib/octokit/client/repositories.rb', line 28 def repository(repo, = {}) get Repository.path(repo), end |
#repository?(repo, options = {}) ⇒ Boolean
Check if a repository exists
14 15 16 17 18 19 20 |
# File 'lib/octokit/client/repositories.rb', line 14 def repository?(repo, = {}) !!repository(repo, ) rescue Octokit::InvalidRepository false rescue Octokit::NotFound false end |
#repository_assignees(repo, options = {}) ⇒ Array<Sawyer::Resource> Also known as: repo_assignees
List users available for assigning to issues.
Requires authenticated client for private repos.
656 657 658 |
# File 'lib/octokit/client/repositories.rb', line 656 def repository_assignees(repo, = {}) paginate "#{Repository.path repo}/assignees", end |
#repository_teams(repo, options = {}) ⇒ Array<Sawyer::Resource> Also known as: repo_teams, teams
List teams for a repo
Requires authenticated client that is an owner or collaborator of the repo.
416 417 418 |
# File 'lib/octokit/client/repositories.rb', line 416 def repository_teams(repo, = {}) paginate "#{Repository.path repo}/teams", end |
#set_private(repo, options = {}) ⇒ Sawyer::Resource
Hide a public repository
223 224 225 226 |
# File 'lib/octokit/client/repositories.rb', line 223 def set_private(repo, = {}) # GitHub Api for setting private updated to use private attr, rather than public update_repository repo, .merge({ :private => true }) end |
#set_public(repo, options = {}) ⇒ Sawyer::Resource
Unhide a private repository
232 233 234 235 |
# File 'lib/octokit/client/repositories.rb', line 232 def set_public(repo, = {}) # GitHub Api for setting private updated to use private attr, rather than public update_repository repo, .merge({ :private => false }) end |
#star(repo, options = {}) ⇒ Boolean
Star a repository
101 102 103 |
# File 'lib/octokit/client/repositories.rb', line 101 def star(repo, = {}) boolean_from_response :put, "user/starred/#{Repository.new(repo)}", end |
#stargazers(repo, options = {}) ⇒ Array<Sawyer::Resource>
List stargazers of a repo
Requires authenticated client for private repos.
486 487 488 |
# File 'lib/octokit/client/repositories.rb', line 486 def stargazers(repo, = {}) paginate "#{Repository.path repo}/stargazers", end |
#subscribers(repo, options = {}) ⇒ Array<Sawyer::Resource>
List watchers subscribing to notifications for a repo
680 681 682 |
# File 'lib/octokit/client/repositories.rb', line 680 def subscribers(repo, = {}) paginate "#{Repository.path repo}/subscribers", end |
#subscription(repo, options = {}) ⇒ Sawyer::Resource
Get a repository subscription
691 692 693 |
# File 'lib/octokit/client/repositories.rb', line 691 def subscription(repo, = {}) get "#{Repository.path repo}/subscription", end |
#tags(repo, options = {}) ⇒ Array<Sawyer::Resource>
List tags
Requires authenticated client for private repos.
551 552 553 |
# File 'lib/octokit/client/repositories.rb', line 551 def (repo, = {}) paginate "#{Repository.path repo}/tags", end |
#topics(repo, options = {}) ⇒ Sawyer::Resource
List all topics for a repository
Requires authenticated client for private repos.
433 434 435 436 |
# File 'lib/octokit/client/repositories.rb', line 433 def topics(repo, = {}) opts = ensure_api_media_type(:topics, ) paginate "#{Repository.path repo}/topics", opts end |
#transfer_repository(repo, new_owner, options = {}) ⇒ Sawyer::Resource Also known as: transfer_repo
Transfer repository
Transfer a repository owned by your organization
197 198 199 200 |
# File 'lib/octokit/client/repositories.rb', line 197 def transfer_repository(repo, new_owner, = {}) = ensure_api_media_type(:transfer_repository, ) post "#{Repository.path repo}/transfer", .merge({ new_owner: new_owner }) end |
#unprotect_branch(repo, branch, options = {}) ⇒ Sawyer::Resource
Unlock a single branch from a repository
Requires authenticated client
638 639 640 641 |
# File 'lib/octokit/client/repositories.rb', line 638 def unprotect_branch(repo, branch, = {}) opts = ensure_api_media_type(:branch_protection, ) boolean_from_response :delete, "#{Repository.path repo}/branches/#{branch}/protection", opts end |
#unstar(repo, options = {}) ⇒ Boolean
Unstar a repository
110 111 112 |
# File 'lib/octokit/client/repositories.rb', line 110 def unstar(repo, = {}) boolean_from_response :delete, "user/starred/#{Repository.new(repo)}", end |
#unwatch(repo, options = {}) ⇒ Boolean
Use #unstar instead
Unwatch a repository
130 131 132 |
# File 'lib/octokit/client/repositories.rb', line 130 def unwatch(repo, = {}) boolean_from_response :delete, "user/watched/#{Repository.new(repo)}", end |
#update_subscription(repo, options = {}) ⇒ Sawyer::Resource
Update repository subscription
708 709 710 |
# File 'lib/octokit/client/repositories.rb', line 708 def update_subscription(repo, = {}) put "#{Repository.path repo}/subscription", end |
#watch(repo, options = {}) ⇒ Boolean
Use #star instead
Watch a repository
120 121 122 |
# File 'lib/octokit/client/repositories.rb', line 120 def watch(repo, = {}) boolean_from_response :put, "user/watched/#{Repository.new(repo)}", end |
#watchers(repo, options = {}) ⇒ Array<Sawyer::Resource>
Use #stargazers instead
List watchers of repo.
Requires authenticated client for private repos.
503 504 505 |
# File 'lib/octokit/client/repositories.rb', line 503 def watchers(repo, = {}) paginate "#{Repository.path repo}/watchers", end |