Module: HTTPI

Defined in:
lib/httpi.rb,
lib/httpi/dime.rb,
lib/httpi/cookie.rb,
lib/httpi/logger.rb,
lib/httpi/adapter.rb,
lib/httpi/request.rb,
lib/httpi/version.rb,
lib/httpi/auth/ssl.rb,
lib/httpi/response.rb,
lib/httpi/auth/config.rb,
lib/httpi/adapter/base.rb,
lib/httpi/adapter/curb.rb,
lib/httpi/adapter/rack.rb,
lib/httpi/cookie_store.rb,
lib/httpi/adapter/excon.rb,
lib/httpi/adapter/em_http.rb,
lib/httpi/adapter/net_http.rb,
lib/httpi/adapter/httpclient.rb,
lib/httpi/adapter/net_http_persistent.rb

Overview

HTTPI

Executes HTTP requests using a predefined adapter. All request methods accept an HTTPI::Request and an optional adapter. They may also offer shortcut methods for executing basic requests. Also they all return an HTTPI::Response.

GET

request = HTTPI::Request.new("http://example.com")
HTTPI.get(request, :httpclient)

Shortcuts

HTTPI.get("http://example.com", :curb)

POST

request = HTTPI::Request.new
request.url = "http://example.com"
request.body = "<some>xml</some>"

HTTPI.post(request, :httpclient)

Shortcuts

HTTPI.post("http://example.com", "<some>xml</some>", :curb)

HEAD

request = HTTPI::Request.new("http://example.com")
HTTPI.head(request, :httpclient)

Shortcuts

HTTPI.head("http://example.com", :curb)

PUT

request = HTTPI::Request.new
request.url = "http://example.com"
request.body = "<some>xml</some>"

HTTPI.put(request, :httpclient)

Shortcuts

HTTPI.put("http://example.com", "<some>xml</some>", :curb)

DELETE

request = HTTPI::Request.new("http://example.com")
HTTPI.delete(request, :httpclient)

Shortcuts

HTTPI.delete("http://example.com", :curb)

More control

If you need more control over your request, you can access the HTTP client instance represented by your adapter in a block.

HTTPI.get request do |http|
  http.follow_redirect_count = 3  # HTTPClient example
end

Defined Under Namespace

Modules: Adapter, Auth, ConnectionError Classes: Cookie, CookieStore, Dime, DimeRecord, Error, NotImplementedError, NotSupportedError, Request, Response, SSLError, TimeoutError

Constant Summary collapse

REQUEST_METHODS = 
[:get, :post, :head, :put, :delete]
DEFAULT_LOG_LEVEL = 
:debug
VERSION = 
"2.2.4"

Class Attribute Summary collapse

Class Method Summary collapse

Class Attribute Details

.log(message) ⇒ Object

Logs a given message.



32
33
34
 
# File 'lib/httpi/logger.rb', line 32

def log(message)
  logger.send(log_level, message) if log?
end

.log_level ⇒ Object

Returns the log level. Defaults to :debug.



27
28
29
 
# File 'lib/httpi/logger.rb', line 27

def log_level
  @log_level ||= DEFAULT_LOG_LEVEL
end

.logger ⇒ Object

Returns the logger. Defaults to an instance of Logger writing to STDOUT.



19
20
21
 
# File 'lib/httpi/logger.rb', line 19

def logger
  @logger ||= ::Logger.new($stdout)
end

Class Method Details

.adapter=(adapter) ⇒ Object

Shortcut for setting the default adapter to use.



151
152
153
 
# File 'lib/httpi.rb', line 151

def adapter=(adapter)
  Adapter.use = adapter
end

.delete(request, adapter = nil, &block) ⇒ Object

Executes an HTTP DELETE request.



127
128
129
130
 
# File 'lib/httpi.rb', line 127

def delete(request, adapter = nil, &block)
  request = Request.new(request) if request.kind_of? String
  request(:delete, request, adapter, &block)
end

.get(request, adapter = nil, &block) ⇒ Object

Executes an HTTP GET request.



103
104
105
106
 
# File 'lib/httpi.rb', line 103

def get(request, adapter = nil, &block)
  request = Request.new(request) if request.kind_of? String
  request(:get, request, adapter, &block)
end

.head(request, adapter = nil, &block) ⇒ Object

Executes an HTTP HEAD request.



115
116
117
118
 
# File 'lib/httpi.rb', line 115

def head(request, adapter = nil, &block)
  request = Request.new(request) if request.kind_of? String
  request(:head, request, adapter, &block)
end

.log? ⇒ Boolean

Returns whether to log HTTP requests. Defaults to true.

Returns:

  • (Boolean) 


11
12
13
 
# File 'lib/httpi/logger.rb', line 11

def log?
  @log != false
end

.post(*args, &block) ⇒ Object

Executes an HTTP POST request.



109
110
111
112
 
# File 'lib/httpi.rb', line 109

def post(*args, &block)
  request, adapter = request_and_adapter_from(args)
  request(:post, request, adapter, &block)
end

.put(*args, &block) ⇒ Object

Executes an HTTP PUT request.



121
122
123
124
 
# File 'lib/httpi.rb', line 121

def put(*args, &block)
  request, adapter = request_and_adapter_from(args)
  request(:put, request, adapter, &block)
end

.request(method, request, adapter = nil) {|adapter_class.client| ... } ⇒ Object

Executes an HTTP request for the given method.

Yields:

  • (adapter_class.client) 


133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
 
# File 'lib/httpi.rb', line 133

def request(method, request, adapter = nil)
  adapter_class = load_adapter(adapter, request)

  yield adapter_class.client if block_given?
  log_request(method, request, Adapter.identify(adapter_class.class))

  response = adapter_class.request(method)

  if response and response.code == 302 and request.follow_redirect?
    log('Following redirect...')
    request.url = response.headers['location']
    return request(method, request, adapter)
  end

  response
end

.reset_config! ⇒ Object

Reset the default config.



37
38
39
40
41
 
# File 'lib/httpi/logger.rb', line 37

def reset_config!
  @log = nil
  @logger = nil
  @log_level = nil
end