contact_sport 1.0.0

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in contact_sport.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Andy Stewart
+
+MIT License
+
+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.md

@@ -0,0 +1,65 @@
+# ContactSport
+
+Simple importing of contacts from Outlook and vCard.
+
+`ContactSport` provides a simple way to read contacts exported from Outlook or vCard files.  It came about because I needed to enable users of a webapp to import contacts from their existing desktop address books and email clients.
+
+Outlook contacts should be exported as [Comma Separated Values (Windows)][outlook].
+
+vCards can be exported from most other address books or email clients.  Here are [instructions for Apple's Address Book][osx].
+
+
+## Usage
+
+There is precisely one method in the API:
+
+Assuming `contacts_file` is the name and path of your contacts file:
+
+```ruby
+ContactSport.contacts(contacts_file)
+```
+
+This returns an array of contacts, where a contact is an object responding to:
+
+```ruby
+:first_name
+:last_name
+:name
+:email
+:url
+:office_phone
+:mobile_phone
+:fax
+:company
+:address1
+:address2
+:city
+:region
+:postcode
+:country
+```
+
+All responses are strings.  If a value is not set (e.g. a contact has no fax number) an empty string is returned.
+
+Where there are work and home values, e.g. a work phone and a home phone, `ContactSport` will prefer the work phone.
+
+
+## Installation
+
+    $ gem install contact_sport
+
+The code requires Ruby 1.9.
+
+
+## Intellectual Property
+
+Copyright [Andrew Stewart][boss], AirBlade Software Ltd.
+
+Released under the MIT licence.
+
+
+  [outlook]: http://office.microsoft.com/en-us/outlook-help/export-contacts-HA101870639.aspx
+  [osx]: http://support.apple.com/kb/PH4655
+  [contact_csv]: https://github.com/mwhuss/contact_csv
+  [contactgems]: https://rubygems.org/search?query=contact
+  [boss]: mailto:boss@airbladesoftware.com

data/Rakefile

@@ -0,0 +1,8 @@
+require 'bundler/gem_tasks'
+require 'rake/testtask'
+
+Rake::TestTask.new do |t|
+  t.libs << 'lib' << 'test'
+  t.test_files = FileList['test/*_test.rb']
+  t.verbose = true
+end

data/contact_sport.gemspec

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'contact_sport/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "contact_sport"
+  gem.version       = ContactSport::VERSION
+  gem.authors       = ["Andy Stewart"]
+  gem.email         = ["boss@airbladesoftware.com"]
+  gem.description   = 'Simple importing of contacts from Outlook and vCard.'
+  gem.summary       = gem.description
+  gem.homepage      = ""
+
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+
+  gem.add_dependency 'vcard', '~> 0.2'
+  
+  gem.add_development_dependency 'rake', '~> 0.9.2'
+end

data/lib/contact_sport/contact.rb

@@ -0,0 +1,8 @@
+require 'ostruct'
+
+module ContactSport
+
+  class Contact < OpenStruct
+  end
+
+end

data/lib/contact_sport/encoding.rb

@@ -0,0 +1,25 @@
+module ContactSport
+  module Encoding
+    
+    # https://github.com/Manfred/Ensure-encoding/blob/master/lib/ensure/encoding.rb
+    # https://github.com/oleander/rchardet/blob/master/lib/rchardet/universaldetector.rb
+    BYTE_ORDER_MARKS = {
+      ::Encoding::UTF_32BE => [0x00, 0x00, 0xfe, 0xff],
+      ::Encoding::UTF_32LE => [0xff, 0xfe, 0x00, 0x00],
+      ::Encoding::UTF_8    => [0xef, 0xbb, 0xbf],
+      ::Encoding::UTF_16BE => [0xfe, 0xff],
+      ::Encoding::UTF_16LE => [0xff, 0xfe],
+    }
+
+    FALLBACK_ENCODING = ::Encoding::ISO_8859_1
+
+    # Guesses the encoding of the given file.
+    def self.guess_encoding(file)
+      # First look for a byte order mark (BOM).
+      first_bytes = IO.read(file, 4).bytes.to_a
+      bom = BYTE_ORDER_MARKS.detect { |encoding, bytes| first_bytes[0...bytes.length] == bytes }
+      bom ? bom.first : FALLBACK_ENCODING
+    end
+
+  end
+end

data/lib/contact_sport/outlook_reader.rb

@@ -0,0 +1,145 @@
+require 'csv'
+require 'contact_sport/contact'
+require 'contact_sport/encoding'
+
+module ContactSport
+
+  # To read an Outlook "Comma Separated Values (Windows)" file we need to guess:
+  #
+  # * the file's encoding
+  # * the column separator
+  # * the column headings
+  #
+  # These all vary by Outlook version, platform, and phase of the moon.
+  #
+  # Some example contact headings are given here:
+  #
+  # * http://stackoverflow.com/questions/4847596/what-are-the-csv-headers-in-outlook-contact-export
+  # * http://lists.lrug.org/pipermail/chat-lrug.org/2013-February/008474.html
+  class OutlookReader
+    attr_reader :file, :file_encoding, :column_separator
+
+    def initialize(file)
+      @file = file
+      @file_encoding = ContactSport::Encoding.guess_encoding file
+      @column_separator = guess_column_separator
+    end
+
+    def contacts
+      begin
+        @contacts ||= begin
+          results = []
+          CSV.foreach(file, headers: true,
+                            col_sep: column_separator,
+                            encoding: "#{file_encoding.to_s}:UTF-8") do |row|
+            # Headers:
+            results << Contact.new(
+              first_name:    first_name(row),
+              last_name:     last_name(row),
+              name:          name(row),
+
+              email:         email(row),
+              url:           web_page(row),
+
+              company:       company(row),
+              office_phone:  office_phone(row),
+              mobile_phone:  mobile_phone(row),
+              fax:           fax(row),
+
+              address1:      street(row),
+              address2:      street2(row),
+              city:          city(row),
+              region:        state(row),
+              postcode:      postcode(row),
+              country:       country(row)
+            )
+          end
+          results
+        end
+      rescue EncodingError => e
+        raise ContactSport::EncodingError, e.message
+      rescue StandardError => e
+        raise ContactSport::FormatError, e.message
+      end
+    end
+
+    private
+
+    def guess_column_separator
+      first_line  = File.open file, encoding: "#{file_encoding.to_s}:UTF-8", &:readline
+      comma_count = first_line.count ','
+      tab_count   = first_line.count '\t'
+      comma_count > tab_count ? ',' : "\t"
+    end
+
+    def find_first(row, *fields)
+      fields.each do |field|
+        if result = row[field]
+          return result
+        end
+      end
+      EMPTY_FIELD
+    end
+
+    def first_name(row)
+      find_first row, 'First Name'
+    end
+
+    def last_name(row)
+      find_first row, 'Last Name'
+    end
+
+    def street(row)
+      find_first row, 'Business Street', 'Home Street', 'Work Street Address', 'Home Street Address'
+    end
+
+    def street2(row)
+      find_first row, 'Business Street 2', 'Home Street 2', 'Work Street Address 2', 'Home Street Address 2'
+    end
+
+    def city(row)
+      find_first row, 'Business City', 'Home City', 'Work City'
+    end
+
+    def state(row)
+      find_first row, 'Business State', 'Home State', 'Work State'
+    end
+
+    def postcode(row)
+      find_first row, 'Business Postal Code', 'Home Postal Code', 'Work Zip', 'Home Zip'
+    end
+
+    def country(row)
+      find_first row, 'Business Country', 'Home Country', 'Business Country/Region', 'Work Country/Region', 'Home Country/Region'
+    end
+
+    def fax(row)
+      find_first row, 'Business Fax', 'Work Fax', 'Home Fax'
+    end
+
+    def web_page(row)
+      find_first row, 'Web Page'
+    end
+
+    def email(row)
+      find_first row, 'E-mail Address', 'Email Address 1'
+    end
+
+    def office_phone(row)
+      find_first row, 'Work Phone 1', 'Home Phone 1', 'Business Phone', 'Home Phone'
+    end
+
+    def mobile_phone(row)
+      find_first row, 'Mobile Phone'
+    end
+
+    def company(row)
+      find_first row, 'Company'
+    end
+
+    def name(row)
+      [ row['First Name'], row['Last Name'] ].compact.join(' ') || EMPTY_FIELD
+    end
+  end
+
+end

data/lib/contact_sport/vcard_reader.rb

@@ -0,0 +1,97 @@
+require 'vcard'
+require 'contact_sport/contact'
+
+module ContactSport
+
+  class VcardReader
+    attr_reader :file
+
+    def initialize(file)
+      @file = file
+    end
+
+    def contacts
+      begin
+        @contacts ||= Vcard::Vcard.decode(contents).map do |card|
+          Contact.new(
+            first_name:    card.name.given,
+            last_name:     card.name.family,
+            name:          card.name.fullname,
+
+            email:         email(card),
+            url:           url(card),
+
+            company:       company(card),
+            office_phone:  work_phone(card),
+            mobile_phone:  mobile_phone(card),
+            fax:           fax(card),
+
+            address1:      address_first_line(card),
+            address2:      address_second_line(card),
+            city:          address(:locality, card),
+            region:        address(:region, card),
+            postcode:      address(:postalcode, card),
+            country:       address(:country, card)
+          )
+        end
+      rescue Vcard::InvalidEncodingError, Vcard::UnsupportedError, Vcard::Unencodeable => e
+        raise ContactSport::FormatError, e.message
+      end
+    end
+
+    private
+
+    def contents
+      File.read file
+    end
+
+    def company(card)
+      card.org ? card.org.first : EMPTY_FIELD
+    end
+
+    def address(field, card)
+      card.address ? card.address.send(field) : EMPTY_FIELD
+    end
+
+    def address_first_line(card)
+      if card.address && card.address.street
+        card.address.street.split("\n").first
+      else
+        EMPTY_FIELD
+      end
+    end
+
+    def address_second_line(card)
+      if card.address && card.address.street
+        card.address.street.split("\n")[1..-1].join "\n"
+      else
+        EMPTY_FIELD
+      end
+    end
+
+    def email(card)
+      card.email ? card.email.to_s : EMPTY_FIELD
+    end
+
+    def url(card)
+      card.url ? card.url.uri.sub('http\\','http') : EMPTY_FIELD
+    end
+
+    def work_phone(card)
+      tel = card.telephones.detect { |t| t.location.any? { |l| l =~ /work/i } } || card.telephone
+      tel ? tel.to_s : EMPTY_FIELD
+    end
+
+    def mobile_phone(card)
+      tel = card.telephones.detect { |t| t.location.any? { |l| l =~ /cell/i } }
+      tel ? tel.to_s : EMPTY_FIELD
+    end
+
+    def fax(card)
+      fax = card.telephones.detect { |t| t.capability.any? { |c| c =~ /fax/i } }
+      fax ? fax.to_s : EMPTY_FIELD
+    end
+
+  end
+
+end

data/lib/contact_sport/version.rb

@@ -0,0 +1,3 @@
+module ContactSport
+  VERSION = '1.0.0'
+end

data/lib/contact_sport.rb

@@ -0,0 +1,32 @@
+require "contact_sport/version"
+require 'contact_sport/vcard_reader'
+require 'contact_sport/outlook_reader'
+
+module ContactSport
+
+  # Raised when a contacts file doesn't appear to be Outlook CSV or vCard.
+  UnknownProviderError = Class.new RuntimeError
+
+  # Raised when a contacts file cannot be parsed.
+  FormatError = Class.new RuntimeError
+
+  # Raised when a contacts file is in an unknown encoding.
+  EncodingError = Class.new RuntimeError
+
+  EMPTY_FIELD = ''
+  
+  def self.contacts(file)
+    reader(file).contacts
+  end
+
+  private
+
+  def self.reader(file)
+    case File.extname(file)
+    when /[.]vcf$/i; VcardReader.new(file)
+    when /[.]csv$/i; OutlookReader.new(file)
+    else raise UnknownProviderError
+    end
+  end
+
+end

data/test/fixtures/iso_8859_1_commas.csv

@@ -0,0 +1,5 @@
+"Title","First Name","Middle Name","Last Name","Suffix","Company","Department","Job Title","Business Street","Business Street 2","Business Street 3","Business City","Business State","Business Postal Code","Business Country/Region","Home Street","Home Street 2","Home Street 3","Home City","Home State","Home Postal Code","Home Country/Region","Other Street","Other Street 2","Other Street 3","Other City","Other State","Other Postal Code","Other Country/Region","Assistant's Phone","Business Fax","Business Phone","Business Phone 2","Callback","Car Phone","Company Main Phone","Home Fax","Home Phone","Home Phone 2","ISDN","Mobile Phone","Other Fax","Other Phone","Pager","Primary Phone","Radio Phone","TTY/TDD Phone","Telex","Account","Anniversary","Assistant's Name","Billing Information","Birthday","Business Address PO Box","Categories","Children","Directory Server","E-mail Address","E-mail Type","E-mail Display Name","E-mail 2 Address","E-mail 2 Type","E-mail 2 Display Name","E-mail 3 Address","E-mail 3 Type","E-mail 3 Display Name","Gender","Government ID Number","Hobby","Home Address PO Box","Initials","Internet Free Busy","Keywords","Language","Location","Manager's Name","Mileage","Notes","Office Location","Organizational ID Number","Other Address PO Box","Priority","Private","Profession","Referred By","Sensitivity","Spouse","User 1","User 2","User 3","User 4","Web Page"
+"","Bruce","","Wayne",,"Wayne Enterprises",,,"1st Floor","1 High Street",,"London","Middlesex","W1 1AB","United Kingdom",,,,,,,,,,,,,,,,"020 7123 4560","020 7123 4567",,,,,,,,,"07979 797 979",,,,,,,,,,,,,,,,,"b.wayne@example.com","SMTP",,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,"http://example.com"
+"","James","","Bond",,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,""
+"","Clarke","","Kent",,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,"
+",,,,,,,,,""

data/test/fixtures/vcards.vcf

@@ -0,0 +1,26 @@
+BEGIN:VCARD
+VERSION:3.0
+N:;;;;
+FN:Wayne Enterprises
+ORG:Wayne Enterprises;
+EMAIL;type=INTERNET;type=WORK;type=pref:info@wayneenterprises.com
+X-ABShowAs:COMPANY
+CATEGORIES:Test
+X-ABUID:C9C08B97-1889-4D67-9595-C12482BF3B5F\:ABPerson
+END:VCARD
+BEGIN:VCARD
+VERSION:3.0
+N:Wayne;Bruce;;;
+FN:Bruce Wayne
+ORG:Wayne Enterprises;
+EMAIL;type=INTERNET;type=WORK;type=pref:bruce@wayneenterprises.com
+TEL;type=WORK;type=pref:+44 20 7123 4567
+TEL;type=CELL:07777 999 888
+TEL;type=HOME;type=FAX:+44 20 71234 4560
+item1.ADR;type=WORK;type=pref:;;The Batcave;Gotham;NY;90210;USA
+item1.X-ABADR:gb
+item2.URL;type=pref:www.batman.com
+item2.X-ABLabel:_$!<HomePage>!$_
+CATEGORIES:Test
+X-ABUID:3852D6F6-6DDB-441C-8CE7-6594B0112C3D\:ABPerson
+END:VCARD

data/test/outlook_reader_test.rb

@@ -0,0 +1,74 @@
+require 'minitest/autorun'
+require 'test_helper'
+require 'contact_sport'
+
+class OutlookReaderTest < MiniTest::Unit::TestCase
+
+  def test_iso_8859_1_commas
+    contacts = ContactSport.contacts fixture('iso_8859_1_commas.csv')
+    assert_equal 3, contacts.length
+    
+    contact = contacts.shift
+    assert_equal 'Bruce',               contact.first_name
+    assert_equal 'Wayne',               contact.last_name
+    assert_equal 'Bruce Wayne',         contact.name
+    assert_equal 'b.wayne@example.com', contact.email
+    assert_equal 'http://example.com',  contact.url
+    assert_equal '020 7123 4567',       contact.office_phone
+    assert_equal '07979 797 979',       contact.mobile_phone
+    assert_equal '020 7123 4560',       contact.fax
+    assert_equal 'Wayne Enterprises',   contact.company
+    assert_equal '1st Floor',           contact.address1
+    assert_equal '1 High Street',       contact.address2
+    assert_equal 'London',              contact.city
+    assert_equal 'Middlesex',           contact.region
+    assert_equal 'W1 1AB',              contact.postcode
+    assert_equal 'United Kingdom',      contact.country
+    
+    contact = contacts.shift
+    assert_equal 'James Bond',  contact.name
+    
+    contact = contacts.shift
+    assert_equal 'Clarke Kent',  contact.name
+  end
+
+  def test_utf_16_le_tabs
+    contacts = ContactSport.contacts fixture('utf_16_le_tabs.csv')
+    assert_equal 6, contacts.length
+    
+    contact = contacts.shift
+    assert_equal 'Andrew',                contact.first_name
+    assert_equal 'Stewart',               contact.last_name
+    assert_equal 'Andrew Stewart',        contact.name
+    assert_equal 'andrew@home.de',        contact.email
+    assert_equal 'http://www.mcdonalds.com/staff/Andrew', contact.url
+    assert_equal '4420812345',            contact.office_phone
+    assert_equal '49123456789',           contact.mobile_phone
+    assert_equal '',                      contact.fax
+    assert_equal 'McDonalds Corporation', contact.company
+    assert_equal '1 Leicester Square',    contact.address1
+    assert_equal '',                      contact.address2
+    assert_equal 'London',                contact.city
+    assert_equal '',                      contact.region
+    assert_equal 'WC1A 1AA',              contact.postcode
+    assert_equal '',                      contact.country
+
+    contact = contacts.pop
+    assert_equal '',                      contact.first_name
+    assert_equal '',                      contact.last_name
+    assert_equal '',                      contact.name
+    assert_equal 'info@mcdonalds.com',    contact.email
+    assert_equal 'http://www.mcdonalds.com', contact.url
+    assert_equal '',                      contact.office_phone
+    assert_equal '',                      contact.mobile_phone
+    assert_equal '800234567',             contact.fax
+    assert_equal 'McDonalds Corporation', contact.company
+    assert_equal '1 Canary Wharf',        contact.address1
+    assert_equal '',                      contact.address2
+    assert_equal 'London',                contact.city
+    assert_equal 'E1 1AA',                contact.region    # data-entry mistake
+    assert_equal '',                      contact.postcode  # data-entry mistake
+    assert_equal '',                      contact.country
+  end
+
+end

data/test/test_helper.rb

@@ -0,0 +1,7 @@
+class MiniTest::Unit::TestCase
+
+  def fixture(filename)
+    File.expand_path "../fixtures/#{filename}", __FILE__
+  end
+
+end

data/test/vcard_reader_test.rb

@@ -0,0 +1,45 @@
+require 'minitest/autorun'
+require 'test_helper'
+require 'contact_sport'
+
+class VcardReaderTest < MiniTest::Unit::TestCase
+
+  def test_foo
+    contacts = ContactSport.contacts fixture('vcards.vcf')
+    assert_equal 2, contacts.length
+
+    contact = contacts.shift
+    assert_equal '', contact.first_name
+    assert_equal '', contact.last_name
+    assert_equal 'Wayne Enterprises',         contact.name
+    assert_equal 'info@wayneenterprises.com', contact.email
+    assert_equal '', contact.url
+    assert_equal '', contact.office_phone
+    assert_equal '', contact.mobile_phone
+    assert_equal '', contact.fax
+    assert_equal 'Wayne Enterprises',         contact.company
+    assert_equal '', contact.address1
+    assert_equal '', contact.address2
+    assert_equal '', contact.city
+    assert_equal '', contact.region
+    assert_equal '', contact.postcode
+    assert_equal '', contact.country
+
+    contact = contacts.shift
+    assert_equal 'Bruce',                      contact.first_name
+    assert_equal 'Wayne',                      contact.last_name
+    assert_equal 'Bruce Wayne',                contact.name
+    assert_equal 'bruce@wayneenterprises.com', contact.email
+    assert_equal 'www.batman.com',             contact.url
+    assert_equal '+44 20 7123 4567',           contact.office_phone
+    assert_equal '07777 999 888',              contact.mobile_phone
+    assert_equal '+44 20 71234 4560',          contact.fax
+    assert_equal 'Wayne Enterprises',          contact.company
+    assert_equal 'The Batcave',                contact.address1
+    assert_equal '',                           contact.address2
+    assert_equal 'Gotham',                     contact.city
+    assert_equal 'NY',                         contact.region
+    assert_equal '90210',                      contact.postcode
+    assert_equal 'USA',                        contact.country
+  end
+end

metadata

@@ -0,0 +1,107 @@
+--- !ruby/object:Gem::Specification
+name: contact_sport
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+  prerelease: 
+platform: ruby
+authors:
+- Andy Stewart
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-02-25 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: vcard
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.2'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.2
+description: Simple importing of contacts from Outlook and vCard.
+email:
+- boss@airbladesoftware.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- contact_sport.gemspec
+- lib/contact_sport.rb
+- lib/contact_sport/contact.rb
+- lib/contact_sport/encoding.rb
+- lib/contact_sport/outlook_reader.rb
+- lib/contact_sport/vcard_reader.rb
+- lib/contact_sport/version.rb
+- test/fixtures/iso_8859_1_commas.csv
+- test/fixtures/utf_16_le_tabs.csv
+- test/fixtures/vcards.vcf
+- test/outlook_reader_test.rb
+- test/test_helper.rb
+- test/vcard_reader_test.rb
+homepage: ''
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -3767443409390475510
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -3767443409390475510
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: Simple importing of contacts from Outlook and vCard.
+test_files:
+- test/fixtures/iso_8859_1_commas.csv
+- test/fixtures/utf_16_le_tabs.csv
+- test/fixtures/vcards.vcf
+- test/outlook_reader_test.rb
+- test/test_helper.rb
+- test/vcard_reader_test.rb