linkedin-api2 1.1.13

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: f9f4ecb56436648bda96bcdf4725e074be794791
+  data.tar.gz: ecd89a55479a5cc2bbad17c9a5280e31fc1a23b5
+SHA512:
+  metadata.gz: 7d8e8696ebc4f5b87935e5829650a59c479d4ac3c3c66e21beb3b6a10fae612c23ec71cb3944e658fa2fba19e55456fe3ab9db654fad6f1c992e161ed202d14c
+  data.tar.gz: e8298eef910818b2afa4df29fb7dc18c8daf8b222d1901bcf9173b4df038c54066372cabc55070b2ace06fc26d14f151132496a8e40c2a15d437961df805d281

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/.gitignore

@@ -0,0 +1,42 @@
+*.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
+/.idea

data/.rspec

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

data/.travis.yml

@@ -0,0 +1,6 @@
+rvm:
+  - 2.0.0
+  - 2.1.0
+  - 1.9.3
+  - jruby-19mode
+  - rbx

data/.yardopts

@@ -0,0 +1,7 @@
+--no-private
+--markup markdown
+-
+README.md
+CHANGELOG.md
+LICENSE
+EXAMPLES.md

data/CHANGELOG.md

@@ -0,0 +1,99 @@
+# Changelog
+
+* Document all methods
+* Re-organize modules under Api to match organization in LinkedIn's REST
+  API documentation
+
+## 0.4.4 - Jan 11, 2014
+
+* Group share add
+* Readme updates
+
+## 0.4.3
+
+## 0.4.2
+
+## 0.4.1
+
+## 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.md

@@ -0,0 +1,202 @@
+# Linkedin Gem Examples
+
+## OAuth 1.0a Authentication
+
+Here's an example of authenticating with the LinkedIn API
+
+```ruby
+require 'rubygems'
+require 'linkedin'
+
+# get your api keys at https://www.linkedin.com/secure/developer
+client = LinkedIn::Client.new('your_consumer_key', 'your_consumer_secret')
+
+# If you want to use one of the scopes from linkedin you have to pass it in at this point
+# You can learn more about it here: http://developer.linkedin.com/documents/authentication
+request_token = client.request_token({}, :scope => "r_basicprofile r_emailaddress")
+
+rtoken = request_token.token
+rsecret = request_token.secret
+
+# to test from your desktop, open the following url in your browser
+# and record the pin it gives you
+request_token.authorize_url
+=> "https://api.linkedin.com/uas/oauth/authorize?oauth_token=<generated_token>"
+
+# then fetch your access keys
+client.authorize_from_request(rtoken, rsecret, pin)
+=> ["OU812", "8675309"] # <= save these for future requests
+
+# or authorize from previously fetched access keys
+client.authorize_from_access("OU812", "8675309")
+
+# you're now free to move about the cabin, call any API method
+```
+
+
+## Profile
+
+Here are some examples of accessing a user's profile
+
+```ruby
+# 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]
+
+# Example of a multi-email search against the special email search API
+account_exists = client.profile(:email => 'email=yy@zz.com,email=xx@yy.com', :fields => ['id'])
+```
+
+
+## Sending a Message
+
+Here's an example of sending a message to two recipients
+
+```ruby
+# AUTHENTICATE FIRST found in examples/authenticate.md
+
+# client is a LinkedIn::Client
+
+# send a message to a person in your network. you will need to authenticate the
+# user and ask for the "w_messages" permission.
+response = client.send_message("subject", "body", ["person_1_id", "person_2_id"])
+```
+
+
+## User's Network
+
+Here are some examples of accessing network updates and connections of
+the authenticated user
+
+``` ruby
+# 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
+
+# get the original picture-url for one of the connections
+client.picture_urls(:id => 'id_of_connection')
+
+# get the image over https instead of http
+client.picture_urls(:id => 'id_of_connection', :secure => "true")
+```
+## Update User's Status
+
+Here's an example of updating the current user's status
+
+```ruby
+# AUTHENTICATE FIRST found in examples/authenticate.rb
+
+# client is a LinkedIn::Client
+
+# update status for the authenticated user
+client.add_share(:comment => 'is playing with the LinkedIn Ruby gem')
+```
+
+
+## Sinatra App
+
+Here's an example sinatra application that performs authentication,
+after which some info about the authenticated user can be retrieved.
+
+```ruby
+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)
+    client.authorize_from_access(session[:atoken], session[:asecret])
+    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)
+  request_token = client.request_token(:oauth_callback => "http://#{request.host}:#{request.port}/auth/callback")
+  session[:rtoken] = request_token.token
+  session[:rsecret] = request_token.secret
+
+  redirect client.request_token.authorize_url
+end
+
+get "/auth/logout" do
+   session[:atoken] = nil
+   redirect "/"
+end
+
+get "/auth/callback" do
+  client = LinkedIn::Client.new(settings.api, settings.secret)
+  if session[:atoken].nil?
+    pin = params[:oauth_verifier]
+    atoken, asecret = client.authorize_from_request(session[:rtoken], session[:rsecret], pin)
+    session[:atoken] = atoken
+    session[:asecret] = asecret
+  end
+  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
+```

data/Gemfile

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

data/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2009 Wynn Netherland & Matthew Kirk
+
+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.md

@@ -0,0 +1,43 @@
+# LinkedIn
+
+Ruby wrapper for the [LinkedIn API](http://developer.linkedin.com). The LinkedIn gem provides an easy-to-use wrapper for LinkedIn's REST APIs.
+
+Travis CI : [![Build Status](https://secure.travis-ci.org/hexgnu/linkedin.png)](http://travis-ci.org/hexgnu/linkedin)
+
+## Installation
+
+    gem install linkedin
+
+## Documentation
+
+[http://rdoc.info/gems/linkedin](http://rdoc.info/gems/linkedin)
+
+## Usage
+
+[View the Examples](EXAMPLES.md)
+
+## Changelog
+
+[View the Changelog](CHANGELOG.md)
+
+## TODO
+
+* Update and correct test suite
+* Change to Faraday for authentication
+* Implement Messaging APIs
+
+## 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.
+* Make sure your test doesn't just check of instance of LinkedIn::Mash :smile:.
+* 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.
+
+## Copyright
+
+Copyright (c) 2013-Present [Matt Kirk](http://matthewkirk.com) 2009-11 [Wynn Netherland](http://wynnnetherland.com). See LICENSE for details.