has_vcards 0.5.1

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2008 [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.markdown

@@ -0,0 +1,14 @@
+has_vcards
+==========
+
+Rails plugin providing VCard like contact and address models and helpers.
+
+
+License
+=======
+
+Copyright (c) 2007-2010 Simon Hürlimann <simon.huerlimann@cyt.ch>
+Copyright (c) 2008 Agrabah <http://www.agrabah.ch>
+Copyright (c) 2007-2010 ZytoLabor <http://www.zyto-labor.com>
+
+Released under the MIT license.

data/Rakefile

@@ -0,0 +1,56 @@
+# coding: utf-8
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+
+begin
+  GEM = "has_vcards"
+  AUTHOR = "Simon Hürlimann"
+  EMAIL = "simon.huerlimann@cyt.ch"
+  SUMMARY = "Rails gem providing VCard like contact and address models and helpers."
+  HOMEPAGE = "http://github.com/huerlisi/has_vcards/tree/master"
+  
+  gem 'jeweler', '>= 1.0.0'
+  require 'jeweler'
+  
+  Jeweler::Tasks.new do |s|
+    s.name = GEM
+    s.summary = SUMMARY
+    s.email = EMAIL
+    s.homepage = HOMEPAGE
+    s.description = SUMMARY
+    s.author = AUTHOR
+    
+    s.require_path = 'lib'
+    s.files = %w(MIT-LICENSE README.markdown Rakefile) + Dir.glob("{lib,app,test,config}/**/*")
+    
+    # Runtime dependencies: When installing has_vcards these will be checked if they are installed.
+    # Will be offered to install these if they are not already installed.
+    s.add_dependency 'activerecord'
+    s.add_dependency 'i18n'
+  end
+  
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "[has_vcards:] Jeweler - or one of its dependencies - is not available. Install it with: sudo gem install jeweler -s http://gemcutter.org"
+end
+
+desc 'Default: run unit tests.'
+task :default => :test
+
+desc 'Test the has_vcards 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 has_vcards plugin.'
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'has_vcards'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README.markdown')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/app/helpers/has_vcards_helper.rb

@@ -0,0 +1,13 @@
+module HasVcardsHelper
+  def address(vcard, line_separator = '<br/>')
+    vcard.address_lines.map{|line| h(line)}.join(line_separator).html_safe
+  end
+
+  def full_address(vcard, line_separator = '<br/>')
+    vcard.full_address_lines.map{|line| h(line)}.join(line_separator).html_safe
+  end
+
+  def contact(vcard, line_separator = '<br/>', label_separator = ' ')
+    vcard.contact_lines(label_separator).map{|line| h(line)}.join(line_separator).html_safe
+  end
+end

data/app/models/address.rb

@@ -0,0 +1,3 @@
+class Address < ActiveRecord::Base
+  belongs_to :vcard
+end

data/app/models/phone_number.rb

@@ -0,0 +1,25 @@
+class PhoneNumber < ActiveRecord::Base
+  belongs_to :vcard
+  belongs_to :object, :polymorphic => true
+
+  validates_presence_of :number
+
+  def label
+    case phone_number_type
+    when 'phone'
+      "Tel:"
+    when 'fax'
+      "Fax:"
+    when 'mobile'
+      "Mob:"
+    when 'email'
+      "Mail:"
+    else
+      ""
+    end
+  end
+  
+  def to_s(separator = " ")
+    return [label, number].compact.join(separator)
+  end
+end

data/app/models/vcard.rb

@@ -0,0 +1,131 @@
+class Vcard < ActiveRecord::Base
+  has_one :address, :autosave => true, :validate => true
+  accepts_nested_attributes_for :address
+  delegate  :post_office_box, :extended_address, :street_address, :locality, :region, :postal_code, :country_name, :to => :address
+  delegate  :post_office_box=, :extended_address=, :street_address=, :locality=, :region=, :postal_code=, :country_name=, :to => :address
+
+  has_many :addresses, :autosave => true, :validate => true
+  accepts_nested_attributes_for :addresses
+  
+  scope :active, :conditions => {:active => true}
+  scope :by_name, lambda {|name| {:conditions => self.by_name_conditions(name)}}
+
+  belongs_to :object, :polymorphic => true
+
+  # Convenience accessors
+  def full_name
+    result = read_attribute(:full_name)
+    result ||= [ family_name, given_name ].compact.join(' ')
+
+    return result
+  end
+
+  def abbreviated_name
+    "#{given_name[0..0]}. #{family_name}"
+  end
+
+  # Advanced finders
+  def self.by_name_conditions(name)
+    ['vcards.full_name LIKE :name OR vcards.family_name LIKE :name OR vcards.given_name LIKE :name OR vcards.nickname LIKE :name', {:name => name}]
+  end
+
+  def self.find_by_name(name)
+    self.find(:first, :conditions => self.by_name_conditions(name))
+  end
+
+  def self.find_all_by_name(name)
+    self.find(:all, :conditions => self.by_name_conditions(name))
+  end
+
+  # Helper methods
+  def address_lines
+    lines = [street_address, "#{postal_code} #{locality}"]
+
+    # Only return non-empty lines
+    lines.map {|line| line.strip unless (line.nil? or line.strip.empty?)}.compact
+  end
+
+  def full_address_lines
+    lines = [honorific_prefix, full_name] + address_lines
+
+    # Only return non-empty lines
+    lines.map {|line| line.strip unless (line.nil? or line.strip.empty?)}.compact
+  end
+
+  def contact_lines(separator = " ")
+    lines = contacts.map{|p| p.to_s unless (p.number.nil? or p.number.strip.empty?)}
+    
+    # Only return non-empty lines
+    lines.map {|line| line.strip unless (line.nil? or line.strip.empty?)}.compact
+  end
+
+  # Phone numbers
+  has_many :contacts, :class_name => 'PhoneNumber', :as => :object
+
+  has_many :phone_numbers, :class_name => 'PhoneNumber', :as => :object, :conditions => ["phone_number_type = ?", 'phone'], :after_add => :add_phone_number
+  def add_phone_number(number)
+      number.phone_number_type = 'phone'
+      number.save
+  end
+
+  def phone_number
+    phone_numbers.first
+  end
+  
+  def phone_number=(number)
+    phone_numbers.build(:number => number, :phone_number_type => 'phone')
+  end
+  
+  has_many :mobile_numbers, :class_name => 'PhoneNumber', :as => :object, :conditions => ["phone_number_type = ?", 'mobile'], :after_add => :add_mobile_number
+  def add_mobile_number(number)
+      number.phone_number_type = 'mobile'
+      number.save
+  end
+
+  def mobile_number
+    mobile_numbers.first
+  end
+  
+  def mobile_number=(number)
+    mobile_numbers.build(:number => number, :phone_number_type => 'mobile')
+  end
+  
+  has_many :fax_numbers, :class_name => 'PhoneNumber', :as => :object, :conditions => ["phone_number_type = ?", 'fax'], :after_add => :add_fax_number
+  def add_fax_number(number)
+      number.phone_number_type = 'fax'
+      number.save
+  end
+
+  def fax_number
+    fax_numbers.first
+  end
+  
+  def fax_number=(number)
+    fax_numbers.build(:number => number, :phone_number_type => 'fax')
+  end
+  
+  # Salutation
+  def salutation
+    case honorific_prefix
+    when 'Herr Dr. med.'
+      result = "Sehr geehrter Herr Dr. " + family_name
+    when 'Frau Dr. med.'
+      result = "Sehr geehrte Frau Dr. " + family_name
+    when 'Herr Dr.'
+      result = "Sehr geehrter Herr Dr. " + family_name
+    when 'Frau Dr.'
+      result = "Sehr geehrte Frau Dr. " + family_name
+    when 'Herr'
+      result = "Sehr geehrter Herr " + family_name
+    when 'Frau'
+      result = "Sehr geehrte Frau " + family_name
+    when 'Br.'
+      result = "Sehr geehrter Bruder " + family_name
+    when 'Sr.'
+      result = "Sehr geehrte Schwester " + family_name
+    else
+      result = "Sehr geehrte Damen und Herren"
+    end
+    return result
+  end
+end

data/lib/has_vcards/railtie.rb

@@ -0,0 +1,12 @@
+require 'has_vcards'
+require 'rails'
+
+module HasVcards
+  class Railtie < Rails::Engine
+    initializer :after_initialize do
+      ActionController::Base.helper HasVcardsHelper
+
+      ActiveRecord::Base.extend(HasVcardsClassMethods)
+    end
+  end
+end

data/lib/has_vcards.rb

@@ -0,0 +1,15 @@
+require 'has_vcards/railtie' if defined?(::Rails::Railtie)
+
+module HasVcardsClassMethods
+  def has_vcards(options = {})
+    class_eval <<-end_eval
+      scope :by_name, lambda {|name| {:include => :vcard, :order => 'vcards.full_name', :conditions => Vcard.by_name_conditions(name)}}
+
+      has_one :vcard, :as => 'object', :autosave => true, :validate => true
+      delegate :full_name, :nickname, :family_name, :given_name, :additional_name, :honorific_prefix, :honorific_suffix, :to => :vcard
+      delegate :full_name=, :nickname=, :family_name=, :given_name=, :additional_name=, :honorific_prefix=, :honorific_suffix=, :to => :vcard
+      
+      has_many :vcards, :as => 'object', :autosave => true, :validate => true
+    end_eval
+  end
+end

data/test/vcards_test.rb

@@ -0,0 +1,8 @@
+require 'test/unit'
+
+class VcardsTest < Test::Unit::TestCase
+  # Replace this with your real tests.
+  def test_this_plugin
+    flunk
+  end
+end

metadata

@@ -0,0 +1,94 @@
+--- !ruby/object:Gem::Specification 
+name: has_vcards
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 5
+  - 1
+  version: 0.5.1
+platform: ruby
+authors: 
+- "Simon H\xC3\xBCrlimann"
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-11-10 00:00:00 +01:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: activerecord
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: i18n
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id002
+description: Rails gem providing VCard like contact and address models and helpers.
+email: simon.huerlimann@cyt.ch
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.markdown
+files: 
+- MIT-LICENSE
+- README.markdown
+- Rakefile
+- app/helpers/has_vcards_helper.rb
+- app/models/address.rb
+- app/models/phone_number.rb
+- app/models/vcard.rb
+- lib/has_vcards.rb
+- lib/has_vcards/railtie.rb
+- test/vcards_test.rb
+has_rdoc: true
+homepage: http://github.com/huerlisi/has_vcards/tree/master
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: Rails gem providing VCard like contact and address models and helpers.
+test_files: 
+- test/vcards_test.rb