kentaa-api 0.5.0 → 0.6.0

data/lib/kentaa/api/request.rb

@@ -35,8 +35,6 @@ module Kentaa
         uri = URI.parse(File.join(config.api_url, path))
         uri.query = URI.encode_www_form(params) unless params.empty?
 
-        logger.debug("[Kentaa-API] Request: #{http_method.upcase} #{uri}") if config.debug?
-
         case http_method
         when :get
           request = Net::HTTP::Get.new(uri)
@@ -52,6 +50,8 @@ module Kentaa
           raise Kentaa::Api::Exception, "Invalid HTTP method: #{http_method}"
         end
 
+        logger.debug("[Kentaa-API] Request: #{http_method.upcase} #{uri}") if config.debug?
+
         request["Accept"] = "application/json"
         request["Content-Type"] = "application/json"
         request["X-Api-Key"] = config.api_key

data/lib/kentaa/api/resources/action.rb

@@ -198,11 +198,15 @@ module Kentaa
         end
 
         def donations
-          @donations ||= Kentaa::Api::Resources::Donations.new(config, action_id: id)
+          @donations ||= Kentaa::Api::Resources::List.new(config, resource_class: Kentaa::Api::Resources::Donation, endpoint_path: "/actions/#{id}/donations")
         end
 
         def manual_donations
-          @manual_donations ||= Kentaa::Api::Resources::ManualDonations.new(config, action_id: id)
+          @manual_donations ||= Kentaa::Api::Resources::List.new(config, resource_class: Kentaa::Api::Resources::ManualDonation, endpoint_path: "/actions/#{id}/manual-donations")
+        end
+
+        def performances
+          @performances ||= Kentaa::Api::Resources::List.new(config, resource_class: Kentaa::Api::Resources::Performance, endpoint_path: "/actions/#{id}/performances")
         end
 
         private

data/lib/kentaa/api/resources/base.rb

@@ -4,15 +4,29 @@ module Kentaa
   module Api
     module Resources
       class Base
-        attr_reader :config, :options
+        attr_reader :config, :options, :resource_class, :endpoint_path
 
         def initialize(config, options = {})
           @config = config
           @options = options
+          @resource_class = options.delete(:resource_class) || self.class
+          @endpoint_path = options.delete(:endpoint_path)
+        end
+
+        class << self
+          def attribute_key
+            class_name = name.split('::').last
+            class_name.gsub(/([^\^])([A-Z])/, '\1_\2').downcase
+          end
         end
 
         def load
-          @response ||= load_resource
+          @response ||=
+            if block_given?
+              yield
+            else
+              load_resource
+            end
 
           self
         end
@@ -24,8 +38,7 @@ module Kentaa
         private
 
         def attribute_key
-          class_name = self.class.name.split('::').last
-          class_name.gsub(/([^\^])([A-Z])/, '\1_\2').downcase.to_sym
+          self.class.attribute_key
         end
 
         def load_resource
@@ -36,7 +49,7 @@ module Kentaa
           @data ||= begin
             load unless loaded?
 
-            @response.body[attribute_key] || {}
+            @response.body[attribute_key.to_sym] || {}
           end
         end
 

data/lib/kentaa/api/resources/donation_form.rb

@@ -78,15 +78,19 @@ module Kentaa
         end
 
         def donations
-          @donations ||= Kentaa::Api::Resources::Donations.new(config, donation_form_id: id)
+          @donations ||= Kentaa::Api::Resources::List.new(config, resource_class: Kentaa::Api::Resources::Donation, endpoint_path: "/donation-forms/#{id}/donations")
         end
 
         def manual_donations
-          @manual_donations ||= Kentaa::Api::Resources::ManualDonations.new(config, donation_form_id: id)
+          @manual_donations ||= Kentaa::Api::Resources::List.new(config, resource_class: Kentaa::Api::Resources::ManualDonation, endpoint_path: "/donation-forms/#{id}/manual-donations")
         end
 
         def newsletter_subscriptions
-          @newsletter_subscriptions ||= Kentaa::Api::Resources::NewsletterSubscriptions.new(config, donation_form_id: id)
+          @newsletter_subscriptions ||= Kentaa::Api::Resources::List.new(config, resource_class: Kentaa::Api::Resources::NewsletterSubscription, endpoint_path: "/donation-forms/#{id}/newsletter-subscriptions")
+        end
+
+        def recurring_donors
+          @recurring_donors ||= Kentaa::Api::Resources::List.new(config, resource_class: Kentaa::Api::Resources::RecurringDonor, endpoint_path: "/donation-forms/#{id}/recurring-donors")
         end
 
         private

data/lib/kentaa/api/resources/list.rb

@@ -4,6 +4,20 @@ module Kentaa
   module Api
     module Resources
       class List < Base
+        include Enumerable
+
+        def [](index)
+          resources[index]
+        end
+
+        def size
+          resources.size
+        end
+
+        def each(&block)
+          resources.each(&block)
+        end
+
         def links
           body[:links]
         end
@@ -45,11 +59,11 @@ module Kentaa
         end
 
         def next
-          self.class.new(config, options.merge(page: next_page)) if next_page?
+          self.class.new(config, options.merge(resource_class: resource_class, endpoint_path: endpoint_path, page: next_page)) if next_page?
         end
 
         def previous
-          self.class.new(config, options.merge(page: previous_page)) if previous_page?
+          self.class.new(config, options.merge(resource_class: resource_class, endpoint_path: endpoint_path, page: previous_page)) if previous_page?
         end
 
         def all
@@ -57,7 +71,7 @@ module Kentaa
             page = 1
 
             loop do
-              response = self.class.new(config, options.merge(page: page))
+              response = self.class.new(config, options.merge(resource_class: resource_class, endpoint_path: endpoint_path, page: page))
               response.each { |item| yielder.yield item }
 
               raise StopIteration unless response.next_page?
@@ -68,6 +82,50 @@ module Kentaa
 
           enumerator.lazy
         end
+
+        def get(id, options = {})
+          resource = resource_class.new(config, id: id, options: options.merge(endpoint_path: endpoint_path))
+          resource.load
+        end
+
+        def create(attributes, options = {})
+          resource = resource_class.new(config, options: options.merge(endpoint_path: endpoint_path))
+          resource.save(attributes)
+        end
+
+        def update(id, attributes, options = {})
+          resource = resource_class.new(config, id: id, options: options.merge(endpoint_path: endpoint_path))
+          resource.save(attributes)
+        end
+
+        def delete(id, options = {})
+          resource = resource_class.new(config, id: id, options: options.merge(endpoint_path: endpoint_path))
+          resource.delete
+        end
+
+        private
+
+        def resources
+          @resources ||= begin
+            resources = []
+
+            if data
+              data.each do |resource|
+                resources << resource_class.new(config, data: resource, options: options)
+              end
+            end
+
+            resources
+          end
+        end
+
+        def attribute_key
+          Util.pluralize(resource_class.attribute_key)
+        end
+
+        def load_resource
+          request.get(endpoint_path, options)
+        end
       end
     end
   end

data/lib/kentaa/api/resources/performance.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+require 'bigdecimal'
+require 'time'
+
+module Kentaa
+  module Api
+    module Resources
+      class Performance < Resource
+        def object_key
+          "ActionPerformance_#{id}"
+        end
+
+        def action_id
+          data[:action_id]
+        end
+
+        def action
+          Kentaa::Api::Resources::Action.new(config, id: action_id, options: options)
+        end
+
+        def title
+          data[:title]
+        end
+
+        def performance_type
+          data[:performance_type]
+        end
+
+        def performance_at
+          Time.parse(data[:performance_at])
+        end
+
+        def distance
+          BigDecimal(data[:distance])
+        end
+
+        def unit
+          data[:unit]
+        end
+
+        private
+
+        def load_resource
+          request.get("#{endpoint_path}/#{id}", options)
+        end
+
+        def create_resource(attributes)
+          request.post(endpoint_path, options, attributes)
+        end
+
+        def update_resource(attributes)
+          request.patch("#{endpoint_path}/#{id}", options, attributes)
+        end
+
+        def delete_resource
+          request.delete("#{endpoint_path}/#{id}", options)
+        end
+      end
+    end
+  end
+end

data/lib/kentaa/api/resources/project.rb

@@ -145,16 +145,24 @@ module Kentaa
           data[:external_reference]
         end
 
+        def actions
+          @actions ||= Kentaa::Api::Resources::List.new(config, resource_class: Kentaa::Api::Resources::Action, endpoint_path: "/projects/#{id}/actions")
+        end
+
+        def teams
+          @teams ||= Kentaa::Api::Resources::List.new(config, resource_class: Kentaa::Api::Resources::Team, endpoint_path: "/projects/#{id}/teams")
+        end
+
         def donations
-          @donations ||= Kentaa::Api::Resources::Donations.new(config, project_id: id)
+          @donations ||= Kentaa::Api::Resources::List.new(config, resource_class: Kentaa::Api::Resources::Donation, endpoint_path: "/projects/#{id}/donations")
         end
 
         def manual_donations
-          @manual_donations ||= Kentaa::Api::Resources::ManualDonations.new(config, project_id: id)
+          @manual_donations ||= Kentaa::Api::Resources::List.new(config, resource_class: Kentaa::Api::Resources::ManualDonation, endpoint_path: "/projects/#{id}/manual-donations")
         end
 
         def newsletter_subscriptions
-          @newsletter_subscriptions ||= Kentaa::Api::Resources::NewsletterSubscriptions.new(config, project_id: id)
+          @newsletter_subscriptions ||= Kentaa::Api::Resources::List.new(config, resource_class: Kentaa::Api::Resources::NewsletterSubscription, endpoint_path: "/projects/#{id}/newsletter-subscriptions")
         end
 
         private

data/lib/kentaa/api/resources/recurring_donor.rb

@@ -96,7 +96,7 @@ module Kentaa
         end
 
         def donations
-          @donations ||= Kentaa::Api::Resources::Donations.new(config, recurring_donor_id: id)
+          @donations ||= Kentaa::Api::Resources::List.new(config, resource_class: Kentaa::Api::Resources::Donation, endpoint_path: "/recurring-donors/#{id}/donations")
         end
 
         private

data/lib/kentaa/api/resources/segment.rb

@@ -81,16 +81,28 @@ module Kentaa
           data[:external_reference]
         end
 
+        def actions
+          @actions ||= Kentaa::Api::Resources::List.new(config, resource_class: Kentaa::Api::Resources::Action, endpoint_path: "/segments/#{id}/actions")
+        end
+
+        def teams
+          @teams ||= Kentaa::Api::Resources::List.new(config, resource_class: Kentaa::Api::Resources::Team, endpoint_path: "/segments/#{id}/teams")
+        end
+
+        def projects
+          @projects ||= Kentaa::Api::Resources::List.new(config, resource_class: Kentaa::Api::Resources::Project, endpoint_path: "/segments/#{id}/projects")
+        end
+
         def donations
-          @donations ||= Kentaa::Api::Resources::Donations.new(config, segment_id: id)
+          @donations ||= Kentaa::Api::Resources::List.new(config, resource_class: Kentaa::Api::Resources::Donation, endpoint_path: "/segments/#{id}/donations")
         end
 
         def manual_donations
-          @manual_donations ||= Kentaa::Api::Resources::ManualDonations.new(config, segment_id: id)
+          @manual_donations ||= Kentaa::Api::Resources::List.new(config, resource_class: Kentaa::Api::Resources::ManualDonation, endpoint_path: "/segments/#{id}/manual-donations")
         end
 
         def newsletter_subscriptions
-          @newsletter_subscriptions ||= Kentaa::Api::Resources::NewsletterSubscriptions.new(config, segment_id: id)
+          @newsletter_subscriptions ||= Kentaa::Api::Resources::List.new(config, resource_class: Kentaa::Api::Resources::NewsletterSubscription, endpoint_path: "/segments/#{id}/newsletter-subscriptions")
         end
 
         private

data/lib/kentaa/api/resources/site.rb

@@ -86,15 +86,15 @@ module Kentaa
         end
 
         def donations
-          @donations ||= Kentaa::Api::Resources::Donations.new(config)
+          @donations ||= Kentaa::Api::Resources::List.new(config, resource_class: Kentaa::Api::Resources::Donation, endpoint_path: "/donations")
         end
 
         def manual_donations
-          @manual_donations ||= Kentaa::Api::Resources::ManualDonations.new(config)
+          @manual_donations ||= Kentaa::Api::Resources::List.new(config, resource_class: Kentaa::Api::Resources::ManualDonation, endpoint_path: "/manual-donations")
         end
 
         def newsletter_subscriptions
-          @newsletter_subscriptions ||= Kentaa::Api::Resources::NewsletterSubscriptions.new(config)
+          @newsletter_subscriptions ||= Kentaa::Api::Resources::List.new(config, resource_class: Kentaa::Api::Resources::NewsletterSubscription, endpoint_path: "/newsletter-subscriptions")
         end
 
         private

data/lib/kentaa/api/{clients → resources}/sites.rb

@@ -2,7 +2,7 @@
 
 module Kentaa
   module Api
-    module Clients
+    module Resources
       class Sites < Base
         def current(options = {})
           site = Kentaa::Api::Resources::Site.new(config, options: options)

data/lib/kentaa/api/resources/team.rb

@@ -162,11 +162,11 @@ module Kentaa
         end
 
         def donations
-          @donations ||= Kentaa::Api::Resources::Donations.new(config, team_id: id)
+          @donations ||= Kentaa::Api::Resources::List.new(config, resource_class: Kentaa::Api::Resources::Donation, endpoint_path: "/teams/#{id}/donations")
         end
 
         def manual_donations
-          @manual_donations ||= Kentaa::Api::Resources::ManualDonations.new(config, team_id: id)
+          @manual_donations ||= Kentaa::Api::Resources::List.new(config, resource_class: Kentaa::Api::Resources::ManualDonation, endpoint_path: "/teams/#{id}/manual-donations")
         end
 
         private

data/lib/kentaa/api/resources/user.rb

@@ -94,12 +94,6 @@ module Kentaa
           @consent ||= Kentaa::Api::Resources::Consent.new(data[:consent]) if data[:consent]
         end
 
-        def auth(attributes)
-          @response = request.post("/users/auth", options, attributes)
-
-          self
-        end
-
         private
 
         def load_resource

data/lib/kentaa/api/resources/users.rb

@@ -4,40 +4,13 @@ module Kentaa
   module Api
     module Resources
       class Users < List
-        include Enumerable
-
-        def each(&block)
-          users.each(&block)
-        end
-
-        def create(attributes = {})
-          user = Kentaa::Api::Resources::User.new(config, options: options)
-          user.save(attributes)
-        end
-
-        def auth(attributes = {})
-          user = Kentaa::Api::Resources::User.new(config, options: options)
-          user.auth(attributes)
+        def initialize(config, options = {})
+          super(config, options.merge(resource_class: Kentaa::Api::Resources::User, endpoint_path: "/users"))
         end
 
-        private
-
-        def load_resource
-          request.get("/users", options)
-        end
-
-        def users
-          @users ||= begin
-            users = []
-
-            if data
-              data.each do |user|
-                users << Kentaa::Api::Resources::User.new(config, data: user, options: options)
-              end
-            end
-
-            users
-          end
+        def auth(attributes, options = {})
+          resource = resource_class.new(config, options: options)
+          resource.load { request.post("#{endpoint_path}/auth", options, attributes) }
         end
       end
     end