lita-pagerduty 0.2.0 → 1.0.0

data/spec/lita/handlers/forget_spec.rb

@@ -0,0 +1,22 @@
+require 'spec_helper'
+
+describe Lita::Handlers::Pagerduty, lita_handler: true do
+  context 'pager forget' do
+    it do
+      is_expected.to route_command('pager forget').to(:forget)
+    end
+
+    it 'existing' do
+      user = Lita::User.create(123, name: 'foo')
+      send_command('pager identify foo@example.com', as: user)
+      send_command('pager forget', as: user)
+      expect(replies.last).to eq('Your email has now been forgotten.')
+    end
+
+    it 'non-existing' do
+      user = Lita::User.create(123, name: 'foo')
+      send_command('pager forget', as: user)
+      expect(replies.last).to eq('No email on record for you.')
+    end
+  end
+end

data/spec/lita/handlers/identify_email_spec.rb

@@ -0,0 +1,22 @@
+require 'spec_helper'
+
+describe Lita::Handlers::Pagerduty, lita_handler: true do
+  context 'pager identify foobar@example.com' do
+    it do
+      is_expected.to route_command('pager identify foobar@example.com').to(:identify)
+    end
+
+    it 'identify first time' do
+      user = Lita::User.create(123, name: 'foo')
+      send_command('pager identify foo@example.com', as: user)
+      expect(replies.last).to eq('You have now been identified.')
+    end
+
+    it 'identify existing user' do
+      user = Lita::User.create(123, name: 'foo')
+      send_command('pager identify foo@example.com', as: user)
+      send_command('pager identify foo@example.com', as: user)
+      expect(replies.last).to eq('You have already been identified!')
+    end
+  end
+end

data/spec/lita/handlers/incident_id_spec.rb

@@ -0,0 +1,23 @@
+require 'spec_helper'
+
+describe Lita::Handlers::Pagerduty, lita_handler: true do
+  context 'incident ABC123' do
+    it do
+      is_expected.to route_command('pager incident ABC123').to(:incident)
+    end
+
+    it 'found' do
+      expect_any_instance_of(Pagerduty).to receive(:get_incident).and_return({
+        id: 'ABC123', title: 'ABC', html_url: 'https://foo.pagerduty.com/incidents/ABC123'
+      })
+      send_command('pager incident ABC123')
+      expect(replies.last).to eq('ABC123: "ABC", assigned to: "none", url: https://foo.pagerduty.com/incidents/ABC123')
+    end
+
+    it 'not found' do
+      expect_any_instance_of(Pagerduty).to receive(:get_incident).and_raise(Exceptions::IncidentNotFound)
+      send_command('pager incident ABC123')
+      expect(replies.last).to eq('ABC123: Incident not found')
+    end
+  end
+end

data/spec/lita/handlers/incidents_all_spec.rb

@@ -0,0 +1,31 @@
+require 'spec_helper'
+
+describe Lita::Handlers::Pagerduty, lita_handler: true do
+  context 'incidents all' do
+    it do
+      is_expected.to route_command('pager incidents all').to(:incidents_all)
+    end
+
+    it 'empty list' do
+      expect_any_instance_of(Pagerduty).to receive(:get_incidents).and_raise(Exceptions::IncidentsEmptyList)
+      send_command('pager incidents all')
+      expect(replies.last).to eq('No triggered, open, or acknowledged incidents')
+    end
+
+    it 'list of incidents' do
+      expect_any_instance_of(Pagerduty).to receive(:get_incidents).and_return([
+        { id: 'ABC123', title: 'ABC', html_url: 'https://foo.pagerduty.com/incidents/ABC123' }
+      ])
+      send_command('pager incidents all')
+      expect(replies.last).to eq('ABC123: "ABC", assigned to: "none", url: https://foo.pagerduty.com/incidents/ABC123')
+    end
+
+    it 'list of assigned incidents' do
+      expect_any_instance_of(Pagerduty).to receive(:get_incidents).and_return([
+        { id: 'ABC123', title: 'ABC', html_url: 'https://foo.pagerduty.com/incidents/ABC123', assignments: [{ assignee: { summary: 'foo' } }] }
+      ])
+      send_command('pager incidents all')
+      expect(replies.last).to eq('ABC123: "ABC", assigned to: "foo", url: https://foo.pagerduty.com/incidents/ABC123')
+    end
+  end
+end

data/spec/lita/handlers/incidents_mine_spec.rb

@@ -0,0 +1,35 @@
+require 'spec_helper'
+
+describe Lita::Handlers::Pagerduty, lita_handler: true do
+  context 'incidents mine' do
+    it do
+      is_expected.to route_command('pager incidents mine').to(:incidents_mine)
+    end
+
+    it 'unknown user' do
+      user = Lita::User.create(123, name: 'foo')
+      send_command('pager incidents mine', as: user)
+      expect(replies.last).to eq('You have no triggered, open, or acknowledged incidents')
+    end
+
+    it 'empty list' do
+      user = Lita::User.create(123, name: 'foo')
+      send_command('pager identify foo@pagerduty.com', as: user)
+      expect_any_instance_of(Pagerduty).to receive(:get_users).and_return([{ id: 'abc123'}])
+      expect_any_instance_of(Pagerduty).to receive(:get_incidents).and_raise(Exceptions::IncidentsEmptyList)
+      send_command('pager incidents mine', as: user)
+      expect(replies.last).to eq('No triggered, open, or acknowledged incidents')
+    end
+
+    it 'list of incidents' do
+      user = Lita::User.create(123, name: 'foo')
+      send_command('pager identify foo@pagerduty.com', as: user)
+      expect_any_instance_of(Pagerduty).to receive(:get_users).and_return([{ id: 'abc123'}])
+      expect_any_instance_of(Pagerduty).to receive(:get_incidents).and_return([
+        { id: 'ABC123', title: 'ABC', html_url: 'https://foo.pagerduty.com/incidents/ABC123', assignments: [{ assignee: { summary: 'foo' } }] }
+      ])
+      send_command('pager incidents mine', as: user)
+      expect(replies.last).to eq('ABC123: "ABC", assigned to: "foo", url: https://foo.pagerduty.com/incidents/ABC123')
+    end
+  end
+end

data/spec/lita/handlers/notes_spec.rb

@@ -0,0 +1,29 @@
+require 'spec_helper'
+
+describe Lita::Handlers::Pagerduty, lita_handler: true do
+  context 'notes ABC123' do
+    it do
+      is_expected.to route_command('pager notes ABC123').to(:notes)
+    end
+
+    it 'incident not found' do
+      expect_any_instance_of(Pagerduty).to receive(:get_notes_by_incident_id).and_raise(Exceptions::IncidentNotFound)
+      send_command('pager notes ABC123')
+      expect(replies.last).to eq('ABC123: Incident not found')
+    end
+
+    it 'notes list' do
+      expect_any_instance_of(Pagerduty).to receive(:get_notes_by_incident_id).and_return([
+        { content: 'Content', user: { summary: 'foo' } }
+      ])
+      send_command('pager notes ABC123')
+      expect(replies.last).to eq('ABC123: Content (foo)')
+    end
+
+    it 'empty notes list' do
+      expect_any_instance_of(Pagerduty).to receive(:get_notes_by_incident_id).and_raise(Exceptions::NotesEmptyList)
+      send_command('pager notes ABC123')
+      expect(replies.last).to eq('ABC123: No notes')
+    end
+  end
+end

data/spec/lita/handlers/on_call_list_spec.rb

@@ -0,0 +1,21 @@
+require 'spec_helper'
+
+describe Lita::Handlers::Pagerduty, lita_handler: true do
+  context 'oncall' do
+    it do
+      is_expected.to route_command('pager oncall').to(:on_call_list)
+    end
+
+    it 'empty list' do
+      expect_any_instance_of(Pagerduty).to receive(:get_schedules).and_raise(Exceptions::SchedulesEmptyList)
+      send_command('pager oncall')
+      expect(replies.last).to eq('No schedules found')
+    end
+
+    it 'list' do
+      expect_any_instance_of(Pagerduty).to receive(:get_schedules).and_return([{ name: 'A' }, { name: 'B' }])
+      send_command('pager oncall')
+      expect(replies.last).to eq("Available schedules:\nA\nB")
+    end
+  end
+end

data/spec/lita/handlers/on_call_lookup_spec.rb

@@ -0,0 +1,29 @@
+require 'spec_helper'
+
+describe Lita::Handlers::Pagerduty, lita_handler: true do
+  context 'oncall abc' do
+    it do
+      is_expected.to route_command('pager oncall abc').to(:on_call_lookup)
+    end
+
+    it 'schedule not found' do
+      expect_any_instance_of(Pagerduty).to receive(:get_schedules).and_raise(Exceptions::SchedulesEmptyList)
+      send_command('pager oncall abc')
+      expect(replies.last).to eq('No matching schedules found for \'abc\'')
+    end
+
+    it 'no one on call' do
+      expect_any_instance_of(Pagerduty).to receive(:get_schedules).and_return([{ id: 'abc123' }])
+      expect_any_instance_of(Pagerduty).to receive(:get_oncall_user).and_raise(Exceptions::NoOncallUser)
+      send_command('pager oncall abc')
+      expect(replies.last).to eq('No one is currently on call for abc')
+    end
+
+    it 'somebody on call' do
+      expect_any_instance_of(Pagerduty).to receive(:get_schedules).and_return([{ id: 'abc123', name: 'abc' }])
+      expect_any_instance_of(Pagerduty).to receive(:get_oncall_user).and_return({summary: 'foo', email: 'foo@pagerduty.com'})
+      send_command('pager oncall abc')
+      expect(replies.last).to eq('foo (foo@pagerduty.com) is currently on call for abc')
+    end
+  end
+end

data/spec/lita/handlers/pager_me_spec.rb

@@ -0,0 +1,56 @@
+require 'spec_helper'
+
+describe Lita::Handlers::Pagerduty, lita_handler: true do
+  context 'pager me abc 1m' do
+    it do
+      is_expected.to route_command('pager me abc 1m').to(:pager_me)
+    end
+
+    it 'unknown user' do
+      expect_any_instance_of(Pagerduty).to receive(:get_schedules).and_return([{ id: 'bcd123'}])
+      user = Lita::User.create(123, name: 'foo')
+      send_command('pager me abc 1m', as: user)
+      expect(replies.last).to eq('You have not identified yourself (use the help command for more info)')
+    end
+
+    it 'unrecognised user' do
+      user = Lita::User.create(123, name: 'foo')
+      send_command('pager identify foo@pagerduty.com', as: user)
+      expect_any_instance_of(Pagerduty).to receive(:get_schedules).and_return([{ id: 'bcd123'}])
+      expect_any_instance_of(Pagerduty).to receive(:get_users).and_raise(Exceptions::UsersEmptyList)
+      send_command('pager me abc 1m', as: user)
+      expect(replies.last).to eq('You have identified yourself with an email address unknown to PagerDuty')
+    end
+
+    it 'unknown schedule' do
+      user = Lita::User.create(123, name: 'foo')
+      send_command('pager identify foo@pagerduty.com', as: user)
+      expect_any_instance_of(Pagerduty).to receive(:get_schedules).and_raise(Exceptions::SchedulesEmptyList)
+      send_command('pager me abc 1m', as: user)
+      expect(replies.last).to eq('No matching schedules found for \'abc\'')
+    end
+
+    it 'failure' do
+      user = Lita::User.create(123, name: 'foo')
+      send_command('pager identify foo@pagerduty.com', as: user)
+      expect_any_instance_of(Pagerduty).to receive(:get_schedules).and_return([{ id: 'abc123' }])
+      expect_any_instance_of(Pagerduty).to receive(:get_users).and_return([{id: 'abc123'}])
+      expect_any_instance_of(Pagerduty).to receive(:override).and_raise(Exceptions::OverrideUnsuccess)
+      send_command('pager me abc 1m', as: user)
+      expect(replies.last).to eq('failed to take the pager')
+    end
+
+    it 'success' do
+      user = Lita::User.create(123, name: 'foo')
+      send_command('pager identify foo@pagerduty.com', as: user)
+      expect_any_instance_of(Pagerduty).to receive(:get_schedules).and_return([{ id: 'abc123' }])
+      expect_any_instance_of(Pagerduty).to receive(:get_users).and_return([{id: 'abc123', email: 'foo@pagerduty.com'}])
+      expect_any_instance_of(Pagerduty).to receive(:override).and_return({
+        user: { summary: 'foo' },
+        end: 12345
+      })
+      send_command('pager me abc 1m', as: user)
+      expect(replies.last).to eq('foo (foo@pagerduty.com) is now on call until 12345')
+    end
+  end
+end

data/spec/lita/handlers/resolve_all_spec.rb

@@ -0,0 +1,26 @@
+require 'spec_helper'
+
+describe Lita::Handlers::Pagerduty, lita_handler: true do
+  context 'resolve all' do
+    it do
+      is_expected.to route_command('pager resolve all').to(:resolve_all)
+    end
+
+    it 'empty list' do
+      expect_any_instance_of(Pagerduty).to receive(:get_incidents).and_raise(Exceptions::IncidentsEmptyList)
+      send_command('pager resolve all')
+      expect(replies.last).to eq('No triggered, open, or acknowledged incidents')
+    end
+
+    it 'list of incidents' do
+      expect_any_instance_of(Pagerduty).to receive(:get_incidents).and_return([
+        { id: 'ABC123' }, { id: 'ABC124' }
+      ])
+      expect_any_instance_of(Pagerduty).to receive(:manage_incidents).and_return(
+        OpenStruct.new(status: 200)
+      )
+      send_command('pager resolve all')
+      expect(replies.last).to eq('Resolved: ABC123, ABC124')
+    end
+  end
+end

data/spec/lita/handlers/resolve_id_spec.rb

@@ -0,0 +1,21 @@
+require 'spec_helper'
+
+describe Lita::Handlers::Pagerduty, lita_handler: true do
+  context 'resolve ABC123' do
+    it do
+      is_expected.to route_command('pager resolve ABC123').to(:resolve)
+    end
+
+    it 'not found' do
+      expect_any_instance_of(Pagerduty).to receive(:manage_incidents).and_raise(Exceptions::IncidentManageUnsuccess)
+      send_command('pager resolve ABC123')
+      expect(replies.last).to be_nil
+    end
+
+    it 'found' do
+      expect_any_instance_of(Pagerduty).to receive(:manage_incidents)
+      send_command('pager resolve ABC123')
+      expect(replies.last).to eq 'Resolved: ABC123'
+    end
+  end
+end

data/spec/lita/handlers/resolve_mine_spec.rb

@@ -0,0 +1,38 @@
+require 'spec_helper'
+
+describe Lita::Handlers::Pagerduty, lita_handler: true do
+  context 'resolve mine' do
+    it do
+      is_expected.to route_command('pager resolve mine').to(:resolve_mine)
+    end
+
+    it 'unknown user' do
+      user = Lita::User.create(123, name: 'foo')
+      send_command('pager resolve mine', as: user)
+      expect(replies.last).to eq('You have no triggered, open, or acknowledged incidents')
+    end
+
+    it 'empty list' do
+      user = Lita::User.create(123, name: 'foo')
+      send_command('pager identify foo@pagerduty.com', as: user)
+      expect_any_instance_of(Pagerduty).to receive(:get_users).and_return([{ id: 'abc123' }])
+      expect_any_instance_of(Pagerduty).to receive(:get_incidents).and_raise(Exceptions::IncidentsEmptyList)
+      send_command('pager resolve mine', as: user)
+      expect(replies.last).to eq('You have no triggered, open, or acknowledged incidents')
+    end
+
+    it 'list of incidents' do
+      user = Lita::User.create(123, name: 'foo')
+      send_command('pager identify foo@pagerduty.com', as: user)
+      expect_any_instance_of(Pagerduty).to receive(:get_users).and_return([{ id: 'abc123' }])
+      expect_any_instance_of(Pagerduty).to receive(:get_incidents).and_return([
+        { id: 'ABC123' }, { id: 'ABC124' }
+      ])
+      expect_any_instance_of(Pagerduty).to receive(:manage_incidents).and_return(
+        OpenStruct.new(status: 200)
+      )
+      send_command('pager resolve mine', as: user)
+      expect(replies.last).to eq('Resolved: ABC123, ABC124')
+    end
+  end
+end

data/spec/pagerduty_spec.rb

@@ -0,0 +1,106 @@
+require 'spec_helper'
+
+describe Pagerduty do
+  let(:http) { double }
+  let(:pagerduty) { Pagerduty.new(http, 'token', 'email') }
+
+  before :each do
+    expect(http).to receive(:url_prefix=).with('https://api.pagerduty.com/')
+    expect(http).to receive(:headers=).with({
+      'Accept' => 'application/vnd.pagerduty+json;version=2',
+      'Authorization' => 'Token token=token',
+      'From' => 'email'
+    })
+  end
+
+  it 'get_incidents' do
+    expect(http).to receive(:get).with('/incidents', {}).and_return(
+      OpenStruct.new(body: { incidents: [{id: 1}]}.to_json)
+    )
+    expect(pagerduty.get_incidents).to eq([{ id: 1 }])
+
+    expect(http).to receive(:get).with('/incidents', {}).and_return(
+      OpenStruct.new(body: { incidents: []}.to_json)
+    )
+    expect{ pagerduty.get_incidents }.to raise_exception Exceptions::IncidentsEmptyList
+  end
+
+  it 'get_incident' do
+    expect(http).to receive(:get).with('/incidents/ABC123').and_return(
+      OpenStruct.new(body: { incident: {}}.to_json)
+    )
+    pagerduty.get_incident('ABC123')
+  end
+
+  it 'get_users' do
+    expect(http).to receive(:get).with('/users', {}).and_return(
+      OpenStruct.new(body: { users: [{ id: 1 }]}.to_json)
+    )
+    expect(pagerduty.get_users).to eq [{ id: 1 }]
+
+    expect(http).to receive(:get).with('/users', {}).and_return(
+      OpenStruct.new(body: { users: []}.to_json)
+    )
+    expect{ pagerduty.get_users }.to raise_exception Exceptions::UsersEmptyList
+  end
+
+  it 'get_notes_by_incident_id' do
+    expect(http).to receive(:get).with('/incidents/ABC123/notes').and_return(
+      OpenStruct.new(body: { notes: [{ id: 1 }]}.to_json)
+    )
+    expect(pagerduty.get_notes_by_incident_id('ABC123')).to eq [{ id: 1 }]
+
+    expect(http).to receive(:get).with('/incidents/ABC123/notes').and_return(
+      OpenStruct.new(body: { notes: []}.to_json)
+    )
+    expect{ pagerduty.get_notes_by_incident_id('ABC123') }.to raise_exception Exceptions::NotesEmptyList
+  end
+
+  it 'manage_incidents' do
+    params = { incidents: [
+      { id: 'a', status: 'acknowledged', type: 'incident_reference' },
+      { id: 'b', status: 'acknowledged', type: 'incident_reference' }
+    ]}
+    expect(http).to receive(:put).with('/incidents', params).and_return(
+      OpenStruct.new(body: { users: [] }.to_json, status: 200)
+    )
+    pagerduty.manage_incidents(:acknowledge, ['a', 'b'])
+  end
+
+  it 'get_schedules' do
+    expect(http).to receive(:get).with('/schedules', {}).and_return(
+      OpenStruct.new(body: { schedules: [{ id: 1 }]}.to_json)
+    )
+    expect(pagerduty.get_schedules).to eq [{ id: 1 }]
+
+    expect(http).to receive(:get).with('/schedules', {}).and_return(
+      OpenStruct.new(body: { incidents: []}.to_json)
+    )
+    expect{ pagerduty.get_schedules }.to raise_exception Exceptions::SchedulesEmptyList
+  end
+
+  it 'get_oncall_user' do
+    expect(http).to receive(:get).with('/oncalls', {}).and_return(
+      OpenStruct.new(body: { oncalls: [{ id: 1, user: 'abc' }]}.to_json)
+    )
+    expect(pagerduty.get_oncall_user).to eq('abc')
+
+    expect(http).to receive(:get).with('/oncalls', {}).and_return(
+      OpenStruct.new(body: { incidents: []}.to_json)
+    )
+    expect{ pagerduty.get_oncall_user }.to raise_exception Exceptions::NoOncallUser
+  end
+
+  it 'override' do
+    expect(Time).to receive(:now).and_return(Time.new(2000))
+    params = { override: {
+        end: '2000-01-01T00:01:10Z',
+        start: '2000-01-01T00:00:10Z',
+        user: { id: 'b', type: 'user_reference' }
+    } }
+    expect(http).to receive(:post).with('/schedules/a/overrides', params).and_return(
+      OpenStruct.new(body: { override: []}.to_json, status: 201)
+    )
+    pagerduty.override('a', 'b', 1)
+  end
+end