pco_api 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 6389ae53bf68d7cd03849bc44f51776dd0c8705a
-  data.tar.gz: d0a6ef6c002c42787f00e8e3525f407959eebbf0
+  metadata.gz: 98876042745a7cd20d3682c5c55b9fab8a92a465
+  data.tar.gz: edcdf7afa5cdf072b108b04f14a7be227764dfa3
 SHA512:
-  metadata.gz: edad5401340bd1a6c87f7cc360c8fc09af04d2eebc61de5fed0eba57dbc8d92ce6db43253d810d786b25c475a5e8b17367e42af5d475d4276573034ca90bc374
-  data.tar.gz: ff3c7b758c84e4331b16356689111ff717c1bf322fd2fa2888a4af3838c59360c56263e1e020c18b0a9884fcf26f8af3726d973b35d94b4928651bfc9782f0e4
+  metadata.gz: f14acb70bde82951bbe7734cba538330a244c6008bc8a345895d8b843fa135f04a8e0231d6ff6885b1f481699cfc045ef08f055872c62d5cbf156d6c2f6b0d77
+  data.tar.gz: db31e5122f5f2853cba8d16a1d0701b15d8905e5c89e4c3f9272c7c1aaa73e5b90ac31b6beeb395011b2a05dcc3bc19d976b68faf1d294e4724bb8d6f0fc89e4

data/README.md

@@ -187,11 +187,17 @@ api.people.v1.people[1].delete
 
 The following errors may be raised, which you should rescue in most circumstances.
 
-| HTTP Status Codes   | Error Class                     |
-| ------------------- | ------------------------------- |
-| 404                 | `PCO::API::Errors::NotFound`    |
-| 4xx (except 404)    | `PCO::API::Errors::ClientError` |
-| 5xx                 | `PCO::API::Errors::ServerError` |
+| HTTP Status Codes   | Error Class                                                               |
+| ------------------- | ------------------------------------------------------------------------- |
+| 400                 | `PCO::API::Errors::BadRequest` < `PCO::API::Errors::ClientError`          |
+| 401                 | `PCO::API::Errors::Unauthorized` < `PCO::API::Errors::ClientError`        |
+| 403                 | `PCO::API::Errors::Forbidden` < `PCO::API::Errors::ClientError`           |
+| 404                 | `PCO::API::Errors::NotFound` < `PCO::API::Errors::ClientError`            |
+| 405                 | `PCO::API::Errors::MethodNotAllowed` < `PCO::API::Errors::ClientError`    |
+| 422                 | `PCO::API::Errors::UnprocessableEntity` < `PCO::API::Errors::ClientError` |
+| other 4xx errors    | `PCO::API::Errors::ClientError`                                           |
+| 500                 | `PCO::API::Errors::InternalServerError` < `PCO::API::Errors::ServerError` |
+| other 5xx errors    | `PCO::API::Errors::ServerError`                                           |
 
 The exception class has the following methods:
 

data/lib/pco/api/endpoint.rb

@@ -43,14 +43,14 @@ module PCO
 
       def post(body = {})
         @last_result = @connection.post(@url) do |req|
-          req.body = body.to_json
+          req.body = _build_body(body)
         end
         _build_response(@last_result)
       end
 
       def patch(body = {})
         @last_result = @connection.patch(@url) do |req|
-          req.body = body.to_json
+          req.body = _build_body(body)
         end
         _build_response(@last_result)
       end
@@ -70,10 +70,22 @@ module PCO
         case result.status
         when 200..299
           result.body
+        when 400
+          fail Errors::BadRequest, result
+        when 401
+          fail Errors::Unauthorized, result
+        when 403
+          fail Errors::Forbidden, result
         when 404
           fail Errors::NotFound, result
+        when 405
+          fail Errors::MethodNotAllowed, result
+        when 422
+          fail Errors::UnprocessableEntity, result
         when 400..499
           fail Errors::ClientError, result
+        when 500
+          fail Errors::InternalServerError, result
         when 500..599
           fail Errors::ServerError, result
         else
@@ -81,6 +93,18 @@ module PCO
         end
       end
 
+      def _build_body(body)
+        if _needs_url_encoded?
+          Faraday::Utils.build_nested_query(body)
+        else
+          body.to_json
+        end
+      end
+
+      def _needs_url_encoded?
+        @url =~ /oauth\/[a-z]+\z/
+      end
+
       def _build_endpoint(path)
         @cache[path] ||= begin
           self.class.new(

data/lib/pco/api/errors.rb

@@ -20,9 +20,16 @@ module PCO
         end
       end
 
-      class NotFound    < BaseError; end
-      class ClientError < BaseError; end
-      class ServerError < BaseError; end
+      class ClientError              < BaseError;   end # 400..499
+      class BadRequest               < ClientError; end # 400
+      class Unauthorized             < ClientError; end # 401
+      class Forbidden                < ClientError; end # 403
+      class NotFound                 < ClientError; end # 404
+      class MethodNotAllowed         < ClientError; end # 405
+      class UnprocessableEntity      < ClientError; end # 422
+
+      class ServerError              < BaseError;   end # 500..599
+      class InternalServerError      < ServerError; end # 500
     end
   end
 end

data/lib/pco/api/version.rb

@@ -1,5 +1,5 @@
 module PCO
   module API
-    VERSION = '1.0.0'
+    VERSION = '1.1.0'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pco_api
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Planning Center Online
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-06-03 00:00:00.000000000 Z
+date: 2015-06-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -94,7 +94,7 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 0.10.1
-description: Ruby wrapper for the RESTful PCO API
+description: Ruby wrapper for api.planningcenteronline.com
 email: 
 executables: []
 extensions: []
@@ -130,7 +130,7 @@ rubyforge_project:
 rubygems_version: 2.4.6
 signing_key: 
 specification_version: 4
-summary: Ruby wrapper for the RESTful PCO API
+summary: Ruby wrapper for api.planningcenteronline.com
 test_files:
 - spec/pco/api/endpoint_spec.rb
 - spec/spec_helper.rb