Contents

module Acfs::Resource::Attributes

  # @api public
  #
  # UUID attribute type. Use it in your model as an attribute type:
  #
  # @example
  #   class User < Acfs::Resource
  #     attribute :id, :uuid
  #   end
  #
  class UUID < Base

    #
    REGEXP = /[0-9a-f]{8}(-[0-9a-f]{4}){3}-[0-9a-f]{12}/i

    # @api public
    #
    # Check if given object looks like a UUID, eg:
    #   `450b7a40-94ad-11e3-baa8-0800200c9a66`
    # Valid UUIDs are 16 byte numbers represented as
    #  a hexadecimal string in five sub-groups seperated
    #  by a dash. Each group has to consist of a fixed
    #  number of hexadecimal digits:
    #   | Group | Digits |
    #   | -----:|:------ |
    #   |     1 | 8      |
    #   |     2 | 4      |
    #   |     3 | 4      |
    #   |     4 | 4      |
    #   |     5 | 12     |
    #
    # @param [Object] obj Object to cast.
    # @return [String] Casted object as UUID.
    #
    def cast_type(obj)
      cast_string obj.to_s
    end

    private

    def cast_string(str)
      if nil_allowed? && str.blank?
        return nil
      elsif str =~ REGEXP
        str
      else
        raise ArgumentError.new "given String `#{str}` " \
                                "does not look like a UUID"
      end
    end
  end

  # Lower-case alias for automatic type lookup
  Uuid = UUID
end

Version data entries

3 entries across 3 versions & 1 rubygems

Version	Path
acfs-1.0.0.dev.1.b305	lib/acfs/resource/attributes/uuid.rb
acfs-1.0.0.dev.1.b298	lib/acfs/resource/attributes/uuid.rb
acfs-1.0.0.dev.1.b297	lib/acfs/resource/attributes/uuid.rb