status_page-api 0.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: e2639d460eefcc7f5c041c85269d016bcfd49f6e
+  data.tar.gz: fbc1dd24fd91594a256db4c0362d3c0dd5fb5020
+SHA512:
+  metadata.gz: 5bd5f444101565a3f60c1288a87041564821413a9578a611cf0fef6b9479ba9756de026f794cbfad617774bd8653ce73c94e377e07d99804bf718fb68b02944c
+  data.tar.gz: d12f087c994e88c0eac00610e0de4f5b9b6acc53abefc302777d1b0797213ca78b6f58f4965f9323e40b287ee878a61183163e9f7616b2e029b8d7e24b22e2d2

data/.gitignore

@@ -0,0 +1,3 @@
+.git/
+coverage/
+Gemfile.lock

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--require spec_helper

data/.ruby-version

@@ -0,0 +1 @@
+2.4.0

data/.travis.yml

@@ -0,0 +1,8 @@
+language: ruby
+rvm:
+  - 2.1.10
+  - 2.2.6
+  - 2.3.3
+  - 2.4.0
+script:
+  - bundle exec rspec

data/Gemfile

@@ -0,0 +1,2 @@
+source 'http://rubygems.org'
+gemspec

data/README.md

@@ -0,0 +1,74 @@
+# StatusPage::API
+
+[![NYU](https://github.com/NYULibraries/nyulibraries-assets/blob/master/lib/assets/images/nyu.png)](https://dev.library.nyu.edu)
+[![Build Status](https://travis-ci.org/NYULibraries/status_page-api.svg)](https://travis-ci.org/NYULibraries/status_page-api)
+[![Code Climate](https://codeclimate.com/github/NYULibraries/status_page-api/badges/gpa.svg)](https://codeclimate.com/github/NYULibraries/status_page-api)
+[![Coverage Status](https://coveralls.io/repos/github/NYULibraries/status_page-api/badge.svg?branch=development)](https://coveralls.io/github/NYULibraries/status_page-api?branch=development)
+
+Ruby client for [StatusPage](https://www.statuspage.io/) [REST API](https://doers.statuspage.io/api/v1/).
+
+## Installation
+
+```
+gem 'status_page-api', github: "NYULibraries/status_page-api"
+require 'status_page/api'
+```
+
+You must set `STATUS_PAGE_API_KEY` environment variable to your API key.
+
+## Usage
+
+### Get component list
+
+To fetch a list of components for a particular page:
+
+```
+component_list = StatusPage::API::ComponentList.new('page_id')
+component_list.get
+```
+
+You can then interact with the instance as if it were an array:
+
+```
+component_list[0]
+component_list.map(&:id)
+component_list.each do |component|
+  # do something with component
+end
+```
+
+### Get component data
+
+To fetch a particular component:
+
+```
+component = StatusPage::API::Component.new('component_id', 'page_id')
+component.get
+```
+
+All data returned by the API exists in instance methods, e.g.:
+
+```
+component.id
+component.name
+component.description
+component.status
+component.page_id
+component.group_id
+component.created_at
+component.updated_at
+```
+
+### Modifying a component
+
+The API only allows the following fields to be modified: `status`, `name`, and `description`.
+
+To modify a field:
+
+```
+component.status = 'major_outage'
+component.description = 'Hello world'
+component.save
+```
+
+The `save` method does not catch any errors raised by `RestClient`.

data/lib/status_page.rb

@@ -0,0 +1,4 @@
+require 'status_page/api'
+
+module StatusPage
+end

data/lib/status_page/api.rb

@@ -0,0 +1,11 @@
+require 'rest_client'
+require 'json'
+require 'status_page/api/base'
+require 'status_page/api/component_list'
+require 'status_page/api/component'
+require 'status_page/api/exception'
+
+module StatusPage
+  module API
+  end
+end

data/lib/status_page/api/base.rb

@@ -0,0 +1,43 @@
+module StatusPage
+  module API
+    class Base
+      # sends request to status page API for given path and method, passing any other options through to RestClient
+      # parses the response and returns as a ruby hash or array
+      def execute(path, method:, **options)
+        default_options = {headers: headers, method: method, url: get_full_url(path)}
+        JSON.parse(RestClient::Request.execute(default_options.merge(options)))
+      rescue ::RestClient::Exception => e
+        raise Exception.new(e)
+      end
+
+      # sends GET request for subclass's resource_path and returns json result as hash
+      def get_resource
+        execute(resource_path, method: :get)
+      end
+
+      # sends PATCH request for subclass's resource_path and returns json result as hash;
+      # accepts a payload parameter to convert to JSON body
+      def patch_resource(payload)
+        execute(resource_path, method: :patch, payload: payload.to_json)
+      end
+
+      private
+
+      def resource_path
+        raise("Must define resource_path in your subclass")
+      end
+
+      def get_full_url(subpath)
+        "https://api.statuspage.io/v1/#{subpath}"
+      end
+
+      def headers
+        {"Authorization" => "OAuth #{api_key}", "Content-Type" => "application/json"}
+      end
+
+      def api_key
+        ENV['STATUS_PAGE_API_KEY'] || raise("Must specify STATUS_PAGE_API_KEY to use StatusPage")
+      end
+    end
+  end
+end

data/lib/status_page/api/component.rb

@@ -0,0 +1,60 @@
+module StatusPage
+  module API
+    class Component < Base
+
+      MUTABLE_ATTRIBUTES = %i[name description status]
+      IMMUTABLE_ATTRIBUTES = %i[id page_id group_id created_at updated_at position]
+
+      attr_accessor(*MUTABLE_ATTRIBUTES)
+      attr_reader(*IMMUTABLE_ATTRIBUTES)
+
+      STATUSES = %w[operational degraded_performance partial_outage major_outage]
+      SUCCESS_STATUS = 'operational'
+
+      def initialize(id, page_id)
+        assign_attributes(id: id, page_id: page_id)
+      end
+
+      def get
+        assign_attributes(get_resource)
+      end
+
+      def save
+        assign_attributes(patch_resource({component: mutable_attributes})) if mutable_attributes.any?
+      end
+
+      def failing?
+        status != SUCCESS_STATUS
+      end
+
+      def status=(status_type)
+        validate_status(status_type)
+        @status = status_type
+      end
+
+      def resource_path
+        "pages/#{page_id}/components/#{id}.json"
+      end
+
+      def assign_attributes(attributes)
+        attributes.each do |key, value|
+          instance_variable_set("@#{key}", value)
+        end
+      end
+
+      private
+
+      def mutable_attributes
+        MUTABLE_ATTRIBUTES.inject({}) do |result, attr_name|
+          result[attr_name] = send(attr_name) if send(attr_name)
+          result
+        end
+      end
+
+      def validate_status(status_type)
+        STATUSES.include?(status_type.to_s) || raise("Status '#{status_type}' not recognized. Valid statuses: #{STATUSES}")
+      end
+
+    end
+  end
+end

data/lib/status_page/api/component_list.rb

@@ -0,0 +1,26 @@
+module StatusPage
+  module API
+    class ComponentList < Base
+      extend Forwardable
+      delegate [:to_a, :to_ary, :[], :map, :each] => :@components
+
+      attr_accessor :page_id
+
+      def initialize(page_id)
+        @page_id = page_id
+      end
+
+      def get
+        @components = get_resource.map do |attributes|
+          comp = Component.new attributes["id"], attributes["page_id"]
+          comp.assign_attributes attributes
+          comp
+        end
+      end
+
+      def resource_path
+        "pages/#{page_id}/components.json"
+      end
+    end
+  end
+end

data/lib/status_page/api/exception.rb

@@ -0,0 +1,29 @@
+module StatusPage
+  module API
+    class Exception < StandardError
+      attr_reader :rest_client_error
+
+      def initialize(rest_client_error)
+        @rest_client_error = rest_client_error
+        super(message)
+      end
+
+      # generates message from original error and JSON response
+      def message
+        "#{rest_client_error.message} (#{response})"
+      end
+
+      # parses error from JSON response if possible
+      # if invalid JSON, or JSON missing "error" key, returns full JSON string
+      def response
+        return "NO RESPONSE" unless rest_client_error.response
+        error_text = JSON.parse(rest_client_error.response)["error"]
+        error_text.is_a?(Array) ? error_text.join(", ") : error_text
+      rescue JSON::ParserError
+        rest_client_error.response
+      rescue NoMethodError
+        rest_client_error.response
+      end
+    end
+  end
+end

data/lib/status_page/version.rb

@@ -0,0 +1,3 @@
+module StatusPage
+  VERSION = "0.0.0"
+end

data/spec/lib/status_page/api/base_spec.rb

@@ -0,0 +1,208 @@
+require 'spec_helper'
+require 'status_page'
+
+describe StatusPage::API::Base do
+  let(:base){ described_class.new }
+
+  describe "execute" do
+    context "with STATUS_PAGE_API_KEY" do
+      # stub out api key env variable
+      let(:status_page_api_key){ "XXXX" }
+      around do |example|
+        with_modified_env STATUS_PAGE_API_KEY: status_page_api_key do
+          example.run
+        end
+      end
+
+      context "given successful response" do
+        # stub out request/response
+        let(:response){ {"name"=>"apple", "id"=>"xyz"} }
+        let(:json_response){ response.to_json }
+        let(:url_result){ "https://api.statuspage.io/v1/sample/path.json" }
+        before do
+          allow(RestClient::Request).to receive(:execute).and_return json_response
+        end
+
+        it "should call execute with URL generated from path" do
+          expect(RestClient::Request).to receive(:execute).with(hash_including(url: url_result))
+          base.execute "sample/path.json", method: :get
+        end
+
+        it "should call execute with method specified" do
+          expect(RestClient::Request).to receive(:execute).with(hash_including(method: :patch))
+          base.execute "sample/path.json", method: :patch
+        end
+
+        it "should call execute with headers" do
+          expect(RestClient::Request).to receive(:execute).with(hash_including(headers: {"Authorization" => "OAuth #{status_page_api_key}", "Content-Type" => "application/json"}))
+          base.execute "sample/path.json", method: :get
+        end
+
+        it "should raise error if no method specified" do
+          expect{ base.execute "sample/path.json" }.to raise_error ArgumentError
+        end
+
+        it "should call execute with any additional options specified" do
+          expect(RestClient::Request).to receive(:execute).with(hash_including(option: :value, arr: [1,2]))
+          base.execute "sample/path.json", method: :patch, option: :value, arr: [1,2]
+        end
+
+        it "should return parsed json" do
+          expect(JSON).to receive(:parse).with(json_response).and_call_original
+          expect(base.execute("sample/path.json", method: :patch)).to eq response
+        end
+      end
+
+      context "given response known to RestClient (422)" do
+        # stub out request/response
+        let(:error){ RestClient::UnprocessableEntity.new }
+        let(:json_response){ {"error" => ["Something went wrong"]}.to_json }
+        before do
+          allow(RestClient::Request).to receive(:execute).and_raise error
+          allow(error).to receive(:response).and_return json_response
+        end
+
+        it "should raise validation error parsed from response" do
+          expect{ base.execute "sample/path.json", method: :patch }.to raise_error StatusPage::API::Exception, "Unprocessable Entity (Something went wrong)"
+        end
+      end
+
+      context "given response unknown to RestClient (420)" do
+        # stub out request/response
+        let(:error){ RestClient::RequestFailed.new }
+        let(:json_response){ {"error" => "Slow your roll"}.to_json }
+        let(:http_code){ 420 }
+        before do
+          allow(RestClient::Request).to receive(:execute).and_raise error
+          allow(error).to receive(:response).and_return json_response
+          allow(error).to receive(:http_code).and_return http_code
+        end
+
+        it "should raise validation error parsed from response" do
+          expect{ base.execute "sample/path.json", method: :patch }.to raise_error StatusPage::API::Exception, "HTTP status code 420 (Slow your roll)"
+        end
+      end
+
+      context "given other error response" do
+        # stub out request/response
+        let(:error){ RestClient::ResourceNotFound.new }
+        before do
+          allow(RestClient::Request).to receive(:execute).and_raise error
+        end
+
+        it "should raise the error" do
+          expect{ base.execute "sample/path.json", method: :patch }.to raise_error StatusPage::API::Exception, "Not Found (NO RESPONSE)"
+        end
+      end
+    end
+
+    context "without STATUS_PAGE_API_KEY" do
+      # stub out api key env variable
+      around do |example|
+        with_modified_env STATUS_PAGE_API_KEY: nil do
+          example.run
+        end
+      end
+
+      it "should raise an error without calling api" do
+        expect(RestClient::Request).to_not receive(:execute)
+        expect{ base.execute "sample/path.json", method: :get }.to raise_error "Must specify STATUS_PAGE_API_KEY to use StatusPage"
+      end
+    end
+
+  end
+
+  describe "get_resource" do
+    subject { base.get_resource }
+    let(:result){ {a: :b} }
+    before { allow(base).to receive(:execute).and_return result }
+
+    context "with resource_path defined" do
+      let(:path){ "/some/path.json" }
+      before do
+        base.define_singleton_method(:resource_path){ "/some/path.json" }
+      end
+
+      it { is_expected.to eq result }
+
+      it "should call execute with correct parameters" do
+        expect(base).to receive(:execute).with(path, method: :get)
+        subject
+      end
+    end
+
+    context "without resource_path defined" do
+      it "should raise error" do
+        expect{ subject }.to raise_error("Must define resource_path in your subclass")
+      end
+    end
+  end
+
+  describe "patch_resource" do
+    subject { base.patch_resource payload }
+    let(:payload){ {some: :thing} }
+    let(:result){ {a: :b} }
+    before { allow(base).to receive(:execute).and_return result }
+
+    context "with resource_path defined" do
+      let(:path){ "/some/path.json" }
+      before do
+        base.define_singleton_method(:resource_path){ "/some/path.json" }
+      end
+
+      context "with hash payload" do
+        it { is_expected.to eq result }
+
+        it "should call execute with path and method" do
+          expect(base).to receive(:execute).with(path, hash_including(method: :patch))
+          subject
+        end
+
+        it "should call execute with payload as json" do
+          expect(base).to receive(:execute).with(path, hash_including(payload: payload.to_json))
+          subject
+        end
+      end
+
+      context "with string payload" do
+        let(:payload){ "abcd" }
+
+        it { is_expected.to eq result }
+
+        it "should call execute with path and method" do
+          expect(base).to receive(:execute).with(path, hash_including(method: :patch))
+          subject
+        end
+
+        it "should call execute with payload as json" do
+          expect(base).to receive(:execute).with(path, hash_including(payload: payload.to_json))
+          subject
+        end
+      end
+
+      context "with nil payload" do
+        let(:payload){ nil }
+
+        it { is_expected.to eq result }
+
+        it "should call execute with path and method" do
+          expect(base).to receive(:execute).with(path, hash_including(method: :patch))
+          subject
+        end
+
+        it "should call execute with json null payload" do
+          expect(base).to receive(:execute).with(path, hash_including(payload: payload.to_json))
+          subject
+        end
+      end
+    end
+
+    context "without resource_path defined" do
+      it "should raise error" do
+        expect{ subject }.to raise_error("Must define resource_path in your subclass")
+      end
+    end
+  end
+
+
+end

data/spec/lib/status_page/api/component_list_spec.rb

@@ -0,0 +1,54 @@
+require 'spec_helper'
+require 'status_page'
+
+describe StatusPage::API::ComponentList do
+  let(:page_id){ "zzzz" }
+  let(:component_list){ described_class.new page_id }
+
+  describe "get" do
+    subject { component_list.get }
+    # stub out request
+    let(:array_response) do
+      [
+        {"status"=>"operational", "name"=>"Library.nyu.edu", "id"=>"abcd", "page_id"=>"zzzz"},
+        {"status"=>"operational", "name"=>"E-Shelf", "id"=>"1234", "page_id"=>"zzzz"},
+        {"status"=>"operational", "name"=>"Login", "id"=>"wxyz", "page_id"=>"zzzz"},
+      ]
+    end
+    let(:component_class){ StatusPage::API::Component }
+    let(:component1){ double component_class, assign_attributes: true }
+    let(:component2){ double component_class, assign_attributes: true }
+    let(:component3){ double component_class, assign_attributes: true }
+    before do
+      allow(component_list).to receive(:get_resource).and_return array_response
+      allow(component_class).to receive(:new).and_return component1, component2, component3
+    end
+
+    it { is_expected.to be_a Array }
+    it { is_expected.to match_array [component1, component2, component3] }
+
+    it "should initialize each instance correctly" do
+      expect(component_class).to receive(:new).with("abcd", "zzzz").once
+      expect(component_class).to receive(:new).with("1234", "zzzz").once
+      expect(component_class).to receive(:new).with("wxyz", "zzzz").once
+      subject
+    end
+
+    it "should call assign_attributes on each instance" do
+      expect(component1).to receive(:assign_attributes).with(array_response[0])
+      expect(component2).to receive(:assign_attributes).with(array_response[1])
+      expect(component3).to receive(:assign_attributes).with(array_response[2])
+      subject
+    end
+
+    it "should persist array to instance" do
+      subject
+      expect(component_list).to match_array [component1, component2, component3]
+    end
+  end
+
+  describe "resource_path" do
+    subject { component_list.resource_path }
+    it { is_expected.to eq "pages/#{page_id}/components.json" }
+  end
+end

data/spec/lib/status_page/api/component_spec.rb

@@ -0,0 +1,289 @@
+require 'spec_helper'
+require 'status_page'
+
+describe StatusPage::API::Component do
+
+  describe "instance methods" do
+    let(:id){ "abcd" }
+    let(:page_id){ "wxyz" }
+    let(:component){ described_class.new id, page_id }
+
+    describe "id" do
+      subject { component.id }
+      it { is_expected.to eq id }
+    end
+
+    describe "page_id" do
+      subject { component.page_id }
+      it { is_expected.to eq page_id }
+    end
+
+    describe "get" do
+      subject { component.get }
+
+      context "with successful get" do
+        let(:result_attributes) do
+          {
+            "status"=>"operational",
+            "name"=>"Example site",
+            "created_at"=>"2015-07-14T19:41:51.042Z",
+            "updated_at"=>"2016-05-26T21:32:09.450Z",
+            "position"=>1,
+            "description"=>"Hello",
+            "id"=>"abcd",
+            "page_id"=>"wxyz",
+            "group_id"=>"nqrw"
+          }
+        end
+        before { allow(component).to receive(:get_resource).and_return result_attributes }
+
+        it { is_expected.to eq result_attributes }
+
+        context "after load" do
+          before { subject }
+          it "should assign id" do
+            expect(component.id).to eq "abcd"
+          end
+          it "should assign page_id" do
+            expect(component.page_id).to eq "wxyz"
+          end
+          it "should assign status" do
+            expect(component.status).to eq "operational"
+          end
+          it "should assign name" do
+            expect(component.name).to eq "Example site"
+          end
+          it "should assign created_at" do
+            expect(component.created_at).to eq "2015-07-14T19:41:51.042Z"
+          end
+          it "should assign updated_at" do
+            expect(component.updated_at).to eq "2016-05-26T21:32:09.450Z"
+          end
+          it "should assign position" do
+            expect(component.position).to eq 1
+          end
+          it "should assign description" do
+            expect(component.description).to eq "Hello"
+          end
+          it "should assign group_id" do
+            expect(component.group_id).to eq "nqrw"
+          end
+        end
+      end
+
+      context "with unsuccessful get" do
+        before { allow(component).to receive(:get_resource).and_raise RuntimeError, "some error" }
+
+        it "should raise that error" do
+          expect{ subject }.to raise_error RuntimeError, "some error"
+        end
+      end
+    end
+
+    describe "save" do
+      subject { component.save }
+      let(:result_attributes) do
+        {
+          "status"=>"major_outage",
+          "name"=>"Example site",
+          "created_at"=>"2015-07-14T19:41:51.042Z",
+          "updated_at"=>"2016-05-26T21:32:09.450Z",
+          "position"=>4,
+          "description"=>"Hello",
+          "id"=>"abcd",
+          "page_id"=>"wxyz",
+          "group_id"=>"nqrw"
+        }
+      end
+      before { allow(component).to receive(:patch_resource).and_return result_attributes }
+
+      context "with attributes assigned" do
+        let(:attributes) do
+          {
+            "status"=>"major_outage",
+            "name"=>"Example site",
+            "created_at"=>"2015-07-14T19:41:51.042Z",
+            "updated_at"=>"2016-05-26T21:32:09.450Z",
+            "position"=>1,
+            "description"=>"Hello",
+            "id"=>"abcd",
+            "page_id"=>"wxyz",
+            "group_id"=>"nqrw"
+          }
+        end
+        before { component.send(:assign_attributes, attributes) }
+
+        context "with successful response" do
+          it { is_expected.to eq result_attributes }
+
+          it "should call patch_resource with correct hash" do
+            expect(component).to receive(:patch_resource).with({component: {status: "major_outage", description: "Hello", name: "Example site"}})
+            subject
+          end
+
+          it "should assign any changed attributes" do
+            subject
+            expect(component.position).to eq 4
+          end
+        end
+
+        context "with unsuccessful response" do
+          before { allow(component).to receive(:patch_resource).and_raise RuntimeError, "some error" }
+
+          it "should raise that error" do
+            expect{ subject }.to raise_error RuntimeError, "some error"
+          end
+        end
+      end
+
+      context "with attributes unassigned" do
+        it "should not call patch_resource" do
+          expect(component).to_not receive(:patch_resource)
+          subject
+        end
+      end
+    end
+
+    describe "failing?" do
+      subject { component.failing? }
+      context "when status operational" do
+        before { component.status = "operational" }
+        it { is_expected.to be_falsy }
+      end
+      context "when status not operational" do
+        before { component.status = "major_outage" }
+        it { is_expected.to be_truthy }
+      end
+    end
+
+    describe "status=" do
+      subject { component.status = status_type }
+      let(:status_type){ "major_outage" }
+
+      it "should assign status" do
+        subject
+        expect(component.status).to eq status_type
+      end
+
+      context "with invalid status" do
+        let(:status_type){ "xyz" }
+        it "should raise error" do
+          expect{ subject }.to raise_error "Status 'xyz' not recognized. Valid statuses: [\"operational\", \"degraded_performance\", \"partial_outage\", \"major_outage\"]"
+        end
+      end
+    end
+
+    describe "resource_path" do
+      subject { component.resource_path }
+      it { is_expected.to eq "pages/#{page_id}/components/#{id}.json" }
+    end
+
+    describe "assign_attributes" do
+      subject { component.assign_attributes attributes }
+
+      context "given valid attributes with string keys" do
+        let(:attributes) do
+          {
+            "status"=>"operational",
+            "name"=>"Example site",
+            "created_at"=>"2015-07-14T19:41:51.042Z",
+            "updated_at"=>"2016-05-26T21:32:09.450Z",
+            "position"=>1,
+            "description"=>"Hello",
+            "id"=>"abcd",
+            "page_id"=>"wxyz",
+            "group_id"=>"nqrw"
+          }
+        end
+
+        it { is_expected.to eq attributes }
+
+        context "after call" do
+          before { subject }
+          it "should assign id" do
+            expect(component.id).to eq "abcd"
+          end
+          it "should assign page_id" do
+            expect(component.page_id).to eq "wxyz"
+          end
+          it "should assign status" do
+            expect(component.status).to eq "operational"
+          end
+          it "should assign name" do
+            expect(component.name).to eq "Example site"
+          end
+          it "should assign created_at" do
+            expect(component.created_at).to eq "2015-07-14T19:41:51.042Z"
+          end
+          it "should assign updated_at" do
+            expect(component.updated_at).to eq "2016-05-26T21:32:09.450Z"
+          end
+          it "should assign position" do
+            expect(component.position).to eq 1
+          end
+          it "should assign description" do
+            expect(component.description).to eq "Hello"
+          end
+          it "should assign group_id" do
+            expect(component.group_id).to eq "nqrw"
+          end
+        end
+      end
+
+      context "given valid attributes with symbol keys" do
+        let(:attributes) do
+          {
+            status: "operational",
+            name: "Example site",
+            created_at: "2015-07-14T19:41:51.042Z",
+            updated_at: "2016-05-26T21:32:09.450Z",
+            position: 1,
+            description: "Hello",
+            id: "abcd",
+            page_id: "wxyz",
+            group_id: "nqrw"
+          }
+        end
+
+        it { is_expected.to eq attributes }
+
+        context "after call" do
+          before { subject }
+          it "should assign id" do
+            expect(component.id).to eq "abcd"
+          end
+          it "should assign page_id" do
+            expect(component.page_id).to eq "wxyz"
+          end
+          it "should assign status" do
+            expect(component.status).to eq "operational"
+          end
+          it "should assign name" do
+            expect(component.name).to eq "Example site"
+          end
+          it "should assign created_at" do
+            expect(component.created_at).to eq "2015-07-14T19:41:51.042Z"
+          end
+          it "should assign updated_at" do
+            expect(component.updated_at).to eq "2016-05-26T21:32:09.450Z"
+          end
+          it "should assign position" do
+            expect(component.position).to eq 1
+          end
+          it "should assign description" do
+            expect(component.description).to eq "Hello"
+          end
+          it "should assign group_id" do
+            expect(component.group_id).to eq "nqrw"
+          end
+        end
+      end
+
+      context "given empty hash" do
+        let(:attributes){ {} }
+
+        it { is_expected.to eq attributes }
+      end
+    end
+  end
+end

data/spec/lib/status_page/api/exception_spec.rb

@@ -0,0 +1,69 @@
+require 'spec_helper'
+require 'status_page'
+
+describe StatusPage::API::Exception do
+  let(:exception){ described_class.new rest_client_error }
+
+  describe "message" do
+    subject{ exception.message }
+
+    before do
+      allow(exception).to receive(:response).and_return response
+    end
+
+    context "given response known to RestClient (422)" do
+      let(:rest_client_error){ RestClient::UnprocessableEntity.new }
+      let(:response){ "Something went wrong" }
+
+      it { is_expected.to eq "Unprocessable Entity (Something went wrong)" }
+    end
+
+    context "given response unknown to RestClient (420)" do
+      let(:rest_client_error){ RestClient::RequestFailed.new }
+      let(:response){ "Slow your roll" }
+      let(:http_code){ 420 }
+      before do
+        allow(rest_client_error).to receive(:http_code).and_return http_code
+      end
+
+      it { is_expected.to eq "HTTP status code 420 (Slow your roll)" }
+    end
+
+    context "given empty error response" do
+      let(:rest_client_error){ RestClient::ResourceNotFound.new }
+      let(:response){ "NO RESPONSE" }
+
+      it { is_expected.to eq "Not Found (NO RESPONSE)" }
+    end
+  end
+
+  describe "response" do
+    subject{ exception.response }
+
+    context "given response known to RestClient (422)" do
+      let(:rest_client_error){ RestClient::UnprocessableEntity.new }
+      let(:json_response){ {"error" => ["Something went wrong"]}.to_json }
+      before do
+        allow(rest_client_error).to receive(:response).and_return json_response
+      end
+
+      it { is_expected.to eq "Something went wrong" }
+    end
+
+    context "given response unknown to RestClient (420)" do
+      let(:rest_client_error){ RestClient::RequestFailed.new }
+      let(:json_response){ {"error" => "Slow your roll"}.to_json }
+      before do
+        allow(rest_client_error).to receive(:response).and_return json_response
+      end
+
+      it { is_expected.to eq "Slow your roll" }
+    end
+
+    context "given empty error response" do
+      let(:rest_client_error){ RestClient::ResourceNotFound.new }
+
+      it { is_expected.to eq "NO RESPONSE" }
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,105 @@
+# This file was generated by the `rspec --init` command. Conventionally, all
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# The generated `.rspec` file contains `--require spec_helper` which will cause
+# this file to always be loaded, without a need to explicitly require it in any
+# files.
+#
+# Given that it is always loaded, you are encouraged to keep this file as
+# light-weight as possible. Requiring heavyweight dependencies from this file
+# will add to the boot time of your test suite on EVERY test run, even for an
+# individual file that may not need all of that loaded. Instead, consider making
+# a separate helper file that requires the additional dependencies and performs
+# the additional setup, and require it from the spec files that actually need
+# it.
+#
+# The `.rspec` file also contains a few flags that are not defaults but that
+# users commonly want.
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+
+require 'coveralls'
+Coveralls.wear!
+require 'support/modify_env'
+require 'pry'
+
+RSpec.configure do |config|
+
+  config.include ModifyEnv
+
+  # rspec-expectations config goes here. You can use an alternate
+  # assertion/expectation library such as wrong or the stdlib/minitest
+  # assertions if you prefer.
+  config.expect_with :rspec do |expectations|
+    # This option will default to `true` in RSpec 4. It makes the `description`
+    # and `failure_message` of custom matchers include text for helper methods
+    # defined using `chain`, e.g.:
+    #     be_bigger_than(2).and_smaller_than(4).description
+    #     # => "be bigger than 2 and smaller than 4"
+    # ...rather than:
+    #     # => "be bigger than 2"
+    expectations.include_chain_clauses_in_custom_matcher_descriptions = true
+  end
+
+  # rspec-mocks config goes here. You can use an alternate test double
+  # library (such as bogus or mocha) by changing the `mock_with` option here.
+  config.mock_with :rspec do |mocks|
+    # Prevents you from mocking or stubbing a method that does not exist on
+    # a real object. This is generally recommended, and will default to
+    # `true` in RSpec 4.
+    mocks.verify_partial_doubles = true
+  end
+
+# The settings below are suggested to provide a good initial experience
+# with RSpec, but feel free to customize to your heart's content.
+=begin
+  # These two settings work together to allow you to limit a spec run
+  # to individual examples or groups you care about by tagging them with
+  # `:focus` metadata. When nothing is tagged with `:focus`, all examples
+  # get run.
+  config.filter_run :focus
+  config.run_all_when_everything_filtered = true
+
+  # Allows RSpec to persist some state between runs in order to support
+  # the `--only-failures` and `--next-failure` CLI options. We recommend
+  # you configure your source control system to ignore this file.
+  config.example_status_persistence_file_path = "spec/examples.txt"
+
+  # Limits the available syntax to the non-monkey patched syntax that is
+  # recommended. For more details, see:
+  #   - http://rspec.info/blog/2012/06/rspecs-new-expectation-syntax/
+  #   - http://www.teaisaweso.me/blog/2013/05/27/rspecs-new-message-expectation-syntax/
+  #   - http://rspec.info/blog/2014/05/notable-changes-in-rspec-3/#zero-monkey-patching-mode
+  config.disable_monkey_patching!
+
+  # This setting enables warnings. It's recommended, but in some cases may
+  # be too noisy due to issues in dependencies.
+  config.warnings = true
+
+  # Many RSpec users commonly either run the entire suite or an individual
+  # file, and it's useful to allow more verbose output when running an
+  # individual spec file.
+  if config.files_to_run.one?
+    # Use the documentation formatter for detailed output,
+    # unless a formatter has already been configured
+    # (e.g. via a command-line flag).
+    config.default_formatter = 'doc'
+  end
+
+  # Print the 10 slowest examples and example groups at the
+  # end of the spec run, to help surface which specs are running
+  # particularly slow.
+  config.profile_examples = 10
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = :random
+
+  # Seed global randomization in this process using the `--seed` CLI option.
+  # Setting this allows you to use `--seed` to deterministically reproduce
+  # test failures related to randomization by passing the same `--seed` value
+  # as the one that triggered the failure.
+  Kernel.srand config.seed
+=end
+end

data/spec/support/modify_env.rb

@@ -0,0 +1,7 @@
+require 'climate_control'
+
+module ModifyEnv
+  def with_modified_env(options, &block)
+    ClimateControl.modify(options, &block)
+  end
+end

data/status_page.gemspec

@@ -0,0 +1,29 @@
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'status_page/version'
+
+Gem::Specification.new do |s|
+  s.name        = 'status_page-api'
+  s.version     = StatusPage::VERSION
+  s.date        = '2016-05-26'
+  s.summary     = "Ruby client for StatusPage API"
+  s.description = "Ruby client for StatusPage API"
+  s.authors     = ["Eric Griffis"]
+  s.email       = 'eric.griffis@nyu.edu'
+
+  s.files         = `git ls-files`.split($/)
+  s.test_files    = %w[spec/lib/status_page/api/base_spec.rb spec/lib/status_page/api/component_spec.rb spec/lib/status_page/api/component_list_spec.rb]
+  s.require_paths = ["lib"]
+
+  s.homepage    = 'https://github.com/NYULibraries/status_page'
+  s.license     = 'MIT'
+
+  s.required_ruby_version = '>= 2.1'
+  s.add_dependency 'rest-client', '>= 2.0'
+  s.add_dependency 'json', '>= 1.0'
+
+  s.add_development_dependency 'rspec', '~> 3.5'
+  s.add_development_dependency 'climate_control', '~> 0.1'
+  s.add_development_dependency 'pry', '~> 0.10'
+  s.add_development_dependency 'coveralls', '~> 0.8'
+end

metadata

@@ -0,0 +1,150 @@
+--- !ruby/object:Gem::Specification
+name: status_page-api
+version: !ruby/object:Gem::Version
+  version: 0.0.0
+platform: ruby
+authors:
+- Eric Griffis
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-05-26 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rest-client
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.5'
+- !ruby/object:Gem::Dependency
+  name: climate_control
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+- !ruby/object:Gem::Dependency
+  name: coveralls
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+description: Ruby client for StatusPage API
+email: eric.griffis@nyu.edu
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".ruby-version"
+- ".travis.yml"
+- Gemfile
+- README.md
+- lib/status_page.rb
+- lib/status_page/api.rb
+- lib/status_page/api/base.rb
+- lib/status_page/api/component.rb
+- lib/status_page/api/component_list.rb
+- lib/status_page/api/exception.rb
+- lib/status_page/version.rb
+- spec/lib/status_page/api/base_spec.rb
+- spec/lib/status_page/api/component_list_spec.rb
+- spec/lib/status_page/api/component_spec.rb
+- spec/lib/status_page/api/exception_spec.rb
+- spec/spec_helper.rb
+- spec/support/modify_env.rb
+- status_page.gemspec
+homepage: https://github.com/NYULibraries/status_page
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.1'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.8
+signing_key: 
+specification_version: 4
+summary: Ruby client for StatusPage API
+test_files:
+- spec/lib/status_page/api/base_spec.rb
+- spec/lib/status_page/api/component_spec.rb
+- spec/lib/status_page/api/component_list_spec.rb