Vcard support extracted from Vpim
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
lib Version 0.2.15 Dec 1, 2016
test Fix incorrect scope of Vcard.configure and Vcard.configuration methods Nov 29, 2016
.gitignore ignore rvmc files Nov 30, 2012
.ruby-gemset
.ruby-version updated ruby version Sep 22, 2016
.travis.yml
Gemfile Explicitly install test-unit gem to fix failure on 2.2 and 2.3 Sep 22, 2016
LICENSE
README.md Update README.md Nov 21, 2016
Rakefile
vcard.gemspec changed license to GPL according to author's response Oct 2, 2013

README.md

Vcard Build Status

Vcard gem extracts Vcard support from Vpim gem.

Installation

Add this line to your application's Gemfile:

gem "vcard"

And then execute:

$ bundle

Or install it yourself as:

$ gem install vcard

Configuration

You can configure how to deal with invalid lines. The gem supports three behaviours:

  1. raise_on_invalid_line = true

Vcard::InvalidEncodingError will be raised if any invalid line is found.

  1. raise_on_invalid_line = false, ignore_invalid_vcards = true

If the vcard source has an invalid line, this vcard object will be ignored. If you have only one vcard object in your source string, an empty array will be returned from Vcard.decode.

  1. raise_on_invalid_line = false, ignore_invalid_vcards = false

If the vcard is marked as invalid, invalid fields will be ignored, but the vcard will be present in the results of Vcard#decode.

Vcard.configure do |config|
  config.raise_on_invalid_line = false # default true
  config.ignore_invalid_vcards = false # default true
end

Upgrade Notes

We are no longer testing against Ruby 1.8.7.