Class: Worldwide::Regions

Inherits:
Object
  • Object
show all
Extended by:
Forwardable
Includes:
Singleton
Defined in:
lib/worldwide/regions.rb

Instance Method Summary collapse

Constructor Details

#initialize ⇒ Regions

Returns a new instance of Regions.



18
19
20
 
# File 'lib/worldwide/regions.rb', line 18

def initialize
  @regions = RegionsLoader.new.load_regions
end

Instance Method Details

#all ⇒ Object 



22
23
24
 
# File 'lib/worldwide/regions.rb', line 22

def all
  @regions
end

#region(cldr: nil, code: nil, name: nil) ⇒ Object 



26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
 
# File 'lib/worldwide/regions.rb', line 26

def region(cldr: nil, code: nil, name: nil)
  unless exactly_one_present?(cldr, code, name)
    raise ArgumentError, "Must specify exactly one of cldr:, code: or name:. (code: is preferred)"
  end

  result = if cldr
    search_code = cldr.to_s.upcase

    @regions.find do |r|
      r.cldr_code.upcase == search_code
    end
  elsif code
    search_code = code.to_s.upcase

    @regions.find do |r|
      r.iso_code == search_code || r.alpha_three == search_code || r.numeric_three == search_code
    end
  else # search by name
    search_name = name.upcase

    @regions.find do |r|
      r.legacy_name&.upcase == search_name || r.full_name&.upcase == search_name
    end
  end

  result || Worldwide.unknown_region
end