linkedin 0.4.6 → 0.4.7

data/.document

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

data/README.markdown

@@ -1,84 +0,0 @@
-# LinkedIn
-
-Ruby wrapper for the [LinkedIn API](http://developer.linkedin.com). The LinkedIn gem provides an easy-to-use wrapper for LinkedIn's Oauth/XML APIs.
-
-Travis CI : [![Build Status](https://secure.travis-ci.org/hexgnu/linkedin.png)](http://travis-ci.org/hexgnu/linkedin)
-
-## Installation
-
-    gem install linkedin
-
-## Usage
-
-### Authenticate
-
-LinkedIn's API uses Oauth for authentication. Luckily, the LinkedIn gem hides most of the gory details from you.
-
-```ruby
-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
-c.authorize_from_access("OU812", "8675309")
-
-# you're now free to move about the cabin, call any API method
-```
-
-### 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).
-
-## TODO
-
-* Change to json api
-* 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.

data/examples/authenticate.rb

@@ -1,26 +0,0 @@
-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
-c.authorize_from_access("OU812", "8675309")
-
-# you're now free to move about the cabin, call any API method

data/examples/communication.rb

@@ -1,7 +0,0 @@
-# AUTHENTICATE FIRST found in examples/authenticate.rb
-
-# 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"])

data/examples/network.rb

@@ -1,12 +0,0 @@
-# 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

@@ -1,18 +0,0 @@
-# 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

@@ -1,77 +0,0 @@
-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/examples/status.rb

@@ -1,6 +0,0 @@
-# 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')

data/lib/linked_in/api/query_methods.rb

@@ -1,176 +0,0 @@
-module LinkedIn
-  module Api
-
-    module QueryMethods
-
-      def profile(options={})
-        path = person_path(options)
-        simple_query(path, options)
-      end
-
-      def connections(options={})
-        path = "#{person_path(options)}/connections"
-        simple_query(path, options)
-      end
-
-      def network_updates(options={})
-        path = "#{person_path(options)}/network/updates"
-        simple_query(path, options)
-      end
-
-      def company(options = {})
-        path   = company_path(options)
-        simple_query(path, options)
-      end
-
-      def company_updates(options={})
-        path = "#{company_path(options)}/updates"
-        simple_query(path, options)
-      end
-
-      def company_statistics(options={})
-        path = "#{company_path(options)}/company-statistics"
-        simple_query(path, options)
-      end
-
-      def company_updates_comments(update_key, options={})
-        path = "#{company_path(options)}/updates/key=#{update_key}/update-comments"
-        simple_query(path, options)
-      end
-
-      def company_updates_likes(update_key, options={})
-        path = "#{company_path(options)}/updates/key=#{update_key}/likes"
-        simple_query(path, options)
-      end
-
-      def job(options = {})
-        path = jobs_path(options)
-        simple_query(path, options)
-      end
-
-      def job_bookmarks(options = {})
-        path = "#{person_path(options)}/job-bookmarks"
-        simple_query(path, options)
-      end
-
-      def job_suggestions(options = {})
-        path = "#{person_path(options)}/suggestions/job-suggestions"
-        simple_query(path, options)
-      end
-
-      def group_memberships(options = {})
-        path = "#{person_path(options)}/group-memberships"
-        simple_query(path, options)
-      end
-
-      def group_profile(options)
-        path = group_path(options)
-        simple_query(path, options)
-      end
-
-      def group_posts(options)
-        path = "#{group_path(options)}/posts"
-        simple_query(path, options)
-      end
-
-      def shares(options={})
-        path = "#{person_path(options)}/network/updates"
-        simple_query(path, {:type => "SHAR", :scope => "self"}.merge(options))
-      end
-
-      def share_comments(update_key, options={})
-        path = "#{person_path(options)}/network/updates/key=#{update_key}/update-comments"
-        simple_query(path, options)
-      end
-
-      def share_likes(update_key, options={})
-        path = "#{person_path(options)}/network/updates/key=#{update_key}/likes"
-        simple_query(path, options)
-      end
-
-      def picture_urls(options={})
-        picture_size = options.delete(:picture_size) || 'original'
-        path = "#{picture_urls_path(options)}::(#{picture_size})"
-        simple_query(path, options)
-      end
-
-      private
-
-      def group_path(options)
-        path = "/groups"
-        if id = options.delete(:id)
-          path += "/#{id}"
-        end
-      end
-
-      def simple_query(path, options={})
-        fields = options.delete(:fields) || LinkedIn.default_profile_fields
-
-        if options.delete(:public)
-          path +=":public"
-        elsif fields
-          path +=":(#{build_fields_params(fields)})"
-        end
-
-        headers = options.delete(:headers) || {}
-        params  = to_query(options)
-        path   += "#{path.include?("?") ? "&" : "?"}#{params}" if !params.empty?
-
-        Mash.from_json(get(path, headers))
-      end
-
-      def build_fields_params(fields)
-        if fields.is_a?(Hash) && !fields.empty?
-          fields.map {|index,value| "#{index}:(#{build_fields_params(value)})" }.join(',')
-        elsif fields.respond_to?(:each)
-          fields.map {|field| build_fields_params(field) }.join(',')
-        else
-          fields.to_s.gsub("_", "-")
-        end
-      end
-
-      def person_path(options)
-        path = "/people/"
-        if id = options.delete(:id)
-          path += "id=#{id}"
-        elsif url = options.delete(:url)
-          path += "url=#{CGI.escape(url)}"
-        else
-          path += "~"
-        end
-      end
-
-      def company_path(options)
-        path = "/companies"
-
-        if domain = options.delete(:domain)
-          path += "?email-domain=#{CGI.escape(domain)}"
-        elsif id = options.delete(:id)
-          path += "/id=#{id}"
-        elsif url = options.delete(:url)
-          path += "/url=#{CGI.escape(url)}"
-        elsif name = options.delete(:name)
-          path += "/universal-name=#{CGI.escape(name)}"
-        elsif is_admin = options.delete(:is_admin)
-          path += "?is-company-admin=#{CGI.escape(is_admin)}"
-        else
-          path += "/~"
-        end
-      end
-
-      def picture_urls_path(options)
-        path = person_path(options)
-        path += "/picture-urls"
-      end
-
-      def jobs_path(options)
-        path = "/jobs"
-        if id = options.delete(:id)
-          path += "/id=#{id}"
-        else
-          path += "/~"
-        end
-      end
-    end
-  end
-end

data/lib/linked_in/api/update_methods.rb

@@ -1,85 +0,0 @@
-module LinkedIn
-  module Api
-
-    module UpdateMethods
-
-      def add_share(share)
-        path = "/people/~/shares"
-        defaults = {:visibility => {:code => "anyone"}}
-        post(path, defaults.merge(share).to_json, "Content-Type" => "application/json")
-      end
-
-      def add_company_share(company_id, share)
-        path = "/companies/#{company_id}/shares"
-        defaults = {:visibility => {:code => "anyone"}}
-        post(path, defaults.merge(share).to_json, "Content-Type" => "application/json")
-      end
-
-      def post_group_discussion(group_id, discussion)
-        warn 'Use add_group_share over post_group_discussion. This will be taken out in future versions'
-        add_group_share(group_id, discussion)
-      end
-
-      def add_group_share(group_id, share)
-        path = "/groups/#{group_id}/posts"
-        post(path, share.to_json, "Content-Type" => "application/json")
-      end
-
-      def follow_company(company_id)
-        path = "/people/~/following/companies"
-        body = {:id => company_id }
-        post(path, body.to_json, "Content-Type" => "application/json")
-      end
-
-      def unfollow_company(company_id)
-        path = "/people/~/following/companies/id=#{company_id}"
-        delete(path)
-      end
-
-      def join_group(group_id)
-        path = "/people/~/group-memberships/#{group_id}"
-        body = {'membership-state' => {'code' => 'member' }}
-        put(path, body.to_json, "Content-Type" => "application/json")
-      end
-
-      def add_job_bookmark(bookmark)
-        path = "/people/~/job-bookmarks"
-        body = {'job' => {'id' => bookmark}}
-        post(path, body.to_json, "Content-Type" => "application/json")
-      end
-
-      def update_comment(network_key, comment)
-        path = "/people/~/network/updates/key=#{network_key}/update-comments"
-        body = {'comment' => comment}
-        post(path, body.to_json, "Content-Type" => "application/json")
-      end
-
-      def like_share(network_key)
-        path = "/people/~/network/updates/key=#{network_key}/is-liked"
-        put(path, 'true', "Content-Type" => "application/json")
-      end
-
-      def unlike_share(network_key)
-        path = "/people/~/network/updates/key=#{network_key}/is-liked"
-        put(path, 'false', "Content-Type" => "application/json")
-      end
-
-      def send_message(subject, body, recipient_paths)
-        path = "/people/~/mailbox"
-
-        message = {
-            'subject' => subject,
-            'body' => body,
-            'recipients' => {
-                'values' => recipient_paths.map do |profile_path|
-                  { 'person' => { '_path' => "/people/#{profile_path}" } }
-                end
-            }
-        }
-        post(path, message.to_json, "Content-Type" => "application/json")
-      end
-
-    end
-
-  end
-end