require File.dirname(__FILE__) + '/spec_helper.rb' describe AMEE::Connection do it "requires server name, username, and password" do flexmock(Net::HTTP).new_instances.should_receive(:start => nil) lambda{AMEE::Connection.new(nil, nil, nil)}.should raise_error lambda{AMEE::Connection.new(nil, 'username', nil)}.should raise_error lambda{AMEE::Connection.new(nil, nil, 'password')}.should raise_error lambda{AMEE::Connection.new(nil, 'username', 'password')}.should raise_error lambda{AMEE::Connection.new('server.example.com', nil, nil)}.should raise_error lambda{AMEE::Connection.new('server.example.com', 'username', nil)}.should raise_error lambda{AMEE::Connection.new('server.example.com', nil, 'password')}.should raise_error c = AMEE::Connection.new('server.example.com', 'username', 'password') c.should be_valid end it "has default timeout of 60 seconds" do flexmock(Net::HTTP).new_instances.should_receive(:start => nil) c = AMEE::Connection.new('server.example.com', 'username', 'password') c.timeout.should be(60) end it "can set timeout" do flexmock(Net::HTTP).new_instances.should_receive(:start => nil) c = AMEE::Connection.new('server.example.com', 'username', 'password') c.timeout = 30 c.timeout.should be(30) end it "can set timeout on creation" do flexmock(Net::HTTP).new_instances.should_receive(:start => nil) c = AMEE::Connection.new('server.example.com', 'username', 'password', :timeout => 30) c.timeout.should be(30) end end describe AMEE::Connection, "with authentication" do it "should start out unauthenticated" do flexmock(Net::HTTP).new_instances.should_receive(:start => nil) amee = AMEE::Connection.new('server.example.com', 'username', 'password') amee.authenticated?.should be_false end it "detects the API version (1)" do flexmock(Net::HTTP).new_instances do |mock| mock.should_receive(:start => nil) mock.should_receive(:request).and_return(flexmock(:code => '200', :body => '0', :'[]' => 'dummy_auth_token_data')) mock.should_receive(:finish => nil) end amee = AMEE::Connection.new('server.example.com', 'username', 'password') amee.authenticate amee.authenticated?.should be_true amee.version.should == 1.0 end it "detects the API version (2 - XML)" do flexmock(Net::HTTP).new_instances do |mock| mock.should_receive(:start => nil) mock.should_receive(:request).and_return(flexmock(:code => '200', :body => '/authACTIVESTANDARDameeStandardAll2.0', :'[]' => 'dummy_auth_token_data')) mock.should_receive(:finish => nil) end amee = AMEE::Connection.new('server.example.com', 'username', 'password') amee.authenticate amee.authenticated?.should be_true amee.version.should == 2.0 end it "detects the API version (2 - JSON)" do flexmock(Net::HTTP).new_instances do |mock| mock.should_receive(:start => nil) mock.should_receive(:request).and_return(flexmock(:code => '200', :body => '{ "next" : "/auth","user" : { "apiVersion" : "2.0","groupNames" : [ "amee","Standard","All"],"status" : "ACTIVE","type" : "STANDARD","uid" : "DB2C6DA7EAA7"}}', :'[]' => 'dummy_auth_token_data')) mock.should_receive(:finish => nil) end amee = AMEE::Connection.new('server.example.com', 'username', 'password') amee.authenticate amee.authenticated?.should be_true amee.version.should == 2.0 end it "should be able to get private URLs" do flexmock(Net::HTTP).new_instances do |mock| mock.should_receive(:start => nil) mock.should_receive(:request).and_return(flexmock(:code => '401', :body => '')).once mock.should_receive(:request).and_return(flexmock(:code => '200', :body => '', :'[]' => 'dummy_auth_token_data')).once mock.should_receive(:request).and_return { |request| if request['authToken'] == 'dummy_auth_token_data' flexmock(:code => '200', :body => 'RootHomehomeMetadatametadataTesttestTransporttransportUseruser') else flexmock(:code => '401', :body => '') end }.once mock.should_receive(:finish => nil) end amee = AMEE::Connection.new('server.example.com', 'username', 'password') amee.get('/data') do |response| response.should_not be_empty end amee.authenticated?.should be_true end it "should handle 404s gracefully" do flexmock(Net::HTTP).new_instances.should_receive(:start => nil, :request => flexmock(:code => '404', :body => ""), :finish => nil) amee = AMEE::Connection.new('server.example.com', 'username', 'password') lambda{amee.get('/missing_url')}.should raise_error(AMEE::NotFound, "The URL was not found on the server.\nRequest: GET /missing_url") end it "should raise error if permission for operation is denied" do flexmock(Net::HTTP).new_instances do |mock| mock.should_receive(:start => nil) mock.should_receive(:request).and_return(flexmock(:code => '403', :body => '{}')) mock.should_receive(:finish => nil) end amee = AMEE::Connection.new('server.example.com', 'username', 'password') lambda { amee.get('/data') }.should raise_error(AMEE::PermissionDenied,"You do not have permission to perform the requested operation. Request: GET /data Response: {}") end it "should raise error if authentication succeeds, but permission for operation is denied" do flexmock(Net::HTTP).new_instances do |mock| mock.should_receive(:start => nil) mock.should_receive(:request).and_return(flexmock(:code => '401', :body => ''), flexmock(:code => '200', :body => '', :'[]' => 'dummy_auth_token_data'), flexmock(:code => '403', :body => '{}')) mock.should_receive(:finish => nil) end amee = AMEE::Connection.new('server.example.com', 'username', 'password') lambda { amee.get('/data') }.should raise_error(AMEE::PermissionDenied,"You do not have permission to perform the requested operation. Request: GET /data Response: {}") amee.authenticated?.should be_true end it "should raise error if unhandled errors occur in connection" do flexmock(Net::HTTP).new_instances do |mock| mock.should_receive(:start => nil) mock.should_receive(:request).and_return(flexmock(:code => '500', :body => '{}')) mock.should_receive(:finish => nil) end amee = AMEE::Connection.new('server.example.com', 'username', 'password') lambda { amee.get('/data') }.should raise_error(AMEE::UnknownError,"An error occurred while talking to AMEE: HTTP response code 500. Request: GET /data Response: {}") end end describe AMEE::Connection, "with retry enabled" do [ Timeout::Error, Errno::EINVAL, Errno::ECONNRESET, EOFError, Net::HTTPBadResponse, Net::HTTPHeaderSyntaxError, Net::ProtocolError ].each do |e| it "should retry after #{e.name} the correct number of times" do flexmock(Net::HTTP).new_instances do |mock| mock.should_receive(:start => nil) mock.should_receive(:request).and_raise(e.new).twice mock.should_receive(:request).and_return(flexmock(:code => '200', :body => '{}')).once mock.should_receive(:finish => nil) end amee = AMEE::Connection.new('server.example.com', 'username', 'password', :retries => 2) lambda { amee.get('/data') }.should_not raise_error end it "should retry #{e.name} the correct number of times and raise error on failure" do flexmock(Net::HTTP).new_instances do |mock| mock.should_receive(:start => nil) mock.should_receive(:request).and_raise(e.new).times(3) mock.should_receive(:finish => nil) end amee = AMEE::Connection.new('server.example.com', 'username', 'password', :retries => 2) lambda { amee.get('/data') }.should raise_error(e) end end [ '502', '503', '504' ].each do |e| it "should retry after #{e} the correct number of times" do flexmock(Net::HTTP).new_instances do |mock| mock.should_receive(:start => nil) mock.should_receive(:request).and_return(flexmock(:code => e, :body => '{}')).twice mock.should_receive(:request).and_return(flexmock(:code => '200', :body => '{}')).once mock.should_receive(:finish => nil) end amee = AMEE::Connection.new('server.example.com', 'username', 'password', :retries => 2) lambda { amee.get('/data') }.should_not raise_error end it "should retry #{e} the correct number of times and raise error on failure" do flexmock(Net::HTTP).new_instances do |mock| mock.should_receive(:start => nil) mock.should_receive(:request).and_return(flexmock(:code => e, :body => '{}')).times(3) mock.should_receive(:finish => nil) end amee = AMEE::Connection.new('server.example.com', 'username', 'password', :retries => 2) lambda { amee.get('/data') }.should raise_error(AMEE::ConnectionFailed) end end end describe AMEE::Connection, "with incorrect server name" do it "should raise a useful error" do flexmock(Net::HTTP).new_instances.should_receive(:start).and_raise(SocketError.new) amee = AMEE::Connection.new('badservername.example.com', 'username', 'password') lambda{ amee.get('/') }.should raise_error(AMEE::ConnectionFailed, "Connection failed. Check server name or network connection.") end end describe AMEE::Connection, "with bad authentication information" do it "should be capable of making requests for public URLs" do flexmock(Net::HTTP).new_instances.should_receive(:start => nil, :request => flexmock(:code => '200', :body => ""), :finish => nil) amee = AMEE::Connection.new('server.example.com', 'wrong', 'details') lambda{amee.get('/')}.should_not raise_error end it "should get an authentication failure when accessing private URLs" do flexmock(Net::HTTP).new_instances.should_receive(:start => nil, :request => flexmock(:code => '401', :body => "", :'[]' => nil), :finish => nil) amee = AMEE::Connection.new('server.example.com', 'wrong', 'details') lambda{amee.get('/data')}.should raise_error(AMEE::AuthFailed, "Authentication failed. Please check your username and password. (tried wrong,details)") end end describe AMEE::Connection, "with authentication , doing write-requests" do it "should be able to send post requests" do flexmock(Net::HTTP).new_instances do |mock| mock.should_receive(:start => nil) mock.should_receive(:request).and_return(flexmock(:code => '200', :body => '')) mock.should_receive(:finish => nil) end amee = AMEE::Connection.new('server.example.com', 'username', 'password') amee.post('/profiles', :test => 1, :test2 => 2) do |response| response.should be_empty end end it "should be able to send put requests" do flexmock(Net::HTTP).new_instances do |mock| mock.should_receive(:start => nil) mock.should_receive(:request).and_return(flexmock(:code => '200', :body => '')) mock.should_receive(:finish => nil) end amee = AMEE::Connection.new('server.example.com', 'username', 'password') amee.put('/profiles/ABC123', :test => 1, :test2 => 2) do |response| response.should be_empty end end it "should be able to send delete requests" do flexmock(Net::HTTP).new_instances do |mock| mock.should_receive(:start => nil) mock.should_receive(:request).and_return(flexmock(:code => '200', :body => '')) mock.should_receive(:finish => nil) end amee = AMEE::Connection.new('server.example.com', 'username', 'password') amee.delete('/profiles/ABC123') do |response| response.should be_empty end end end