cardmagic / contacts
watch download tarball
public
Forks37Right
Watchers211Right
Description: A universal interface to import email contacts from various providers including Yahoo, Gmail, Hotmail, AOL and Plaxo.
Homepage: http://rubyforge.org/projects/contacts
Clone URL: git://github.com/cardmagic/contacts.git
Click here to lend your support to: contacts and make a donation at www.pledgie.com ! 
Bump to 1.0.18 - wqFix for Rails 2.3.4 - thanks Bill Kirtley
cardmagic (author)
Wed Oct 28 13:44:18 -0700 2009
commit  42b49ad5f5a9b0554f0560634fcf29e1a929a424
tree    9e347ac888153d1c7f92391c371c072840ed1b66
parent  b96b8ea7884fda5da08372899ae911e3e074ca57
contacts / README
100644 46 lines (27 sloc) 2.102 kb
raw blame history 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46

== Welcome to Contacts
 
Contacts is a universal interface to grab contact list information from various providers including Hotmail, Gmail and Yahoo.
 
== Download
 
* gem install contacts
* http://rubyforge.org/projects/contacts
* svn co svn://rubyforge.org/var/svn/contacts
 
== Background
 
For a long time, the only way to get a list of contacts from your free online email accounts was with proprietary PHP scripts that would cost you $50. The act of grabbing that list is a simple matter of screen scrapping and this library gives you all the functionality you need. Thanks to the generosity of the highly popular Rails website MOG (http://mog.com) for allowing this library to be released open-source to the world. It is easy to extend this library to add new free email providers, so please contact the author if you would like to help.
 
== Usage
 
	Contacts::Hotmail.new(login, password).contacts # => [["name", "foo@bar.com"], ["another name", "bow@wow.com"]]
	Contacts::Yahoo.new(login, password).contacts
	Contacts::Gmail.new(login, password).contacts
 
	Contacts.new(:gmail, login, password).contacts
	Contacts.new(:hotmail, login, password).contacts
	Contacts.new(:yahoo, login, password).contacts
 
	Contacts.guess(login, password).contacts
 
Notice there are three ways to use this library so that you can limit the use as much as you would like in your particular application. The Contacts.guess method will automatically concatenate all the address book contacts from each of the successful logins in the case that a username password works across multiple services.
 
== Examples
 
See the examples/ directory.
 
== Authors
 
* Lucas Carlson from MOG (mailto:lucas@rufy.com) - http://mog.com
 
== Contributors
 
* Britt Selvitelle from Twitter (mailto:anotherbritt@gmail.com) - http://twitter.com
* Tony Targonski from GigPark (mailto:tony@gigpark.com) - http://gigpark.com
* Waheed Barghouthi from Watwet (mailto:waheed.barghouthi@gmail.com) - http://watwet.com
* Glenn Sidney from Glenn Fu (mailto:glenn@glennfu.com) - http://glennfu.com
 
This library is released under the terms of the BSD.