linkedin 0.4.4 → 0.4.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: bfe7308054e4ded9f8fabfdbfc04ee68eae04257
-  data.tar.gz: 446b1003b220d412dcd323fa7b5a5ebefa689713
+  metadata.gz: beb262e6873736feb890b56c140f682c80beb36f
+  data.tar.gz: 8e1878a8f048e6807c3c3470aa9e9cc391ba4354
 SHA512:
-  metadata.gz: 3459938df6bee5b3e97434b626a55a790778a02017b09fc1ca761ec2a39088c82f15a992eb65b77fc81c3170bbf900d3bfd1527ded889fb45480c2d6dec67529
-  data.tar.gz: ac1f9808e63d3830562f24905d20a82fed94df13795ccf7c4e51b80c6066fe1ca58f1a8618d3aa8ae8e7a2b3300350dc21ed2acebcc1fff0727b7a9668602539
+  metadata.gz: 4de393817404a35a883e2987ef686e2763a5b9c0d684998aff0c66a28e988dde4da3513889fa6de8bed23562abd2e9a32851d8a6fedb6967d5027d2442c28f6d
+  data.tar.gz: 8b22d8d9eff024281c1a8c388ecabe73e436f3ed80806694113890d319c72c206d3f58ad8a831e37d88e856490bdccf00f8f5d3365f65d2787e1adb998619be3

data/.travis.yml

@@ -1,4 +1,7 @@
 rvm:
   - 2.0.0
+  - 2.1.0
+  - 1.9.3
+  - jruby-18mode
   - jruby-19mode
-  - rbx-19mode
+  - rbx

data/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

data/README.markdown

@@ -1,12 +1,12 @@
 # LinkedIn
 
-Ruby wrapper for the [LinkedIn API](http://developer.linkedin.com). Heavily inspired by [John Nunemaker's](http://github.com/jnunemaker) [Twitter gem](http://github.com/jnunemaker/twitter), the LinkedIn gem provides an easy-to-use wrapper for LinkedIn's Oauth/XML APIs.
+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
 
-    [sudo] gem install linkedin
+    gem install linkedin
 
 ## Usage
 
@@ -15,17 +15,21 @@ Travis CI : [![Build Status](https://secure.travis-ci.org/hexgnu/linkedin.png)](
 LinkedIn's API uses Oauth for authentication. Luckily, the LinkedIn gem hides most of the gory details from you.
 
 ```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')
-rtoken = client.request_token.token
-rsecret = client.request_token.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
-client.request_token.authorize_url
+request_token.authorize_url
 => "https://api.linkedin.com/uas/oauth/authorize?oauth_token=<generated_token>"
 
 # then fetch your access keys
@@ -33,7 +37,7 @@ 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")
+c.authorize_from_access("OU812", "8675309")
 
 # you're now free to move about the cabin, call any API method
 ```
@@ -50,7 +54,6 @@ client.profile(:id => 'gNma67_AdI')
 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).
@@ -70,6 +73,7 @@ If you want to play with the LinkedIn api without using the gem, have a look at
 * 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)
@@ -77,4 +81,4 @@ If you want to play with the LinkedIn api without using the gem, have a look at
 
 ## Copyright
 
-Copyright (c) 2009-11 [Wynn Netherland](http://wynnnetherland.com). See LICENSE for details.
+Copyright (c) 2013-Present [Matt Kirk](http://matthewkirk.com) 2009-11 [Wynn Netherland](http://wynnnetherland.com). See LICENSE for details.

data/changelog.markdown

@@ -1,20 +1,29 @@
 # Changelog
 
+## 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  
+* fix to be able to pass the permission scope
 * Manipulating comments/likes for network_updates ('shares')
-* Methods to work with comments/likes for share  
+* 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

data/examples/authenticate.rb

@@ -3,12 +3,17 @@ require 'linkedin'
 
 # get your api keys at https://www.linkedin.com/secure/developer
 client = LinkedIn::Client.new('your_consumer_key', 'your_consumer_secret')
-rtoken = client.request_token.token
-rsecret = client.request_token.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
-client.request_token.authorize_url
+request_token.authorize_url
 => "https://api.linkedin.com/uas/oauth/authorize?oauth_token=<generated_token>"
 
 # then fetch your access keys

data/examples/communication.rb

@@ -0,0 +1,7 @@
+# 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/lib/linked_in/api/query_methods.rb

@@ -87,7 +87,7 @@ module LinkedIn
         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})"
@@ -109,7 +109,7 @@ module LinkedIn
         if options.delete(:public)
           path +=":public"
         elsif fields
-          path +=":(#{fields.map{ |f| f.to_s.gsub("_","-") }.join(',')})"
+          path +=":(#{build_fields_params(fields)})"
         end
 
         headers = options.delete(:headers) || {}
@@ -119,6 +119,16 @@ module LinkedIn
         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)

data/lib/linked_in/api/update_methods.rb

@@ -15,6 +15,16 @@ module LinkedIn
         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 }
@@ -69,17 +79,6 @@ module LinkedIn
         post(path, message.to_json, "Content-Type" => "application/json")
       end
 
-      def post_group_discussion(group_id, discussion)
-        path = "/groups/#{group_id}/posts"
-
-        discussion_post = {
-          'title' => discussion['title'],
-          'summary' => discussion['summary']
-        }
-
-        post(path, discussion_post.to_json, "Content-Type" => "application/json")
-      end
-
     end
 
   end

data/lib/linked_in/version.rb

@@ -3,7 +3,7 @@ module LinkedIn
   module VERSION #:nodoc:
     MAJOR = 0
     MINOR = 4
-    PATCH = 4
+    PATCH = 6
     PRE   = nil
     STRING = [MAJOR, MINOR, PATCH, PRE].compact.join('.')
   end

data/linkedin.gemspec

@@ -12,11 +12,11 @@ Gem::Specification.new do |gem|
   gem.add_development_dependency 'simplecov', '~> 0.7'
   gem.add_development_dependency 'vcr', '~> 2.5'
   gem.add_development_dependency 'webmock', '~> 1.11'
-  gem.authors = ["Wynn Netherland", "Josh Kalderimis"]
-  gem.description = %q{Ruby wrapper for the LinkedIn API}
-  gem.email = ['wynn.netherland@gmail.com', 'josh.kalderimis@gmail.com']
+  gem.authors = ['Matthew Kirk', 'Wynn Netherland', 'Josh Kalderimis']
+  gem.description = 'Ruby wrapper for the LinkedIn API'
+  gem.email = ['meteor.kirk@gmail.com', 'wynn.netherland@gmail.com', 'josh.kalderimis@gmail.com']
   gem.files = `git ls-files`.split("\n")
-  gem.homepage = 'http://github.com/pengwynn/linkedin'
+  gem.homepage = 'http://github.com/hexgnu/linkedin'
   gem.name = 'linkedin'
   gem.require_paths = ['lib']
   gem.summary = gem.description

data/spec/cases/api_spec.rb

@@ -19,7 +19,7 @@ describe LinkedIn::Api do
     stub_request(:get, "https://api.linkedin.com/v1/people/id=123").to_return(:body => "{}")
     client.profile(:id => 123).should be_an_instance_of(LinkedIn::Mash)
   end
-  
+
   it "should be able to view the picture urls" do
     stub_request(:get, "https://api.linkedin.com/v1/people/~/picture-urls::(original)").to_return(:body => "{}")
     client.picture_urls.should be_an_instance_of(LinkedIn::Mash)
@@ -89,13 +89,6 @@ describe LinkedIn::Api do
     response.code.should == "201"
   end
 
-  it "should be able to send a message" do
-    stub_request(:post, "https://api.linkedin.com/v1/people/~/mailbox").to_return(:body => "", :status => 201)
-    response = client.send_message("subject", "body", ["recip1", "recip2"])
-    response.body.should == nil
-    response.code.should == "201"
-  end
-
   it "should be able to like a network update" do
     stub_request(:put, "https://api.linkedin.com/v1/people/~/network/updates/key=SOMEKEY/is-liked").
       with(:body => "true").to_return(:body => "", :status => 201)
@@ -234,6 +227,11 @@ describe LinkedIn::Api do
       client.group_memberships.should be_an_instance_of(LinkedIn::Mash)
     end
 
+    it "should be able to parse nested fields" do
+      stub_request(:get, "https://api.linkedin.com/v1/people/~/group-memberships:(group:(id,name,small-logo-url,short-description))").to_return(:body => "{}")
+      client.group_memberships(fields: [{group: ['id', 'name', 'small-logo-url', 'short-description']}]).should be_an_instance_of(LinkedIn::Mash)
+    end
+
     it "should be able to join a group" do
       stub_request(:put, "https://api.linkedin.com/v1/people/~/group-memberships/123").to_return(:body => "", :status => 201)
 
@@ -255,11 +253,35 @@ describe LinkedIn::Api do
     end
 
     it 'should be able to post a discussion to a group' do
-      stub_request(:post, "https://api.linkedin.com/v1/groups/123/posts").to_return(:body => "", :status => 201)
-      response = client.post_group_discussion(123, {'title' => 'New Discussion', 'summary' => 'New Summary'})
+      expected = {
+        'title' => 'New Discussion',
+        'summary' => 'New Summary',
+        'content' => {
+          "submitted-url" => "http://www.google.com"
+        }
+      }
+
+      stub_request(:post, "https://api.linkedin.com/v1/groups/123/posts").with(:body => expected).to_return(:body => "", :status => 201)
+      response = client.post_group_discussion(123, expected)
       response.body.should == nil
       response.code.should == '201'
     end
+
+    it "should be able to share a new group status" do
+      stub_request(:post, "https://api.linkedin.com/v1/groups/1/posts").to_return(:body => "", :status => 201)
+      response = client.add_group_share(1, :comment => "Testing, 1, 2, 3")
+      response.body.should == nil
+      response.code.should == "201"
+    end
+  end
+
+  context "Communication API" do
+    it "should be able to send a message" do
+      stub_request(:post, "https://api.linkedin.com/v1/people/~/mailbox").to_return(:body => "", :status => 201)
+      response = client.send_message("subject", "body", ["recip1", "recip2"])
+      response.body.should == nil
+      response.code.should == "201"
+    end
   end
 
   context "Errors" do

metadata

@@ -1,15 +1,16 @@
 --- !ruby/object:Gem::Specification
 name: linkedin
 version: !ruby/object:Gem::Version
-  version: 0.4.4
+  version: 0.4.6
 platform: ruby
 authors:
+- Matthew Kirk
 - Wynn Netherland
 - Josh Kalderimis
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-11-15 00:00:00.000000000 Z
+date: 2014-01-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: hashie
@@ -145,6 +146,7 @@ dependencies:
         version: '1.11'
 description: Ruby wrapper for the LinkedIn API
 email:
+- meteor.kirk@gmail.com
 - wynn.netherland@gmail.com
 - josh.kalderimis@gmail.com
 executables: []
@@ -163,6 +165,7 @@ files:
 - Rakefile
 - changelog.markdown
 - examples/authenticate.rb
+- examples/communication.rb
 - examples/network.rb
 - examples/profile.rb
 - examples/sinatra.rb
@@ -202,7 +205,7 @@ files:
 - spec/fixtures/cassette_library/LinkedIn_Search/_search_company/by_single_keywords_option_with_facets_to_return.yml
 - spec/fixtures/cassette_library/LinkedIn_Search/_search_company/by_single_keywords_option_with_pagination.yml
 - spec/helper.rb
-homepage: http://github.com/pengwynn/linkedin
+homepage: http://github.com/hexgnu/linkedin
 licenses: []
 metadata: {}
 post_install_message: 
@@ -221,8 +224,30 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.0.3
+rubygems_version: 2.0.2
 signing_key: 
 specification_version: 4
 summary: Ruby wrapper for the LinkedIn API
-test_files: []
+test_files:
+- spec/cases/api_spec.rb
+- spec/cases/linkedin_spec.rb
+- spec/cases/mash_spec.rb
+- spec/cases/oauth_spec.rb
+- spec/cases/search_spec.rb
+- spec/fixtures/cassette_library/LinkedIn_Api/Company_API.yml
+- spec/fixtures/cassette_library/LinkedIn_Client/_authorize_from_request.yml
+- spec/fixtures/cassette_library/LinkedIn_Client/_request_token.yml
+- spec/fixtures/cassette_library/LinkedIn_Client/_request_token/with_a_callback_url.yml
+- spec/fixtures/cassette_library/LinkedIn_Client/_request_token/with_default_options.yml
+- spec/fixtures/cassette_library/LinkedIn_Search/_search/by_company_name_option.yml
+- spec/fixtures/cassette_library/LinkedIn_Search/_search/by_first_name_and_last_name_options.yml
+- spec/fixtures/cassette_library/LinkedIn_Search/_search/by_first_name_and_last_name_options_with_fields.yml
+- spec/fixtures/cassette_library/LinkedIn_Search/_search/by_keywords_string_parameter.yml
+- spec/fixtures/cassette_library/LinkedIn_Search/_search/by_single_keywords_option.yml
+- spec/fixtures/cassette_library/LinkedIn_Search/_search/by_single_keywords_option_with_pagination.yml
+- spec/fixtures/cassette_library/LinkedIn_Search/_search_company/by_keywords_options_with_fields.yml
+- spec/fixtures/cassette_library/LinkedIn_Search/_search_company/by_keywords_string_parameter.yml
+- spec/fixtures/cassette_library/LinkedIn_Search/_search_company/by_single_keywords_option.yml
+- spec/fixtures/cassette_library/LinkedIn_Search/_search_company/by_single_keywords_option_with_facets_to_return.yml
+- spec/fixtures/cassette_library/LinkedIn_Search/_search_company/by_single_keywords_option_with_pagination.yml
+- spec/helper.rb