Contents

# frozen_string_literal: true

#
# Whenever a collection from a has_many relationship is accessed, an instance
# of this class is returned.  This instance wraps the Array of instances in
# the collection with an extra build method, which allows new instances to be
# built on the collection with the correct properties.
#
# In practice, instances of this class behave exactly like an Array.
#
module Tempo
  class HasManyProxy
    attr_reader :target_class, :parent
    attr_accessor :collection

    def initialize(parent, target_class, collection = [])
      @parent       = parent
      @target_class = target_class
      @collection   = collection
    end

    # Builds an instance of this class with the correct parent.
    # For example, issue.comments.build(attrs) will initialize a
    # comment as follows:
    #
    #   Tempo::resource::Member.new(team.client,
    #                               :attrs => attrs,
    #                               :team => team)
    def build(attrs = {})
      resource = target_class.new(parent.client, :attrs => attrs, parent.to_sym => parent)
      collection << resource
      resource
    end

    # Forces an HTTP request to fetch all instances of the target class that
    # are associated with the parent
    def all
      target_class.all(parent.client, parent.to_sym => parent)
    end

    # Delegate any missing methods to the collection that this proxy wraps
    def method_missing(method_name, *args, &block)
      collection.send(method_name, *args, &block)
    end
  end
end

Version data entries

1 entries across 1 versions & 1 rubygems

Version	Path
tempo-ruby-0.1.0	lib/tempo/has_many_proxy.rb