Home > dialy

dialy

Dialy is a project mainly written in Ruby, based on the MIT license.

Formatting phone numbers in E.123

= dialy

Formatting phone numbers in the E.123 format (http://en.wikipedia.org/wiki/E.123)

This gem takes an unformatted ugly string with a phone number and builds a pretty one. This is useful for applications storing phone numbers in a normalized way.

Because the area codes in Germany, Austria and Switzerland have different lengths, an automatic detection from a given phone number is not possible. So the gem knows all area codes for this countries.

== Examples

Dialy::Number.new('+49 (0221) 12 34 56').to_s
# => '+49 221 1234567'

Dialy::Number.new('+49 (0)221 12 34 56').to_s
# => '+49 221 1234567'

Dialy::Number.new('0049221123456').to_s
# => '+49 221 1234567'

Dialy::Config[:default_country_code] = 49
Dialy::Number.new('0221/123456').to_s
# => '+49 221 1234567'

# Display national number without country code
Dialy::Number.new('0221/123456').to_s(:short)
# => '(0221) 1234567'

== Install

You can install the library as a gem

gem install dialy

== TODO

  • Add area codes for other countries than DE/AT/CH

== Note on Patches/Pull Requests

  • Fork the project.
  • Make your feature addition or bug fix.
  • Add tests for it. This is important so I don't break it in a future version unintentionally.
  • Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
  • Send me a pull request. Bonus points for topic branches.

== Copyright

Copyright (c) 2010 Georg Ledermann. See LICENSE for details.