namae 0.2.0 → 0.2.1

data/README.md

@@ -39,6 +39,33 @@ Quickstart
         matz.initials :dots => false
         #-> "YM"
 
+Rails
+-----
+It is easy to integrate Namae into your Rails project. There are two typical
+cases where this might be useful: you want to store individual parts of a
+person's name in your database, but want to provide your user's with a single
+input field; or else, you keep personal names in a single database column
+but your application occasionally requires access to individual parts.
+
+For the latter use case, there is a straightforward way to add Namae to your
+Rails model:
+
+    class Person < ActiveRecord::Base
+      attr_accessible :name
+
+    	delegate :family, :initials, :to => :namae
+
+      private
+
+    	def namae
+    		@namae ||= Namae::Name.parse(name)
+    	end
+    end
+
+In this minimal example, we are using the method `Namae::Name.parse` which
+always returns a single Name instance and delegate all readers for the name's
+parts in which we are interested to this instance.
+
 Format and Examples
 -------------------
 Namae recognizes names in a wide variety of two basic formats, internally

data/lib/namae/name.rb

@@ -36,11 +36,11 @@ module Namae
       end
       
       # @param name [String] the name to be parsed
-      # @return [Name,nil] the parsed name  or nil if the name cannot be parsed
+      # @return [Name] the parsed name
       def parse(name)
         parse!(name)
       rescue
-        nil
+        new
       end
     end
 

data/lib/namae/version.rb

@@ -2,7 +2,7 @@ module Namae
   module Version
     MAJOR = 0
     MINOR = 2
-    PATCH = 0
+    PATCH = 1
     BUILD = nil
 
     STRING = [MAJOR, MINOR, PATCH, BUILD].compact.join('.').freeze

data/namae.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = "namae"
-  s.version = "0.2.0"
+  s.version = "0.2.1"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Sylvester Keil", "Dan Collis-Puro"]
-  s.date = "2012-06-23"
+  s.date = "2012-06-24"
   s.description = " Namae is a parser for human names. It recognizes personal names of various cultural backgrounds and tries to split them into their component parts (e.g., given and family names, honorifics etc.). "
   s.email = ["sylvester@keil.or.at", "dan@collispuro.com"]
   s.extra_rdoc_files = [

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: namae
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
   prerelease: 
 platform: ruby
 authors:
@@ -10,11 +10,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-06-23 00:00:00.000000000 Z
+date: 2012-06-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: racc
-  requirement: &70254620056100 !ruby/object:Gem::Requirement
+  requirement: &70303877856980 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -22,10 +22,10 @@ dependencies:
         version: 1.4.8
   type: :development
   prerelease: false
-  version_requirements: *70254620056100
+  version_requirements: *70303877856980
 - !ruby/object:Gem::Dependency
   name: rdoc
-  requirement: &70254620055160 !ruby/object:Gem::Requirement
+  requirement: &70303877872020 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -33,10 +33,10 @@ dependencies:
         version: '3.12'
   type: :development
   prerelease: false
-  version_requirements: *70254620055160
+  version_requirements: *70303877872020
 - !ruby/object:Gem::Dependency
   name: bundler
-  requirement: &70254620053560 !ruby/object:Gem::Requirement
+  requirement: &70303877871300 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -44,10 +44,10 @@ dependencies:
         version: '1.1'
   type: :development
   prerelease: false
-  version_requirements: *70254620053560
+  version_requirements: *70303877871300
 - !ruby/object:Gem::Dependency
   name: simplecov
-  requirement: &70254620052500 !ruby/object:Gem::Requirement
+  requirement: &70303877870540 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -55,10 +55,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70254620052500
+  version_requirements: *70303877870540
 - !ruby/object:Gem::Dependency
   name: ZenTest
-  requirement: &70254620051340 !ruby/object:Gem::Requirement
+  requirement: &70303877869820 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -66,10 +66,10 @@ dependencies:
         version: 4.8.0
   type: :development
   prerelease: false
-  version_requirements: *70254620051340
+  version_requirements: *70303877869820
 - !ruby/object:Gem::Dependency
   name: jeweler
-  requirement: &70254620660080 !ruby/object:Gem::Requirement
+  requirement: &70303877869300 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -77,7 +77,7 @@ dependencies:
         version: 1.8.3
   type: :development
   prerelease: false
-  version_requirements: *70254620660080
+  version_requirements: *70303877869300
 description: ! ' Namae is a parser for human names. It recognizes personal names of
   various cultural backgrounds and tries to split them into their component parts
   (e.g., given and family names, honorifics etc.). '
@@ -131,7 +131,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -521949166001682720
+      hash: 212543173299856896
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements: