Module: Hub::GitHubAPI::HttpMethods

Included in:
Hub::GitHubAPI
Defined in:
lib/hub/github_api.rb

Overview

Methods for performing HTTP requests

Requires access to a ‘config` object that implements:

  • proxy_uri(with_ssl)

  • username(host)

  • password(host, user)

Defined Under Namespace

Modules: ResponseMethods

Instance Method Summary collapse

Instance Method Details

#apply_authentication(req, url) ⇒ Object 



266
267
268
269
270
 
# File 'lib/hub/github_api.rb', line 266

def apply_authentication req, url
  user = url.user ? CGI.unescape(url.user) : config.username(url.host)
  pass = config.password(url.host, user)
  req.basic_auth user, pass
end

#byte_size(str) ⇒ Object 



212
213
214
215
216
217
 
# File 'lib/hub/github_api.rb', line 212

def byte_size str
  if    str.respond_to? :bytesize then str.bytesize
  elsif str.respond_to? :length   then str.length
  else  0
  end
end

#configure_connection(req, url) {|url| ... } ⇒ Object

Yields:

  • (url) 


253
254
255
256
257
258
259
260
261
262
263
264
 
# File 'lib/hub/github_api.rb', line 253

def configure_connection req, url
  url.scheme = config.protocol(url.host)
  if ENV['HUB_TEST_HOST']
    req['Host'] = url.host
    req['X-Original-Scheme'] = url.scheme
    url = url.dup
    url.scheme = 'http'
    url.host, test_port = ENV['HUB_TEST_HOST'].split(':')
    url.port = test_port.to_i if test_port
  end
  yield url
end

#create_connection(url) ⇒ Object 



278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
 
# File 'lib/hub/github_api.rb', line 278

def create_connection url
  use_ssl = 'https' == url.scheme

  proxy_args = []
  if proxy = config.proxy_uri(use_ssl)
    proxy_args << proxy.host << proxy.port
    if proxy.userinfo
      # proxy user + password
      proxy_args.concat proxy.userinfo.split(':', 2).map {|a| CGI.unescape a }
    end
  end

  http = Net::HTTP.new(url.host, url.port, *proxy_args)

  if http.use_ssl = use_ssl
    # FIXME: enable SSL peer verification!
    http.verify_mode = OpenSSL::SSL::VERIFY_NONE
  end
  return http
end

#finalize_request(req, url) ⇒ Object 



272
273
274
275
276
 
# File 'lib/hub/github_api.rb', line 272

def finalize_request(req, url)
  if !req['Accept'] || req['Accept'] == '*/*'
    req['Accept'] = 'application/vnd.github.v3+json'
  end
end

#get(url, &block) ⇒ Object 



197
198
199
 
# File 'lib/hub/github_api.rb', line 197

def get url, &block
  perform_request url, :Get, &block
end

#perform_request(url, type) {|req| ... } ⇒ Object

Yields:

  • (req) 


223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
 
# File 'lib/hub/github_api.rb', line 223

def perform_request url, type
  url = URI.parse url unless url.respond_to? :host

  require 'net/https'
  req = Net::HTTP.const_get(type).new request_uri(url)
  # TODO: better naming?
  http = configure_connection(req, url) do |host_url|
    create_connection host_url
  end

  req['User-Agent'] = "Hub #{Hub::VERSION}"
  apply_authentication(req, url)
  yield req if block_given?
  finalize_request(req, url)

  begin
    res = http.start { http.request(req) }
    res.extend ResponseMethods
    return res
  rescue SocketError => err
    raise Context::FatalError, "error with #{type.to_s.upcase} #{url} (#{err.message})"
  end
end

#post(url, params = nil) ⇒ Object 



201
202
203
204
205
206
207
208
209
210
 
# File 'lib/hub/github_api.rb', line 201

def post url, params = nil
  perform_request url, :Post do |req|
    if params
      req.body = JSON.dump params
      req['Content-Type'] = 'application/json;charset=utf-8'
    end
    yield req if block_given?
    req['Content-Length'] = byte_size req.body
  end
end

#post_form(url, params) ⇒ Object 



219
220
221
 
# File 'lib/hub/github_api.rb', line 219

def post_form url, params
  post(url) {|req| req.set_form_data params }
end

#request_uri(url) ⇒ Object 



247
248
249
250
251
 
# File 'lib/hub/github_api.rb', line 247

def request_uri url
  str = url.request_uri
  str = '/api/v3' << str if url.host != 'api.github.com' && url.host != 'gist.github.com'
  str
end