###Convert numeric data into friendly, human-like verbal expressions that match the occasion!
N2W or number_to_word, is a ruby gem that allows you to transform numeric data into verbal expressions.
The way that we express numbers verbally (or the way that we choose to iterate phonetically numerical data --whatever you prefer!) differs from one occasion to another, according to our intention and purpose. This ruby gem is all about giving your rails app, the ability to express large volumes of numerical data in words, in a way that is more intelligent and sounds more natural.
This might be useful to people for example who have a large database of phone numbers and they use text-to-speech technology in order to communicate their data phonetically with their clients. This might be also useful to people who work with educational tts resources and they want to readily transform scores of scientific data (float readings, co-ordinates or no. of pages) into words that can be read out loud during a presentation, in a more human-like fashion than one single digit after the other.
This facility already includes class methods for the explicit expression of the following numerical data structures and is scheduled to feature the options marked with a in the near future:
-
Integers: (0..999*10^48), takes either a string or an integer.
-
Telephone numbers: this feature uses reg expressions to discover phonetic patterns in your data in order to make tel numbers more memorable!
The program is currently using three modes in order to output tel. numbers:
a) patterns: patterns uses regular expressions to detect patterns inside the number.
For example, "0589998850" will be: "zero five eight, triple nine, double eight, five zero".
b) suggestive: suggestive makes use of the notation provided by the author either as whitespace or as any non digit symbol. For example, "////222-108-2822" will become: "triple two, one zero eight, twenty eight, double two".
c) standard: standard breaks the number to a standard array format on the sole criterion of whether length is even or odd.
For example, "51371082918" will be: "fifty one, three seven one, zero eighty two, nine one eight".
The gem has a little sorting algorithm on the top of it all in order to decide whether to go with a, b or c.
This core functionality makes it easy to extend services to:
-
Floats/Scientific measurements
-
Zips && Post Codes
-
Pages
-
Bank Checks
-
Co-ordinates
-
ISBNs
-
Pay_as_you_go mobile telephony activation codes
--Soon to come: An explaining facility on how big is that number, with examples drawn by science (feel free to contribute on this one as long as you are willing and able to cross-reference!)
Add this line to your application's Gemfile:
gem 'n_2_w'And then execute:
$ bundle
Or install it yourself as:
$ gem install n_2_w
For an integer, <%= N2W::Spint.any_other b %> --where <%= b=" 805060087776" %>
For a tel number, N2W::Tel.sortln a (for pattern finder) or N2W::Tel.tel_number a (for suggestive or standard mode). --where <%= a="///80-50600-87776" %> Please note that if sortln can't find more than one pattern on the input number, it will default to tel_number automatically.
After checking out the repo, run bin/setup to install dependencies. Then, run rake spec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.
To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.
Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/n_2_w. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.
The gem is available as open source under the terms of the MIT License.