graybook 1.0.24 → 1.1.0

data/README.md

@@ -1,66 +0,0 @@
-Graybook
-
-== Description:
-  
-Pulls contact lists from EVERYWHERE! (Some sites not included.)
-
-== Features:
-  
-The current list of supported services and file types:
-
-import:
-- AOL
-- CSV files
-- Gmail
-- Hotmail
-- Yahoo! Mail
-
-export:
-- Simple hash (default)
-- JSON (soon)
-
-If you create an additional importer or exporter - or simply find a bug - please consider submitting it as a patch to the project so the community can all benefit from your hard work and ingenuity. 
-
-== Synopsis:
-
-# An example of fetching Gmail contacts - by default, returns an array of hashes with :name and :email
-  contacts = Graybook.get :username => 'me@gmail.com', :password => 'whatever'
-
-== Requirements:
-
-* Mechanize and its dependencies, for interacting with online providers
-* Fastercsv for reading CSV, Mechanize >= 0.7.0 for page scraping
-
-== Install:
-
-1. gem install gemcutter
-1. gem tumble
-2. gem install graybook
-
-== Thanks:
-
-Big thanks to Contentfree for making Blackbook.
-
-== License:
-
-Copyright (c) 2009, kojul.com
-Copyright (c) 2007, Contentfree
-
-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/debug_graybook.rb

@@ -1,10 +0,0 @@
-require 'graybook'
-
-aol = Graybook.get :username => 'mondragonmichael@aol.com', :password => '123aol0'
-puts "===== aol #{aol.inspect}"
-
-unless aol.detect{|c| c[:name].downcase == 'Dave Myron'.downcase && c[:email] == 'dave.myron@contentfree.com'}
-  puts "AOL not working"
-  exit 1
-end
-

data/lib/graybook/exporter/vcf.rb

@@ -1,45 +0,0 @@
-##
-# exports contacts in Vcard format
-class Graybook::Exporter::Vcf < Graybook::Exporter::Base
-
-  ##
-  # representation of a vcard
-
-  class Vcard
-
-    attr_accessor :first, :last, :email
-    
-    ##
-    # initialize dynamically sets the attributes passed in as accessible 
-    # attribute on its object
-
-    def initialize( attributes = {} )
-      attributes.each{ |name,value| self.send("#{name}=", value) rescue next }
-    end
-    
-    ##
-    # text representation of this vcard
-    def to_s
-      <<-EOVC
-BEGIN:VCARD
-N:#{last};#{first}
-EMAIL:#{email}
-END:VCARD
-      EOVC
-    end
-  end
-
-  ##
-  # exports contacts as Vcards
-
-  def export( contacts = [] )
-    return if contacts.empty? 
-    
-    contacts.uniq.compact.collect do |contact|
-      first_name, last_name = contact[:name].split(' ', 2)
-      Vcard.new( :first => first_name.to_s, :last => last_name.to_s, :email => contact[:email])
-    end
-  end
-  
-  Graybook.register(:vcf, self)
-end

data/lib/graybook/exporter/xml.rb

@@ -1,28 +0,0 @@
-require 'rexml/document'
-
-##
-# exports contacts in xml format
-
-class Graybook::Exporter::Xml < Graybook::Exporter::Base
-
-  ##
-  # contacts are an array of hashes that are contacts and returns xml
-
-  def export( contacts )
-    doc = REXML::Document.new
-    doc << REXML::XMLDecl.new
-    
-    root = doc.add_element 'contacts'
-    contacts.each do |contact|
-      el = root.add_element 'contact'
-      name = el.add_element 'name' 
-      name.text = contact[:name]
-      
-      el.add_element('email').text = contact[:email]
-    end
-    
-    doc.to_s
-  end
-  
-  Graybook.register(:xml, self)
-end

data/lib/graybook/importer/csv.rb

@@ -1,74 +0,0 @@
-require 'fastercsv'
-
-##
-# Imports contacts from a CSV file
-
-class Graybook::Importer::Csv < Graybook::Importer::Base
-
-  DEFAULT_COLUMNS = [:name,:email,:misc]
-  DEFAULT_PATTERN = /,/
-
-  ##
-  # Matches this importer to a file that contains CSV values
-
-  def =~(options)
-    options && options[:file].respond_to?(:open) ? true : false
-  end
-
-  ##
-  # fetch_contacts! implementation for this importer
-
-  def fetch_contacts!
-    lines   = IO.readlines(options[:file].path)
-    columns = to_columns(lines.first)
-    lines.shift if columns.first == :name
-    columns = DEFAULT_COLUMNS.dup unless columns.first == :name
-
-    contacts = Array.new
-    lines.each do |l|
-      vals = l.split(pattern)
-      next if vals.empty?
-      vals.map! {|x| x.gsub( /\A"/m, "" ).strip.gsub( /"\Z/m, "" ) }
-      contacts << to_hash(columns, vals)
-    end
-
-    contacts
-  end
-
-  def to_hash(cols, vals) # :nodoc:
-    h = Hash.new
-    cols.each do |c|
-      h[c] = (c == cols.last) ? vals.join(',') : vals.shift
-    end
-    h
-  end
-
-  def to_columns(line) # :nodoc:
-    columns = Array.new
-    if line.match(pattern)
-      tags = line.split(pattern)
-    else
-      tags = line.split(DEFAULT_PATTERN)
-    end
-    # deal with "Name,E-mail..." oddity up front
-    if tags.first =~ /^name$/i
-      tags.shift
-      columns << :name
-      if tags.first =~ /^e.?mail/i # E-mail or Email
-        tags.shift
-        columns << :email
-      end
-    end
-    tags.each do |v|
-      v = v.to_s.gsub(/\0/,"")
-      columns << v.strip.to_sym unless v.blank?
-    end
-    columns
-  end
-  
-  def pattern
-    @pattern ||= (options[:pattern] || DEFAULT_PATTERN) rescue DEFAULT_PATTERN
-  end
-
-  Graybook.register(:csv, self)
-end

data/lib/graybook/importer/freenet.rb

@@ -1,62 +0,0 @@
-require 'graybook/importer/page_scraper'
-
-class Graybook::Importer::Freenet < Graybook::Importer::PageScraper
-  LOGIN_URL = "https://office.freenet.de"
-  MESSAGES_URL = "/main_overview.html"
-
-  def =~( options )
-    options && options[:username] =~ /@freenet\.de$/i
-  end
-
-  def login
-    username, password = options[:username], options[:password]
-
-    begin
-      page = agent.get LOGIN_URL
-
-      form = page.forms.with.name("loginform").first
-      form.username = username.split("@").first
-      form.password = password
-      page = form.submit
-
-      if page.body.match(/Fehlgeschlagene Login-Versuche/)
-        page = page.forms.with.name("sicherform").submit
-        page = agent.get MESSAGES_URL
-      end
-
-      if page.body.match(/Login (erneut )?fehlgeschlagen/) || page.body.match(/Ich bin bereits Mitglied/)
-        raise Graybook::BadCredentialsError.new
-      end
-    rescue => e
-      raise e || Graybook::GraybookError.new
-    end
-  end
-
-  def prepare
-    login
-  end
-
-  def scrape_contacts
-    contacts = ["INBOX", "INBOX.sent"].map do |folder|
-      page = agent.get "/messages/mail_mailbox.html?mail_folder=#{folder}"
-      find_contacts(page)
-    end
-
-    contacts.inject([]) do |memo, contact|
-      memo << contact unless memo.include? contact
-      memo
-    end.flatten
-  end
-
-
-  protected
-    def find_contacts(page)
-      page.search("tr[@id]/td[9]").map do |cell|
-        recp, fullname, email = *cell.attributes["title"].match(/"(.*)"<(.*)>/)
-
-        { :name => fullname, :email => email }
-      end
-    end
-
-    Graybook.register :freenet, self
-end

data/lib/graybook/importer/gmx.rb

@@ -1,68 +0,0 @@
-require 'graybook/importer/page_scraper'
-
-class Graybook::Importer::GMX < Graybook::Importer::PageScraper
-  LOGIN_URL = "https://www.gmx.net/"
-
-  def =~( options )
-    options && options[:username] =~ /@gmx\.(de|net)$/i
-  end
-
-  def login
-    username, password = options[:username], options[:password]
-
-    begin
-      page = agent.get LOGIN_URL
-
-      form = page.forms.with.name("login").first
-      form.id = username
-      form.p = password
-      page = form.submit
-      @next = page
-
-      if (page.at("div.index") && page.at("div.index").inner_html == "Passwort vergessen?") ||
-        page.uri.to_s.match(/login-failed/)
-        raise Graybook::BadCredentialsError.new
-      end
-    rescue => e
-      raise e || Graybook::GraybookError.new
-    end
-  end
-
-  def prepare
-    login
-  end
-
-  def scrape_contacts
-    page = @next
-
-    # Go to E-Mails
-    page = page.links.select { |link| link.text =~ /E-Mail/ }.first.click
-
-    contacts = [/Posteingang/, /Archiv/, /Gesendet/].map do |folder|
-      # puts "folder: #{folder}"
-      # puts "page title: #{page.title}"
-      # puts "page links: #{page.links.select { |link| link.text =~ folder }}"
-      page = page.links.select { |link| link.text =~ folder }.first.click
-      find_contacts(page)
-    end
-
-    contacts.inject([]) do |memo, contact|
-      memo << contact unless memo.include? contact
-      memo
-    end.flatten
-  end
-
-  protected
-
-    def find_contacts(page)
-      links = page.search("form#MI a").select { |link| link.attributes["title"] =~ /@/ }
-      links.map do |link|
-        recp = link.attributes["title"].gsub(/\n/, "").split(/\s/)
-        email = recp.pop.gsub(/[<>]/, "")
-        fullname = recp.join(" ")
-
-        { :name => fullname, :email => email }
-      end
-    end
-    Graybook.register :gmx, self
-end

data/lib/graybook/importer/web.de.rb

@@ -1,67 +0,0 @@
-require 'graybook/importer/page_scraper'
-
-class Graybook::Importer::WebDE < Graybook::Importer::PageScraper
-  LOGIN_URL = "https://freemail.web.de"
-
-  def =~( options )
-    options && options[:username] =~ /@web\.de$/i
-  end
-
-  def login
-    username, password = options[:username], options[:password]
-
-    begin
-      page = agent.get LOGIN_URL
-
-      form = page.forms.with.name("login").first
-      form.username = username
-      form.password = password
-
-      page = form.submit
-      # follow logout hint
-      if (continue_link = page.links.select { |link| link.text =~ /weiter zu FreeMail/ }.first)
-        page = continue_link.click
-      end
-
-      if page.uri.to_s.match(/logonfailed/)
-        raise Graybook::BadCredentialsError.new
-      end
-
-      # follow content frame
-      @next = agent.get page.frames[1].src
-    rescue => e
-      raise e || Graybook::GraybookError.new
-    end
-  end
-
-  def prepare
-    login
-  end
-
-  def scrape_contacts
-    page = @next
-
-    contacts = [/Posteingang/, /Unbekannt/].map do |folder|
-      page = page.links.select { |link| link.text =~ folder }.first.click
-      find_contacts(page)
-    end
-
-    contacts.inject([]) do |memo, contact|
-      memo << contact unless memo.include? contact
-      memo
-    end
-  end
-
-  protected
-    def find_contacts(page)
-      page.search("span.from a").map do |link|
-        recp = link.attributes["title"].gsub(/\n/, "").split(/\s/)
-        email = recp.pop
-        fullname = recp.join(" ")
-
-        { :name => fullname, :email => email }
-      end
-    end
-
-    Graybook.register :webde, self
-end

data/test/config/credentials.yml.example

@@ -1,9 +0,0 @@
-gmx:
-  username: nil
-  password: nil
-freenet:
-  username: nil
-  password: nil
-webde:
-  username: nil
-  password: nil