# File lib/couchrest/core/rest_api.rb, line 3
  def put(uri, doc = nil)
    payload = doc.to_json if doc
    begin
      JSON.parse(HttpAbstraction.put(uri, payload))
    rescue Exception => e
      if $DEBUG
        raise "Error while sending a PUT request #{uri}\npayload: #{payload.inspect}\n#{e}"
      else
        raise e
      end
    end
  end