acts_as_human_name 0.0.1

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2010 [name of plugin creator]
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README

@@ -0,0 +1,19 @@
+ActsAsHumanName
+===============
+
+Adds two methods to your model:
+
+regular_name: "David Christiansen"
+full_name: "Christiansen, David Ray III"
+
+
+The tests don't work yet. I need to figure out how to include shoulda. Also, you can't configure the names of the columns I use yet. They have to be first_name, last_name, middle_name, and suffix.
+
+
+Example
+=======
+
+acts_as_human_name
+
+
+Copyright (c) 2010 David Christiansen, released under the MIT license

data/Rakefile

@@ -0,0 +1,52 @@
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+require 'rake/gempackagetask' 
+
+PKG_FILES = FileList[
+  '[a-zA-Z]*',
+  'generators/**/*',
+  'lib/**/*',
+  'rails/**/*',
+  'tasks/**/*',
+  'test/**/*'
+]
+
+spec = Gem::Specification.new do |s|
+  s.name = "acts_as_human_name"
+  s.version = "0.0.1"
+  s.author = "Dave Christiansen"
+  s.email = "dave@trooptrack.com"
+  s.homepage = "http://trooptrack.com/"
+  s.platform = Gem::Platform::RUBY
+  s.summary = "Easy way to display people's names"
+  s.files = PKG_FILES.to_a
+  s.require_path = "lib"
+  s.has_rdoc = false
+  s.extra_rdoc_files = ["README"]
+end
+
+desc 'Turn this plugin into a gem.'
+Rake::GemPackageTask.new(spec) do |pkg|
+  pkg.gem_spec = spec
+end
+
+desc 'Default: run unit tests.'
+task :default => :test
+
+desc 'Test the acts_as_human_name plugin.'
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.libs << 'test'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = true
+end
+
+desc 'Generate documentation for the acts_as_human_name plugin.'
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'ActsAsHumanName'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/init.rb

@@ -0,0 +1,4 @@
+$:.unshift "#{File.dirname(__FILE__)}/lib"
+require 'active_record/acts/human_name'
+
+ActiveRecord::Base.class_eval { include ActiveRecord::Acts::HumanName }

data/lib/active_record/acts/human_name.rb

@@ -0,0 +1,70 @@
+module ActiveRecord
+  module Acts #:nodoc:
+    module HumanName #:nodoc:
+      def self.included(base)
+        base.extend(ClassMethods)
+      end
+
+      # This +acts_as+ extension provides the capabilities rendering different representations of a 
+      # human name in English. Models need to store last_name, first_name, middle_name, and suffix columns
+      # for this plugin to work.
+      
+      module ClassMethods
+        # Configuration options are:
+        #
+        # * +last_name+ - specifies where the last name is stored (default: +last_name+)
+        # * +first_name+ - specifies where the first name is stored (default: +first_name+)
+        # * +middle_name+ - specifies where the middle name is stored (default: +middle_name+)
+        # * +suffix+ - specifies where the suffix is stored (default: +suffix+)
+        #   Example: <tt>acts_as_human_name :last_name => "surname"</tt>
+        # HEY!!! This configuration stuff doesn't actually work yet!!!
+        def acts_as_human_name(options = {})
+          configuration = { :last_name => "last_name", 
+                            :first_name => "first_name", 
+                            :middle_name => "middle_name",
+                            :suffix => "suffix" }
+                            
+          configuration.update(options) if options.is_a?(Hash)
+
+          class_eval <<-EOV
+            include ActiveRecord::Acts::HumanName::InstanceMethods
+
+            def acts_as_human_name_class
+              ::#{self.name}
+            end
+
+            
+          EOV
+        end
+      end
+
+      module InstanceMethods
+        def regular_name
+          if first_name and last_name
+            "#{self.first_name} #{self.last_name}"
+          elsif first_name
+            first_name
+          elsif last_name
+            last_name
+          end
+        end
+
+        def full_name
+          if first_name and last_name and middle_name and suffix
+            "#{last_name}, #{first_name} #{middle_name} #{suffix}"
+          elsif first_name and last_name and middle_name
+            "#{last_name}, #{first_name} #{middle_name}"
+          elsif first_name and last_name and suffix
+            "#{last_name}, #{first_name} #{suffix}"
+          elsif first_name and last_name
+            "#{last_name}, #{first_name}"
+          elsif last_name
+            last_name
+          elsif first_name
+            first_name
+          end
+        end
+      end 
+    end
+  end
+end

metadata

@@ -0,0 +1,71 @@
+--- !ruby/object:Gem::Specification 
+name: acts_as_human_name
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Dave Christiansen
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-09-07 00:00:00 -04:00
+default_executable: 
+dependencies: []
+
+description: 
+email: dave@trooptrack.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README
+files: 
+- init.rb
+- MIT-LICENSE
+- Rakefile
+- README
+- lib/active_record/acts/human_name.rb
+has_rdoc: true
+homepage: http://trooptrack.com/
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Easy way to display people's names
+test_files: []
+