Contents

# frozen_string_literal: true

require 'json'

module Excon
  module HyperMedia
    # Collection
    #
    # Given a `Hash`, provides dot-notation properties and other helper methods.
    #
    module Collection
      include Enumerable

      def initialize(collection = {})
        @collection ||= collection.to_h
        to_properties
      end

      def each(&block)
        collection.each(&block)
      end

      def keys
        @collection.keys
      end

      def key?(key)
        collection.key?(key.to_s)
      end

      def [](key)
        to_property(key)
      end

      private

      # method_missing
      #
      # Collections can be accessed using both the "dot notation" and the hash
      # notation:
      #
      #   collection.hello_world
      #   collection['hello_world']
      #
      # The second notation returns `nil` on missing keys, the first should do
      # as well.
      #
      def method_missing(_)
        nil
      end

      def to_properties
        collection.each do |key, value|
          key = key.downcase
          next unless /[@$"]/ !~ key.to_sym.inspect

          singleton_class.class_eval { attr_reader key }
          instance_variable_set("@#{key}", property(value))
        end
      end

      def property(value)
        value.respond_to?(:keys) ? self.class.new(value) : value
      end

      def to_property(key)
        key?(key) ? property(collection[key]) : nil
      end

      def to_property!(key)
        key?(key) ? to_property(key) : method_missing(key)
      end

      attr_reader :collection
    end
  end
end

Version data entries

4 entries across 4 versions & 1 rubygems

Version	Path
excon-hypermedia-0.5.3	lib/excon/hypermedia/helpers/collection.rb
excon-hypermedia-0.5.2	lib/excon/hypermedia/helpers/collection.rb
excon-hypermedia-0.5.1	lib/excon/hypermedia/helpers/collection.rb
excon-hypermedia-0.5.0	lib/excon/hypermedia/helpers/collection.rb