qualtrics_api 0.0.2 → 0.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: a1bc31e5bdb1d4226c3a1f0511a03dd30e90a733
-  data.tar.gz: 75c496a12eddd15a9cafc638eaf3ef1d1c176692
+  metadata.gz: abd7228ac110efc90a89dce24f0a7de7e7335704
+  data.tar.gz: bc6f5225fd701ad819038027d0d3baadec2ecdf8
 SHA512:
-  metadata.gz: 062dd62b815df05915fa106c95018d3347093db0b18a8c16639f0aca2cb0dd88f8f6047e5fa5d4a7b4cfe47195eba83fc933a763c2bf0632965bd64c16b42eb4
-  data.tar.gz: e18f3a82dcc31b40ae17c9d97c51e245ee5893726d72ff3e17cfbe2b49d30e27a6ef01325ae47c6f9ce278bef1f6e55950da708d76b70ddd6c2d633e45e7e533
+  metadata.gz: 813bbed6a8992818faec40c1dc93707bc5c2c5769cc2f422de93578a19c941516ee3b1912963fac4c8e9be7aeeda22bbcd378db449dba7a3e3ab5b365acc7287
+  data.tar.gz: 147e595c36036bd0664d5fb3d90ec387a74f46fb35120f1ab7c7d56551433b7505303e15dc5471aa94907e9da007b5b59874265f2b7d4c794b7b4590db5ae96f

data/README.md

@@ -136,6 +136,52 @@ export.status
 => "99.99999%"
 ```
 
+### Panels
+
+To get all the panels:
+
+```ruby
+client.panels.fetch
+# => #<QualtricsAPI::PanelCollection:0x007f8769aae2c0 ....>
+```
+
+After you have received results, you can search for a panel by id:
+
+```ruby
+panel = client.panels.find("panelIdHere")
+# => #<QualtricsAPI::Panel:0x007f876906f278 @id="panelIdHere" ...>
+```
+
+or just:
+
+```ruby
+panel = client.panels["panelIdHere"]
+# => #<QualtricsAPI::Panel:0x007f876906f278 @id="panelIdHere" ...>
+```
+
+#### Panel Members
+
+To add panel members to a panel:
+
+```ruby
+panel = client.panels.fetch["panelIdHere"]
+members = [QualtricsAPI::PanelMember.new(first_name: 'John', last_name: 'Doe', email: 'test@test.com')]
+panel.members.create(members)
+=> #<QualtricsAPI::PanelImport:0x007fb7db984668 ...>
+```
+
+and update athe status of panel import:
+```ruby
+members = [QualtricsAPI::PanelMember.new(first_name: 'John', last_name: 'Doe', email: 'test@test.com')]
+panel_import = panel.members.create(members)
+=> #<QualtricsAPI::PanelImport:0x007fb7db984668 ...>
+panel_import.status
+=> "99.99999%"
+panel_import.update_status
+panel_import.status
+=> "100.0%"
+```
+
 ## Contributing
 
 1. Fork it ( https://github.com/pallymore/qualtrics_api/fork )

data/fixtures/vcr_cassettes/panel_collection_fetch_fail.yml

@@ -0,0 +1,33 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://co1.qualtrics.com/API/v1/panels?apiToken=6Wpo0Vsx1cN1kcHivCaGTz5IhOvchLrg1o4L0KOZ
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      User-Agent:
+      - Faraday v0.8.9
+  response:
+    status:
+      code: 200
+      message:
+    headers:
+      server:
+      - Apache-Coyote/1.1
+      content-type:
+      - application/json
+      content-length:
+      - '223'
+      date:
+      - Sun, 28 Jun 2015 21:05:57 GMT
+      connection:
+      - close
+    body:
+      encoding: UTF-8
+       string: '{"meta":{"status":"Error","errorMessage":"You do not have permission
+        to access this resource.","internalErrorCode":"GS_5","errorId":"3d6a9018-3b87-4265-b662-572ad96bbe6c"},"result":null}'
+    http_version:
+  recorded_at: Sun, 28 Jun 2015 21:05:57 GMT
+recorded_with: VCR 2.9.3

data/fixtures/vcr_cassettes/panel_collection_fetch_success.yml

@@ -0,0 +1,32 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://co1.qualtrics.com/API/v1/panels?apiToken=6Wpo0Vsx1cN1kcHivCaGTz5IhOvchLrg1o4L0KOZ
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      User-Agent:
+      - Faraday v0.8.9
+  response:
+    status:
+      code: 200
+      message:
+    headers:
+      server:
+      - Apache-Coyote/1.1
+      content-type:
+      - application/json
+      content-length:
+      - '223'
+      date:
+      - Sun, 28 Jun 2015 21:05:57 GMT
+      connection:
+      - close
+    body:
+      encoding: UTF-8
+      string: '{"result":[{"panelId":"AB_abcdefghijk","name":"Master Panel","libraryId":"GR_abcdefghijk","category":"Unassigned"}],"meta":{"status":"Success","qualtricsErrorCode":null,"errorMessage":null}}'
+    http_version:
+  recorded_at: Sun, 28 Jun 2015 21:05:57 GMT
+recorded_with: VCR 2.9.3

data/fixtures/vcr_cassettes/panel_import_update_success.yml

@@ -0,0 +1,32 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://co1.qualtrics.com/API/v1/panels/ML_bC2c5xBz1DxyOYB/members/panelImports/PGRS_bEJLYLkqMBs8Bwx?apiToken=6Wpo0Vsx1cN1kcHivCaGTz5IhOvchLrg1o4L0KOZ
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      User-Agent:
+      - Faraday v0.8.9
+  response:
+    status:
+      code: 200
+      message: 
+    headers:
+      server:
+      - Apache-Coyote/1.1
+      content-type:
+      - application/json
+      date:
+      - Tue, 30 Jun 2015 18:36:33 GMT
+      content-length:
+      - '85'
+      connection:
+      - close
+    body:
+      encoding: UTF-8
+      string: '{"result":{"status":"COMPLETED","percentComplete":100.0},"meta":{"status":"Success"}}'
+    http_version: 
+  recorded_at: Tue, 30 Jun 2015 18:36:34 GMT
+recorded_with: VCR 2.9.3

data/fixtures/vcr_cassettes/panel_member_collection_create_fail.yml

@@ -0,0 +1,31 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://co1.qualtrics.com/API/v1/panels/ABCD/members?apiToken=6Wpo0Vsx1cN1kcHivCaGTz5IhOvchLrg1o4L0KOZ
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      User-Agent:
+      - Faraday v0.8.9
+  response:
+    status:
+      code: 400
+      message: 
+    headers:
+      server:
+      - Apache-Coyote/1.1
+      content-type:
+      - application/json
+      date:
+      - Tue, 30 Jun 2015 11:02:46 GMT
+      connection:
+      - close
+    body:
+      encoding: UTF-8
+      string: '{"meta":{"status":"Error","errorMessage":"Missing or invalid parameter
+        panelId.","internalErrorCode":"GPR_1","errorId":"f399b7aa-7ce4-4d1d-9903-61435a929a9d"},"result":null}'
+    http_version: 
+  recorded_at: Tue, 30 Jun 2015 11:02:46 GMT
+recorded_with: VCR 2.9.3

data/fixtures/vcr_cassettes/panel_member_collection_create_success.yml

@@ -0,0 +1,66 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://co1.qualtrics.com/API/v1/panels?apiToken=6Wpo0Vsx1cN1kcHivCaGTz5IhOvchLrg1o4L0KOZ
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      User-Agent:
+      - Faraday v0.8.9
+  response:
+    status:
+      code: 200
+      message: 
+    headers:
+      server:
+      - Apache-Coyote/1.1
+      content-type:
+      - application/json
+      date:
+      - Tue, 30 Jun 2015 11:05:46 GMT
+      content-length:
+      - '1104'
+      connection:
+      - close
+    body:
+      encoding: UTF-8
+      string: '{"result":[{"libraryId":"UR_a3IUfBgXyuCHefP","panelId":"ML_bC2c5xBz1DxyOYB","name":"Test
+        Panel","category":"Unassigned"},{"libraryId":"GR_2aaKA1aGidXQtOA","panelId":"ML_3DWuh7BTCbBDMrz","name":"1032
+        test","category":"Unassigned"},{"libraryId":"GR_2aaKA1aGidXQtOA","panelId":"ML_801qFFVH8bOdbdH","name":"Master2015","category":"Unassigned"},{"libraryId":"GR_2aaKA1aGidXQtOA","panelId":"ML_8CTTM1NuWINZUO1","name":"29.X-2","category":"Unassigned"},{"libraryId":"GR_2aaKA1aGidXQtOA","panelId":"ML_8FZn6SlO02EfpwV","name":"29.X","category":"Unassigned"},{"libraryId":"GR_2aaKA1aGidXQtOA","panelId":"ML_aYrBXdYJZ5SnYqx","name":"ML_b3GT2LOMImo2Rnf","category":"Unassigned"},{"libraryId":"GR_2aaKA1aGidXQtOA","panelId":"ML_bJj6bKQErauewzH","name":"GRPSteacherSpring2013fixed_seperate","category":"Unassigned"},{"libraryId":"GR_2aaKA1aGidXQtOA","panelId":"ML_bseUhQDwAJolD1j","name":"Master
+        Panel","category":"Unassigned"},{"libraryId":"GR_2aaKA1aGidXQtOA","panelId":"ML_eRKRb6a6Waiukap","name":"OhioSpring2015","category":"Unassigned"}],"meta":{"status":"Success","qualtricsErrorCode":null,"errorMessage":null}}'
+    http_version: 
+  recorded_at: Tue, 30 Jun 2015 11:05:47 GMT
+- request:
+    method: post
+    uri: https://co1.qualtrics.com/API/v1/panels/ML_bC2c5xBz1DxyOYB/members?apiToken=6Wpo0Vsx1cN1kcHivCaGTz5IhOvchLrg1o4L0KOZ
+    body:
+      encoding: US-ASCII
+      string: apiToken=6Wpo0Vsx1cN1kcHivCaGTz5IhOvchLrg1o4L0KOZ&panelMembers=%5B%7B%22FirstName%22%3A%22Marcin%22%2C%22LastName%22%3A%22Naglik%22%2C%22Email%22%3A%22test%40test.com%22%7D%5D
+    headers:
+      User-Agent:
+      - Faraday v0.8.9
+      Content-Type:
+      - application/x-www-form-urlencoded
+  response:
+    status:
+      code: 200
+      message: 
+    headers:
+      server:
+      - Apache-Coyote/1.1
+      content-type:
+      - application/json
+      date:
+      - Tue, 30 Jun 2015 11:05:47 GMT
+      content-length:
+      - '203'
+      connection:
+      - close
+    body:
+      encoding: UTF-8
+      string: '{"result":{"importStatus":"http://co1.qualtrics.com/API/v1/panels/ML_bC2c5xBz1DxyOYB/members/panelImports/PGRS_bEJLYLkqMBs8Bwx"},"meta":{"status":"Success","qualtricsErrorCode":null,"errorMessage":null}}'
+    http_version: 
+  recorded_at: Tue, 30 Jun 2015 11:05:47 GMT
+recorded_with: VCR 2.9.3

data/fixtures/vcr_cassettes/panel_member_collection_fetch_fail.yml

@@ -0,0 +1,33 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://co1.qualtrics.com/API/v1/panels/ABCD/members?apiToken=6Wpo0Vsx1cN1kcHivCaGTz5IhOvchLrg1o4L0KOZ
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      User-Agent:
+      - Faraday v0.8.9
+  response:
+    status:
+      code: 200
+      message:
+    headers:
+      server:
+      - Apache-Coyote/1.1
+      content-type:
+      - application/json
+      content-length:
+      - '223'
+      date:
+      - Sun, 28 Jun 2015 21:05:57 GMT
+      connection:
+      - close
+    body:
+      encoding: UTF-8
+       string: '{"meta":{"status":"Error","errorMessage":"You do not have permission
+        to access this resource.","internalErrorCode":"GS_5","errorId":"3d6a9018-3b87-4265-b662-572ad96bbe6c"},"result":null}'
+    http_version:
+  recorded_at: Sun, 28 Jun 2015 21:05:57 GMT
+recorded_with: VCR 2.9.3

data/fixtures/vcr_cassettes/panel_member_collection_fetch_success.yml

@@ -0,0 +1,33 @@
+
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://co1.qualtrics.com/API/v1/panels/ABCD/members?apiToken=6Wpo0Vsx1cN1kcHivCaGTz5IhOvchLrg1o4L0KOZ
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      User-Agent:
+      - Faraday v0.8.9
+  response:
+    status:
+      code: 200
+      message:
+    headers:
+      server:
+      - Apache-Coyote/1.1
+      content-type:
+      - application/json
+      content-length:
+      - '223'
+      date:
+      - Sun, 28 Jun 2015 21:05:57 GMT
+      connection:
+      - close
+    body:
+      encoding: UTF-8
+      string: '{ "result": [ { "rowId": "33369396", "panelMemberId": "MLRP_abcd", "firstName": "Thom", "lastName": "Yorke",  "email": "thom@yorke.com",  "externalDataReference": null,  "embeddedData": {  } } ], "meta": { "status": "Success", "qualtricsErrorCode": null, "errorMessage": null }}'
+    http_version:
+  recorded_at: Sun, 28 Jun 2015 21:05:57 GMT
+recorded_with: VCR 2.9.3

data/lib/qualtrics_api.rb

@@ -1,3 +1,4 @@
+require 'json'
 require 'virtus'
 require "faraday"
 require "faraday_middleware"
@@ -12,13 +13,16 @@ require "qualtrics_api/survey"
 require "qualtrics_api/survey_collection"
 require "qualtrics_api/response_export"
 require "qualtrics_api/response_export_collection"
+require "qualtrics_api/panel"
+require "qualtrics_api/panel_collection"
+require "qualtrics_api/panel_member"
+require "qualtrics_api/panel_member_collection"
+require "qualtrics_api/panel_import"
 
 require "qualtrics_api/services/response_export_service"
 
 module QualtricsAPI
-
   def self.new(token)
     Client.new(api_token: token)
   end
-
 end

data/lib/qualtrics_api/client.rb

@@ -5,17 +5,21 @@ module QualtricsAPI
     attribute :api_token, String
 
     def surveys(options = {})
-      @surveys ||= QualtricsAPI::SurveyCollection.new options.merge(connection: connection)
+      @surveys ||= QualtricsAPI::SurveyCollection.new(options.merge(connection: connection))
     end
 
     def response_exports(options = {})
-      @response_exports ||= QualtricsAPI::ResponseExportCollection.new options.merge(connection: connection)
+      @response_exports ||= QualtricsAPI::ResponseExportCollection.new(options.merge(connection: connection))
+    end
+
+    def panels(options = {})
+      @panels ||= QualtricsAPI::PanelCollection.new(options.merge(connection: connection))
     end
 
     def connection
       @conn ||= Faraday.new(url: QualtricsAPI::URL,
                             params: { apiToken: api_token }) do |faraday|
-        faraday.request :json
+        faraday.request :url_encoded
         faraday.response :json, :content_type => /\bjson$/
 
         faraday.use FaradayMiddleware::FollowRedirects

data/lib/qualtrics_api/panel.rb

@@ -0,0 +1,32 @@
+module QualtricsAPI
+  class Panel
+    include Virtus.value_object
+
+    attribute :connection
+    attribute :id, String
+    attribute :library_id, String
+    attribute :name, String
+    attribute :category, String
+
+    def initialize(options = {})
+      attributes_mappings.each do |key, qualtrics_key|
+        instance_variable_set "@#{key}", options[qualtrics_key]
+      end
+      super
+    end
+
+    def members(options = {})
+      @members ||= QualtricsAPI::PanelMemberCollection.new(options.merge(id: id, connection: connection))
+    end
+
+    private
+
+    def attributes_mappings
+      {
+        :id => "panelId",
+        :library_id => "libraryId",
+        :name => "name"
+      }
+    end
+  end
+end

data/lib/qualtrics_api/panel_collection.rb

@@ -0,0 +1,37 @@
+module QualtricsAPI
+  class PanelCollection
+    extend Forwardable
+    include Enumerable
+    include Virtus.value_object
+
+    attribute :connection
+    attribute :all, Array, :default => []
+
+    def_delegator :all, :each
+    def_delegator :all, :size
+
+    def fetch(_options = {})
+      @all = []
+      parse_fetch_response(connection.get('panels'))
+      self
+    end
+
+    def [](panel_id)
+      find(panel_id)
+    end
+
+    def find(panel_id)
+      @all.detect do |panel|
+        panel.id == panel_id
+      end || QualtricsAPI::Panel.new("panelId" => panel_id, connection: connection)
+    end
+
+    private
+
+    def parse_fetch_response(response)
+      @all = response.body["result"].map do |result|
+        QualtricsAPI::Panel.new result.merge(connection: connection)
+      end
+    end
+  end
+end

data/lib/qualtrics_api/panel_import.rb

@@ -0,0 +1,30 @@
+module QualtricsAPI
+  class PanelImport
+    include Virtus.value_object
+
+    attribute :connection
+    attribute :id, String
+    attribute :panel_id, String
+
+    def update_status
+      res = connection.get("panels/#{panel_id}/members/panelImports/#{id}").body["result"]
+      @import_progress = res["percentComplete"]
+      @completed = true if @import_progress == 100.0
+      self
+    end
+
+    def status
+      update_status unless completed?
+      "#{@import_progress}%"
+    end
+
+    def percent_completed
+      update_status unless completed?
+      @import_progress
+    end
+
+    def completed?
+      @completed == true
+    end
+  end
+end

data/lib/qualtrics_api/panel_member.rb

@@ -0,0 +1,50 @@
+module QualtricsAPI
+  class PanelMember
+    include Virtus.value_object
+
+    attribute :connection
+    attribute :id, String
+    attribute :first_name, String
+    attribute :last_name, String
+    attribute :email, String
+    attribute :language, String
+    attribute :unsubscribed, Integer
+    attribute :external_data_reference, String
+    attribute :embeded_data, Hash
+
+    def initialize(options = {})
+      attributes_mappings.each do |key, qualtrics_key|
+        instance_variable_set "@#{key}", options[qualtrics_key]
+      end
+      super
+    end
+
+    def to_json(_options = {})
+      serialized_attributes.to_json
+    end
+
+    private
+
+    def serialized_attributes
+      Hash[attributes.map { |k, v| [mapped_and_uppercased_attribute(k), v] }].tap do |h|
+        h.delete("Connection")
+      end.delete_if { |_k, v| v.nil? }
+    end
+
+    def mapped_and_uppercased_attribute(attribute)
+      (attributes_mappings[attribute] || attribute).to_s.tap do |a|
+        a[0] = a[0].upcase
+      end
+    end
+
+    def attributes_mappings
+      {
+        :id => "panelMemberId",
+        :first_name => "firstName",
+        :last_name => "lastName",
+        :external_data_reference => "externalDataReference",
+        :embeded_data => "embeddedData"
+      }
+    end
+  end
+end

data/lib/qualtrics_api/panel_member_collection.rb

@@ -0,0 +1,46 @@
+module QualtricsAPI
+  class PanelMemberCollection
+    extend Forwardable
+    include Enumerable
+    include Virtus.value_object
+
+    attribute :connection
+    attribute :id, String
+    attribute :all, Array, :default => []
+  
+    def_delegator :all, :each
+    def_delegator :all, :size
+
+    def fetch(_options = {})
+      @all = []
+      parse_fetch_response(connection.get("panels/#{id}/members"))
+      self
+    end
+
+    def create(panel_members)
+      res = connection
+            .post("panels/#{id}/members", connection.params.merge(panelMembers: panel_members.to_json))
+            .body["result"]
+      import_id = res['importStatus'].split('/').last
+      QualtricsAPI::PanelImport.new(id: import_id, panel_id: id, connection: connection)
+    end
+
+    def [](member_id)
+      find(member_id)
+    end
+    
+    def find(member_id)
+      @all.detect do |panel_member|
+        panel_member.id == member_id
+      end || QualtricsAPI::PanelMember.new(:id => member_id, connection: connection)
+    end
+
+    private
+
+    def parse_fetch_response(response)
+      @all = response.body["result"].map do |result|
+        QualtricsAPI::PanelMember.new(result.merge(connection: connection))
+      end
+    end
+  end
+end

data/lib/qualtrics_api/response_export_collection.rb

@@ -15,9 +15,9 @@ module QualtricsAPI
     end
     
     def find(export_id)
-      @all.select do |response_export|
+      @all.detect do |response_export|
         response_export.id == export_id
-      end.first || QualtricsAPI::ResponseExport.new(:id => export_id, connection: connection)
+      end || QualtricsAPI::ResponseExport.new(:id => export_id, connection: connection)
     end
   end
 end

data/lib/qualtrics_api/survey.rb

@@ -10,8 +10,6 @@ module QualtricsAPI
     attribute :created_at, String
     attribute :status, String
 
-    attr_accessor :id, :name, :owner_id, :last_modified, :status, :created_at
-
     def initialize(options = {})
       attributes_mappings.each do |key, qualtrics_key|
         instance_variable_set "@#{key}", options[qualtrics_key]

data/lib/qualtrics_api/survey_collection.rb

@@ -35,9 +35,9 @@ module QualtricsAPI
     end
     
     def find(survey_id)
-      @all.select do |survey|
+      @all.detect do |survey|
         survey.id == survey_id
-      end.first || QualtricsAPI::Survey.new("id" => survey_id, connection: connection)
+      end || QualtricsAPI::Survey.new("id" => survey_id, connection: connection)
     end
 
     private

data/lib/qualtrics_api/version.rb

@@ -1,3 +1,3 @@
 module QualtricsAPI
-  VERSION = "0.0.2"
+  VERSION = "0.0.3"
 end

data/spec/lib/panel_collection_spec.rb

@@ -0,0 +1,77 @@
+require 'spec_helper'
+
+describe QualtricsAPI::PanelCollection do
+  let(:connection) { double('connection') }
+
+  subject { described_class.new connection: connection }
+
+  it "has no @all when initialized" do
+    expect(subject.all).to eq []
+  end
+
+  it "takes a connection" do
+    expect(subject.connection).to eq connection
+  end
+
+  describe "#find, #[]" do
+    let(:panel_1) { QualtricsAPI::Panel.new "panelId" => "p1" }
+    let(:panel_2) { QualtricsAPI::Panel.new "panelId" => "p2" }
+
+    it "finds the panel by id" do
+      subject.instance_variable_set :@all, [panel_1, panel_2]
+      expect(subject.find("p1")).to eq panel_1
+      expect(subject["p2"]).to eq panel_2
+    end
+
+    it "returns a new panel with the id" do
+      new_panel = subject["p3"]
+      expect(new_panel).to be_a QualtricsAPI::Panel
+      expect(new_panel.id).to eq "p3"
+      expect(new_panel.connection).to eq connection
+    end
+  end
+
+  describe "integration" do
+    let(:client) { QualtricsAPI.new TEST_API_TOKEN }
+
+    subject { described_class.new connection: client.connection }
+
+    describe "#fetch" do
+      describe "when success" do
+        before do
+          expect(subject.size).to eq 0
+        end
+
+        let!(:result) do
+          VCR.use_cassette("panel_collection_fetch_success") do
+            subject.fetch
+          end
+        end
+
+        it "populates the collection" do
+          expect(subject.size).to eq 1
+          expect(subject.first).to be_a QualtricsAPI::Panel
+        end
+
+        it "passes down the connection" do
+          expect(subject.all.first.connection).to eq client.connection
+        end
+
+        it "returns itself" do
+          expect(result).to eq subject
+        end
+      end
+
+      describe "when failed" do
+        it "resets panels" do
+          subject.instance_variable_set :@all, [QualtricsAPI::Panel.new({})]
+          expect {
+            VCR.use_cassette("panel_collection_fetch_fail") do
+              subject.fetch rescue nil
+            end
+          }.to change { subject.all }.to([])
+        end
+      end
+    end
+  end
+end

data/spec/lib/panel_import_spec.rb

@@ -0,0 +1,28 @@
+require 'spec_helper'
+
+describe QualtricsAPI::PanelImport do
+  describe "integration" do
+    let(:connection) { QualtricsAPI.new(TEST_API_TOKEN).connection }
+    subject { described_class.new(id: 'PGRS_bEJLYLkqMBs8Bwx', panel_id: 'ML_bC2c5xBz1DxyOYB', connection: connection) }
+
+    describe "#update_status" do
+      let(:result) do
+        VCR.use_cassette('panel_import_update_success') do
+          subject.update_status
+        end
+      end
+
+      it "updates status" do
+        expect(result.status).to eq('100.0%')
+      end
+    
+      it "updates percent completed" do
+        expect(result.percent_completed).to eq(100.0)
+      end
+    
+      it "updates completed" do
+        expect(result.completed?).to be_truthy
+      end
+    end
+  end
+end

data/spec/lib/panel_member_collection_spec.rb

@@ -0,0 +1,115 @@
+require 'spec_helper'
+
+describe QualtricsAPI::PanelMemberCollection do
+  let(:connection) { double('connection') }
+
+  subject { described_class.new connection: connection }
+
+  it "has no @all when initialized" do
+    expect(subject.all).to eq []
+  end
+
+  it "takes a connection" do
+    expect(subject.connection).to eq connection
+  end
+
+  describe "#find, #[]" do
+    let(:panel_member_1) { QualtricsAPI::PanelMember.new("panelMemberId" => "p1") }
+    let(:panel_member_2) { QualtricsAPI::PanelMember.new("panelMemberId" => "p2") }
+
+    it "finds the panel member by id" do
+      subject.instance_variable_set :@all, [panel_member_1, panel_member_2]
+      expect(subject.find("p1")).to eq panel_member_1
+      expect(subject["p2"]).to eq panel_member_2
+    end
+
+    it "returns a new panel with the id" do
+      new_panel_member = subject["p3"]
+      expect(new_panel_member).to be_a QualtricsAPI::PanelMember
+      expect(new_panel_member.id).to eq "p3"
+      expect(new_panel_member.connection).to eq connection
+    end
+  end
+
+  describe "integration" do
+    let(:client) { QualtricsAPI.new TEST_API_TOKEN }
+
+    subject { described_class.new(connection: client.connection, id: 'ABCD') }
+
+    describe "#fetch" do
+      describe "when success" do
+        before do
+          expect(subject.size).to eq 0
+        end
+
+        let!(:result) do
+          VCR.use_cassette("panel_member_collection_fetch_success") do
+            subject.fetch
+          end
+        end
+
+        it "populates the collection" do
+          expect(subject.size).to eq 1
+          expect(subject.first).to be_a QualtricsAPI::PanelMember
+        end
+
+        it "passes down the connection" do
+          expect(subject.all.first.connection).to eq client.connection
+        end
+
+        it "returns itself" do
+          expect(result).to eq subject
+        end
+      end
+
+      describe "when failed" do
+        it "resets panels" do
+          subject.instance_variable_set :@all, [QualtricsAPI::PanelMember.new({})]
+          expect do
+            VCR.use_cassette("panel_member_collection_fetch_fail") do
+              expect { subject.fetch }.to raise_error
+            end
+          end.to change { subject.all }.to([])
+        end
+      end
+    end
+
+    describe "#create" do
+      let(:result) do
+        VCR.use_cassette(cassette) do
+          QualtricsAPI.new(TEST_API_TOKEN).panels.fetch['ML_bC2c5xBz1DxyOYB'].members.create(panel_members)
+        end
+      end
+      
+      describe "when success" do
+        let(:cassette) { "panel_member_collection_create_success" }
+        let(:panel_members) { [QualtricsAPI::PanelMember.new(first_name: 'Marcin', last_name: 'Naglik', email: 'test@test.com')] }
+
+        it "returns PanelImport" do
+          expect(result).to be_a QualtricsAPI::PanelImport
+        end
+      
+        it "returns PanelImport with id" do
+          expect(result.id).to eq('PGRS_bEJLYLkqMBs8Bwx')
+        end
+
+        it "returns PanelImport with panel id" do
+          expect(result.panel_id).to eq('ML_bC2c5xBz1DxyOYB')
+        end
+
+        it "returns PanelImport with connection" do
+          expect(result.connection).not_to be_nil
+        end
+      end
+
+      describe "when failed" do
+        let(:cassette) { "panel_member_collection_create_fail" }
+        let(:panel_members) { [QualtricsAPI::PanelMember.new] }
+
+        it "returns results" do
+          expect { result }.to raise_error 
+        end
+      end
+    end
+  end
+end

data/spec/lib/panel_member_spec.rb

@@ -0,0 +1,66 @@
+require 'spec_helper'
+
+describe QualtricsAPI::PanelMember do
+  let(:panel_member) do
+    {
+      "panelMemberId" => "ML_abcdefg",
+      "firstName" => "Thom",
+      "lastName" => "Yorke",
+      "email" => "thom@radiohead.com",
+      "language" => "EN",
+      "unsubscribed" => 1,
+      "externalDataReference" => "1234",
+      "embeddedData" => { "a" => "b", "b" => "c" }
+    }
+  end
+
+  let(:connection) { double('connection', get: {}) }
+  subject { described_class.new panel_member.merge(connection: connection) }
+
+  it "has a panel member id" do
+    expect(subject.id).to eq(panel_member["panelMemberId"])
+  end
+
+  it "has a first name" do
+    expect(subject.first_name).to eq(panel_member["firstName"])
+  end
+
+  it "has a last name" do
+    expect(subject.last_name).to eq(panel_member["lastName"])
+  end
+
+  it "has an email" do
+    expect(subject.email).to eq(panel_member["email"])
+  end
+
+  it "has language" do
+    expect(subject.language).to eq(panel_member["language"])
+  end
+
+  it "has unsubscribed flag" do
+    expect(subject.unsubscribed).to eq(panel_member["unsubscribed"])
+  end
+
+  it "has external data reference" do
+    expect(subject.external_data_reference).to eq(panel_member["externalDataReference"])
+  end
+
+  it "has embedded data" do
+    expect(subject.embeded_data).to eq(panel_member["embeddedData"])
+  end
+
+  context "#to_json" do
+    let(:members) { [subject].to_json }
+    it "serialize array of panel members" do
+      expect(JSON.parse(members)).to eq(
+        [{ "PanelMemberId" => "ML_abcdefg", 
+           "FirstName" => "Thom",
+           "LastName" => "Yorke",
+           "Email" => "thom@radiohead.com",
+           "Language" => "EN",
+           "Unsubscribed" => 1,
+           "ExternalDataReference" => "1234",
+           "EmbeddedData" => { "a" => "b", "b" => "c" } }])
+    end
+  end
+end

data/spec/lib/panel_spec.rb

@@ -0,0 +1,54 @@
+require 'spec_helper'
+
+describe QualtricsAPI::Panel do
+  let(:qualtrics_response) do
+    {
+      "panelid" => "ML_bseUhQDwAJolD1j",
+      "name" => "Master Panel",
+      "libraryId" => "GR_2aaKA1aGidXQtOA",
+      "category" => "Unassigned"
+    }
+  end
+
+  let(:connection) { double('connection', get: {}) }
+
+  subject { described_class.new qualtrics_response.merge(connection: connection) }
+
+  it "has an panelId" do
+    expect(subject.id).to eq qualtrics_response["panelId"]
+  end
+
+  it "has a name" do
+    expect(subject.name).to eq qualtrics_response["name"]
+  end
+
+  it "has an libraryId" do
+    expect(subject.library_id).to eq qualtrics_response["libraryId"]
+  end
+
+  it "has a category" do
+    expect(subject.category).to eq qualtrics_response["category"]
+  end
+
+  it "has a connection" do
+    expect(subject.connection).to eq(connection)
+  end
+
+  describe "#members" do
+    it "returns a PanelMemberCollection" do
+      expect(subject.members).to be_a QualtricsAPI::PanelMemberCollection
+    end
+
+    it "sets connection" do
+      expect(subject.members.connection).to eq subject.connection
+    end
+
+    it "assigns panel id" do
+      expect(subject.members.id).to eq subject.id
+    end
+
+    it "caches the members" do
+      expect(subject.members.object_id).to eq subject.members.object_id
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: qualtrics_api
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.3
 platform: ruby
 authors:
 - Yurui Zhang
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-06-26 00:00:00.000000000 Z
+date: 2015-06-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -143,6 +143,13 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
+- fixtures/vcr_cassettes/panel_collection_fetch_fail.yml
+- fixtures/vcr_cassettes/panel_collection_fetch_success.yml
+- fixtures/vcr_cassettes/panel_import_update_success.yml
+- fixtures/vcr_cassettes/panel_member_collection_create_fail.yml
+- fixtures/vcr_cassettes/panel_member_collection_create_success.yml
+- fixtures/vcr_cassettes/panel_member_collection_fetch_fail.yml
+- fixtures/vcr_cassettes/panel_member_collection_fetch_success.yml
 - fixtures/vcr_cassettes/response_export_start_success.yml
 - fixtures/vcr_cassettes/response_export_update_success.yml
 - fixtures/vcr_cassettes/survey_collection_fetch_fail.yml
@@ -150,6 +157,11 @@ files:
 - fixtures/vcr_cassettes/survey_collection_fetch_with_scopeId_success.yml
 - lib/qualtrics_api.rb
 - lib/qualtrics_api/client.rb
+- lib/qualtrics_api/panel.rb
+- lib/qualtrics_api/panel_collection.rb
+- lib/qualtrics_api/panel_import.rb
+- lib/qualtrics_api/panel_member.rb
+- lib/qualtrics_api/panel_member_collection.rb
 - lib/qualtrics_api/request_error_handler.rb
 - lib/qualtrics_api/response_export.rb
 - lib/qualtrics_api/response_export_collection.rb
@@ -160,6 +172,11 @@ files:
 - lib/qualtrics_api/version.rb
 - qualtrics_api.gemspec
 - spec/lib/client_spec.rb
+- spec/lib/panel_collection_spec.rb
+- spec/lib/panel_import_spec.rb
+- spec/lib/panel_member_collection_spec.rb
+- spec/lib/panel_member_spec.rb
+- spec/lib/panel_spec.rb
 - spec/lib/response_export_collection_spec.rb
 - spec/lib/response_export_spec.rb
 - spec/lib/services/response_export_service_spec.rb
@@ -193,6 +210,11 @@ specification_version: 4
 summary: A Ruby wrapper for Qualtrics REST API v3.0
 test_files:
 - spec/lib/client_spec.rb
+- spec/lib/panel_collection_spec.rb
+- spec/lib/panel_import_spec.rb
+- spec/lib/panel_member_collection_spec.rb
+- spec/lib/panel_member_spec.rb
+- spec/lib/panel_spec.rb
 - spec/lib/response_export_collection_spec.rb
 - spec/lib/response_export_spec.rb
 - spec/lib/services/response_export_service_spec.rb