Class: Jekyll::GitHubMetadata::Repository

Inherits:
Object
  • Object
show all
Extended by:
Forwardable
Defined in:
lib/jekyll-github-metadata/repository.rb

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(name_with_owner) ⇒ Repository

Returns a new instance of Repository.



38
39
40
41
42
 
# File 'lib/jekyll-github-metadata/repository.rb', line 38

def initialize(name_with_owner)
  @nwo   = name_with_owner
  @owner = nwo.split("/").first
  @name  = nwo.split("/").last
end

Instance Attribute Details

#name ⇒ Object (readonly)

Returns the value of attribute name.



6
7
8
 
# File 'lib/jekyll-github-metadata/repository.rb', line 6

def name
  @name
end

#nwo ⇒ Object (readonly)

Returns the value of attribute nwo.



6
7
8
 
# File 'lib/jekyll-github-metadata/repository.rb', line 6

def nwo
  @nwo
end

#owner ⇒ Object (readonly)

Returns the value of attribute owner.



6
7
8
 
# File 'lib/jekyll-github-metadata/repository.rb', line 6

def owner
  @owner
end

Class Method Details

.def_hash_delegator(hash, key, method) ⇒ Object

Defines an instance method that delegates to a hash’s key

hash - a symbol representing the instance method to delegate to. The

instance method should return a hash or respond to #[]

key - the key to call within the hash method - (optional) the instance method the key should be aliased to.

If not specified, defaults to the hash key

Returns a symbol representing the instance method



17
18
19
20
21
 
# File 'lib/jekyll-github-metadata/repository.rb', line 17

def self.def_hash_delegator(hash, key, method)
  define_method(method) do
    public_send(hash)[key.to_s]
  end
end

Instance Method Details

#cname ⇒ Object 



174
175
176
177
178
 
# File 'lib/jekyll-github-metadata/repository.rb', line 174

def cname
  return nil unless Pages.custom_domains_enabled?

  repo_pages_info["cname"]
end

#contributors ⇒ Object 



125
126
127
 
# File 'lib/jekyll-github-metadata/repository.rb', line 125

def contributors
  memoize_value :@contributors, Value.new("contributors", proc { |c| c.contributors(nwo) })
end

#default_user_domain ⇒ Object 



164
165
166
167
168
169
170
171
172
 
# File 'lib/jekyll-github-metadata/repository.rb', line 164

def default_user_domain
  if github_repo?
    "#{owner}.#{Pages.github_hostname}".downcase
  elsif Pages.enterprise?
    Pages.pages_hostname.downcase
  else
    "#{owner}.#{Pages.pages_hostname}".downcase
  end
end

#forks_count ⇒ Object 



196
197
198
 
# File 'lib/jekyll-github-metadata/repository.rb', line 196

def forks_count
  repo_pages_info["forks_count"] || 0
end

#github_repo? ⇒ Boolean

Returns:

  • (Boolean) 


145
146
147
 
# File 'lib/jekyll-github-metadata/repository.rb', line 145

def github_repo?
  !Pages.enterprise? && owner.eql?("github")
end

#html_url ⇒ Object 



180
181
182
 
# File 'lib/jekyll-github-metadata/repository.rb', line 180

def html_url
  @html_url ||= (repo_pages_info["html_url"] || repo_compat.pages_url).chomp("/")
end

#issues_url ⇒ Object 



99
100
101
 
# File 'lib/jekyll-github-metadata/repository.rb', line 99

def issues_url
  "#{repository_url}/issues" if repo_info["has_issues"]
end

#latest_release ⇒ Object 



133
134
135
 
# File 'lib/jekyll-github-metadata/repository.rb', line 133

def latest_release
  memoize_value :@latest_release, Value.new("latest_release", proc { |c| c.latest_release(nwo) })
end

#organization_public_members ⇒ Object 



119
120
121
122
123
 
# File 'lib/jekyll-github-metadata/repository.rb', line 119

def organization_public_members
  memoize_value :@organization_public_members, Value.new("organization_public_members", proc do |c|
    c.organization_public_members(owner) if organization_repository?
  end)
end

#organization_repository? ⇒ Boolean

Returns:

  • (Boolean) 


107
108
109
 
# File 'lib/jekyll-github-metadata/repository.rb', line 107

def organization_repository?
  memoize_value :@is_organization_repository, Value.new("organization_repository?", proc { |c| !!c.organization(owner) })
end

#owner_gravatar_url ⇒ Object 



75
76
77
 
# File 'lib/jekyll-github-metadata/repository.rb', line 75

def owner_gravatar_url
  "#{owner_url}.png"
end

#owner_metadata ⇒ Object 



67
68
69
 
# File 'lib/jekyll-github-metadata/repository.rb', line 67

def owner_metadata
  @owner_metadata ||= Jekyll::GitHubMetadata::Owner.new(owner)
end

#owner_public_repositories ⇒ Object 



111
112
113
114
115
116
117
 
# File 'lib/jekyll-github-metadata/repository.rb', line 111

def owner_public_repositories
  options = {
    :type   => "public",
    :accept => "application/vnd.github.mercy-preview+json",
  }
  memoize_value :@owner_public_repositories, Value.new("owner_public_repositories", proc { |c| c.list_repos(owner, options) })
end

#owner_url ⇒ Object 



71
72
73
 
# File 'lib/jekyll-github-metadata/repository.rb', line 71

def owner_url
  "#{Pages.github_url}/#{owner}"
end

#primary? ⇒ Boolean Also known as: user_page?

Returns:

  • (Boolean) 


149
150
151
152
153
154
155
 
# File 'lib/jekyll-github-metadata/repository.rb', line 149

def primary?
  if Pages.enterprise?
    name.downcase == "#{owner.to_s.downcase}.#{Pages.github_hostname}"
  else
    user_page_domains.include? name.downcase
  end
end

#project_page? ⇒ Boolean

Returns:

  • (Boolean) 


141
142
143
 
# File 'lib/jekyll-github-metadata/repository.rb', line 141

def project_page?
  !user_page?
end

#releases ⇒ Object 



129
130
131
 
# File 'lib/jekyll-github-metadata/repository.rb', line 129

def releases
  memoize_value :@releases, Value.new("releases", proc { |c| c.releases(nwo) })
end

#releases_url ⇒ Object 



95
96
97
 
# File 'lib/jekyll-github-metadata/repository.rb', line 95

def releases_url
  "#{repository_url}/releases"
end

#repo_clone_url ⇒ Object 



79
80
81
 
# File 'lib/jekyll-github-metadata/repository.rb', line 79

def repo_clone_url
  "#{repository_url}.git"
end

#repo_compat ⇒ Object 



44
45
46
 
# File 'lib/jekyll-github-metadata/repository.rb', line 44

def repo_compat
  @repo_compat ||= Jekyll::GitHubMetadata::RepositoryCompat.new(self)
end

#repo_info ⇒ Object 



48
49
50
51
52
53
 
# File 'lib/jekyll-github-metadata/repository.rb', line 48

def repo_info
  @repo_info ||= begin
    options = { :accept => "application/vnd.github.drax-preview+json" }
    (Value.new("repo_info", proc { |c| c.repository(nwo, options) }).render || {})
  end
end

#repo_pages_info ⇒ Object 



55
56
57
 
# File 'lib/jekyll-github-metadata/repository.rb', line 55

def repo_pages_info
  @repo_pages_info ||= (Value.new("repo_pages_info", proc { |c| c.pages(nwo, repo_pages_info_opts) }).render || {})
end

#repo_pages_info_opts ⇒ Object 



59
60
61
62
63
64
65
 
# File 'lib/jekyll-github-metadata/repository.rb', line 59

def repo_pages_info_opts
  if Pages.repo_pages_html_url_preview?
    { :accept => "application/vnd.github.mister-fantastic-preview+json" }
  else
    {}
  end
end

#repository_url ⇒ Object 



83
84
85
 
# File 'lib/jekyll-github-metadata/repository.rb', line 83

def repository_url
  "#{owner_url}/#{name}"
end

#source ⇒ Object 



137
138
139
 
# File 'lib/jekyll-github-metadata/repository.rb', line 137

def source
  repo_pages_info["source"] || repo_compat.source
end

#stargazers_count ⇒ Object 



192
193
194
 
# File 'lib/jekyll-github-metadata/repository.rb', line 192

def stargazers_count
  repo_pages_info["stargazers_count"] || 0
end

#tar_url ⇒ Object 



91
92
93
 
# File 'lib/jekyll-github-metadata/repository.rb', line 91

def tar_url
  "#{repository_url}/tarball/#{git_ref}"
end

#uri ⇒ Object 



184
185
186
 
# File 'lib/jekyll-github-metadata/repository.rb', line 184

def uri
  @uri ||= URI(html_url)
end

#url_without_path ⇒ Object 



188
189
190
 
# File 'lib/jekyll-github-metadata/repository.rb', line 188

def url_without_path
  uri.dup.tap { |u| u.path = "" }.to_s
end

#user_page_domains ⇒ Object 



158
159
160
161
162
 
# File 'lib/jekyll-github-metadata/repository.rb', line 158

def user_page_domains
  domains = [default_user_domain]
  domains.push "#{owner}.github.com".downcase unless Pages.enterprise?
  domains
end

#wiki_url ⇒ Object 



103
104
105
 
# File 'lib/jekyll-github-metadata/repository.rb', line 103

def wiki_url
  "#{repository_url}/wiki" if repo_info["has_wiki"]
end

#zip_url ⇒ Object 



87
88
89
 
# File 'lib/jekyll-github-metadata/repository.rb', line 87

def zip_url
  "#{repository_url}/zipball/#{git_ref}"
end