Small tools to aid in developing SMS applications.
Ruby
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
lib
tasks
test
vendor/assets/javascripts
MIT-LICENSE
README.rdoc
Rakefile
sms_toolkit.gemspec

README.rdoc

SmsToolkit

This is the collection of tools to help developing SMS applications.

Usage

Phone Number Normalization

If you want to get a phone number as just 10-digit string without the country code or complex parentheses and dashes, you can use the normalization method:

SmsToolkit::PhoneNumbers.normalize("(012) 345-6789")   # => "0123456789"
SmsToolkit::PhoneNumbers.normalize("(0123) 45-67-89")  # => "0123456789"
SmsToolkit::PhoneNumbers.normalize("+10123456789")     # => "0123456789"
SmsToolkit::PhoneNumbers.normalize("000123456789")     # => "0123456789"
SmsToolkit::PhoneNumbers.normalize("0010123456789")    # => "0123456789"

Normalization method will pass on blank strings, nil and whatever else that doesn't look like a number.

Phone Number Formatting

To unify the formatting of the phone numbers you can use the Northern US Formatting method. It will use the normalization first and then convert 10-digit numbers into the “(nnn) nnn-nnnn” format while leaving short codes intact.

SmsToolkit::PhoneNumbers.format("0123456789")          # => "(012) 345-6789"
SmsToolkit::PhoneNumbers.format("+10123456789")        # => "(012) 345-6789"
SmsToolkit::PhoneNumbers.format("(01234) 56-78-9")     # => "(012) 345-6789"

This feature can also be used in views via the helper method:

formatted_phone_number("012-345-6789")

License

The SMS Toolkit is Copyright © 2013 Aleksey Gureiev and Recess Mobile.

It is free software, and may be redistributed under the terms specified in the MIT-LICENSE file.