Upstream merge

.travis.yml

@@ -1,5 +1,8 @@
 rvm:
-  - 1.8.7
-  - 1.9.2
+  - 2.5
+  - 2.4
+  - 2.3
+  - 2.0.0
+  - 2.1.0
   - 1.9.3
-  - ree
+  - jruby-19mode

.yardopts

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

changelog.markdown → CHANGELOG.md

@@ -1,5 +1,37 @@
 # Changelog
 
+* Document all methods
+* Re-organize modules under Api to match organization in LinkedIn's REST
+  API documentation
+
+## 1.1.1 - August 8, 2018
+
+* Switch to OAuth2
+
+## 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
@@ -68,4 +100,4 @@
 
 ## 0.0.1 - November 24, 2009
 
-* Initial release
+* Initial release

EXAMPLES.md

@@ -0,0 +1,200 @@
+# Linkedin Gem Examples
+
+## OAuth2 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
+
+# to test from your desktop, open the following url in your browser
+# and record the pin it gives you
+client.authorize_url(:redirect_uri => 'https:://www.yourdomain.com/callback', :state => SecureRandom.uuid, :scope => "r_basicprofile+r_emailaddress")
+=> "https://api.linkedin.com/uas/oauth2/authorization?"
+
+# then fetch your access keys
+client.authorize_from_request(params[:code], :redirect_uri => 'https:://www.yourdomain.com/callback')
+=> "OU812" # <= save this for future requests
+
+NOTE: params[:code] is returned in the callback
+
+# or authorize from previously fetched access keys
+client.authorize_from_access("OU812")
+
+# 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])
+    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
+```

Gemfile

@@ -4,4 +4,8 @@ platforms :jruby do
   gem 'jruby-openssl', '~> 0.7'
 end
 
+platforms :rbx do
+  gem 'rubysl'
+end
+
 gemspec

LICENSE

@@ -1,4 +1,6 @@
-Copyright (c) 2009 Wynn Netherland
+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