Contents

require 'unicode_utils'

module Carmen
  module Querying
    # Find a region by code.
    #
    # code - The String code to search for
    #
    # Returns a region with the supplied code, or nil if none is found.
    def coded(code)
      return nil if code.nil?
      attribute = attribute_to_search_for_code(code)
      if attribute.nil?
        fail "could not find an attribute to search for code '#{code}'"
      end
      code = code.downcase # Codes are all ASCII
      query_collection.find do |region|
        region.send(attribute).downcase == code
      end
    end

    # Find a region by name.
    #
    # name - The String name to search for.
    # options - The Hash options used to modify the search (default:{}):
    #           :fuzzy - Whether to use fuzzy matching when finding a
    #                    matching name (optional, default: false)
    #           :case  - Whether or not the match is case-sensitive
    #                    (optional, default: false)
    #
    # Returns a region with the supplied name, or nil if none if found.
    def named(name, options={})
      case_fold = !options[:case] && name.respond_to?(:each_codepoint)
      # These only need to be built once
      name = case_fold ? UnicodeUtils.casefold(name) : name
      # For now, "fuzzy" just means substring, optionally case-insensitive (the second argument looks for nil, not falseness)
      regexp = options[:fuzzy] ? Regexp.new(name, options[:case] ? nil : true) : nil

      query_collection.find do |region|
        found_literal = name === (case_fold && region.name ? UnicodeUtils.casefold(region.name) : region.name)
        found_literal || options[:fuzzy] && regexp === region.name
      end
    end

  end
end

Version data entries

1 entries across 1 versions & 1 rubygems

Version	Path
carmen-1.0.1	lib/carmen/querying.rb