Module: Pod::GitHub

Defined in:
lib/cocoapods-core/github.rb

Overview

Allows to access information about the GitHub repos.

This class is stored in Core because it might be used by web services.

Class Method Summary collapse

Class Method Details

.branches(url) ⇒ Array

Returns the branches of a repo.

Parameters:

  • url (String) —

    @see #repo

Returns:

  • (Array) —

    The list of the branches.



49
50
51
52
53
 
# File 'lib/cocoapods-core/github.rb', line 49

def self.branches(url)
  if repo_id = normalized_repo_id(url)
    peform_request("https://api.github.com/repos/#{repo_id}/branches")
  end
end

.contents(url, path = nil, branch = nil) ⇒ Array, Hash

Returns the contents of a file or directory in a repository.

Parameters:

  • url (String) —

    @see #repo

  • path (#to_s) (defaults to: nil) —

    The path for which the contents are needed.

  • branch (String) (defaults to: nil) —

    The branch for which to fetch the contents of the path.

Returns:

  • (Array) —

    The list of the files and of the directories if the given path is a directory.

  • (Hash) —

    The contents of the file (usually base64 encoded).



70
71
72
73
74
75
76
77
 
# File 'lib/cocoapods-core/github.rb', line 70

def self.contents(url, path = nil, branch = nil)
  if repo_id = normalized_repo_id(url)
    request_url = "https://api.github.com/repos/#{repo_id}/contents"
    request_url << "/#{path}" if path
    request_url << "?ref=#{branch}" if branch
    peform_request(request_url)
  end
end

.modified_since_commit(url, commit) ⇒ Boolean

Returns whether the repository has been updated since a given commit. If the request fails, the response will be true as the API is still in beta and likely to change.

Parameters:

  • url (String) —

    @see #repo

  • commit (String) —

    The current HEAD commit.

Returns:

  • (Boolean) —

    Whether the repository has been updated since the commit.



90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
 
# File 'lib/cocoapods-core/github.rb', line 90

def self.modified_since_commit(url, commit)
  return true unless repo_id = normalized_repo_id(url)
  require 'rest'
  request_url = "https://api.github.com/repos/#{repo_id}/commits/master"
  headers = {
    'User-Agent' => 'CocoaPods',
    'Accept' => 'application/vnd.github.v3.sha',
    'If-None-Match' => %("#{commit}"),
  }

  begin
    response = REST.get(request_url, headers)
    code = response.status_code
    code != 304
  rescue
    raise Informative, "Failed to connect to GitHub to update the #{repo_id} specs repo - Please check if you are offline, or that GitHub is down"
  end
end

.repo(url) ⇒ Hash

Returns the information of a repo.

Parameters:

  • url (String) —

    The URL of the repo.

Returns:

  • (Hash) —

    The hash containing the data as reported by GitHub.



25
26
27
28
29
 
# File 'lib/cocoapods-core/github.rb', line 25

def self.repo(url)
  if repo_id = normalized_repo_id(url)
    peform_request("https://api.github.com/repos/#{repo_id}")
  end
end

.tags(url) ⇒ Array

Returns the tags of a repo.

Parameters:

  • url (String) —

    @see #repo

Returns:

  • (Array) —

    The list of the tags.



37
38
39
40
41
 
# File 'lib/cocoapods-core/github.rb', line 37

def self.tags(url)
  if repo_id = normalized_repo_id(url)
    peform_request("https://api.github.com/repos/#{repo_id}/tags")
  end
end

.user(login) ⇒ Hash

Returns the information of a user.

Parameters:

  • login (String) —

    The name of the user.

Returns:

  • (Hash) —

    The data of user.



14
15
16
 
# File 'lib/cocoapods-core/github.rb', line 14

def self.user()
  peform_request("https://api.github.com/users/#{login}")
end