jtimberman/opscode-rest forked from chef-boneyard/opscode-rest

Opscode::REST

This is a wrapper around the excellent RestClient gem. It provides for some basic User-Agent style functionality (like a simple cookie jar), does JSON inflation, and handles redirects like a web browser. In addition, it knows how to do OpenID authentication with Opscode-style OpenID providers (used mainly for API level authentication, unattended by human beings.)

To use:

r = Opscode::REST
r.get("https://localhost") # Requests application/json from localhost
# Send a PUT with :one => 'two' form-encoded.
r.put("https://localhost", { :payload => { :one => 'two' }})
# Send a PUT with a JSON hash
r.put("https://localhost", { :payload => { :one => 'two'}.to_json })
# Post is just like PUT
# Delete is just like GET
# Authenticate to a Chef Server as 'adam' with the secret 'monkey'.
#
# First argument is the openid consumer, second is your openid, followed by your password.
r.authenticate(
  'https://localhost:4000/openid/consumer/start',    
  'https://localhost:4001/openid/server/node/adam', 
  'monkey'
)

See the RDOC for more information.

Opscode::REST::Resource

This behaves exactly like RestClient::Resource. The difference is that we utilize the Opscode::REST wrapper under the hood, and it supports the authentication method from above.