namae 0.1.1 → 0.2.0

data/lib/namae/name.rb

@@ -26,6 +26,22 @@ module Namae
     
     class << self
       attr_reader :parts, :defaults
+
+      # @param name [String] the name to be parsed
+      # @raise [ArgumentError] if the name cannot be parsed or if the input
+      #   contains more than a single name
+      # @return [Name] the parsed name
+      def parse!(name)
+        Parser.instance.parse!(name)[0] || new
+      end
+      
+      # @param name [String] the name to be parsed
+      # @return [Name,nil] the parsed name  or nil if the name cannot be parsed
+      def parse(name)
+        parse!(name)
+      rescue
+        nil
+      end
     end
 
     

data/lib/namae/version.rb

@@ -1,8 +1,8 @@
 module Namae
   module Version
     MAJOR = 0
-    MINOR = 1
-    PATCH = 1
+    MINOR = 2
+    PATCH = 0
     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.1.1"
+  s.version = "0.2.0"
 
   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-08"
+  s.date = "2012-06-23"
   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 = [

data/spec/namae/name_spec.rb

@@ -17,6 +17,17 @@ module Namae
       
     end
     
+    describe '.parse' do
+      it 'returns an empty name for an empty string' do
+        Name.parse('').should be_empty
+        Name.parse('').should be_a(Name)
+      end
+      
+      it 'returns a single name object if there is more than one name' do
+        Name.parse('Plato and Sokrates').given.should == 'Plato'
+      end
+    end
+    
     describe '#values_at' do
       it 'returns an array with the given values' do
         Name.new(:family => 'foo').values_at(:family).should == ['foo']

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: namae
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
   prerelease: 
 platform: ruby
 authors:
@@ -10,11 +10,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-06-08 00:00:00.000000000 Z
+date: 2012-06-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: racc
-  requirement: &70121416905540 !ruby/object:Gem::Requirement
+  requirement: &70254620056100 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -22,10 +22,10 @@ dependencies:
         version: 1.4.8
   type: :development
   prerelease: false
-  version_requirements: *70121416905540
+  version_requirements: *70254620056100
 - !ruby/object:Gem::Dependency
   name: rdoc
-  requirement: &70121416904800 !ruby/object:Gem::Requirement
+  requirement: &70254620055160 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -33,10 +33,10 @@ dependencies:
         version: '3.12'
   type: :development
   prerelease: false
-  version_requirements: *70121416904800
+  version_requirements: *70254620055160
 - !ruby/object:Gem::Dependency
   name: bundler
-  requirement: &70121416903740 !ruby/object:Gem::Requirement
+  requirement: &70254620053560 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -44,10 +44,10 @@ dependencies:
         version: '1.1'
   type: :development
   prerelease: false
-  version_requirements: *70121416903740
+  version_requirements: *70254620053560
 - !ruby/object:Gem::Dependency
   name: simplecov
-  requirement: &70121416902880 !ruby/object:Gem::Requirement
+  requirement: &70254620052500 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -55,10 +55,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70121416902880
+  version_requirements: *70254620052500
 - !ruby/object:Gem::Dependency
   name: ZenTest
-  requirement: &70121416921440 !ruby/object:Gem::Requirement
+  requirement: &70254620051340 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -66,10 +66,10 @@ dependencies:
         version: 4.8.0
   type: :development
   prerelease: false
-  version_requirements: *70121416921440
+  version_requirements: *70254620051340
 - !ruby/object:Gem::Dependency
   name: jeweler
-  requirement: &70121416920760 !ruby/object:Gem::Requirement
+  requirement: &70254620660080 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -77,7 +77,7 @@ dependencies:
         version: 1.8.3
   type: :development
   prerelease: false
-  version_requirements: *70121416920760
+  version_requirements: *70254620660080
 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: 1491375851231395854
+      hash: -521949166001682720
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements: