Class: Dependabot::Source

Inherits:
Object
  • Object
show all
Extended by:
T::Sig
Defined in:
lib/dependabot/source.rb

Constant Summary collapse

GITHUB_SOURCE = 
%r{
  (?<provider>github)
  (?:\.com)[/:]
  (?<repo>[\w.-]+/(?:[\w.-])+)
  (?:(?:/tree|/blob)/(?<branch>[^/]+)/(?<directory>.*)[\#|/])?
}x
GITHUB_ENTERPRISE_SOURCE = 
%r{
  (?<protocol>(http://|https://|git://|ssh://))*
  (?<username>[^@]+@)*
  (?<host>[^/]+)
  [/:]
  (?<repo>[\w.-]+/(?:[\w.-])+)
  (?:(?:/tree|/blob)/(?<branch>[^/]+)/(?<directory>.*)[\#|/])?
}x
GITLAB_SOURCE = 
%r{
  (?<provider>gitlab)
  (?:\.com)[/:]
  (?<repo>[^/]+/(?:[^/])+((?!/tree|/blob/|/-)/[^/]+)?)
  (?:(?:/tree|/blob)/(?<branch>[^/]+)/(?<directory>.*)[\#|/].*)?
}x
BITBUCKET_SOURCE = 
%r{
  (?<provider>bitbucket)
  (?:\.org)[/:]
  (?<repo>[\w.-]+/(?:[\w.-])+)
  (?:(?:/src)/(?<branch>[^/]+)/(?<directory>.*)[\#|/])?
}x
AZURE_SOURCE = 
%r{
  (?<provider>azure)
  (?:\.com)[/:]
  (?<repo>[\w.-]+/([\w.-]+/)?(?:_git/)(?:[\w.-])+)
}x
CODECOMMIT_SOURCE = 
%r{
  (?<protocol>(http://|https://|git://|ssh://))
  git[-]
  (?<provider>codecommit)
  (?:.*)
  (?:\.com/v1/repos/)
  (?<repo>([^/]*))
  (?:/)?(?<directory>[^?]*)?
  [?]?
  (?<ref>.*)?
}x
SOURCE_REGEX = 
/
  (?:#{GITHUB_SOURCE})|
  (?:#{GITLAB_SOURCE})|
  (?:#{BITBUCKET_SOURCE})|
  (?:#{AZURE_SOURCE})|
  (?:#{CODECOMMIT_SOURCE})
/x
IGNORED_PROVIDER_HOSTS = 
T.let(
  %w(gitbox.apache.org svn.apache.org fuchsia.googlesource.com).freeze,
  T::Array[String]
)

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(provider:, repo:, directory: nil, directories: nil, branch: nil, commit: nil, hostname: nil, api_endpoint: nil) ⇒ Source

Returns a new instance of Source.



152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
 
# File 'lib/dependabot/source.rb', line 152

def initialize(
  provider:,
  repo:,
  directory: nil,
  directories: nil,
  branch: nil,
  commit: nil,
  hostname: nil,
  api_endpoint: nil
)
  if (hostname.nil? ^ api_endpoint.nil?) && (provider != "codecommit")
    msg = "Both hostname and api_endpoint must be specified if either " \
          "are. Alternatively, both may be left blank to use the " \
          "provider's defaults."
    raise msg
  end

  @provider = provider
  @repo = repo
  @directory = directory
  @directories = directories
  @branch = branch
  @commit = commit
  @hostname = T.let(hostname || default_hostname(provider), String)
  @api_endpoint = T.let(api_endpoint || default_api_endpoint(provider), T.nilable(String))
end

Instance Attribute Details

#api_endpoint ⇒ Object

Returns the value of attribute api_endpoint.



93
94
95
 
# File 'lib/dependabot/source.rb', line 93

def api_endpoint
  @api_endpoint
end

#branch ⇒ Object

Returns the value of attribute branch.



84
85
86
 
# File 'lib/dependabot/source.rb', line 84

def branch
  @branch
end

#commit ⇒ Object

Returns the value of attribute commit.



87
88
89
 
# File 'lib/dependabot/source.rb', line 87

def commit
  @commit
end

#directories ⇒ Object

Returns the value of attribute directories.



81
82
83
 
# File 'lib/dependabot/source.rb', line 81

def directories
  @directories
end

#directory ⇒ Object

Returns the value of attribute directory.



78
79
80
 
# File 'lib/dependabot/source.rb', line 78

def directory
  @directory
end

#hostname ⇒ Object

Returns the value of attribute hostname.



90
91
92
 
# File 'lib/dependabot/source.rb', line 90

def hostname
  @hostname
end

#provider ⇒ Object

Returns the value of attribute provider.



72
73
74
 
# File 'lib/dependabot/source.rb', line 72

def provider
  @provider
end

#repo ⇒ Object

Returns the value of attribute repo.



75
76
77
 
# File 'lib/dependabot/source.rb', line 75

def repo
  @repo
end

Class Method Details

.from_url(url_string) ⇒ Object 



96
97
98
99
100
101
102
103
104
105
106
107
 
# File 'lib/dependabot/source.rb', line 96

def self.from_url(url_string)
  return github_enterprise_from_url(url_string) unless url_string&.match?(SOURCE_REGEX)

  captures = T.must(url_string.match(SOURCE_REGEX)).named_captures

  new(
    provider: T.must(captures.fetch("provider")),
    repo: T.must(captures.fetch("repo")).delete_suffix(".git").delete_suffix("."),
    directory: captures.fetch("directory"),
    branch: captures.fetch("branch")
  )
end

.github_enterprise?(base_url) ⇒ Boolean

Returns:

  • (Boolean) 


130
131
132
133
134
135
136
137
138
 
# File 'lib/dependabot/source.rb', line 130

def self.github_enterprise?(base_url)
  resp = Excon.get(File.join(base_url, "status"))
  resp.status == 200 &&
    # Alternatively: resp.headers["Server"] == "GitHub.com", but this
    # currently doesn't work with development environments
    ((resp.headers["X-GitHub-Request-Id"] && !resp.headers["X-GitHub-Request-Id"]&.empty?) || false)
rescue StandardError
  false
end

.github_enterprise_from_url(url_string) ⇒ Object 



110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
 
# File 'lib/dependabot/source.rb', line 110

def self.github_enterprise_from_url(url_string)
  captures = url_string&.match(GITHUB_ENTERPRISE_SOURCE)&.named_captures
  return unless captures
  return if IGNORED_PROVIDER_HOSTS.include?(captures.fetch("host"))

  base_url = "https://#{captures.fetch('host')}"

  return unless github_enterprise?(base_url)

  new(
    provider: "github",
    repo: T.must(captures.fetch("repo")).delete_suffix(".git").delete_suffix("."),
    directory: captures.fetch("directory"),
    branch: captures.fetch("branch"),
    hostname: captures.fetch("host"),
    api_endpoint: File.join(base_url, "api", "v3")
  )
end

Instance Method Details

#organization ⇒ Object 



206
207
208
209
210
211
212
213
214
 
# File 'lib/dependabot/source.rb', line 206

def organization
  case provider
  when "azure"
    parts = repo.split("/_git/")
    T.must(T.must(parts.first).split("/").last(2).first)
  else
    T.must(repo.split("/").first)
  end
end

#project ⇒ Object 



217
218
219
220
221
222
223
224
 
# File 'lib/dependabot/source.rb', line 217

def project
  raise "Project is an Azure DevOps concept only" unless provider == "azure"

  parts = repo.split("/_git/")
  return T.must(T.must(parts.first).split("/").last) if parts.first&.split("/")&.count&.>=(2)

  T.must(parts.last)
end

#unscoped_repo ⇒ Object 



227
228
229
 
# File 'lib/dependabot/source.rb', line 227

def unscoped_repo
  T.must(repo.split("/").last)
end

#url ⇒ Object 



180
181
182
 
# File 'lib/dependabot/source.rb', line 180

def url
  "https://" + hostname + "/" + repo
end

#url_with_directory ⇒ Object 



185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
 
# File 'lib/dependabot/source.rb', line 185

def url_with_directory
  return url if [nil, ".", "/"].include?(directory)

  case provider
  when "github", "gitlab"
    path = Pathname.new(File.join("tree/#{branch || 'HEAD'}", directory))
                   .cleanpath.to_path
    url + "/" + path
  when "bitbucket"
    path = Pathname.new(File.join("src/#{branch || 'default'}", directory))
                   .cleanpath.to_path
    url + "/" + path
  when "azure"
    url + "?path=#{directory}"
  when "codecommit"
    raise "The codecommit provider does not utilize URLs"
  else raise "Unexpected repo provider '#{provider}'"
  end
end