• Stars
    star
    612
  • Rank 73,287 (Top 2 %)
  • Language
    Ruby
  • License
    BSD 3-Clause "New...
  • Created over 16 years ago
  • Updated about 2 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

A universal interface to import email contacts from various providers including Yahoo, Gmail, Hotmail, AOL and Plaxo.

Welcome to Contacts

Contacts is a universal interface to grab contact list information from various providers including Hotmail, AOL, Gmail, Plaxo and Yahoo.

Download

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", "[email protected]"], ["another name", "[email protected]"]]
   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.

Captcha error

If there are too many failed attempts with the gmail login info, Google will raise a captcha response. To integrate the captcha handling, pass in the token and response via:


  Contacts::Gmail.new(login, password, :captcha_token => params[:captcha_token], :captcha_response => params[:captcha_response]).contacts

Examples

See the examples/ directory.

Authors

Lucas Carlson from MOG (mailto:[email protected]) - http://mog.com

Contributors

This library is released under the terms of the BSD.

More Repositories

1

classifier

A general classifier module to allow Bayesian and LSI classifications.
Ruby
662
star
2

simple-rss

A simple, flexible, extensible, and liberal RSS and Atom reader for Ruby. It is designed to be backwards compatible with the standard RSS parser, but will never do RSS generation.
Ruby
222
star
3

shipping

An easy to use shipping API for Ruby. Shipping is used to calculate shipping costs, track orders and other shipping based processes through major shipping companies such as, UPS and Fedex, etc.
Ruby
44
star
4

starfish

Starfish is a utility to make distributed programming ridiculously easy
Ruby
41
star
5

payment

An easy to use payment gateway for Ruby. Payment is used to process credit cards and electronic cash through merchant accounts like Authorize.Net.
Ruby
20
star
6

lucash

A highly dynamic programming language/shell environment with data structures
Scheme
8
star
7

github-contest

Woot!
Ruby
8
star
8

dm-works

Fork of DataMapper 0.3 with patches to fix major show-stopping bugs
Ruby
5
star
9

PyAMF

Python AMF
Python
5
star
10

dm-www

The DataMapper Website
Ruby
3
star
11

dm-more

Extras for DataMapper, including bridges to DataObjects::Migrations and Merb::DataMapper
Ruby
3
star
12

do

DataObjects
Ruby
3
star
13

dm-core

DataMapper - Core
Ruby
3
star
14

tesh

A highly dynamic shell/programming language environment with data structures written in Crystal
Crystal
3
star
15

standard_failure

A rails plugin for handling standard failures in an app
Ruby
2
star
16

copypaste

CopyPaste provides rcopy, rcut, rpaste unix tools that interact with a central queue server through the memcached protocol
Ruby
2
star
17

lucas-panamax-templates

1
star
18

kamalx

KamalX is a command-line tool that enhances the user experience of the kamal deploy tool from Basecamp by making it more user-friendly and easier to watch and understand.
Ruby
1
star