rturk 2.3.5 → 2.3.6

data/CHANGELOG.markdown

@@ -1,6 +1,7 @@
 2.3.5
 -----
 * Added GetQualificationRequests API call [hamin]
+* Added RequestQualificationRequests API call [hamin]
 * rake spec now works correctly [hamin]
 
 2.3.4

data/Gemfile

@@ -1,4 +1,6 @@
+source "http://rubygems.org"
 gem 'nokogiri'
+gem 'jeweler'
 gem 'fakeweb'
 gem 'rest-client'
-gem 'rspec'
+gem 'rspec', '~> 1.3.1'

data/README.markdown

@@ -11,7 +11,7 @@ If your integrating RTurk with a Rails app, do yourself a favor and check out [T
 ## Installation
 
     gem install rturk
-    
+
 ## Use
 
 Let's say you have a form at "http://myapp.com/turkers/add_tags" where Turkers can add some tags to items in your catalogue.
@@ -29,9 +29,9 @@ Let's say you have a form at "http://myapp.com/turkers/add_tags" where Turkers c
       hit.reward = 0.05
       hit.qualifications.add :approval_rate, { :gt => 80 }
     end
-    
+
     p hit.url #=>  'https://workersandbox.mturk.com:443/mturk/preview?groupId=Q29J3XZQ1ASZH5YNKZDZ'
-    
+
 ### Reviewing and Approving hits HIT's
 
     hits = RTurk::Hit.all_reviewable
@@ -40,7 +40,7 @@ Let's say you have a form at "http://myapp.com/turkers/add_tags" where Turkers c
 
     unless hits.empty?
       puts "Reviewing all assignments"
-  
+
       hits.each do |hit|
         hit.assignments.each do |assignment|
           puts assignment.answers['tags']
@@ -48,7 +48,7 @@ Let's say you have a form at "http://myapp.com/turkers/add_tags" where Turkers c
         end
       end
     end
-  
+
 ### Wiping all your hits out
 
     hits = RTurk::Hit.all_reviewable
@@ -57,7 +57,7 @@ Let's say you have a form at "http://myapp.com/turkers/add_tags" where Turkers c
 
     unless hits.empty?
       puts "Approving all assignments and disposing of each hit!"
-  
+
       hits.each do |hit|
         hit.expire!
         hit.assignments.each do |assignment|
@@ -66,13 +66,13 @@ Let's say you have a form at "http://myapp.com/turkers/add_tags" where Turkers c
         hit.dispose!
       end
     end
-    
-    
+
+
 ### Logging
 Want to see what's going on - enable logging.
 
     RTurk::logger.level = Logger::DEBUG
-    
+
 ## Nitty Gritty
 
 Here's a quick peak at what happens on the Mechanical Turk side.
@@ -82,11 +82,11 @@ A worker takes a look at your hit. The page will contain an iframe with your que
 Amazon will append the AssignmentID parameter to the URL for your own information. In preview mode this will look like
 
     http://myapp.com/turkers/add_tags?item_id=1234&AssignmentId=ASSIGNMENT_ID_NOT_AVAILABLE
-    
+
 If the Turker accepts the HIT, the page will reload and the iframe URL will resemble
 
     http://myapp.com/turkers/add_tags?item_id=1234&AssignmentId=1234567890123456789ABC
-    
+
 The form in your page MUST CONTAIN the AssignmentID in a hidden input element. You could do this on the server side with a rails app, or on the client side with javascript(check the examples)
 
 Anything submitted in this form will be sent to Amazon and saved for your review later.
@@ -95,5 +95,12 @@ Anything submitted in this form will be sent to Amazon and saved for your review
 
 Take a look at the [Amazon MTurk developer docs](http://docs.amazonwebservices.com/AWSMechTurk/latest/AWSMechanicalTurkRequester/) for more information. They have a complete list of API operations, all of which can be called with this library.
 
-    
-    
+## Contributors
+
+[Zach Hale](http://github.com/zachhale)  
+[David Balatero](http://github.com/dbalatero)  
+[Rob Hanlon](http://github.com/ohwillie)  
+[Haris Amin](http://github.com/hamin)  
+[Tyler](http://github.com/tkieft)  
+[David Dai](http://github.com/newtonsapple)  
+

data/VERSION

@@ -1 +1 @@
-2.3.5
+2.3.6

data/lib/rturk/operations/grant_qualification.rb

@@ -0,0 +1,19 @@
+# Operation grants a Worker's request for a Qualification.
+
+module RTurk
+  class GrantQualification < Operation
+
+    attr_accessor :qualification_request_id, :integer_value
+    require_params :qualification_request_id
+    
+    def to_params
+      {'QualificationRequestId' => self.qualification_request_id,
+        'IntegerValue' => self.integer_value}
+    end
+  end
+  
+  def self.GrantQualification(*args)
+    RTurk::GrantQualification.create(*args)
+  end
+
+end

data/lib/rturk/operations/reject_qualification_request.rb

@@ -0,0 +1,19 @@
+# Operation rejects a user's request for a Qualification
+
+module RTurk
+  class RejectQualificationRequest < Operation
+
+    attr_accessor :qualification_request_id, :reason
+    require_params :qualification_request_id
+    
+    def to_params
+      {'QualificationRequestId' => self.qualification_request_id,
+        'Reason' => self.reason}
+    end
+  end
+  
+  def self.RejectQualificationRequest(*args)
+    RTurk::RejectQualificationRequest.create(*args)
+  end
+
+end

data/spec/fake_responses/grant_qualification.xml

@@ -0,0 +1,5 @@
+<GrantQualificationResult>
+  <Request>
+    <IsValid>True</IsValid>
+  </Request>
+</GrantQualificationResult>

data/spec/fake_responses/reject_qualification_request.xml

@@ -0,0 +1,5 @@
+<RejectQualificationRequestResult>
+  <Request>
+    <IsValid>True</IsValid>
+  </Request>
+</RejectQualificationRequestResult>

data/spec/operations/grant_qualification_spec.rb

@@ -0,0 +1,27 @@
+require File.expand_path(File.join(File.dirname(__FILE__), '..', 'spec_helper'))
+
+describe RTurk::GrantQualification do
+
+  before(:all) do
+    aws = YAML.load(File.open(File.join(SPEC_ROOT, 'mturk.yml')))
+    RTurk.setup(aws['AWSAccessKeyId'], aws['AWSAccessKey'], :sandbox => true)
+    faker('grant_qualification', :operation => 'GrantQualification')
+  end
+
+  it "should ensure required params" do
+    lambda{RTurk::GrantQualification()}.should raise_error RTurk::MissingParameters
+  end
+  
+  it "should successfully request the operation" do
+    RTurk::Requester.should_receive(:request).once.with(
+      hash_including('Operation' => 'GrantQualification'))
+    RTurk::GrantQualification(:qualification_request_id => "789RVWYBAZW00EXAMPLE951RVWYBAZW00EXAMPLE") rescue RTurk::InvalidRequest
+  end
+  
+  it "should parse and return the result" do
+    RTurk::GrantQualification(:qualification_request_id => "789RVWYBAZW00EXAMPLE951RVWYBAZW00EXAMPLE").elements.should eql(
+      {"GrantQualificationResult"=>{"Request"=>{"IsValid"=>"True"}}}
+    )
+  end
+
+end

data/spec/operations/reject_qualification_request_spec.rb

@@ -0,0 +1,28 @@
+require File.expand_path(File.join(File.dirname(__FILE__), '..', 'spec_helper'))
+
+describe RTurk::RejectQualificationRequest do
+
+  before(:all) do
+    aws = YAML.load(File.open(File.join(SPEC_ROOT, 'mturk.yml')))
+    RTurk.setup(aws['AWSAccessKeyId'], aws['AWSAccessKey'], :sandbox => true)
+    faker('reject_qualification_request', :operation => 'RejectQualificationRequest')
+  end
+
+  it "should ensure required params" do
+    lambda{RTurk::RejectQualificationRequest()}.should raise_error RTurk::MissingParameters
+  end
+  
+  it "should successfully request the operation" do
+    RTurk::Requester.should_receive(:request).once.with(
+      hash_including('Operation' => 'RejectQualificationRequest'))
+    RTurk::RejectQualificationRequest(:qualification_request_id => "123456789", :reason => "Your work is terrible!") rescue RTurk::InvalidRequest
+  end
+  
+  it "should parse and return the result" do
+    RTurk::RejectQualificationRequest(:qualification_request_id => "123456789", :reason => "Your work is terrible!").should be_a_kind_of RTurk::Response
+    RTurk::RejectQualificationRequest(:qualification_request_id => "789RVWYBAZW00EXAMPLE951RVWYBAZW00EXAMPLE").elements.should eql(
+      {"RejectQualificationRequestResult"=>{"Request"=>{"IsValid"=>"True"}}}
+    )
+  end
+
+end

metadata

@@ -1,13 +1,8 @@
 --- !ruby/object:Gem::Specification 
 name: rturk
 version: !ruby/object:Gem::Version 
-  hash: 9
-  prerelease: false
-  segments: 
-  - 2
-  - 3
-  - 5
-  version: 2.3.5
+  prerelease: 
+  version: 2.3.6
 platform: ruby
 authors: 
 - Mark Percival
@@ -18,97 +13,86 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-03-29 00:00:00 -07:00
+date: 2011-03-31 00:00:00 +00:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
-  type: :runtime
-  prerelease: false
-  version_requirements: &id001 !ruby/object:Gem::Requirement 
+  name: nokogiri
+  requirement: &id001 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        hash: 3
-        segments: 
-        - 0
         version: "0"
-  name: nokogiri
-  requirement: *id001
-- !ruby/object:Gem::Dependency 
   type: :runtime
   prerelease: false
-  version_requirements: &id002 !ruby/object:Gem::Requirement 
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: jeweler
+  requirement: &id002 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        hash: 3
-        segments: 
-        - 0
         version: "0"
-  name: fakeweb
-  requirement: *id002
-- !ruby/object:Gem::Dependency 
   type: :runtime
   prerelease: false
-  version_requirements: &id003 !ruby/object:Gem::Requirement 
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: fakeweb
+  requirement: &id003 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        hash: 3
-        segments: 
-        - 0
         version: "0"
-  name: rest-client
-  requirement: *id003
-- !ruby/object:Gem::Dependency 
   type: :runtime
   prerelease: false
-  version_requirements: &id004 !ruby/object:Gem::Requirement 
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: rest-client
+  requirement: &id004 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        hash: 3
-        segments: 
-        - 0
         version: "0"
-  name: rspec
-  requirement: *id004
+  type: :runtime
+  prerelease: false
+  version_requirements: *id004
 - !ruby/object:Gem::Dependency 
+  name: rspec
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 1.3.1
   type: :runtime
   prerelease: false
-  version_requirements: &id005 !ruby/object:Gem::Requirement 
+  version_requirements: *id005
+- !ruby/object:Gem::Dependency 
+  name: rest-client
+  requirement: &id006 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        hash: 7
-        segments: 
-        - 1
-        - 4
-        - 0
         version: 1.4.0
-  name: rest-client
-  requirement: *id005
-- !ruby/object:Gem::Dependency 
   type: :runtime
   prerelease: false
-  version_requirements: &id006 !ruby/object:Gem::Requirement 
+  version_requirements: *id006
+- !ruby/object:Gem::Dependency 
+  name: nokogiri
+  requirement: &id007 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        hash: 5
-        segments: 
-        - 1
-        - 4
-        - 1
         version: 1.4.1
-  name: nokogiri
-  requirement: *id006
+  type: :runtime
+  prerelease: false
+  version_requirements: *id007
 description: 
 email: mark@mpercival.com
 executables: []
@@ -251,9 +235,11 @@ files:
 - lib/rturk/operations/get_qualifications_for_qualification_type.rb
 - lib/rturk/operations/get_reviewable_hits.rb
 - lib/rturk/operations/grant_bonus.rb
+- lib/rturk/operations/grant_qualification.rb
 - lib/rturk/operations/notify_workers.rb
 - lib/rturk/operations/register_hit_type.rb
 - lib/rturk/operations/reject_assignment.rb
+- lib/rturk/operations/reject_qualification_request.rb
 - lib/rturk/operations/revoke_qualification.rb
 - lib/rturk/operations/search_hits.rb
 - lib/rturk/operations/send_test_event_notification.rb
@@ -309,10 +295,12 @@ files:
 - spec/fake_responses/get_qualifications_for_qualification_type.xml
 - spec/fake_responses/get_reviewable_hits.xml
 - spec/fake_responses/grant_bonus.xml
+- spec/fake_responses/grant_qualification.xml
 - spec/fake_responses/invalid_credentials.xml
 - spec/fake_responses/notify_workers.xml
 - spec/fake_responses/register_hit_type.xml
 - spec/fake_responses/reject_assignment.xml
+- spec/fake_responses/reject_qualification_request.xml
 - spec/fake_responses/revoke_qualification.xml
 - spec/fake_responses/search_hits.xml
 - spec/fake_responses/unblock_worker.xml
@@ -337,9 +325,11 @@ files:
 - spec/operations/get_qualifications_for_qualification_type_spec.rb
 - spec/operations/get_reviewable_hits_spec.rb
 - spec/operations/grant_bonus_spec.rb
+- spec/operations/grant_qualification_spec.rb
 - spec/operations/notify_workers_spec.rb
 - spec/operations/register_hit_type_spec.rb
 - spec/operations/reject_assignment_spec.rb
+- spec/operations/reject_qualification_request_spec.rb
 - spec/operations/revoke_qualification_spec.rb
 - spec/operations/send_test_event_notification_spec.rb
 - spec/operations/set_hit_type_notification_spec.rb
@@ -367,23 +357,17 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
-      - 0
       version: "0"
 required_rubygems_version: !ruby/object:Gem::Requirement 
   none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
-      - 0
       version: "0"
 requirements: []
 
 rubyforge_project: 
-rubygems_version: 1.3.7
+rubygems_version: 1.6.2
 signing_key: 
 specification_version: 3
 summary: Mechanical Turk API Wrapper
@@ -416,9 +400,11 @@ test_files:
 - spec/operations/get_qualifications_for_qualification_type_spec.rb
 - spec/operations/get_reviewable_hits_spec.rb
 - spec/operations/grant_bonus_spec.rb
+- spec/operations/grant_qualification_spec.rb
 - spec/operations/notify_workers_spec.rb
 - spec/operations/register_hit_type_spec.rb
 - spec/operations/reject_assignment_spec.rb
+- spec/operations/reject_qualification_request_spec.rb
 - spec/operations/revoke_qualification_spec.rb
 - spec/operations/send_test_event_notification_spec.rb
 - spec/operations/set_hit_type_notification_spec.rb