# encoding: utf-8
module Github
class Repos < API
extend AutoloadHelper
# Load all the modules after initializing Repos to avoid superclass mismatch
autoload_all 'github_api/repos',
:Collaborators => 'collaborators',
:Commits => 'commits',
:Downloads => 'downloads',
:Forks => 'forks',
:Hooks => 'hooks',
:Keys => 'keys',
:Watching => 'watching',
:PubSubHubbub => 'pub_sub_hubbub'
include Github::Repos::Collaborators
include Github::Repos::Commits
include Github::Repos::Downloads
include Github::Repos::Forks
include Github::Repos::Hooks
include Github::Repos::Keys
include Github::Repos::Watching
include Github::Repos::PubSubHubbub
DEFAULT_REPO_OPTIONS = {
"homepage" => "https://github.com",
"private" => false,
"has_issues" => true,
"has_wiki" => true,
"has_downloads" => true
}.freeze
VALID_REPO_OPTIONS = %w[
name
description
homepage
private
has_issues
has_wiki
has_downloads
].freeze
VALID_REPO_TYPES = %w[ all public private member ].freeze
# Creates new Repositories API
def initialize(options = {})
super(options)
end
# List branches
#
# = Examples
#
# @github = Github.new
# @github.repos.branches 'user-name', 'repo-name'
#
# @repos = Github::Repos.new
# @repos.branches 'user-name', 'repo-name'
#
def branches(user_name, repo_name, params={})
_update_user_repo_params(user_name, repo_name)
_validate_user_repo_params(user, repo) unless (user? && repo?)
_normalize_params_keys(params)
response = get("/repos/#{user}/#{repo}/branches", params)
return response unless block_given?
response.each { |el| yield el }
end
alias :list_branches :branches
# Create a new repository for the autheticated user.
#
# = Parameters
# :name - Required string
# :description - Optional string
# :homepage - Optional string
# :private - Optional boolean - false to create public reps, false to create a private one
# :has_issues - Optional boolean - true to enable issues for this repository, false to disable them
# :has_wiki - Optional boolean - true to enable the wiki for this repository, false to disable it. Default is true
# :has_downloads Optional boolean - true to enable downloads for this repository
#
# = Examples
# @github = Github.new
# @github.repos.create_repo "name" => 'repo-name'
# "description": "This is your first repo",
# "homepage": "https://github.com",
# "private": false,
# "has_issues": true,
# "has_wiki": true,
# "has_downloads": true
#
# Create a new repository in this organisation. The authenticated user
# must be a member of this organisation
#
# Examples:
# @github = Github.new :oauth_token => '...'
# @github.repos.create_repo :name => 'repo-name', :org => 'organisation-name'
#
def create_repo(*args)
params = args.last.is_a?(Hash) ? args.pop : {}
_normalize_params_keys(params)
_filter_params_keys(VALID_REPO_OPTIONS + %w[ org ], params)
# if !_validate_inputs(%w[ name ], params)
# raise ArgumentError, "Required params are: :name"
# end
_validate_inputs(%w[ name ], params)
# Requires authenticated user
if (org = params.delete("org"))
post("/orgs/#{org}/repos", DEFAULT_REPO_OPTIONS.merge(params))
else
post("/user/repos", DEFAULT_REPO_OPTIONS.merge(params))
end
end
alias :create_repository :create_repo
# List contributors
#
# = Parameters
# :anon - Optional flag. Set to 1 or true to include anonymous contributors.
#
# = Examples
#
# @github = Github.new
# @github.repos.contributors 'user-name','repo-name'
# @github.repos.contributors 'user-name','repo-name' { |cont| ... }
#
def contributors(user_name=nil, repo_name=nil, params={})
_update_user_repo_params(user_name, repo_name)
_validate_user_repo_params(user, repo) unless user? && repo?
_normalize_params_keys(params)
_filter_params_keys(['anon'], params)
response = get("/repos/#{user}/#{repo}/contributors", params)
return response unless block_given?
response.each { |el| yield el }
end
alias :list_contributors :contributors
alias :contribs :contributors
# Edit a repository
#
# = Parameters
# * :name Required string
# * :description Optional string
# * :homepage Optional string
# :private - Optional boolean - false to create public reps, false to create a private one
# * :has_issues Optional boolean - true to enable issues for this repository, false to disable them
# * :has_wiki Optional boolean - true to enable the wiki for this repository, false to disable it. Default is true
# * :has_downloads Optional boolean - true to enable downloads for this repository
#
# = Examples
#
# @github = Github.new
# @github.repos.edit_repo('user-name', 'repo-name', { :name => 'hello-world', :description => 'This is your first repo', :homepage => "https://github.com", :private => false, :has_issues => true })
#
def edit_repo(user_name=nil, repo_name=nil, params={})
_update_user_repo_params(user_name, repo_name)
_validate_user_repo_params(user, repo) unless user? && repo?
_normalize_params_keys(params)
_filter_params_keys(VALID_REPO_OPTIONS, params)
unless _validate_inputs(%w[ name ], params)
raise ArgumentError, "Required params are: #{%w[ :name ] }"
end
patch("/repos/#{user}/#{repo}", DEFAULT_REPO_OPTIONS.merge(params))
end
alias :edit_repository :edit_repo
# Get a repository
#
# = Examples
# @github = Github.new
# @github.repos.get_repo('user-name', 'repo-name')
#
def get_repo(user_name=nil, repo_name=nil, params={})
_update_user_repo_params(user_name, repo_name)
_validate_user_repo_params(user, repo) unless user? && repo?
_normalize_params_keys(params)
get("/repos/#{user}/#{repo}", params)
end
alias :get_repository :get_repo
# List languages
#
# = Examples
# @github = Github.new
# @github.repos.languages('user-name', 'repo-name')
# @github.repos.languages('user-name', 'repo-name') { |lang| ... }
#
def languages(user_name=nil, repo_name=nil, params={})
_update_user_repo_params(user_name, repo_name)
_validate_user_repo_params(user, repo) unless user? && repo?
_normalize_params_keys(params)
response = get("/repos/#{user}/#{repo}/languages", params)
return response unless block_given?
response.each { |el| yield el }
end
alias :list_languages :languages
# List repositories for the authenticated user
#
# = Examples
# @github = Github.new :oauth_token => '...'
# @github.repos.list_repos
# @github.repos.list_repos { |repo| ... }
#
# List public repositories for the specified user.
#
# = Examples
# github = Github.new
# github.repos.list_repos :user => 'user-name'
# github.repos.list_repos :user => 'user-name', { |repo| ... }
#
# List repositories for the specified organisation.
#
# = Examples
# @github = Github.new
# @github.repos.list_repos :org => 'org-name'
# @github.repos.list_repos :org => 'org-name', { |repo| ... }
#
def repos(*args)
params = args.last.is_a?(Hash) ? args.pop : {}
_normalize_params_keys(params)
_merge_user_into_params!(params) unless params.has_key?('user')
_filter_params_keys(%w[ org user type ], params)
response = if (user_name = params.delete("user"))
get("/users/#{user_name}/repos", params)
elsif (org_name = params.delete("org"))
get("/orgs/#{org_name}/repos", params)
else
# For authenticated user
get("/user/repos", params)
end
return response unless block_given?
response.each { |el| yield el }
end
alias :list_repos :repos
alias :list_repositories :repos
# List tags
#
# = Examples
# @github = Github.new
# @github.repos.tags('user-name', 'repo-name')
# @github.repos.tags('user-name', 'repo-name') { |tag| ... }
#
def tags(user_name=nil, repo_name=nil, params={})
_update_user_repo_params(user_name, repo_name)
_validate_user_repo_params(user, repo) unless user? && repo?
_normalize_params_keys(params)
response = get("/repos/#{user}/#{repo}/tags", params)
return response unless block_given?
response.each { |el| yield el }
end
alias :list_tags :tags
alias :repo_tags :tags
alias :repository_tags :tags
# List teams
#
# == Examples
# @github = Github.new
# @github.repos.teams('user-name', 'repo-name')
# @github.repos.teams('user-name', 'repo-name') { |team| ... }
#
def teams(user_name=nil, repo_name=nil, params={})
_update_user_repo_params(user_name, repo_name)
_validate_user_repo_params(user, repo) unless user? && repo?
_normalize_params_keys(params)
response = get("/repos/#{user}/#{repo}/teams", params)
return response unless block_given?
response.each { |el| yield el }
end
alias :list_teams :teams
alias :repo_teams :teams
alias :repository_teams :teams
end # Repos
end # Github