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)

  • update_username(host, old_username, new_username)

  • password(host, user)

Defined Under Namespace

Modules: ResponseMethods

Instance Method Summary collapse

Instance Method Details

#apply_authentication(req, url) ⇒ Object 



209
210
211
212
213
 
# File 'lib/hub/github_api.rb', line 209

def apply_authentication req, url
  user = url.user || config.username(url.host)
  pass = config.password(url.host, user)
  req.basic_auth user, pass
end

#byte_size(str) ⇒ Object 



159
160
161
162
163
164
 
# File 'lib/hub/github_api.rb', line 159

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) 


198
199
200
201
202
203
204
205
206
207
 
# File 'lib/hub/github_api.rb', line 198

def configure_connection req, url
  if ENV['HUB_TEST_HOST']
    req['Host'] = url.host
    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 



215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
 
# File 'lib/hub/github_api.rb', line 215

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
      require 'cgi'
      # 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

#get(url, &block) ⇒ Object 



144
145
146
 
# File 'lib/hub/github_api.rb', line 144

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

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

Yields:

  • (req) 


170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
 
# File 'lib/hub/github_api.rb', line 170

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

  apply_authentication(req, url)
  yield req if block_given?

  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 



148
149
150
151
152
153
154
155
156
157
 
# File 'lib/hub/github_api.rb', line 148

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 



166
167
168
 
# File 'lib/hub/github_api.rb', line 166

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

#request_uri(url) ⇒ Object 



192
193
194
195
196
 
# File 'lib/hub/github_api.rb', line 192

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