Contents

require 'uber/inheritable_attr'

module DMV
  AttributeAlreadyDefined = Class.new(StandardError)

  class Form
    extend Uber::InheritableAttr

    inheritable_attr :_attributes
    self._attributes = Hash.new

    inheritable_attr :middleware
    self.middleware = DMV::Middleware.new

    attr_reader :attributes

    # Adds an attribute to the forms attributes set and creates accessors
    #
    # @param name The name of the attribute
    # @param options [Hash] The options for this attribute (type for example)
    def self.attribute *names
      options = names.last.kind_of?(Hash) ? names.pop : {}

      names.each do |name|
        name = name.to_sym

        if _attributes.keys.include?(name)
          raise AttributeAlreadyDefined, "the attribute #{name} has already been defined"
        end

        _attributes[name] = options.freeze
        class_eval <<-ATTR, __FILE__, __LINE__ + 1
          def #{name}
            get(:#{name})
          end

          def #{name}=(value)
            set(:#{name}, value)
          end
        ATTR
      end
    end

    # Returns a cloned frozen hash containing the details of the
    # attributes on this form
    #
    # @return Hash (frozen)
    def self.attributes
      _attributes.clone.freeze
    end

    # Initialize a new form instance from values
    #
    # @param attributes A hash of attributes to be set
    def initialize attributes = {}
      @attributes = {}
      attributes.each { |attribute, value| set attribute, value }
    end

    # Sets an attribute value and performs any coercions needed
    #
    # @param attribute The name of an attribute
    # @param value The value you would like to set the attribute to
    def set attribute, value
      attributes[attribute] = value
    end

    # Retrieve the value for an attribute
    #
    # @param attribute [Symbol] Name of an attribute
    # @return attribute value
    def get attribute
      attributes[attribute]
    end
  end
end

Version data entries

1 entries across 1 versions & 1 rubygems

Version	Path
dmv-0.1.0	lib/dmv/form.rb