koala 1.3.0 → 1.4.0.rc1

data/lib/koala/version.rb

@@ -1,3 +1,3 @@
 module Koala
-  VERSION = "1.3.0"
+  VERSION = "1.4.0.rc1"
 end

data/readme.md

@@ -32,7 +32,7 @@ The Graph API is the simple, slick new interface to Facebook's data.  Using it w
     @graph.put_object("me", "feed", :message => "I am writing on my wall!")
    
     # three-part queries are easy too!
-    @graph.get_connection("me", "mutualfriends/#{friend_id}")
+    @graph.get_connections("me", "mutualfriends/#{friend_id}")
     
     # you can even use the new Timeline API
     # see https://developers.facebook.com/docs/beta/opengraph/tutorial/

data/spec/cases/graph_api_batch_spec.rb

@@ -372,11 +372,11 @@ describe "Koala::Facebook::GraphAPI in batch mode" do
           end
           result[0].should == {"Content-Type" => "text/javascript; charset=UTF-8"}
         end
-        
+
         describe "if it errors" do
           it "raises an APIError if the response is not 200" do
             Koala.stub(:make_request).and_return(Koala::HTTPService::Response.new(500, "[]", {}))
-            expect { 
+            expect {
               Koala::Facebook::API.new("foo").batch {|batch_api| batch_api.get_object('me') }
             }.to raise_exception(Koala::Facebook::APIError)
           end
@@ -385,21 +385,21 @@ describe "Koala::Facebook::GraphAPI in batch mode" do
             before :each do
               Koala.stub(:make_request).and_return(Koala::HTTPService::Response.new(200, '{"error":190,"error_description":"Error validating access token."}', {}))
             end
-            
+
             it "throws an error if the response is an old Batch API-style error" do
-              expect { 
+              expect {
                 Koala::Facebook::API.new("foo").batch {|batch_api| batch_api.get_object('me') }
               }.to raise_exception(Koala::Facebook::APIError)
-            end   
-            
+            end
+
             it "provides a type for the error if the response is an old Batch API-style error" do
               begin
                 Koala::Facebook::API.new("foo").batch {|batch_api| batch_api.get_object('me') }
               rescue Koala::Facebook::APIError => err
               end
               err.fb_error_type.should
-            end         
-            
+            end
+
             it "passes all the error details if an old Batch API-style error is raised" do
               begin
                 Koala::Facebook::API.new("foo").batch {|batch_api| batch_api.get_object('me') }
@@ -408,18 +408,18 @@ describe "Koala::Facebook::GraphAPI in batch mode" do
               err.raw_response["error"].should == 190
             end
           end
-          
-          context "with the new style" do          
+
+          context "with the new style" do
             before :each do
               Koala.stub(:make_request).and_return(Koala::HTTPService::Response.new(200, '{"error":{"message":"Request 0 cannot depend on an  unresolved request with  name f. Requests can only depend on preceding requests","type":"GraphBatchException"}}', {}))
             end
 
             it "throws an error if the response is a new Graph API-style error" do
-              expect { 
+              expect {
                 Koala::Facebook::API.new("foo").batch {|batch_api| batch_api.get_object('me') }
               }.to raise_exception(Koala::Facebook::APIError)
             end
-            
+
             it "passes all the error details if an old Batch API-style error is raised" do
               begin
                 Koala::Facebook::API.new("foo").batch {|batch_api| batch_api.get_object('me') }
@@ -488,7 +488,7 @@ describe "Koala::Facebook::GraphAPI in batch mode" do
       end
       friends.should be_a(Koala::Facebook::GraphCollection)
     end
-    
+
     it 'turns pageable results into GraphCollections' do
       me, friends = @api.batch do |batch_api|
         batch_api.get_object('me')
@@ -515,11 +515,11 @@ describe "Koala::Facebook::GraphAPI in batch mode" do
     end
 
     it "inserts errors in the appropriate place, without breaking other results" do
-      failed_insights, koppel = @api.batch do |batch_api|
-        batch_api.get_connections(@app_id, 'insights')
+      failed_call, koppel = @api.batch do |batch_api|
+        batch_api.get_connection("2", "invalidconnection")
         batch_api.get_object(KoalaTest.user1, {}, {"access_token" => @app_api.access_token})
       end
-      failed_insights.should be_a(Koala::Facebook::APIError)
+      failed_call.should be_a(Koala::Facebook::APIError)
       koppel["id"].should_not be_nil
     end
 
@@ -602,12 +602,12 @@ describe "Koala::Facebook::GraphAPI in batch mode" do
       end
 
       it "properly handles dependencies that fail" do
-        data, koppel = @api.batch do |batch_api|
-          batch_api.get_connections(@app_id, 'insights', {}, :batch_args => {:name => "getdata"})
+        failed_call, koppel = @api.batch do |batch_api|
+          batch_api.get_connections("2", "invalidconnection", {}, :batch_args => {:name => "getdata"})
           batch_api.get_object(KoalaTest.user1, {}, :batch_args => {:depends_on => "getdata"})
         end
 
-        data.should be_a(Koala::Facebook::APIError)
+        failed_call.should be_a(Koala::Facebook::APIError)
         koppel.should be_nil
       end
 

data/spec/cases/http_service_spec.rb

@@ -123,6 +123,13 @@ describe "Koala::HTTPService" do
         val.should == CGI.escape(args[key])
       end
     end
+    
+    it "encodes parameters in alphabetical order" do
+      args = {:b => '2', 'a' => '1'}
+      
+      result = Koala::HTTPService.encode_params(args)
+      result.split('&').map{|key_val| key_val.split('=')[0]}.should == ['a', 'b']
+    end
 
     it "converts all keys to Strings" do
       args = Hash[*(1..4).map {|i| [i, "val#{i}"]}.flatten]

data/spec/cases/koala_test_spec.rb

@@ -0,0 +1,5 @@
+require 'spec_helper'
+
+describe KoalaTest do
+  pending "should have tests, because the test suite depends on it"
+end

data/spec/cases/oauth_spec.rb

@@ -7,6 +7,7 @@ describe "Koala::Facebook::OAuth" do
     @secret = KoalaTest.secret
     @code = KoalaTest.code
     @callback_url = KoalaTest.oauth_test_data["callback_url"]
+    @access_token = KoalaTest.oauth_test_data["access_token"]
     @raw_token_string = KoalaTest.oauth_test_data["raw_token_string"]
     @raw_offline_access_token_string = KoalaTest.oauth_test_data["raw_offline_access_token_string"]
 
@@ -61,7 +62,7 @@ describe "Koala::Facebook::OAuth" do
           @token = "my token"
           @oauth.stub(:get_access_token_info).and_return("access_token" => @token)
         end
-        
+
         it "parses valid cookies" do
           result = @oauth.get_user_info_from_cookies(@cookie)
           result.should be_a(Hash)
@@ -71,9 +72,9 @@ describe "Koala::Facebook::OAuth" do
           result = @oauth.get_user_info_from_cookies(@cookie)
           @oauth.parse_signed_request(@cookie.values.first).each_pair do |k, v|
             result[k].should == v
-          end          
+          end
         end
-        
+
         it "makes a request to Facebook to redeem the code if present" do
           code = "foo"
           @oauth.stub(:parse_signed_request).and_return({"code" => code})
@@ -98,12 +99,12 @@ describe "Koala::Facebook::OAuth" do
             @oauth.get_user_info_from_cookies(@cookie).should be_nil
           end
         end
-        
+
         context "if the code is present" do
           it "adds the access_token into the hash" do
             @oauth.get_user_info_from_cookies(@cookie)["access_token"].should == @token
           end
-          
+
           it "returns nil if the call to FB returns no data" do
             @oauth.stub(:get_access_token_info).and_return(nil)
             @oauth.get_user_info_from_cookies(@cookie).should be_nil
@@ -125,7 +126,7 @@ describe "Koala::Facebook::OAuth" do
             expect { @oauth.get_user_info_from_cookies(@cookie) }.to raise_exception(Koala::Facebook::APIError)
           end
         end
-        
+
         it "doesn't parse invalid cookies" do
           # make an invalid string by replacing some values
           bad_cookie_hash = @cookie.inject({}) { |hash, value| hash[value[0]] = value[1].gsub(/[0-9]/, "3") }
@@ -133,7 +134,7 @@ describe "Koala::Facebook::OAuth" do
           result.should be_nil
         end
       end
-      
+
       context "for unsigned cookies" do
         it "properly parses valid cookies" do
           result = @oauth.get_user_info_from_cookies(KoalaTest.oauth_test_data["valid_cookies"])
@@ -161,7 +162,7 @@ describe "Koala::Facebook::OAuth" do
 
         it "doesn't parse expired cookies" do
           new_time = @time.to_i * 2
-          @time.stub(:to_i).and_return(new_time)          
+          @time.stub(:to_i).and_return(new_time)
           @oauth.get_user_info_from_cookies(KoalaTest.oauth_test_data["valid_cookies"]).should be_nil
         end
 
@@ -179,7 +180,7 @@ describe "Koala::Facebook::OAuth" do
         before :each do
           # we don't actually want to make requests to Facebook to redeem the code
           @cookie = KoalaTest.oauth_test_data["valid_signed_cookies"]
-          @oauth.stub(:get_access_token_info).and_return("access_token" => "my token")          
+          @oauth.stub(:get_access_token_info).and_return("access_token" => "my token")
         end
 
         it "does not uses get_user_info_from_cookies to parse the cookies" do
@@ -199,7 +200,7 @@ describe "Koala::Facebook::OAuth" do
           result.should be_nil
         end
       end
-      
+
       describe "for unsigned cookies" do
         before :each do
           # we don't actually want to make requests to Facebook to redeem the code
@@ -267,14 +268,14 @@ describe "Koala::Facebook::OAuth" do
         oauth2 = Koala::Facebook::OAuth.new(@app_id, @secret)
         lambda { oauth2.url_for_oauth_code }.should raise_error(ArgumentError)
       end
-      
+
       it "includes any additional options as URL parameters, appropriately escaped" do
         params = {
           :url => "http://foo.bar?c=2",
           :email => "cdc@b.com"
         }
         url = @oauth.url_for_oauth_code(params)
-        params.each_pair do |key, value| 
+        params.each_pair do |key, value|
           url.should =~ /[\&\?]#{key}=#{CGI.escape value}/
         end
       end
@@ -285,7 +286,7 @@ describe "Koala::Facebook::OAuth" do
         # since we're just composing a URL here, we don't need to have a real code
         @code ||= "test_code"
       end
-      
+
       it "generates a properly formatted OAuth token URL when provided a code" do
         url = @oauth.url_for_access_token(@code)
         url.should match_url("https://#{Koala::Facebook::GRAPH_SERVER}/oauth/access_token?client_id=#{@app_id}&code=#{@code}&client_secret=#{@secret}&redirect_uri=#{CGI.escape @callback_url}").should be_true
@@ -303,18 +304,18 @@ describe "Koala::Facebook::OAuth" do
           :email => "cdc@b.com"
         }
         url = @oauth.url_for_access_token(@code, params)
-        params.each_pair do |key, value| 
+        params.each_pair do |key, value|
           url.should =~ /[\&\?]#{key}=#{CGI.escape value}/
         end
       end
     end
-    
+
     describe "#url_for_dialog" do
       it "builds the base properly" do
         dialog_type = "my_dialog_type"
         @oauth.url_for_dialog(dialog_type).should =~ /^http:\/\/#{Koala::Facebook::DIALOG_HOST}\/dialog\/#{dialog_type}/
       end
-      
+
       it "adds the app_id/client_id to the url" do
         automatic_params = {:app_id => @app_id, :client_id => @client_id}
         url = @oauth.url_for_dialog("foo", automatic_params)
@@ -323,19 +324,19 @@ describe "Koala::Facebook::OAuth" do
           url.should =~ /[\&\?]#{key}=#{CGI.escape value.to_s}/
         end
       end
-            
+
       it "includes any additional options as URL parameters, appropriately escaped" do
         params = {
           :url => "http://foo.bar?c=2",
           :email => "cdc@b.com"
         }
         url = @oauth.url_for_dialog("friends", params)
-        params.each_pair do |key, value| 
+        params.each_pair do |key, value|
           # we're slightly simplifying how encode_params works, but strings/ints, it's okay
           url.should =~ /[\&\?]#{key}=#{CGI.escape value.to_s}/
         end
       end
-      
+
       describe "real examples from FB documentation" do
         # see http://developers.facebook.com/docs/reference/dialogs/
         # slightly brittle (e.g. if parameter order changes), but still useful
@@ -343,17 +344,17 @@ describe "Koala::Facebook::OAuth" do
           url = @oauth.url_for_dialog("send", :name => "People Argue Just to Win", :link => "http://www.nytimes.com/2011/06/15/arts/people-argue-just-to-win-scholars-assert.html")
           url.should match_url("http://www.facebook.com/dialog/send?app_id=#{@app_id}&client_id=#{@app_id}&link=http%3A%2F%2Fwww.nytimes.com%2F2011%2F06%2F15%2Farts%2Fpeople-argue-just-to-win-scholars-assert.html&name=People+Argue+Just+to+Win&redirect_uri=#{CGI.escape @callback_url}")
         end
-      
+
         it "can generate a feed dialog" do
           url = @oauth.url_for_dialog("feed", :name => "People Argue Just to Win", :link => "http://www.nytimes.com/2011/06/15/arts/people-argue-just-to-win-scholars-assert.html")
           url.should match_url("http://www.facebook.com/dialog/feed?app_id=#{@app_id}&client_id=#{@app_id}&link=http%3A%2F%2Fwww.nytimes.com%2F2011%2F06%2F15%2Farts%2Fpeople-argue-just-to-win-scholars-assert.html&name=People+Argue+Just+to+Win&redirect_uri=#{CGI.escape @callback_url}")
         end
-      
+
         it "can generate a oauth dialog" do
           url = @oauth.url_for_dialog("oauth", :scope => "email", :response_type => "token")
           url.should match_url("http://www.facebook.com/dialog/oauth?app_id=#{@app_id}&client_id=#{@app_id}&redirect_uri=#{CGI.escape @callback_url}&response_type=token&scope=email")
         end
-      
+
         it "can generate a pay dialog" do
           url = @oauth.url_for_dialog("pay", :order_id => "foo", :credits_purchase => false)
           url.should match_url("http://www.facebook.com/dialog/pay?app_id=#{@app_id}&client_id=#{@app_id}&order_id=foo&credits_purchase=false&redirect_uri=#{CGI.escape @callback_url}")
@@ -369,15 +370,15 @@ describe "Koala::Facebook::OAuth" do
         Koala.should_receive(:make_request).with(anything, hash_including(:redirect_uri => uri), anything, anything).and_return(Koala::HTTPService::Response.new(200, "", {}))
         @oauth.get_access_token_info(@code, :redirect_uri => uri)
       end
-      
+
       it "uses the redirect_uri used to create the @oauth if no :redirect_uri option is provided" do
         Koala.should_receive(:make_request).with(anything, hash_including(:redirect_uri => @callback_url), anything, anything).and_return(Koala::HTTPService::Response.new(200, "", {}))
-        @oauth.get_access_token_info(@code)        
+        @oauth.get_access_token_info(@code)
       end
-      
+
       it "makes a GET request" do
         Koala.should_receive(:make_request).with(anything, anything, "get", anything).and_return(Koala::HTTPService::Response.new(200, "", {}))
-        @oauth.get_access_token_info(@code)                
+        @oauth.get_access_token_info(@code)
       end
 
       if KoalaTest.code
@@ -390,13 +391,13 @@ describe "Koala::Facebook::OAuth" do
           result = @oauth.get_access_token_info(@code)
           result["access_token"].should
         end
-        
+
         it "raises an error when get_access_token is called with a bad code" do
           lambda { @oauth.get_access_token_info("foo") }.should raise_error(Koala::Facebook::APIError)
         end
       end
     end
-    
+
     describe "#get_access_token" do
       # TODO refactor these to be proper tests with stubs and tests against real data
       it "passes on any options provided to make_request" do
@@ -422,7 +423,7 @@ describe "Koala::Facebook::OAuth" do
         end
       end
     end
-    
+
     unless KoalaTest.code
       it "Some OAuth code tests will not be run since the code field in facebook_data.yml is blank."
     end
@@ -445,7 +446,7 @@ describe "Koala::Facebook::OAuth" do
       end
     end
 
-    describe "get_app_acess_token" do
+    describe "get_app_access_token" do
       it "uses get_access_token_info to get and parse an access token token results" do
         result = @oauth.get_app_access_token
         result.should be_a(String)
@@ -464,8 +465,47 @@ describe "Koala::Facebook::OAuth" do
       end
     end
 
-    describe "protected methods" do
+    describe "exchange_access_token_info" do
+      if KoalaTest.mock_interface? || KoalaTest.oauth_token
+        it "properly gets and parses an app's access token as a hash" do
+          result = @oauth.exchange_access_token_info(KoalaTest.oauth_token)
+          result.should be_a(Hash)
+        end
 
+        it "includes the access token" do
+          result = @oauth.exchange_access_token_info(KoalaTest.oauth_token)
+          result["access_token"].should
+        end
+      else
+        pending "Some OAuth token exchange tests will not be run since the access token field in facebook_data.yml is blank."
+      end
+
+      it "passes on any options provided to make_request" do
+        options = {:a => 2}
+        Koala.should_receive(:make_request).with(anything, anything, anything, hash_including(options)).and_return(Koala::HTTPService::Response.new(200, "", {}))
+        @oauth.exchange_access_token_info(KoalaTest.oauth_token, options)
+      end
+
+      it "raises an error when exchange_access_token_info is called with a bad code" do
+        lambda { @oauth.exchange_access_token_info("foo") }.should raise_error(Koala::Facebook::APIError)
+      end
+    end
+
+    describe "exchange_access_token" do
+      it "uses get_access_token_info to get and parse an access token token results" do
+        hash = {"access_token" => Time.now.to_i * rand}
+        @oauth.stub(:exchange_access_token_info).and_return(hash)
+        @oauth.exchange_access_token(KoalaTest.oauth_token).should == hash["access_token"]
+      end
+
+      it "passes on any options provided to make_request" do
+        options = {:a => 2}
+        Koala.should_receive(:make_request).with(anything, anything, anything, hash_including(options)).and_return(Koala::HTTPService::Response.new(200, "", {}))
+        @oauth.exchange_access_token(KoalaTest.oauth_token, options)
+      end
+    end
+
+    describe "protected methods" do
       # protected methods
       # since these are pretty fundamental and pretty testable, we want to test them
 
@@ -623,7 +663,7 @@ describe "Koala::Facebook::OAuth" do
       OpenSSL::HMAC.stub!(:hexdigest).and_return("i'm an invalid signature")
       lambda { @oauth.parse_signed_request(@signed_request) }.should raise_error
     end
-    
+
     it "throws an error if the signature string is empty" do
       # this occasionally happens due to Facebook error
       lambda { @oauth.parse_signed_request("") }.should raise_error

data/spec/fixtures/facebook_data.yml

@@ -33,7 +33,7 @@ oauth_test_data:
   offline_access_cookies:
     # note: I've revoked the offline access for security reasons, so you can't make calls against this :)
     fbs_119908831367602: '"access_token=119908831367602|08170230801eb225068e7a70-2905623|Q3LDCYYF8CX9cstxnZLsxiR0nwg.&expires=0&secret=78abaee300b392e275072a9f2727d436&session_key=08170230801eb225068e7a70-2905623&sig=423b8aa4b6fa1f9a571955f8e929d567&uid=2905623"'
-  valid_signed_cookies: 
+  valid_signed_cookies:
     "fbsr_119908831367602": "f1--LHwjHVCxfs97hRHL-4cF-0jNxZRc6MGzo1qHLb0.eyJhbGdvcml0aG0iOiJITUFDLVNIQTI1NiIsImNvZGUiOiIyLkFRQm90a0pBWlhVY1l3RkMuMzYwMC4xMzE0ODEzNjAwLjEtMjkwNTYyM3x4V2xya0d0UmJIZlpIclRnVWwxQmxJcVhRbjQiLCJpc3N1ZWRfYXQiOjEzMTQ4MDY2NTUsInVzZXJfaWQiOiIyOTA1NjIzIn0"
 
 

data/spec/fixtures/mock_facebook_responses.yml

@@ -80,7 +80,7 @@ graph_api:
     batch=<%= MultiJson.encode([{"method"=>"get", "relative_url"=>"me"}, {"method"=>"get", "relative_url"=>"#{OAUTH_DATA["app_id"]}/insights?access_token=#{CGI.escape APP_ACCESS_TOKEN}"}]) %>:
       post:
         with_token: '[{"body":"{\"id\":\"123\"}"}, {"body":"{\"data\":[],\"paging\":{}}"}]'
-    batch=<%= MultiJson.encode([{"method"=>"get", "relative_url"=>"#{OAUTH_DATA["app_id"]}/insights"}, {"method"=>"get", "relative_url"=>"koppel?access_token=#{CGI.escape APP_ACCESS_TOKEN}"}]) %>:
+    batch=<%= MultiJson.encode([{"method"=>"get", "relative_url"=>"2/invalidconnection"}, {"method"=>"get", "relative_url"=>"koppel?access_token=#{CGI.escape APP_ACCESS_TOKEN}"}]) %>:
       post:
         with_token: '[{"body": "{\"error\":{\"type\":\"AnError\", \"message\":\"An error occurred!.\"}}"},{"body":"{\"id\":\"123\"}"}]'
     batch=<%= MultiJson.encode([{"method"=>"post", "relative_url"=>"FEED_ITEM_BATCH/likes"}, {"method"=>"delete", "relative_url"=> "FEED_ITEM_BATCH"}]) %>:
@@ -94,7 +94,7 @@ graph_api:
     batch=<%= MultiJson.encode([{"method"=>"get", "relative_url"=>"me", "name" => "getme"}, {"method"=>"get", "relative_url"=>"koppel", "depends_on" => "getme"}]) %>:
       post:
         with_token: '[null,{"body":"{\"id\":\"123\"}"}]'
-    batch=<%= MultiJson.encode([{"method"=>"get", "relative_url"=>"#{OAUTH_DATA["app_id"]}/insights", "name" => "getdata"}, {"method"=>"get", "relative_url"=>"koppel", "depends_on" => "getdata"}]) %>:
+    batch=<%= MultiJson.encode([{"method"=>"get", "relative_url"=>"2/invalidconnection", "name" => "getdata"}, {"method"=>"get", "relative_url"=>"koppel", "depends_on" => "getdata"}]) %>:
       post:
         with_token: '[{"body": "{\"error\":{\"type\":\"AnError\", \"message\":\"An error occurred!.\"}}"},null]'
     batch=<%= MultiJson.encode([{"method" => "get", "relative_url" => "me/friends?limit=5", "name" => "get-friends"}, {"method" => "get", "relative_url" => "?ids=#{CGI.escape "{result=get-friends:$.data.*.id}"}"}]) %>:
@@ -149,6 +149,9 @@ graph_api:
     message=Hello, world, from the test suite delete method!:
       post:
         with_token: '{"id": "FEED_ITEM_DELETE"}'
+    message=Hello, world, from the test suite delete like method!:
+      post:
+        with_token: '{"id": "FEED_ITEM_DELETE"}'
     message=Hello, world, from the test suite batch API!:
       post:
         with_token: '{"id": "FEED_ITEM_BATCH"}'
@@ -157,7 +160,7 @@ graph_api:
         with_token: '{"id": "FEED_ITEM_CONTEXT"}'
     link=http://oauth.twoalex.com/&message=body&name=It's a big question&picture=http://oauth.twoalex.com//images/logo.png&properties=<%= {"name"=>"Link1'", "text"=>"Left", "href"=>"http://oauth.twoalex.com/"}.to_s %>=<%= {"name"=>"other", "text"=>"Straight ahead"}.to_s %>&type=link:
       post:
-        with_token: '{"id": "FEED_ITEM_CONTEXT"}'        
+        with_token: '{"id": "FEED_ITEM_CONTEXT"}'
 
   /me/photos:
     source=[FILE]:
@@ -308,6 +311,12 @@ graph_api:
     client_id=<%= APP_ID %>&client_secret=<%= SECRET %>&type=client_cred:
       post:
         no_token: access_token=<%= APP_ACCESS_TOKEN %>
+    client_id=<%= APP_ID %>&client_secret=<%= SECRET %>&fb_exchange_token=<%= ACCESS_TOKEN %>&grant_type=fb_exchange_token:
+      post:
+        no_token: access_token=<%= ACCESS_TOKEN %>&expires=5184000
+    client_id=<%= APP_ID %>&client_secret=<%= SECRET %>&fb_exchange_token=foo&grant_type=fb_exchange_token:
+      post:
+        <<: *oauth_error
   /oauth/exchange_sessions:
     client_id=<%= APP_ID %>&client_secret=<%= SECRET %>&sessions=<%= OAUTH_DATA["session_key"] %>&type=client_cred:
       post: