linkedin-oauth2 0.1.1

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    YjgxY2YzOGY3OTc1ZjE3NTAzNzZmMTEyMjM3YjI2MDUxY2FkNDI1Ng==
+  data.tar.gz: !binary |-
+    MmFiMmQ0YzQwYjQzMDI2MjI0NWU3YmZjNWIzNjc0M2JlYjcwYjBmNg==
+!binary "U0hBNTEy":
+  metadata.gz: !binary |-
+    NWViNDkwYTYyMGM0ODYzYzQ2MmNiYjdmNThhZWEzYWJiNGQ1ZGNkYTE3YmE3
+    NGZjMGZlMThlYTU0NWUwMDdhMDRlMTYxZTdlMDA1MzkxY2FhMmE0YWUwMmU2
+    ZjFiNjA0NDY3YmEwNDY1MDMxOTVmYzAyMTgyYTA0OTNiOGNhNjI=
+  data.tar.gz: !binary |-
+    NGI3ZTlmOWM4OTU4MjIzOWViNWVhNmZhZGFkM2U5MDEwZDRmYzM4ODZjNWJm
+    Mjc4MGU3YWEyOWNjNDgwZjZlNTZjMWFlY2RjNTliYmU0MjdlNjViNjQ0ZTU4
+    ODg2MmYwNDU4ODRlMTE1NzdiN2Q2NTZlNWVlNWE1MjI3NDg3M2E=

data/.autotest

@@ -0,0 +1,14 @@
+Autotest.add_hook(:initialize) do |at|
+  at.add_exception(".git")
+end
+
+Autotest.add_hook(:initialize) do |at|
+  at.clear_mappings
+
+  at.add_mapping %r%/^lib/(.*)\.rb$% do |_, m|
+    possible = File.basename(m[1])
+    files_matching %r%^test/.*(#{possible}_test|test_#{possible})\.rb$%
+  end
+
+  at.add_mapping(%r%^test/.*\.rb$%) {|filename, _| filename }
+end

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,41 @@
+*.gem
+*.rbc
+*.sw[a-p]
+*.tmproj
+*.tmproject
+*.un~
+*~
+.DS_Store
+.Spotlight-V100
+.Trashes
+._*
+.bundle
+.config
+.directory
+.elc
+.redcar
+.yardoc
+.rvmrc
+/.emacs.desktop
+/.emacs.desktop.lock
+Desktop.ini
+Gemfile.lock
+Icon?
+InstalledFiles
+Session.vim
+Thumbs.db
+\#*\#
+_yardoc
+auto-save-list
+coverage
+doc/
+lib/bundler/man
+pkg
+pkg/*
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+tmtags
+tramp

data/.rspec

@@ -0,0 +1 @@
+--color

data/.ruby-gemset

@@ -0,0 +1 @@
+linkedin-oauth2

data/.ruby-version

@@ -0,0 +1 @@
+ruby-1.9.3-p429

data/.travis.yml

@@ -0,0 +1,5 @@
+rvm:
+  - 1.8.7
+  - 1.9.2
+  - 1.9.3
+  - ree

data/Gemfile

@@ -0,0 +1,7 @@
+source 'http://rubygems.org'
+
+platforms :jruby do
+  gem 'jruby-openssl', '~> 0.7'
+end
+
+gemspec

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2013 Evan Morikawa
+
+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,121 @@
+# LinkedIn
+
+Oauth 2.0 Ruby wrapper for the [LinkedIn API](http://developer.linkedin.com). Heavily inspired by [pengwynn/linkedin](https://github.com/pengwynn/linkedin)'s Oauth 1.0 Linkedin API interface. Most methods are the same as pengwynn/linkedin's gem, but major terminology changes make this incompatible.
+
+Travis CI : [![Build Status](https://secure.travis-ci.org/emorikawa/linkedin-oauth2.png)](http://travis-ci.org/emorikawa/linkedin-oauth2)
+
+## Installation
+
+    [sudo] gem install linkedin-oauth2
+
+## Usage
+
+### Authenticate Overview
+
+LinkedIn's API uses OAuth 2.0 for authentication. Luckily, this gem hides most of the gory details from you.
+
+The gory details can be found [here](https://developer.linkedin.com/documents/authentication)
+
+For legacy support of LinkedIn's OAuth 1.0a api, refer to the [pengwynn/linkedin](https://github.com/pengwynn/linkedin) gem.
+
+Basically, you need 3 things to start using LinkedIn's API:
+
+1. Your application's `client_id` aka **API Key**
+1. Your application's `client_secret` aka **Secret Key**
+1. An `access_token` from a user who authorized your app.
+
+### If you already have a user's `access_token`
+Then you have already authenticated! Encoded within that access token are
+all of the permissions you have on a given user. Assuming you requested
+the appropriate permissions, you can read their profile, grab connections,
+etc.
+
+    client = LinkedIn::Client.new("<your client_id>",
+                                  "<your client_secret>",
+                                  "<user access_token>")
+    client.profile
+
+You may also use the `set_access_token` method.
+
+    client.set_access_token("<user access_token>", options)
+
+### If you need to fetch an `access_token` for a user.
+There are 4 steps:
+
+1. Setup a client using your application's `client_id` and `client_secret`
+
+    client = LinkedIn::Client.new('your_client_id', 'your_client_secret')
+
+2. Get the `authorize_url` to bring up the page that will ask a user
+   to verify permissions & grant you access.
+
+    authorize_url = client.authorize_url
+
+3. Once a user signs in to your OAuth 2.0 box, you will get an
+   `auth_code` aka **code**. (Check in url you were directed to after a
+   successful auth). Use this **auth code** to request the
+   **access token**.
+
+    access_token = client.request_access_token("<auth_code from last step>")
+
+4. Once you have an `access_token`, you can request profile information or
+   anything else you have permissions for.
+
+    client.profile
+
+### Profile examples
+```ruby
+# get the profile for the authenticated user
+client.profile
+
+# get a profile for someone found in network via ID
+client.profile(:id => 'gNma67_AdI')
+
+# get a profile for someone via their public profile url
+client.profile(:url => 'http://www.linkedin.com/in/netherland')
+```
+
+
+More examples in the [examples folder](http://github.com/pengwynn/linkedin/blob/master/examples).
+
+For a nice example on using this in a [Rails App](http://pivotallabs.com/users/will/blog/articles/1096-linkedin-gem-for-a-web-app).
+
+If you want to play with the LinkedIn api without using the gem, have a look at the [apigee LinkedIn console](http://app.apigee.com/console/linkedin).
+
+## Migration from OAuth 1.0a to OAuth 2.0
+### Overall changes
+* The term `consumer` is now referred to as the `client`
+* The terms `token`, `consumer token`, or `consumer key` in OAuth 1.0 are now referred to as **`client_id`** in OAuth 2.0
+* The terms `secret`, or `consumer secret` in OAuth 1.0 are now referred to as **`client_secret`** in OAuth 2.0
+* In OAuth 1.0 there is both an `auth token` and an `auth secret`. OAuth 2.0 combines these into a single `access token`.
+* The terms `auth token`, `auth key`, `auth secret`, `access secret`, `access token`, or `access key` have all been collapsed and are now referred to as the **`access token`**.
+* `require` `linkedin-oauth2` instead of `linkedin`
+* Removed proxy options
+
+### Gem api changes
+* In general, any place that said "consumer" now says "client"
+* The `authorize_from_request` method has been deprecated. Instead
+  navigate to the url from `authorize_url` then enter the returned code
+  into the `request_access_token` method.
+* The `authorize_from_access` method has been deprecated. Instead
+  initialize the `LinkedIn::Client.new` with the `access_token`.
+  `client = Linkedin::Client.new(client_id, client_secret, access_token)`
+
+
+## Note on Patches/Pull Requests
+
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but
+   bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+## Testing
+Run `bundle install`
+
+## Copyright
+
+Copyright (c) 2013 [Evan Morikawa](https://twitter.com/E0M). See LICENSE for details.

data/Rakefile

@@ -0,0 +1,26 @@
+#!/usr/bin/env rake
+
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec)
+
+task :test => :spec
+task :default => :spec
+
+task :compile_and_test do
+  puts "Compiling"
+  puts `gem build linkedin-oauth2.gemspec && gem install ./linkedin-oauth2*.gem`
+  puts "Testing"
+  Rake::Task["test"].invoke
+end
+
+require 'rdoc/task'
+require File.expand_path('../lib/linked_in/version', __FILE__)
+RDoc::Task.new do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "linkedin #{LinkedIn::VERSION::STRING}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/changelog.markdown

@@ -0,0 +1,94 @@
+# Changelog
+
+# OAuth 2.0 Versions
+
+## 0.1.0 - July 15, 2013
+
+* Migrated API over to use Linkedin's OAuth 2.0
+
+# OAuth 1.0 Legacy Versions Via pengwynn/linkedin
+
+## 0.4.0 - May 30, 2013
+
+* Add capability to ask for desired permissions from linked in api
+* Add option to specify a proxy
+* Bump hashie version
+* fix the permission param passing
+* fix to be able to pass the permission scope  
+* Manipulating comments/likes for network_updates ('shares')
+* Methods to work with comments/likes for share  
+* Added a method to get a user's shares
+* Added current user's shares as an option (client.shares)
+* Readme Typos
+
+
+
+##  0.2.x - March x, 2010
+
+* Removed Crack as a dependency, Nokogiri FTW
+
+##  0.2.1 - March 1, 2010
+
+* Big dependency clean up, only OAuth and Nokogiri are really needed.
+
+* Use Nokogiri for xml generation (thanks Leonid Shevtsov - leonid-shevtsov)
+
+* Like and Likes supported
+
+* Escape querystring args
+
+* General coding cleanup
+
+* Added Languages, Skills, Publications, Patents and Phone Numbers (thanks Tadas Tamošauskas - medwezys)
+
+* Extra fields added to profile (thanks Tadas Tamošauskas - medwezys)
+
+* public\_profile\_field added to Profile (thanks troysteinbauer)
+
+* Added recommendations (thanks Erol)
+
+* Added current-share
+
+* Added default\_profile\__fields config option
+
+##  0.1.7 - February 5, 2010
+
+* New group join status support JGRP from Terry Ray
+
+##  0.1.6 - January 20, 2010
+
+* Fixed bug with network status update connection collections - thanks Terry Ray
+
+##  0.1.5 - January 13, 2010
+
+* Added education and profile fields missing from updated LinkedIn docs
+
+##  0.1.4 - January 13, 2010
+
+* Applied patch for position end month/year from @holman
+
+##  0.1.3 - December 24, 2009
+
+* Added configure block for easier initialization of consumer token, secret
+
+##  0.1.1 - December 8, 2009
+
+* Applied patch from [nfo](http://github.com/nfo) to fix error handling
+
+## 0.1.0 - November 25, 2009
+
+* Network updates API support
+
+* Search API support
+
+* Updates API support
+
+## 0.0.2 - November 25, 2009
+
+* Swapped out Crack for ROXML for prettier object access
+
+* Added more tests for Profile API
+
+## 0.0.1 - November 24, 2009
+
+* Initial release

data/examples/authenticate.rb

@@ -0,0 +1,16 @@
+require 'rubygems'
+require 'linkedin'
+
+# get your api keys at https://www.linkedin.com/secure/developer
+client = LinkedIn::Client.new('your_client_id', 'your_client_secret')
+
+# Get a url that you can enter into the browser to connect a user's
+# account to your client_id and client_secret.
+authorize_url = client.authorize_url
+
+# Record the 'code' param (check the url bar) then use it to request the
+# access_token.
+access_token = client.request_access_token("<auth_code from last step>")
+
+# Once you've initialized the access_token, you can call any api method
+client.profile

data/examples/network.rb

@@ -0,0 +1,12 @@
+# AUTHENTICATE FIRST found in examples/authenticate.rb
+
+# client is a LinkedIn::Client
+
+# get network updates for the authenticated user
+client.network_updates
+
+# get profile picture changes
+client.network_updates(:type => 'PICT')
+
+# view connections for the currently authenticated user
+client.connections

data/examples/profile.rb

@@ -0,0 +1,18 @@
+# AUTHENTICATE FIRST found in examples/authenticate.rb
+
+# client is a LinkedIn::Client
+
+# get the profile for the authenticated user
+client.profile
+
+# get a profile for someone found in network via ID
+client.profile(:id => 'gNma67_AdI')
+
+# get a profile for someone via their public profile url
+client.profile(:url => 'http://www.linkedin.com/in/netherland')
+
+# provides the ability to access authenticated user's company field in the profile
+user = client.profile(:fields => %w(positions))
+companies = user.positions.all.map{|t| t.company}
+# Example: most recent company can be accessed via companies[0]
+

data/examples/sinatra.rb

@@ -0,0 +1,69 @@
+require "rubygems"
+require "haml"
+require "sinatra"
+require "linkedin"
+
+enable :sessions
+
+helpers do
+  def login?
+    !session[:atoken].nil?
+  end
+
+  def profile
+    linkedin_client.profile unless session[:atoken].nil?
+  end
+
+  def connections
+    linkedin_client.connections unless session[:atoken].nil?
+  end
+
+  private
+  def linkedin_client
+    client = LinkedIn::Client.new(settings.api, settings.secret, session[:atoken])
+    client
+  end
+
+end
+
+configure do
+  # get your api keys at https://www.linkedin.com/secure/developer
+  set :api, "your_api_key"
+  set :secret, "your_secret"
+end
+
+get "/" do
+  haml :index
+end
+
+get "/auth" do
+  client = LinkedIn::Client.new(settings.api, settings.secret)
+  authorize_url = client.authorize_url(redirect_uri: "http://#{request.host}:#{request.port}/auth/callback")
+redirect authorize_url
+end
+
+get "/auth/logout" do
+   session[:atoken] = nil
+   redirect "/"
+end
+
+get "/auth/callback" do
+  client = LinkedIn::Client.new(settings.api, settings.secret)
+  code = params[:code]
+  session[:atoken] = client.request_access_token(code, redirect_uri: "/")
+  redirect "/"
+end
+
+
+__END__
+@@index
+-if login?
+  %p Welcome #{profile.first_name}!
+  %a{:href => "/auth/logout"} Logout
+  %p= profile.headline
+  %br
+  %div= "You have #{connections.total} connections!"
+  -connections.all.each do |c|
+    %div= "#{c.first_name} #{c.last_name} - #{c.headline}"
+-else
+  %a{:href => "/auth"} Login using LinkedIn