Royce  Reinger

Royce Reinger


National_colors: A JSON File Containing Each Country's National Colors

National Colors

A JSON file containing each country's national colors, in the proper order.

Scraped from which seems to be the only place that has the correct colors in the correct order.


A small Ruby script is used to scrape the Wikipedia page. To run it, perform the following commands from this repository's root directory:

cd src
gem install normalize_country nokogiri
ruby extract.rb

Alternatively, if you prefer Bundler:

cd src
bundle install
bundle exec ruby extract.rb

The JSON will be written to national_colors.json. To use a different filename:

ruby extract.rb my_amaaaaaaaazing_filename.json


Mapping of CSS color names to hex values are done via a JSON file stolen from the html-colors node package.

Author: sshaw
Source Code: 
License: MIT License

#ruby #json #color #national 

National_colors: A JSON File Containing Each Country's National Colors
Royce  Reinger

Royce Reinger


Global_phone: Parse, Validate, and format Phone Numbers in Ruby


GlobalPhone parses, validates, and formats local and international phone numbers according to the E.164 standard.

Store and display phone numbers in your app. Accept phone number input in national or international format. Convert phone numbers to international strings (+13125551212) for storage and retrieval. Present numbers in national format ((312) 555-1212) in your UI.

Designed with the future in mind. GlobalPhone uses format specifications from Google's open-source libphonenumber database. No need to upgrade the library when a new phone format is introduced—just generate a new copy of the database and check it into your app.

Pure Ruby. No dependencies. GlobalPhone is designed for Ruby 1.9.3 and up. (Works in 1.8.7, too—just bring your own json gem.)


Add the global_phone gem to your app. For example, using Bundler:

 $ echo "gem 'global_phone'" >> Gemfile
 $ bundle install

Use global_phone_dbgen to convert Google's libphonenumber PhoneNumberMetaData.xml file into a JSON database for GlobalPhone.

 $ gem install global_phone_dbgen
 $ global_phone_dbgen > db/global_phone.json

Tell GlobalPhone where to find the database. For example, in a Rails app, create an initializer in config/initializers/global_phone.rb:

require 'global_phone'
GlobalPhone.db_path = Rails.root.join('db/global_phone.json')


Parse an international number string into a GlobalPhone::Number object:

number = GlobalPhone.parse('+1-312-555-1212')
# => #<GlobalPhone::Number territory=#<GlobalPhone::Territory country_code=1 name=US> national_string="3125551212">

Query the country code and likely territory name of the number:

# => "1"
# => "US"

Present the number in national and international formats:

# => "(312) 555-1212"

# => "+1 312-555-1212"

Is the number valid? (Note: this is not definitive. For example, the number here is "valid" by format, but there are no US numbers that start with 555. The valid? method may return false positives, but should not return false negatives unless the database is out of date.)

# => true

Get the number's normalized E.164 international string:

# => "+13125551212"

Parse a number in national format for a given territory:

number = GlobalPhone.parse("(0) 20-7031-3000", :gb)
# => #<GlobalPhone::Number territory=#<GlobalPhone::Territory country_code=44 name=GB> national_string="2070313000">

Parse an international number using a territory's international dialing prefix:

number = GlobalPhone.parse("00 1 3125551212", :gb)
# => #<GlobalPhone::Number territory=#<GlobalPhone::Territory country_code=1 name=US> national_string="3125551212">

Set the default territory to Great Britain (territory names are ISO 3166-1 Alpha-2 codes):

GlobalPhone.default_territory_name = :gb
# => :gb

GlobalPhone.parse("(0) 20-7031-3000")
# => #<GlobalPhone::Number territory=#<GlobalPhone::Territory country_code=44 name=GB> national_string="2070313000">

Shortcuts for validating a phone number:

GlobalPhone.validate("+1 312-555-1212")
# => true

# => true

GlobalPhone.validate("(0) 20-7031-3000")
# => false

GlobalPhone.validate("(0) 20-7031-3000", :gb)
# => true

Shortcuts for normalizing a phone number in E.164 format:

GlobalPhone.normalize("(312) 555-1212")
# => "+13125551212"

# => "+442070313000"

GlobalPhone.normalize("(0) 20-7031-3000")
# => nil

GlobalPhone.normalize("(0) 20-7031-3000", :gb)
# => "+442070313000"


GlobalPhone currently does not parse emergency numbers or SMS short code numbers.

Validation is not definitive and may return false positives, but should not return false negatives unless the database is out of date.

Territory heuristics are imprecise. Parsing a number will usually result in the territory being set to the primary territory of the region. For example, Canadian numbers will be parsed with a territory of US. (In most cases this does not matter, but if your application needs to perform geolocation using phone numbers, GlobalPhone may not be a good fit.)


The GlobalPhone source code is hosted on GitHub. You can check out a copy of the latest code using Git:

$ git clone

If you've found a bug or have a question, please open an issue on the issue tracker. Or, clone the GlobalPhone repository, write a failing test case, fix the bug, and submit a pull request.

GlobalPhone is heavily inspired by Andreas Gal's PhoneNumber.js library.

Version History

1.0.1 (May 29, 2013)

  • GlobalPhone::Number#to_s returns the E.164 international string.
  • Ensure GlobalPhone::Number always returns strings for #national_format, #international_format, and #international_string, regardless of validity.
  • Relax format restrictions to more loosely match available national number patterns.

1.0.0 (May 28, 2013)

  • Initial public release.

Author: sstephenson
Source Code: 
License: MIT license

#ruby #phone #database 

Global_phone: Parse, Validate, and format Phone Numbers in Ruby