erc-contacts 0.3.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 2b51c93fde44ce267e335a7b1bd557ee20409cce
+  data.tar.gz: fb52b5eb4d1ed8c0dfc9330ba9cadc447ee9221f
+SHA512:
+  metadata.gz: 734168c1bf7e7fe005839f7354127fa18e5377b7196089a55ace2854c68aace62e2d1d734f9ba3f5adad8f7d64105a0712a6ffdf89fb30f4853061bd2ba873e7
+  data.tar.gz: 5a9559b9bb7e3381c687b8ff2ef510c3545dd18c0d0cbf6ae8dc0221ee862e58b68f6699b7872d5c09b296df89fa1b8355bd8af8c0affea7ce15f72b9289a062

data/.gitmodules

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

data/Gemfile

@@ -0,0 +1,13 @@
+source "http://rubygems.org"
+gem "httparty"
+gem "hpricot"
+gem "nokogiri", "~> 1.8.1"
+gem "oauth", "~> 0.4.5"
+gem "oj", "~> 3.0"
+
+group :development do
+  gem "rspec", "~> 3.6.0"
+  gem "jeweler", "~> 2.3.7"
+  gem "mocha"
+  gem "fakeweb"
+end

data/Gemfile.lock

@@ -0,0 +1,96 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    addressable (2.4.0)
+    builder (3.2.3)
+    crack (0.1.8)
+    descendants_tracker (0.0.4)
+      thread_safe (~> 0.3, >= 0.3.1)
+    diff-lcs (1.3)
+    fakeweb (1.3.0)
+    faraday (0.9.2)
+      multipart-post (>= 1.2, < 3)
+    git (1.3.0)
+    github_api (0.16.0)
+      addressable (~> 2.4.0)
+      descendants_tracker (~> 0.0.4)
+      faraday (~> 0.8, < 0.10)
+      hashie (>= 3.4)
+      mime-types (>= 1.16, < 3.0)
+      oauth2 (~> 1.0)
+    hashie (3.5.6)
+    highline (1.7.8)
+    hpricot (0.8.4)
+    hpricot (0.8.4-java)
+    httparty (0.7.7)
+      crack (= 0.1.8)
+    jar-dependencies (0.3.11)
+    jeweler (2.3.7)
+      builder
+      bundler (>= 1)
+      git (>= 1.2.5)
+      github_api (~> 0.16.0)
+      highline (>= 1.6.15)
+      nokogiri (>= 1.5.10)
+      psych (~> 2.2)
+      rake
+      rdoc
+      semver2
+    jwt (1.5.6)
+    mime-types (2.99.3)
+    mini_portile2 (2.3.0)
+    mocha (0.9.12)
+    multi_json (1.12.2)
+    multi_xml (0.6.0)
+    multipart-post (2.0.0)
+    nokogiri (1.8.1)
+      mini_portile2 (~> 2.3.0)
+    nokogiri (1.8.1-java)
+    oauth (0.4.5)
+    oauth2 (1.4.0)
+      faraday (>= 0.8, < 0.13)
+      jwt (~> 1.0)
+      multi_json (~> 1.3)
+      multi_xml (~> 0.5)
+      rack (>= 1.2, < 3)
+    oj (3.3.7)
+    psych (2.2.4)
+    psych (2.2.4-java)
+      jar-dependencies (>= 0.1.7)
+    rack (2.0.3)
+    rake (12.1.0)
+    rdoc (5.1.0)
+    rspec (3.6.0)
+      rspec-core (~> 3.6.0)
+      rspec-expectations (~> 3.6.0)
+      rspec-mocks (~> 3.6.0)
+    rspec-core (3.6.0)
+      rspec-support (~> 3.6.0)
+    rspec-expectations (3.6.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.6.0)
+    rspec-mocks (3.6.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.6.0)
+    rspec-support (3.6.0)
+    semver2 (3.4.2)
+    thread_safe (0.3.6)
+    thread_safe (0.3.6-java)
+
+PLATFORMS
+  java
+  ruby
+
+DEPENDENCIES
+  fakeweb
+  hpricot
+  httparty
+  jeweler (~> 2.3.7)
+  mocha
+  nokogiri (~> 1.8.1)
+  oauth (~> 0.4.5)
+  oj (~> 3.0)
+  rspec (~> 3.6.0)
+
+BUNDLED WITH
+   1.16.0.pre.2

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,32 @@
+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 = "erc-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
+
+task :default => :spec

data/VERSION

@@ -0,0 +1 @@
+0.3.0

data/erc-contacts.gemspec

@@ -0,0 +1,91 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+# stub: erc-contacts 0.3.0 ruby lib
+
+Gem::Specification.new do |s|
+  s.name = "erc-contacts"
+  s.version = "0.3.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.require_paths = ["lib"]
+  s.authors = ["Mislav Marohnic", "George Odata", "Julian Countu"]
+  s.date = "2017-10-04"
+  s.description = "Import users' contacts lists from Google, Yahoo!, and Windows Live."
+  s.email = "kulesa@gmail.com"
+  s.extra_rdoc_files = [
+    "LICENSE",
+    "README.markdown"
+  ]
+  s.files = [
+    ".gitmodules",
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE",
+    "README.markdown",
+    "Rakefile",
+    "VERSION",
+    "erc-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",
+    "pkg/kulesa-contacts-0.2.6.gem",
+    "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/spec_helper.rb",
+    "spec/windows_live/windows_live_spec.rb",
+    "spec/yahoo/yahoo_spec.rb"
+  ]
+  s.homepage = "https://github.com/kulesa/contacts"
+  s.licenses = ["MIT"]
+  s.rubygems_version = "2.5.1"
+  s.summary = "Import users' contacts lists from Google, Yahoo!, and Windows Live."
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 4
+
+    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>, ["~> 1.8.1"])
+      s.add_runtime_dependency(%q<oauth>, ["~> 0.4.5"])
+      s.add_runtime_dependency(%q<oj>, ["~> 3.0"])
+      s.add_development_dependency(%q<rspec>, ["~> 3.6.0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 2.3.7"])
+      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>, ["~> 1.8.1"])
+      s.add_dependency(%q<oauth>, ["~> 0.4.5"])
+      s.add_dependency(%q<oj>, ["~> 3.0"])
+      s.add_dependency(%q<rspec>, ["~> 3.6.0"])
+      s.add_dependency(%q<jeweler>, ["~> 2.3.7"])
+      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>, ["~> 1.8.1"])
+    s.add_dependency(%q<oauth>, ["~> 0.4.5"])
+    s.add_dependency(%q<oj>, ["~> 3.0"])
+    s.add_dependency(%q<rspec>, ["~> 3.6.0"])
+    s.add_dependency(%q<jeweler>, ["~> 2.3.7"])
+    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