church-community-builder 0.1.0

data/lib/api/batch.rb

@@ -0,0 +1,48 @@
+module ChurchCommunityBuilder
+
+  include Enumerable
+
+  class Batch < ApiObject
+
+    ccb_attr_accessor :id,
+                      :campus,
+                      :post_date,
+                      :begin_date,
+                      :end_date,
+                      :in_accounting_package,
+                      :status,
+                      :source,
+                      :transactions,
+                      :creator,
+                      :modifier,
+                      :created,
+                      :modified
+                  
+
+    def self.load_by_id(batch_id)
+      reader = BatchReader.new(batch_id)
+      self.new(reader.load_feed)
+    rescue
+      nil
+    end
+
+
+    def initialize(json_data = nil, options = {})
+      initialize_from_json_object(json_data) unless json_data.nil?
+
+      if json_data["ccb_api"].nil?
+        batch_json = json_data
+      else
+        batch_json = json_data["ccb_api"]["response"]["batches"]["batch"]
+      end
+      
+        initialize_from_json_object(batch_json) unless batch_json.nil?
+    end
+
+
+    def has_transactions?
+      !self.transactions.nil?
+    end
+  end
+
+end

data/lib/api/batch_list.rb

@@ -0,0 +1,50 @@
+module ChurchCommunityBuilder
+
+  class BatchList
+
+    include Enumerable
+
+    attr_reader :request_data,
+                :response_data,
+                :service,
+                :batches,
+                :count,
+                :batch_array,
+                :json_data #for debugging
+
+
+    def initialize(json)
+      @json_data = json["ccb_api"]
+      @request_data = @json_data["request"]
+      @response_data = @json_data["response"]
+      @service = @response_data["service"] #CCB service type accessed
+
+      @batches  = @response_data['batches']
+
+      @count = @batches["count"].to_i #number of records
+      @batch_array = @batches["batch"].class == Array ? @batches["batch"] : [@batches["batch"]].compact #array of each batch
+    end
+
+    def all_names
+      return [] unless @batch_array
+      @batch_array.collect { |batch| [batch['first_name'], batch['last_name']].join(' ') }
+    end
+
+    def [](index)
+      Batch.new( @batch_array[index] ) if @batch_array and @batch_array[index]
+    end
+
+
+    # This method is needed for Enumerable.
+    def each &block
+      @batch_array.each{ |batch| yield( Batch.new(batch) )}
+    end
+
+
+    def empty?
+      self.count == 0 ? true : false
+    end
+
+  end
+
+end

data/lib/api/campus.rb

@@ -0,0 +1,29 @@
+module ChurchCommunityBuilder
+
+  include Enumerable
+
+  class Campus < ApiObject
+
+    ccb_attr_accessor :id,
+                      :name,
+                      :active,
+                      :creator,
+                      :modifier,
+                      :created,
+                      :modified
+
+    def initialize(json_data = nil, options = {})
+
+      # When we initialize from CampusReader, the "Campus" is buried
+      if json_data["ccb_api"].nil?
+        campus_json = json_data
+      else
+        campus_json = json_data["ccb_api"]["response"]["campuses"]["campus"]
+      end
+      
+      initialize_from_json_object(campus_json) unless campus_json.nil?
+
+    end
+  end
+
+end

data/lib/api/campus_list.rb

@@ -0,0 +1,65 @@
+module ChurchCommunityBuilder
+
+  class CampusList
+
+    include Enumerable
+
+    attr_reader :request_data,
+                :response_data,
+                :service,
+                :individuals,
+                :count,
+                :campus_array,
+                :json_data #for debugging
+                
+
+    def initialize(json)
+      @json_data = json["ccb_api"]
+      @request_data = @json_data["request"]
+      @response_data = @json_data["response"]
+      @service = @response_data["service"] #CCB service type accessed
+
+      @campuses  = @response_data['campuses']
+
+      @count = @campuses["count"].to_i #number of records
+
+      # if @campuses['campus'] is a single item, it will be returned
+      # as a Hash, rather than a single element Array, containing the Hash.
+      #
+      if @campuses["campus"].is_a?(Array)
+        @campus_array = @campuses["campus"]
+      
+      elsif @campuses["campus"].is_a?(Hash)
+        @campus_array = []
+        @campus_array << @campuses["campus"] #array of each campus
+      end
+
+    end
+
+    def all_names
+      return [] unless @campus_array
+      @campus_array.collect { |campus| campus['name'] }
+    end
+
+    def ids
+      (@campus_array.collect { |campus| campus['id'] }).uniq
+    end
+
+    def [](index)
+      Campus.new( @campus_array[index] ) if @campus_array and @campus_array[index]
+    end
+
+
+    # This method is needed for Enumerable.
+    def each &block
+      @campus_array.each{ |campus| yield( Campus.new(campus) )}
+    end
+
+
+    def empty?
+      @campus_array.size == 0 ? true : false
+    end
+
+  end
+
+end

data/lib/api/individual.rb

@@ -0,0 +1,138 @@
+module ChurchCommunityBuilder
+
+  include Enumerable
+
+  class Individual < ApiObject
+
+    ccb_attr_accessor :id,
+                      :sync_id,
+                      :other_id,
+                      :giving_number,
+                      :campus,
+                      :family,
+                      :family_image,
+                      :family_position,
+                      :family_members,
+                      :first_name,
+                      :last_name,
+                      :middle_name,
+                      :legal_first_name,
+                      :full_name,
+                      :salutation,
+                      :suffix,
+                      :image,
+                      :email,
+                      :addresses,
+                      :phones,
+                      :mobile_carrier,
+                      :gender,
+                      :marital_status,
+                      :birthday,
+                      :anniversary,
+                      :deceased,
+                      :membership_type,
+                      :membership_date,
+                      :membership_end,
+                      :receive_email_from_church,
+                      :default_new_group_messages,
+                      :default_new_group_comments,
+                      :default_new_group_digest,
+                      :default_new_group_sms,
+                      :privacy_settings,
+                      :active,
+                      :creator,
+                      :modifier,
+                      :created,
+                      :modified,
+                      :home_address,
+                      :mailing_address,
+                      :work_address,
+                      :other_address,
+                      :contact_phone,
+                      :home_phone,
+                      :work_phone,
+                      :mobile_phone
+
+
+    def initialize(json_data = nil)
+      #@writer_object = PersonWriter
+      
+      # When we initialize from IndividualReader, the "Individual" is buried
+      if json_data["ccb_api"].nil?
+        individual_json = json_data
+      else
+        individual_json = json_data["ccb_api"]["response"]["individuals"]["individual"]
+      end
+      
+      initialize_from_json_object(individual_json) unless individual_json.nil?
+
+      _set_addresses
+      _set_phones
+
+    end
+
+    def self.load_by_id(individual_id)
+      reader = IndividualReader.new(individual_id)
+      self.new(reader.load_feed)
+    rescue
+      nil
+    end
+
+    def family_id
+      self.family['id']
+    end
+
+    def family_name
+      self.family['content']
+    end
+
+    def campus_id
+      self.campus["id"]
+    end
+
+    def campus_name
+      self.campus["content"]
+    end
+
+    private
+
+    def _set_addresses
+
+      self.addresses["address"].each do |address|
+        case address["type"]
+        when 'mailing'
+          @mailing_address = Address.new(address)
+        when 'home'
+          @home_address = Address.new(address)
+        when 'work'
+          @work_address = Address.new(address)
+        when 'other'
+          @other_address = Address.new(address)
+        end
+
+      end
+
+    end
+
+    def _set_phones
+
+      self.phones["phone"].each do |phone|
+        case phone["type"]
+        when 'contact'
+          @contact_phone = phone["content"]
+        when 'home'
+          @home_phone = phone["content"]
+        when 'work'
+          @work_phone = phone["content"]
+        when 'mobile'
+          @mobile_phone = phone["content"]
+        end
+
+      end
+
+    end
+
+  end
+
+end
+

data/lib/api/individual_list.rb

@@ -0,0 +1,65 @@
+module ChurchCommunityBuilder
+
+  class IndividualList
+
+    include Enumerable
+
+    attr_reader :request_data,
+                :response_data,
+                :service,
+                :individuals,
+                :count,
+                :individual_array,
+                :json_data #for debugging
+
+
+    def initialize(json)
+      @json_data = json["ccb_api"]
+      @request_data = @json_data["request"]
+      @response_data = @json_data["response"]
+      @service = @response_data["service"] #CCB service type accessed
+
+      @individuals  = @response_data['individuals']
+
+      @count = @individuals["count"].to_i #number of records
+
+      # if @individuals['individual'] is a single item, it will be returned
+      # as a Hash, rather than a single element Array, containing the Hash.
+      #
+      if @individuals["individual"].is_a?(Array)
+        @individual_array = @individuals["individual"]
+      
+      elsif @individuals["individual"].is_a?(Hash)
+        @individual_array = []
+        @individual_array << @individuals["individual"] #array of each individual
+      end
+
+    end
+
+    def all_names
+      return [] unless @individual_array
+      @individual_array.collect { |individual| [individual['first_name'], individual['last_name']].join(' ') }
+    end
+
+    def ids
+      (@individual_array.collect { |individual| individual['id'] }).uniq
+    end
+
+    def [](index)
+      Individual.new( @individual_array[index] ) if @individual_array and @individual_array[index]
+    end
+
+
+    # This method is needed for Enumerable.
+    def each &block
+      @individual_array.each{ |individual| yield( Individual.new(individual) )}
+    end
+
+
+    def empty?
+      self.count == 0 ? true : false
+    end
+
+  end
+
+end

data/lib/api/mergeable_individual_list.rb

@@ -0,0 +1,92 @@
+module ChurchCommunityBuilder
+
+  class MergeableIndividualList
+
+    include Enumerable
+
+    # Constructor.
+    # Can initialize from another IndividualList, else will default to an emtpy list
+    # which can then have other lists 'add'ed.
+    #
+    def initialize(individual_list = nil)
+      
+      if individual_list.nil?
+        @individual_array = []
+
+      else
+        @individual_array = individual_list.individual_array
+
+      end
+
+    end
+
+    # All the individuals in the list.
+    #
+    # @return array of names (first last).
+    def all_names
+      return [] unless @individual_array
+      @individual_array.collect { |individual| [individual['first_name'], individual['last_name']].join(' ') }
+    end
+
+    alias_method :names, :all_names
+
+
+    # Get the specified individual.
+    #
+    # @param index The index of the individual to get.
+    #
+    # @return [individual]
+    def [](index)
+      Individual.new( @individual_array[index] ) if @individual_array and @individual_array[index]
+    end
+
+
+    # This method is needed for Enumerable.
+    def each &block
+      @individual_array.each{ |individual| yield( Individual.new(individual) )}
+    end
+  
+
+    # Get all the Individual ids in the list.
+    #
+    # @return An array of Individual ids.
+    def ids
+      (@individual_array.collect { |individual| individual['id'] }).uniq
+    end
+
+    # Adds an IndividualList, MergeableIndividualList, or Individual to this list.
+    #
+    def add(individual_type)
+      
+      if individual_type.is_a?(IndividualList)
+        @individual_array += individual_type.individual_array
+
+      elsif individual_type.is_a?(MergeableIndividualList)
+        @individual_array += individual_type.individual_array
+      
+      elsif individual_type.is_a?(Individual)
+        @individual_array << JSON.parse( individual_type.to_json )
+
+      end
+
+    end   
+
+    alias_method :merge, :add
+
+    def count
+      @individual_array.size
+    end
+
+    # Checks if the list is empty.
+    #
+    # @return true on empty, false otherwise.
+    def empty?
+      self.count == 0 ? true : false
+    end
+
+    # Alias the count method
+    alias :size :count
+
+  end
+    
+end