# 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