kentaa-api 0.4.0 → 0.5.0

data/kentaa-api.gemspec

@@ -21,10 +21,10 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
 
-  spec.required_ruby_version = ">= 2.3.0"
+  spec.required_ruby_version = ">= 2.4.0"
 
-  spec.add_development_dependency "bundler", "~> 1.14"
-  spec.add_development_dependency "rake", "~> 12.3"
+  spec.add_development_dependency "bundler", "~> 2.0"
+  spec.add_development_dependency "rake", "~> 13.0"
   spec.add_development_dependency "rspec", "~> 3.0"
   spec.add_development_dependency "webmock", "~> 2.3", ">= 2.3.2"
 end

data/lib/kentaa/api.rb

@@ -2,10 +2,12 @@
 
 require_relative "api/clients/base"
 require_relative "api/clients/actions"
+require_relative "api/clients/donation_forms"
 require_relative "api/clients/donations"
 require_relative "api/clients/manual_donations"
 require_relative "api/clients/newsletter_subscriptions"
 require_relative "api/clients/projects"
+require_relative "api/clients/recurring_donors"
 require_relative "api/clients/segments"
 require_relative "api/clients/sites"
 require_relative "api/clients/teams"
@@ -23,6 +25,8 @@ require_relative "api/resources/address"
 require_relative "api/resources/banner"
 require_relative "api/resources/consent"
 require_relative "api/resources/contact"
+require_relative "api/resources/donation_form"
+require_relative "api/resources/donation_forms"
 require_relative "api/resources/donation"
 require_relative "api/resources/donations"
 require_relative "api/resources/location"
@@ -34,6 +38,8 @@ require_relative "api/resources/photo"
 require_relative "api/resources/project"
 require_relative "api/resources/projects"
 require_relative "api/resources/question"
+require_relative "api/resources/recurring_donor"
+require_relative "api/resources/recurring_donors"
 require_relative "api/resources/registration_fee"
 require_relative "api/resources/reward"
 require_relative "api/resources/segment"

data/lib/kentaa/api/client.rb

@@ -11,6 +11,10 @@ module Kentaa
         Kentaa::Api::Clients::Actions.new(@config)
       end
 
+      def donation_forms
+        Kentaa::Api::Clients::DonationForms.new(@config)
+      end
+
       def donations
         Kentaa::Api::Clients::Donations.new(@config)
       end
@@ -27,6 +31,10 @@ module Kentaa
         Kentaa::Api::Clients::Projects.new(@config)
       end
 
+      def recurring_donors
+        Kentaa::Api::Clients::RecurringDonors.new(@config)
+      end
+
       def segments
         Kentaa::Api::Clients::Segments.new(@config)
       end

data/lib/kentaa/api/clients/actions.rb

@@ -15,7 +15,7 @@ module Kentaa
         end
 
         def get(id, options = {})
-          action = Kentaa::Api::Resources::Action.new(config, options.merge(id: id))
+          action = Kentaa::Api::Resources::Action.new(config, id: id, options: options)
           action.load
         end
 
@@ -25,7 +25,7 @@ module Kentaa
         end
 
         def update(id, attributes = {}, options = {})
-          action = Kentaa::Api::Resources::Action.new(config, options.merge(id: id))
+          action = Kentaa::Api::Resources::Action.new(config, id: id, options: options)
           action.save(attributes)
         end
       end

data/lib/kentaa/api/clients/donation_forms.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Kentaa
+  module Api
+    module Clients
+      class DonationForms < Base
+        def all(options = {})
+          donation_forms = Kentaa::Api::Resources::DonationForms.new(config, options)
+          donation_forms.all
+        end
+
+        def list(options = {})
+          donation_forms = Kentaa::Api::Resources::DonationForms.new(config, options)
+          donation_forms.load
+        end
+
+        def get(id, options = {})
+          donation_form = Kentaa::Api::Resources::DonationForm.new(config, id: id, options: options)
+          donation_form.load
+        end
+      end
+    end
+  end
+end

data/lib/kentaa/api/clients/donations.rb

@@ -15,7 +15,7 @@ module Kentaa
         end
 
         def get(id, options = {})
-          donation = Kentaa::Api::Resources::Donation.new(config, options.merge(id: id))
+          donation = Kentaa::Api::Resources::Donation.new(config, id: id, options: options)
           donation.load
         end
       end

data/lib/kentaa/api/clients/manual_donations.rb

@@ -15,22 +15,22 @@ module Kentaa
         end
 
         def get(id, options = {})
-          donation = Kentaa::Api::Resources::ManualDonation.new(config, options.merge(id: id))
+          donation = Kentaa::Api::Resources::ManualDonation.new(config, id: id, options: options)
           donation.load
         end
 
         def create(attributes = {}, options = {})
-          donation = Kentaa::Api::Resources::ManualDonation.new(config, options)
-          donation.save(attributes)
+          donation = Kentaa::Api::Resources::ManualDonations.new(config, options)
+          donation.create(attributes)
         end
 
         def update(id, attributes = {}, options = {})
-          donation = Kentaa::Api::Resources::ManualDonation.new(config, options.merge(id: id))
+          donation = Kentaa::Api::Resources::ManualDonation.new(config, id: id, options: options)
           donation.save(attributes)
         end
 
         def delete(id, options = {})
-          donation = Kentaa::Api::Resources::ManualDonation.new(config, options.merge(id: id))
+          donation = Kentaa::Api::Resources::ManualDonation.new(config, id: id, options: options)
           donation.delete
         end
       end

data/lib/kentaa/api/clients/newsletter_subscriptions.rb

@@ -15,7 +15,7 @@ module Kentaa
         end
 
         def get(id, options = {})
-          newsletter_subscription = Kentaa::Api::Resources::NewsletterSubscription.new(config, options.merge(id: id))
+          newsletter_subscription = Kentaa::Api::Resources::NewsletterSubscription.new(config, id: id, options: options)
           newsletter_subscription.load
         end
       end

data/lib/kentaa/api/clients/projects.rb

@@ -15,7 +15,7 @@ module Kentaa
         end
 
         def get(id, options = {})
-          project = Kentaa::Api::Resources::Project.new(config, options.merge(id: id))
+          project = Kentaa::Api::Resources::Project.new(config, id: id, options: options)
           project.load
         end
       end

data/lib/kentaa/api/clients/recurring_donors.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Kentaa
+  module Api
+    module Clients
+      class RecurringDonors < Base
+        def all(options = {})
+          recurring_donors = Kentaa::Api::Resources::RecurringDonors.new(config, options)
+          recurring_donors.all
+        end
+
+        def list(options = {})
+          recurring_donors = Kentaa::Api::Resources::RecurringDonors.new(config, options)
+          recurring_donors.load
+        end
+
+        def get(id, options = {})
+          recurring_donor = Kentaa::Api::Resources::RecurringDonor.new(config, id: id, options: options)
+          recurring_donor.load
+        end
+      end
+    end
+  end
+end

data/lib/kentaa/api/clients/segments.rb

@@ -15,7 +15,7 @@ module Kentaa
         end
 
         def get(id, options = {})
-          segment = Kentaa::Api::Resources::Segment.new(config, options.merge(id: id))
+          segment = Kentaa::Api::Resources::Segment.new(config, id: id, options: options)
           segment.load
         end
       end

data/lib/kentaa/api/clients/sites.rb

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

data/lib/kentaa/api/clients/teams.rb

@@ -15,7 +15,7 @@ module Kentaa
         end
 
         def get(id, options = {})
-          team = Kentaa::Api::Resources::Team.new(config, options.merge(id: id))
+          team = Kentaa::Api::Resources::Team.new(config, id: id, options: options)
           team.load
         end
       end

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

@@ -15,7 +15,7 @@ module Kentaa
         end
 
         def get(id, options = {})
-          user = Kentaa::Api::Resources::User.new(config, options.merge(id: id))
+          user = Kentaa::Api::Resources::User.new(config, id: id, options: options)
           user.load
         end
 
@@ -25,9 +25,14 @@ module Kentaa
         end
 
         def update(id, attributes = {}, options = {})
-          user = Kentaa::Api::Resources::User.new(config, options.merge(id: id))
+          user = Kentaa::Api::Resources::User.new(config, id: id, options: options)
           user.save(attributes)
         end
+
+        def auth(attributes = {}, options = {})
+          user = Kentaa::Api::Resources::Users.new(config, options)
+          user.auth(attributes)
+        end
       end
     end
   end

data/lib/kentaa/api/config.rb

@@ -34,6 +34,10 @@ module Kentaa
           :live
         end
       end
+
+      def debug?
+        options.fetch(:debug, false)
+      end
     end
   end
 end

data/lib/kentaa/api/exception.rb

@@ -10,8 +10,7 @@ module Kentaa
 
       def initialize(response)
         @response = response
-
-        super(response.message)
+        super()
       end
 
       def errors
@@ -21,6 +20,10 @@ module Kentaa
       def http_code
         response.http_code
       end
+
+      def to_s
+        "#{response.http_code}: #{response.message}"
+      end
     end
   end
 end

data/lib/kentaa/api/request.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require 'logger'
 require 'net/http'
 require 'uri'
 
@@ -34,6 +35,8 @@ 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)
@@ -67,12 +70,18 @@ module Kentaa
           raise Kentaa::Api::Exception, e.message
         end
 
+        logger.debug("[Kentaa-API] Response: #{response.http_code}, body: #{response.body}") if config.debug?
+
         if response.error?
           raise Kentaa::Api::RequestError, response
         end
 
         response
       end
+
+      def logger
+        @logger ||= Logger.new($stdout)
+      end
     end
   end
 end

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

@@ -13,16 +13,20 @@ module Kentaa
 
         def parent
           if team_id
-            Kentaa::Api::Resources::Team.new(config, id: team_id)
+            Kentaa::Api::Resources::Team.new(config, id: team_id, options: options)
           elsif project_id
-            Kentaa::Api::Resources::Project.new(config, id: project_id)
+            Kentaa::Api::Resources::Project.new(config, id: project_id, options: options)
           elsif segment_id
-            Kentaa::Api::Resources::Segment.new(config, id: segment_id)
+            Kentaa::Api::Resources::Segment.new(config, id: segment_id, options: options)
           else
-            Kentaa::Api::Resources::Site.new(config, id: site_id)
+            Kentaa::Api::Resources::Site.new(config, id: site_id, options: options)
           end
         end
 
+        def site
+          Kentaa::Api::Resources::Site.new(config, id: site_id, options: options)
+        end
+
         def slug
           data[:slug]
         end
@@ -44,11 +48,11 @@ module Kentaa
         end
 
         def owner
-          @owner ||= Kentaa::Api::Resources::User.new(config, data: data[:owner])
+          @owner ||= Kentaa::Api::Resources::User.new(config, data: data[:owner], options: options)
         end
 
         def team_captain?
-          data[:team_captain]
+          data.fetch(:team_captain, false)
         end
 
         def first_name

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

@@ -11,7 +11,7 @@ module Kentaa
         end
 
         def create(attributes = {})
-          action = Kentaa::Api::Resources::Action.new(config, options)
+          action = Kentaa::Api::Resources::Action.new(config, options: options)
           action.save(attributes)
         end
 
@@ -27,7 +27,7 @@ module Kentaa
 
             if data
               data.each do |action|
-                actions << Kentaa::Api::Resources::Action.new(config, data: action)
+                actions << Kentaa::Api::Resources::Action.new(config, data: action, options: options)
               end
             end
 

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

@@ -71,7 +71,7 @@ module Kentaa
         end
 
         def birthday
-          Time.parse(data[:birthday]) if data[:birthday]
+          Date.parse(data[:birthday]) if data[:birthday]
         end
 
         def gender

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

@@ -13,22 +13,32 @@ module Kentaa
 
         def entity
           if action_id
-            Kentaa::Api::Resources::Action.new(config, id: action_id)
+            Kentaa::Api::Resources::Action.new(config, id: action_id, options: options)
           elsif team_id
-            Kentaa::Api::Resources::Team.new(config, id: team_id)
+            Kentaa::Api::Resources::Team.new(config, id: team_id, options: options)
           elsif project_id
-            Kentaa::Api::Resources::Project.new(config, id: project_id)
+            Kentaa::Api::Resources::Project.new(config, id: project_id, options: options)
           elsif segment_id
-            Kentaa::Api::Resources::Segment.new(config, id: segment_id)
+            Kentaa::Api::Resources::Segment.new(config, id: segment_id, options: options)
+          elsif donation_form_id
+            Kentaa::Api::Resources::DonationForm.new(config, id: donation_form_id, options: options)
           else
-            Kentaa::Api::Resources::Site.new(config, id: site_id)
+            Kentaa::Api::Resources::Site.new(config, id: site_id, options: options)
           end
         end
 
+        def site
+          Kentaa::Api::Resources::Site.new(config, id: site_id, options: options)
+        end
+
         def site_id
           data[:site_id]
         end
 
+        def donation_form_id
+          data[:donation_form_id]
+        end
+
         def segment_id
           data[:segment_id]
         end
@@ -192,7 +202,7 @@ module Kentaa
         end
 
         def birthday
-          Time.parse(data[:birthday]) if data[:birthday]
+          Date.parse(data[:birthday]) if data[:birthday]
         end
 
         def gender

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

@@ -0,0 +1,100 @@
+# frozen_string_literal: true
+
+require 'bigdecimal'
+require 'time'
+
+module Kentaa
+  module Api
+    module Resources
+      class DonationForm < Resource
+        def object_key
+          "DonationForm_#{id}"
+        end
+
+        def parent
+          site
+        end
+
+        def site
+          Kentaa::Api::Resources::Site.new(config, id: site_id, options: options)
+        end
+
+        def slug
+          data[:slug]
+        end
+
+        def site_id
+          data[:site_id]
+        end
+
+        def owner
+          @owner ||= Kentaa::Api::Resources::User.new(config, data: data[:owner], options: options)
+        end
+
+        def title
+          data[:title]
+        end
+
+        def description
+          data[:description]
+        end
+
+        def total_amount
+          BigDecimal(data[:total_amount])
+        end
+
+        def total_donations
+          data[:total_donations]
+        end
+
+        def published?
+          data[:published]
+        end
+
+        def visible?
+          data[:visible]
+        end
+
+        def external_reference
+          data[:external_reference]
+        end
+
+        def url
+          data[:url]
+        end
+
+        def banners
+          @banners ||= begin
+            banners = []
+
+            if data[:banners]
+              data[:banners].each do |banner|
+                banners << Kentaa::Api::Resources::Banner.new(banner)
+              end
+            end
+
+            banners
+          end
+        end
+
+        def donations
+          @donations ||= Kentaa::Api::Resources::Donations.new(config, donation_form_id: id)
+        end
+
+        def manual_donations
+          @manual_donations ||= Kentaa::Api::Resources::ManualDonations.new(config, donation_form_id: id)
+        end
+
+        def newsletter_subscriptions
+          @newsletter_subscriptions ||= Kentaa::Api::Resources::NewsletterSubscriptions.new(config, donation_form_id: id)
+        end
+
+        private
+
+        def load_resource
+          request.get("/donation-forms/#{id}", options)
+        end
+      end
+    end
+  end
+end