Nomener assists with parsing peoples names that they give themselves (or other people). Nomener is was a fork of People as it uses some code contributed there. It's currently geared towards western style name formatting, however other cultural name formatting is (or would like to be supported). Currently it attempts to parse names through pattern matching without using large(r) dictionary/library/data files (except for name decorations and suffixes, see usage). It may not be possible to do without such in all languages.
If you didn't know, parsing names can be much more difficult than it seems it should be.
Two of the main goals are to support (a) UX in a similar manner as described by not splitting form fields and (b) an easy manner to handle parsing of strings which contain a name.
Requires Ruby 1.9.3 or higher (or equivalent). If using Ruby 1.9.3 or 2.0.0, it depends on string-scrub
Add this line to your application's Gemfile:
gem 'nomener'
And then execute:
$ bundle
Or install it yourself as:
$ gem install nomener
Use Nomener directly:
name = Nomener.parse "Joe Smith" # <Nomener::Name first="Joe" last="Smith">Create a new instance:
name = Nomener::Name.new "Duke Joe (Henry) Smith Jr."
#<Nomener::Name title="Duke" first="Joe" nick="Henry" last="Smith" suffix="Jr">returns the same as:
name = Nomener.parse "Duke Joe (Henry) Smith Jr."
name.first # "Joe"
name.name # "Joe Smith"
"Hi #{name}!" # "Hi Joe Smith!""
name.last # "Smith"
name.title # "Duke"
name.suffix # "Jr"
name.nick # "Henry"The .name method accepts a string to format the name however you may like. It defaults to "%f %l", which is the first and last name.
Other options are:
- %f # first name
- %l # last/surname/family name
- %m # middle name
- %n # nick name
- %m # middle name
- %s # suffix
- %t # title/prefix
name = Nomener::Name.new "Duke Joe (Henry) Smith Jr."
name.name "%l, %f" # "Smith, Joe"
name.name "%t %l" # "Duke Smith"- optionally use web service api data to assist (and create the web service!)
- fantasy prefixes/suffixes
- multiple names from one string
- specifying formats to parse by
- many other things
- better non-english support
- translations
- NLP?
- http://en.wikipedia.org/wiki/Personal_name
- http://en.wikipedia.org/wiki/Surname
- http://en.wikipedia.org/wiki/Title
- http://www.w3.org/International/questions/qa-personal-names
- http://heraldry.sca.org/titles.html
- Fork it ( http://github.com//nomener/fork )
- Create your feature branch (
git checkout -b my-new-feature) - Ensure adequate tests (rspec) on your branch
- Commit your changes (
git commit -am 'Add some feature') - Push to the branch (
git push origin my-new-feature) - Create new Pull Request
- People Original
- Namae (Racc based token)
- Nameable
- Person-name