module REST

REST is basically a convenience wrapper around Net::HTTP. It defines a simple and consistant API for doing REST-style HTTP calls.

In addition it provides wrappers for the many error classes that can be raised while making requests. See REST::Error for a complete discussion of options.

Constants

VERSION

Library version

Public Class Methods

delete(uri, headers={}, options={}, &configure_block) click to toggle source

Performs a DELETE on a resource. See REST::Request.new for a complete discussion of options.

response = REST.delete('http://example.com/pigeons/12')
if response.ok?
  puts "Your pigeon died ): )"
elsif response.found?
  puts "Someone moved your pigeon!"
else
  puts "Couldn't delete your pigeon (#{response.status_code})"
end
# File lib/rest.rb, line 51
def self.delete(uri, headers={}, options={}, &configure_block)
  REST::Request.perform(:delete, URI.parse(uri), nil, headers, options, &configure_block)
end
get(uri, headers={}, options={}, &configure_block) click to toggle source

Performs a GET on a resource. See REST::Request.new for a complete discussion of options.

response = REST.get('http://example.com/pigeons/12',
  {'Accept' => 'text/plain'},
  {:username => 'admin', :password => 'secret'}
)
if response.ok?
  puts response.body
else
  puts "Couldn't fetch your pigeon (#{response.status_code})"
end
# File lib/rest.rb, line 23
def self.get(uri, headers={}, options={}, &configure_block)
  REST::Request.perform(:get, URI.parse(uri), nil, headers, options, &configure_block)
end
head(uri, headers={}, options={}, &configure_block) click to toggle source

Performs a HEAD on a resource. See REST::Request.new for a complete discussion of options.

response = REST.head('http://example.com/pigeons/12')
if response.ok?
  puts "Your pigeon exists!"
elsif response.found?
  puts "Someone moved your pigeon!"
else
  puts "Couldn't fetch your pigeon (#{response.status_code})"
end
# File lib/rest.rb, line 37
def self.head(uri, headers={}, options={}, &configure_block)
  REST::Request.perform(:head, URI.parse(uri), nil, headers, options, &configure_block)
end
patch(uri, body, headers={}, options={}, &configure_block) click to toggle source

Performs a PATCH on a resource. See REST::Request.new for a complete discussion of options.

response = REST.patch('http://example.com/pigeons/12',
  {'Name' => 'Homer'}.to_xml,
  {'Accept' => 'application/xml, */*', 'Content-Type' => 'application/xml'}
)
if response.ok?
  puts "Your pigeon was renamed to 'Homer'!"
else
  puts "Couldn't rename your pigeon (#{response.status_code})"
  puts XML.parse(response.body).reason
end
# File lib/rest.rb, line 67
def self.patch(uri, body, headers={}, options={}, &configure_block)
  REST::Request.perform(:patch, URI.parse(uri), body, headers, options, &configure_block)
end
post(uri, body, headers={}, options={}, &configure_block) click to toggle source

Performs a POST on a resource. See REST::Request.new for a complete discussion of options.

response = REST.post('http://example.com/pigeons',
  {'Name' => 'Bowser'}.to_xml,
  {'Accept' => 'application/xml, */*', 'Content-Type' => 'application/xml'}
)
if response.created?
  puts "Created a new pigeon called 'Bowser'"
else
  puts "Couldn't create your pigeon (#{response.status_code})"
  puts XML.parse(response.body).reason
end
# File lib/rest.rb, line 99
def self.post(uri, body, headers={}, options={}, &configure_block)
  REST::Request.perform(:post, URI.parse(uri), body, headers, options, &configure_block)
end
put(uri, body, headers={}, options={}, &configure_block) click to toggle source

Performs a PUT on a resource. See REST::Request.new for a complete discussion of options.

response = REST.put('http://example.com/pigeons/12',
  {'Name' => 'Homer'}.to_xml,
  {'Accept' => 'application/xml, */*', 'Content-Type' => 'application/xml'}
)
if response.ok?
  puts "Your pigeon 'Bowser' was replaced by 'Homer'!"
else
  puts "Couldn't replace your pigeon (#{response.status_code})"
  puts XML.parse(response.body).reason
end
# File lib/rest.rb, line 83
def self.put(uri, body, headers={}, options={}, &configure_block)
  REST::Request.perform(:put, URI.parse(uri), body, headers, options, &configure_block)
end