kulesa-contacts 0.2.6

data/.gitmodules

@@ -0,0 +1,3 @@
+[submodule "vendor/fakeweb"]
+	path = vendor/fakeweb
+	url = git://github.com/mislav/fakeweb.git

data/Gemfile

@@ -0,0 +1,15 @@
+source "http://rubygems.org"
+gem "httparty"
+gem "hpricot"
+gem "nokogiri"
+gem "oauth", "0.4.0"
+gem "json"
+
+group :development do
+  gem "rspec", "~> 2.1.0"
+  gem "bundler", "~> 1.0.0"
+  gem "jeweler", "~> 1.5.1"
+  gem "rcov", ">= 0"
+  gem "mocha"
+  gem "fakeweb"
+end

data/Gemfile.lock

@@ -0,0 +1,51 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    crack (0.1.8)
+    diff-lcs (1.1.2)
+    fakeweb (1.3.0)
+    git (1.2.5)
+    hpricot (0.8.4)
+    hpricot (0.8.4-java)
+    httparty (0.7.7)
+      crack (= 0.1.8)
+    jeweler (1.5.2)
+      bundler (~> 1.0.0)
+      git (>= 1.2.5)
+      rake
+    json (1.5.1)
+    json (1.5.1-java)
+    mocha (0.9.12)
+    nokogiri (1.4.4)
+    nokogiri (1.4.4-java)
+      weakling (>= 0.0.3)
+    oauth (0.4.0)
+    rake (0.8.7)
+    rcov (0.9.9)
+    rcov (0.9.9-java)
+    rspec (2.1.0)
+      rspec-core (~> 2.1.0)
+      rspec-expectations (~> 2.1.0)
+      rspec-mocks (~> 2.1.0)
+    rspec-core (2.1.0)
+    rspec-expectations (2.1.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.1.0)
+    weakling (0.0.4-java)
+
+PLATFORMS
+  java
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.0.0)
+  fakeweb
+  hpricot
+  httparty
+  jeweler (~> 1.5.1)
+  json
+  mocha
+  nokogiri
+  oauth (= 0.4.0)
+  rcov
+  rspec (~> 2.1.0)

data/LICENSE

@@ -0,0 +1,18 @@
+Copyright (c) 2009 Mislav Marohnić
+
+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.markdown

@@ -0,0 +1,111 @@
+## Contacts
+
+Fetch users' contact lists without asking them to provide their
+passwords, as painlessly as possible.
+
+Contacts provides adapters for:
+
+ * Google
+ * Yahoo!
+ * Windows Live
+
+## Basic usage instructions
+
+First, register your application with the service providers you
+require. Instructions below under "Setting up your accounts".
+
+Now, create a consumer:
+
+    consumer = Contacts::Google.new
+    consumer = Contacts::Yahoo.new
+    consumer = Contacts::WindowsLive.new
+    # OR by parameter:
+    # provider is one of :google, :yahoo, :windows_live
+    consumer = Contacts.new_consumer(provider)
+
+Now, direct your user to:
+
+    consumer.authentication_url(return_url)
+
+`return_url` is the page the user will be redirected to by the service
+once authorization has been granted. You should also persist the
+consumer object so you can grab the contacts once the user returns:
+
+    session[:consumer] = consumer.serialize
+
+Now in the request handler of the return_url above:
+
+    consumer = Contacts.deserialize(session[:consumer])
+    if consumer.authorize(params)
+      @contacts = consumer.contacts
+    else
+      # handle error
+    end
+
+Here, `params` is the hash of request parameters that the user returns
+with. `consumer.authorize` returns true if the authorization was
+successful, false otherwise.
+
+The list of `@contacts` are `Contacts::Contact` objects which have
+these attributes:
+
+ * name
+ * emails
+
+## Setting up your accounts
+
+### Google
+
+Set up your projects
+[here](http://code.google.com/apis/accounts/docs/RegistrationForWebAppsAuto.html).
+
+ * When redirecting to an unverified domain (e.g., localhost), the
+   user sees a warning when authorizing access.
+
+What this means:
+
+ * You can use the same consumer key for development as production.
+
+### Yahoo
+
+Set up your projects [here](https://developer.apps.yahoo.com/projects)
+
+ * When a project's domain is verified, you must redirect to it.
+ * When a project's domain is not verified, you can redirect anywhere, and the
+   user sees a warning when authorizing access.
+
+What this means:
+
+ * Set up separate production and development projects.
+ * Verify the domain of your production project. You will only be able to
+   redirect to your production domain when using this key.
+ * Don't verify the domain of your development project. You will be able to
+   redirect to any domain when using this key.
+
+## Windows Live
+
+Set up your projects [here](http://msdn.microsoft.com/en-us/library/cc287659.aspx).
+
+ * There is no domain verification step.
+ * The domain cannot be localhost, an IP address, or have a query string.
+ * You must redirect to the project's domain, on any port, and the URL may not
+   have a query string or fragment.
+ * You must specify a privacy policy URL.
+
+What this means:
+
+ * Set up separate production and development projects.
+ * For development, use a domain like myapp.local.
+ * Map this domain to 127.0.0.1 in /etc/hosts or a local DNS server.
+ * If you want to run your app on a different domain (e.g., localhost:3000),
+   redirect the POST from Windows Live to a GET on the original domain. This
+   ensures the popup window has the same origin as the opener page, in
+   accordance with browser same origin policies.
+
+## Copyright
+
+Copyright (c) 2010 [George Ogata](mailto:george.ogata@gmail.com) See
+LICENSE for details.
+
+Derived from [Mislav's Contacts](http://github.com/mislav/contacts),
+Copyright (c) 2009 [Mislav Marohnić](mailto:mislav.marohnic@gmail.com)

data/Rakefile

@@ -0,0 +1,47 @@
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "kulesa-contacts"
+  gem.homepage = "https://github.com/kulesa/contacts"
+  gem.license = "MIT"
+  gem.summary = "Import users' contacts lists from Google, Yahoo!, and Windows Live."
+  gem.description = "Import users' contacts lists from Google, Yahoo!, and Windows Live."
+  gem.email = "kulesa@gmail.com"
+  gem.authors = ["Mislav Marohnic", "George Odata", "Julian Countu"]
+end
+
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+RSpec::Core::RakeTask.new(:rcov) do |spec|
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :default => :spec
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "gitnetworkitis #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.2.6

data/kulesa-contacts.gemspec

@@ -0,0 +1,104 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{kulesa-contacts}
+  s.version = "0.2.6"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Mislav Marohnic", "George Odata", "Julian Countu"]
+  s.date = %q{2011-06-03}
+  s.description = %q{Import users' contacts lists from Google, Yahoo!, and Windows Live.}
+  s.email = %q{kulesa@gmail.com}
+  s.extra_rdoc_files = [
+    "LICENSE",
+    "README.markdown"
+  ]
+  s.files = [
+    ".gitmodules",
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE",
+    "README.markdown",
+    "Rakefile",
+    "VERSION",
+    "kulesa-contacts.gemspec",
+    "lib/contacts.rb",
+    "lib/contacts/consumer.rb",
+    "lib/contacts/google.rb",
+    "lib/contacts/oauth_consumer.rb",
+    "lib/contacts/railtie.rb",
+    "lib/contacts/util.rb",
+    "lib/contacts/version.rb",
+    "lib/contacts/windows_live.rb",
+    "lib/contacts/yahoo.rb",
+    "spec/config/contacts.yml",
+    "spec/contact_spec.rb",
+    "spec/feeds/google-many.xml",
+    "spec/feeds/wl_contacts.xml",
+    "spec/feeds/yh_contacts.txt",
+    "spec/gmail/google_spec.rb",
+    "spec/rcov.opts",
+    "spec/spec.opts",
+    "spec/spec_helper.rb",
+    "spec/windows_live/windows_live_spec.rb",
+    "spec/yahoo/yahoo_spec.rb"
+  ]
+  s.homepage = %q{https://github.com/kulesa/contacts}
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.6.2}
+  s.summary = %q{Import users' contacts lists from Google, Yahoo!, and Windows Live.}
+  s.test_files = [
+    "spec/contact_spec.rb",
+    "spec/gmail/google_spec.rb",
+    "spec/spec_helper.rb",
+    "spec/windows_live/windows_live_spec.rb",
+    "spec/yahoo/yahoo_spec.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<httparty>, [">= 0"])
+      s.add_runtime_dependency(%q<hpricot>, [">= 0"])
+      s.add_runtime_dependency(%q<nokogiri>, [">= 0"])
+      s.add_runtime_dependency(%q<oauth>, ["= 0.4.0"])
+      s.add_runtime_dependency(%q<json>, [">= 0"])
+      s.add_development_dependency(%q<rspec>, ["~> 2.1.0"])
+      s.add_development_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.5.1"])
+      s.add_development_dependency(%q<rcov>, [">= 0"])
+      s.add_development_dependency(%q<mocha>, [">= 0"])
+      s.add_development_dependency(%q<fakeweb>, [">= 0"])
+    else
+      s.add_dependency(%q<httparty>, [">= 0"])
+      s.add_dependency(%q<hpricot>, [">= 0"])
+      s.add_dependency(%q<nokogiri>, [">= 0"])
+      s.add_dependency(%q<oauth>, ["= 0.4.0"])
+      s.add_dependency(%q<json>, [">= 0"])
+      s.add_dependency(%q<rspec>, ["~> 2.1.0"])
+      s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_dependency(%q<jeweler>, ["~> 1.5.1"])
+      s.add_dependency(%q<rcov>, [">= 0"])
+      s.add_dependency(%q<mocha>, [">= 0"])
+      s.add_dependency(%q<fakeweb>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<httparty>, [">= 0"])
+    s.add_dependency(%q<hpricot>, [">= 0"])
+    s.add_dependency(%q<nokogiri>, [">= 0"])
+    s.add_dependency(%q<oauth>, ["= 0.4.0"])
+    s.add_dependency(%q<json>, [">= 0"])
+    s.add_dependency(%q<rspec>, ["~> 2.1.0"])
+    s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+    s.add_dependency(%q<jeweler>, ["~> 1.5.1"])
+    s.add_dependency(%q<rcov>, [">= 0"])
+    s.add_dependency(%q<mocha>, [">= 0"])
+    s.add_dependency(%q<fakeweb>, [">= 0"])
+  end
+end
+

data/lib/contacts.rb

@@ -0,0 +1,90 @@
+require 'uri'
+require 'contacts/version'
+
+if defined?(Rails)
+  require "contacts/railtie"
+end
+
+module Contacts
+
+  Identifier = 'Ruby Contacts v' + VERSION::STRING
+
+  def self.configure(configuration)
+    configuration.each do |key, value|
+      klass =
+        case key.to_s
+        when 'google'
+          Google
+        when 'yahoo'
+          Yahoo
+        when 'windows_live'
+          WindowsLive
+        else
+          raise ArgumentError, "unknown consumer: #{key}"
+        end
+      klass.configure(value)
+    end
+  end
+
+  class Contact
+    attr_reader :name, :username, :emails
+
+    def initialize(emails, name, username = "")
+      @name = name
+      @emails = Array(emails)
+      @username = username
+    end
+
+    def email
+      @emails.first
+    end
+  end
+
+  def self.deserialize_consumer(name, serialized_data)
+    klass = consumer_class_for(name) and
+      klass.deserialize(serialized_data)
+  end
+
+  def self.new(name, *args, &block)
+    klass = consumer_class_for(name) and
+      klass.new(*args, &block)
+  end
+
+  def self.consumer_class_for(name)
+    class_name = name.to_s.gsub(/(?:\A|_)(.)/){|s| $1.upcase}
+    class_name.sub!(/Oauth/, 'OAuth')
+    class_name.sub!(/Bbauth/, 'BBAuth')
+    begin
+      klass = const_get(class_name)
+    rescue NameError
+      return nil
+    end
+    klass < Consumer ? klass : nil
+  end
+
+  def self.verbose?
+    'irb' == $0
+  end
+  
+  class Error < StandardError
+  end
+  
+  class TooManyRedirects < Error
+    attr_reader :response, :location
+    
+    MAX_REDIRECTS = 2
+    
+    def initialize(response)
+      @response = response
+      @location = @response['Location']
+      super "exceeded maximum of #{MAX_REDIRECTS} redirects (Location: #{location})"
+    end
+  end
+
+  autoload :Util, 'contacts/util'
+  autoload :Consumer, 'contacts/consumer'
+  autoload :OAuthConsumer, 'contacts/oauth_consumer'
+  autoload :Google, 'contacts/google'
+  autoload :Yahoo, 'contacts/yahoo'
+  autoload :WindowsLive, 'contacts/windows_live'
+end