kentaa-api 0.4.0 → 0.7.0

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

@@ -13,12 +13,16 @@ module Kentaa
 
         def parent
           if 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
@@ -130,9 +134,25 @@ module Kentaa
         end
 
         def consent
+          Kentaa::Api::Deprecation.warn('#consent is deprecated. Please use #consents instead.', caller)
+
           @consent ||= Kentaa::Api::Resources::Consent.new(data[:consent]) if data[:consent]
         end
 
+        def consents
+          @consents ||= begin
+            consents = []
+
+            if data[:consents]
+              data[:consents].each do |consent|
+                consents << Kentaa::Api::Resources::Consent.new(consent)
+              end
+            end
+
+            consents
+          end
+        end
+
         def contact
           @contact ||= Kentaa::Api::Resources::Contact.new(data[:contact]) if data[:contact]
         end
@@ -141,12 +161,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::List.new(config, resource_class: Kentaa::Api::Resources::NewsletterSubscription, endpoint_path: "/projects/#{id}/newsletter-subscriptions")
         end
 
         private

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

@@ -14,6 +14,14 @@ module Kentaa
           data[:id]
         end
 
+        def created_at
+          Time.parse(data[:created_at]) if data[:created_at]
+        end
+
+        def updated_at
+          Time.parse(data[:updated_at]) if data[:updated_at]
+        end
+
         def question
           data[:question]
         end

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

@@ -0,0 +1,110 @@
+# frozen_string_literal: true
+
+require 'bigdecimal'
+require 'time'
+
+module Kentaa
+  module Api
+    module Resources
+      class RecurringDonor < Resource
+        def object_key
+          "RecurringDonor_#{id}"
+        end
+
+        def entity
+          if 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, 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 first_name
+          data[:first_name]
+        end
+
+        def infix
+          data[:infix]
+        end
+
+        def last_name
+          data[:last_name]
+        end
+
+        def name
+          [first_name, infix, last_name].reject { |s| s.to_s.empty? }.join(' ')
+        end
+
+        def company
+          data[:company]
+        end
+
+        def anonymous?
+          data[:anonymous]
+        end
+
+        def email
+          data[:email]
+        end
+
+        def locale
+          data[:locale]
+        end
+
+        def frequency_type
+          data[:frequency_type]
+        end
+
+        def start_date
+          Date.parse(data[:start_date])
+        end
+
+        def end_date
+          Date.parse(data[:end_date]) if data[:end_date]
+        end
+
+        def active?
+          data[:active]
+        end
+
+        def currency
+          data[:currency]
+        end
+
+        def amount
+          BigDecimal(data[:amount])
+        end
+
+        def transaction_costs
+          BigDecimal(data[:transaction_costs]) if data[:transaction_costs]
+        end
+
+        def total_amount
+          BigDecimal(data[:total_amount])
+        end
+
+        def donations
+          @donations ||= Kentaa::Api::Resources::List.new(config, resource_class: Kentaa::Api::Resources::Donation, endpoint_path: "/recurring-donors/#{id}/donations")
+        end
+
+        private
+
+        def load_resource
+          request.get("/recurring-donors/#{id}", options)
+        end
+      end
+    end
+  end
+end

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

@@ -8,14 +8,14 @@ module Kentaa
       class Resource < Base
         attr_accessor :id
 
-        def initialize(config, options = {})
+        def initialize(config, id: nil, data: nil, options: {})
           super(config, options)
 
-          if options.key?(:data)
-            @data = options.delete(:data) || {}
+          if data
+            @data = data || {}
             @id = @data.fetch(:id) if @data.key?(:id)
-          elsif options.key?(:id)
-            @id = options.delete(:id)
+          elsif id
+            @id = id
           end
         end
 
@@ -40,7 +40,7 @@ module Kentaa
         def delete
           delete_resource
 
-          self
+          nil
         end
 
         def created_at

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

@@ -11,6 +11,14 @@ module Kentaa
           "Segment_#{id}"
         end
 
+        def parent
+          site
+        end
+
+        def site
+          Kentaa::Api::Resources::Site.new(config, id: site_id, options: options)
+        end
+
         def site_id
           data[:site_id]
         end
@@ -73,12 +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::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,17 +86,21 @@ 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::List.new(config, resource_class: Kentaa::Api::Resources::NewsletterSubscription, endpoint_path: '/newsletter-subscriptions')
         end
 
         private
 
         def load_resource
-          request.get("/sites/current", options)
+          request.get('/sites/current', options)
         end
       end
     end

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

@@ -2,10 +2,10 @@
 
 module Kentaa
   module Api
-    module Clients
+    module Resources
       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/resources/team.rb

@@ -13,14 +13,18 @@ module Kentaa
 
         def parent
           if 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
@@ -38,7 +42,7 @@ 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 members
@@ -47,7 +51,7 @@ module Kentaa
 
             if data[:members]
               data[:members].each do |member|
-                members << Kentaa::Api::Resources::Action.new(config, data: member)
+                members << Kentaa::Api::Resources::Action.new(config, data: member, options: options)
               end
             end
 
@@ -158,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

@@ -10,6 +10,10 @@ module Kentaa
           "User_#{id}"
         end
 
+        def site
+          Kentaa::Api::Resources::Site.new(config, id: site_id, options: options)
+        end
+
         def site_id
           data[:site_id]
         end
@@ -27,7 +31,7 @@ module Kentaa
         end
 
         def name
-          [first_name, infix, last_name].reject { |s| s.to_s.empty? }.join(" ")
+          [first_name, infix, last_name].reject { |s| s.to_s.empty? }.join(' ')
         end
 
         def email
@@ -75,7 +79,7 @@ module Kentaa
         end
 
         def birthday
-          Time.parse(data[:birthday]) if data[:birthday]
+          Date.parse(data[:birthday]) if data[:birthday]
         end
 
         def gender
@@ -87,9 +91,29 @@ module Kentaa
         end
 
         def consent
+          Kentaa::Api::Deprecation.warn('#consent is deprecated. Please use #consents instead.', caller)
+
           @consent ||= Kentaa::Api::Resources::Consent.new(data[:consent]) if data[:consent]
         end
 
+        def consents
+          @consents ||= begin
+            consents = []
+
+            if data[:consents]
+              data[:consents].each do |consent|
+                consents << Kentaa::Api::Resources::Consent.new(consent)
+              end
+            end
+
+            consents
+          end
+        end
+
+        def actions
+          @actions ||= Kentaa::Api::Resources::List.new(config, resource_class: Kentaa::Api::Resources::Action, endpoint_path: "/users/#{id}/actions")
+        end
+
         private
 
         def load_resource
@@ -97,7 +121,7 @@ module Kentaa
         end
 
         def create_resource(attributes)
-          request.post("/users", options, attributes)
+          request.post('/users', options, attributes)
         end
 
         def update_resource(attributes)

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

@@ -4,35 +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)
-          user.save(attributes)
-        end
-
-        private
-
-        def load_resource
-          request.get("/users", options)
+        def initialize(config, options = {})
+          super(config, options.merge(resource_class: Kentaa::Api::Resources::User, endpoint_path: '/users'))
         end
 
-        def users
-          @users ||= begin
-            users = []
-
-            if data
-              data.each do |user|
-                users << Kentaa::Api::Resources::User.new(config, data: user)
-              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

data/lib/kentaa/api/util.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Kentaa
+  module Api
+    module Util
+      module_function
+
+      def pluralize(string)
+        if string[-1] == 'y'
+          "#{string.chop}ies"
+        else
+          "#{string}s"
+        end
+      end
+    end
+  end
+end

data/lib/kentaa/api/version.rb

@@ -2,6 +2,6 @@
 
 module Kentaa
   module Api
-    VERSION = "0.4.0"
+    VERSION = '0.7.0'
   end
 end

data/lib/kentaa/api.rb

@@ -1,55 +1,46 @@
 # frozen_string_literal: true
 
-require_relative "api/clients/base"
-require_relative "api/clients/actions"
-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/segments"
-require_relative "api/clients/sites"
-require_relative "api/clients/teams"
-require_relative "api/clients/users"
+require_relative 'api/resources/base'
+require_relative 'api/resources/error'
+require_relative 'api/resources/list'
+require_relative 'api/resources/resource'
 
-require_relative "api/resources/base"
-require_relative "api/resources/error"
-require_relative "api/resources/list"
-require_relative "api/resources/resource"
+require_relative 'api/resources/action'
+require_relative 'api/resources/activity'
+require_relative 'api/resources/address'
+require_relative 'api/resources/banner'
+require_relative 'api/resources/billing'
+require_relative 'api/resources/company'
+require_relative 'api/resources/company_package'
+require_relative 'api/resources/consent'
+require_relative 'api/resources/contact'
+require_relative 'api/resources/donation_form'
+require_relative 'api/resources/donation'
+require_relative 'api/resources/location'
+require_relative 'api/resources/manual_donation'
+require_relative 'api/resources/newsletter_subscription'
+require_relative 'api/resources/performance'
+require_relative 'api/resources/performance_photo'
+require_relative 'api/resources/photo'
+require_relative 'api/resources/project'
+require_relative 'api/resources/recurring_donor'
+require_relative 'api/resources/registration_fee'
+require_relative 'api/resources/reward'
+require_relative 'api/resources/question'
+require_relative 'api/resources/segment'
+require_relative 'api/resources/site'
+require_relative 'api/resources/sites'
+require_relative 'api/resources/team'
+require_relative 'api/resources/user'
+require_relative 'api/resources/users'
+require_relative 'api/resources/video'
 
-require_relative "api/resources/action"
-require_relative "api/resources/actions"
-require_relative "api/resources/activity"
-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"
-require_relative "api/resources/donations"
-require_relative "api/resources/location"
-require_relative "api/resources/manual_donation"
-require_relative "api/resources/manual_donations"
-require_relative "api/resources/newsletter_subscription"
-require_relative "api/resources/newsletter_subscriptions"
-require_relative "api/resources/photo"
-require_relative "api/resources/project"
-require_relative "api/resources/projects"
-require_relative "api/resources/question"
-require_relative "api/resources/registration_fee"
-require_relative "api/resources/reward"
-require_relative "api/resources/segment"
-require_relative "api/resources/segments"
-require_relative "api/resources/site"
-require_relative "api/resources/team"
-require_relative "api/resources/teams"
-require_relative "api/resources/user"
-require_relative "api/resources/users"
-require_relative "api/resources/video"
+require_relative 'api/client'
+require_relative 'api/config'
+require_relative 'api/deprecation'
+require_relative 'api/exception'
+require_relative 'api/request'
+require_relative 'api/response'
+require_relative 'api/util'
 
-require_relative "api/client"
-require_relative "api/config"
-require_relative "api/exception"
-require_relative "api/finder"
-require_relative "api/request"
-require_relative "api/response"
-
-require_relative "api/version"
+require_relative 'api/version'