webget_ruby_person_name 1.0.2

data.tar.gz.sig

@@ -0,0 +1 @@
+i�#���ua�g

data/LICENSE.txt

@@ -0,0 +1,12 @@
+LICENSE
+
+You may choose any of these licenses:
+
+  - CreativeCommons License, Non-commercial Share Alike
+  - LGPL, GNU Lesser General Public License
+  - MIT License
+  - Ruby License
+
+THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR
+IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.

data/README.rdoc

@@ -0,0 +1,38 @@
+
+= WebGet Ruby Gem: PersonName
+
+Author:: Joel Parker Henderson, joelparkerhenderson@gmail.com
+Copyright:: Copyright (c) 2006-2010 Joel Parker Henderson
+License:: CreativeCommons License, Non-commercial Share Alike
+License:: LGPL, GNU Lesser General Public License
+
+Return the person's name in various ways.
+
+==Example
+  class User < ActiveRecord::Base
+    include PersonName
+  end
+
+  u=User.new  
+  u.first_name = 'Zora'
+  u.middle_name = 'Neale'
+  u.last_name = 'Hurston'
+
+  u.full_name => "Zora Neale Hurston"
+  u.list_name => "Hurston, Zora Neale"
+  u.first_name_middle_name => "Zora Neale"
+  u.first_name_middle_initial_last_name => "Zora N Hurston"
+
+==Suggestion
+
+To make these very fast in Rails, try using the memoize approach:
+  class User < ActiveRecord::Base
+    include PersonName
+    memoize :full_name
+    memoize :list_name
+  end
+
+==Notes
+
+The first_name, middle_name, and last_name fields must be strings.
+

data/lib/webget_ruby_person_name.rb

@@ -0,0 +1,141 @@
+=begin rdoc
+
+= WebGet Ruby Gem: PersonName
+
+Author:: Joel Parker Henderson, joelparkerhenderson@gmail.com
+Copyright:: Copyright (c) 2006-2010 Joel Parker Henderson
+License:: CreativeCommons License, Non-commercial Share Alike
+License:: LGPL, GNU Lesser General Public License
+
+Return the person's name in various ways.
+
+==Example
+  class User < ActiveRecord::Base
+    include PersonName
+  end
+
+  u=User.new  
+  u.first_name = 'Zora'
+  u.middle_name = 'Neale'
+  u.last_name = 'Hurston'
+
+  u.full_name => "Zora Neale Hurston"
+  u.list_name => "Hurston, Zora Neale"
+  u.first_name_middle_name => "Zora Neale"
+  u.first_name_middle_initial_last_name => "Zora N Hurston"
+
+==Suggestion
+
+To make these very fast in Rails, try using the memoize approach:
+  class User < ActiveRecord::Base
+    include PersonName
+    memoize :full_name
+    memoize :list_name
+  end
+
+==Notes
+
+The first_name, middle_name, and last_name fields must be strings.
+
+=end
+
+
+module PersonName
+
+
+  # Return true iff the person has a first name and its non-blank
+
+  def first_name?
+   respond_to?(:first_name) and first_name and first_name!='' and first_name.strip!=''
+  end
+
+
+  # Return true iff the person has a middle name and its non-blank
+
+  def middle_name?
+   respond_to?(:middle_name) and middle_name and middle_name!='' and middle_name.strip!=''
+  end
+
+
+  # Return true iff the person has a last name and its non-blank
+
+  def last_name?
+   respond_to?(:last_name) and last_name and last_name!='' and last_name.strip!=''
+  end
+
+  
+  # Return the person's first name + middle name
+  #
+  # ==Example
+  #   u.first_name_middle_name => "Zora Neale"
+
+  def first_name_middle_name
+    pieces = []
+    (pieces << first_name)    if first_name?
+    (pieces << middle_name)   if middle_name?
+    return pieces.join(' ')
+  end
+  
+
+  # Return the person's first name + middle initial 
+  #
+  # ==Example
+  #   u.first_name_middle_initial => "Zora N"
+
+  def first_name_middle_initial
+    pieces = []
+    (pieces << first_name)           if first_name?
+    (pieces << middle_name[0...1])   if middle_name?
+    return pieces.join(' ')
+  end
+
+
+  # Return the person's first name + middle initial + last name
+  #
+  # ==Example
+  #   u.first_name_middle_initial_last_name => "Zora N Hurston"
+
+  def first_name_middle_initial_last_name
+   pieces = []
+    (pieces << first_name)           if first_name?
+    (pieces << middle_name[0...1])   if middle_name?
+    (pieces << last_name)            if last_name?
+    return pieces.join(' ')
+  end
+
+
+  # Return the person's full name: first_name middle_name last_name
+  #
+  # ==Example
+  #   u.full_name => "Zora Neale Hurston"
+  #
+  # This method skips any piece of the name that is missing or blank.
+
+  def full_name
+    pieces = []
+    (pieces << first_name)     if first_name?
+    (pieces << middle_name)    if middle_name?
+    (pieces << last_name)      if last_name?
+    return pieces.join(' ')
+  end
+
+
+  # Return the person's list name: last_name, first_name middle_name
+  #
+  # ==Example
+  #   u.list_name => "Hurston, Zora Neale"
+  #
+  # This method skips any piece of the name that is missing or blank.
+
+  def list_name
+    pieces = []
+    (pieces << first_name)  if first_name?
+    (pieces << middle_name) if middle_name?
+    if last_name?
+      comma = pieces.size>0 ? ',' : ''
+      pieces.unshift(last_name+comma)
+    end
+    return pieces.join(' ')
+  end
+
+end

data/test/webget_ruby_person_name_test.rb

@@ -0,0 +1,123 @@
+require 'test/unit'
+require 'webget_ruby_person_name'
+
+class PersonNameTest < Test::Unit::TestCase
+
+ def test_first_name_middle_name
+  assert_equal("abc def",p("abc","def","ghi").first_name_middle_name)
+  assert_equal("abc"    ,p("abc",nil  ,"ghi").first_name_middle_name)
+  assert_equal("def"    ,p(nil ,"def" ,"ghi").first_name_middle_name)
+  assert_equal(""       ,p(nil ,nil   ,"ghi").first_name_middle_name)
+ end
+
+ def test_first_name_middle_initial
+  assert_equal("abc d",p("abc","def","ghi").first_name_middle_initial)
+  assert_equal("abc"  ,p("abc",nil  ,"ghi").first_name_middle_initial)
+  assert_equal("d"    ,p(nil ,"def" ,"ghi").first_name_middle_initial)
+  assert_equal(""     ,p(nil ,nil   ,"ghi").first_name_middle_initial)
+ end
+
+ def test_first_name_middle_initial_last_name_with_first_name
+  assert_equal("abc",p("abc",nil,nil).first_name_middle_initial_last_name)
+ end
+
+ def test_first_name_middle_initial_last_name_with_middle_name
+  assert_equal("d", p(nil,"def",nil).first_name_middle_initial_last_name)
+ end
+
+ def test_first_name_middle_initial_last_name_with_last_name
+  assert_equal("ghi",p(nil,nil,"ghi").first_name_middle_initial_last_name)
+ end
+
+ def test_first_name_middle_initial_last_name_with_first_name_and_middle_name
+  assert_equal("abc d",p("abc","def",nil).first_name_middle_initial_last_name)
+ end
+
+ def test_first_name_middle_initial_last_name_with_first_name_and_last_name
+  assert_equal("abc ghi",p("abc",nil,"ghi").first_name_middle_initial_last_name)
+ end
+
+ def test_first_name_middle_initial_last_name
+  p=Person.new("abc","def","ghi")
+  assert_equal("abc d ghi",p.first_name_middle_initial_last_name)
+ end
+
+ def test_full_name_with_first_name
+  assert_equal("abc",p("abc",nil,nil).full_name)
+ end
+
+ def test_full_name_with_middle_name
+  assert_equal("def",p(nil,"def",nil).full_name)
+ end
+
+ def test_full_name_with_last_name
+  assert_equal("ghi",p(nil,nil,"ghi").full_name)
+ end
+
+ def test_full_name_with_first_name_and_middle_name
+  assert_equal("abc def",p("abc","def",nil).full_name)
+ end
+
+ def test_full_name_with_first_name_and_last_name
+  assert_equal("abc ghi",p("abc",nil,"ghi").full_name)
+ end
+
+ def test_full_name_with_middle_name_and_last_name
+  assert_equal("def ghi",p(nil,"def","ghi").full_name)
+ end
+
+ def test_full_name
+  assert_equal("abc def ghi",p("abc","def","ghi").full_name)
+ end
+
+ def test_list_name_with_first_name
+  assert_equal("abc",p("abc",nil,nil).list_name)
+ end
+
+ def test_list_name_with_middle_name
+  assert_equal("def", p(nil,"def",nil).list_name)
+ end
+
+ def test_list_name_with_last_name
+  assert_equal("ghi",p(nil,nil,"ghi").list_name)
+ end
+
+ def test_list_name_with_first_name_and_middle_name
+  assert_equal("abc def",p("abc","def",nil).list_name)
+ end
+
+ def test_list_name_with_first_name_and_last_name
+  assert_equal("ghi, abc",p("abc",nil,"ghi").list_name)
+ end
+
+ def test_list_name_with_middle_name_and_last_name
+  assert_equal("ghi, def",p(nil,"def","ghi").list_name)
+ end
+
+ def test_list_name
+  assert_equal("ghi, abc def",p("abc","def","ghi").list_name)
+ end
+
+ # Factory
+ def p(first,middle,last)
+  Person.new(first,middle,last)
+ end
+
+end
+
+
+class Person
+
+ attr_accessor :first_name
+ attr_accessor :middle_name
+ attr_accessor :last_name
+
+ include PersonName
+
+ def initialize(first,middle,last)
+  @first_name=first
+  @middle_name=middle
+  @last_name=last
+ end
+
+end

metadata

@@ -0,0 +1,80 @@
+--- !ruby/object:Gem::Specification 
+name: webget_ruby_person_name
+version: !ruby/object:Gem::Version 
+  version: 1.0.2
+platform: ruby
+authors: 
+- WebGet
+autorequire: 
+bindir: bin
+cert_chain: 
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIDvDCCAyWgAwIBAgIJAIlSqEkDQaZIMA0GCSqGSIb3DQEBBQUAMIGbMQswCQYD
+  VQQGEwJVUzETMBEGA1UECBMKQ2FsaWZvcm5pYTEWMBQGA1UEBxMNU2FuIEZyYW5j
+  aXNjbzETMBEGA1UEChMKV2ViR2V0LmNvbTETMBEGA1UECxMKV2ViR2V0LmNvbTET
+  MBEGA1UEAxMKV2ViR2V0LmNvbTEgMB4GCSqGSIb3DQEJARYRd2ViZ2V0QHdlYmdl
+  dC5jb20wHhcNMDkwMjI2MTk0NDU4WhcNMTExMTIzMTk0NDU4WjCBmzELMAkGA1UE
+  BhMCVVMxEzARBgNVBAgTCkNhbGlmb3JuaWExFjAUBgNVBAcTDVNhbiBGcmFuY2lz
+  Y28xEzARBgNVBAoTCldlYkdldC5jb20xEzARBgNVBAsTCldlYkdldC5jb20xEzAR
+  BgNVBAMTCldlYkdldC5jb20xIDAeBgkqhkiG9w0BCQEWEXdlYmdldEB3ZWJnZXQu
+  Y29tMIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDXCFYfW6hCQl0ToNjaMIXG
+  ZfPF6OoR20BO/Tg6V37qPi7gDSZ6vIC6Mxcs8LtEcju85cD9lnKKl/lo4S5/w9Ha
+  hGD2ZFFfbF8420X5Za5G2KuriS3GzRz7F5dKCTjb1NH9TPlgOc71bcrDmCwwtFJl
+  T+tdfBju0YxLSBiMXf4y5QIDAQABo4IBBDCCAQAwHQYDVR0OBBYEFHB1kXO/Xd4g
+  G+AJ2/wwh6JOWXzNMIHQBgNVHSMEgcgwgcWAFHB1kXO/Xd4gG+AJ2/wwh6JOWXzN
+  oYGhpIGeMIGbMQswCQYDVQQGEwJVUzETMBEGA1UECBMKQ2FsaWZvcm5pYTEWMBQG
+  A1UEBxMNU2FuIEZyYW5jaXNjbzETMBEGA1UEChMKV2ViR2V0LmNvbTETMBEGA1UE
+  CxMKV2ViR2V0LmNvbTETMBEGA1UEAxMKV2ViR2V0LmNvbTEgMB4GCSqGSIb3DQEJ
+  ARYRd2ViZ2V0QHdlYmdldC5jb22CCQCJUqhJA0GmSDAMBgNVHRMEBTADAQH/MA0G
+  CSqGSIb3DQEBBQUAA4GBADzVXlwuff0/w3yK4LflGKKhtC3oChIrwmSyP6tk628N
+  BHokpc4Kz63xSXqzYTnBS7rFBwlYThtNalQeWmoUjGh3Z0ZR0JlhU0ln8899LuJ3
+  DXnLFY0cVuBnNDMOOFl8vk1qIcZjcTovhzgcixpG6Uk5qmUsKHRLQf4oQJx7TfLK
+  -----END CERTIFICATE-----
+
+date: 2010-02-19 00:00:00 -08:00
+default_executable: 
+dependencies: []
+
+description: 
+email: webget@webget.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- README.rdoc
+- LICENSE.txt
+- lib/webget_ruby_person_name.rb
+has_rdoc: true
+homepage: http://webget.com/
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: "WebGet Ruby Gem: PersonName mixin methods to calculate a person's full name, sortable name, etc."
+test_files: 
+- test/webget_ruby_person_name_test.rb