linkedin2 0.0.1 → 0.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 940f99d965d7161ae9733d7020ae5d309c07c1ab
-  data.tar.gz: 1a52bf8d319dbe8cf70895125d6ae7769f2314ad
+  metadata.gz: ee1e973248a67cb339df26c8fc32d9565fb5ae4f
+  data.tar.gz: 73e5b542f4f95c0074531b3c1b32b558a3598ec0
 SHA512:
-  metadata.gz: 8169135bc4a73f41cacad9fe82ddd7baab77822d12b267508b7068d9dc96cf22ce3b0ee2666c1d2fcf3b77b4362431eaefe922cea8c4b28741faa81694dee4f7
-  data.tar.gz: 08c42010a9118a6585f527981ee60c88d91d80470165de558c45636d2df6a04acbe16d4436563660f3aed549247edb9ccb396141961d64f2349de27a8be0c08d
+  metadata.gz: 61b1565caa8f7e6fcdbb2febec8ea75152b845fe5ad8cbb4d20d624178b416693ad3fcf9af6b6a327d613d2bddfc1bb98b34acaf21088343d83013b3daff7862
+  data.tar.gz: c2a429ebf3c5fbbb18251b915df6e5a2f7e00f2354b39ae4c56a80bcd427450bfe8332593da249ca4d9e676e31d34fb89e839690fe0a362c417ce93c063498ef

data/.gitignore

@@ -15,3 +15,4 @@ spec/reports
 test/tmp
 test/version_tmp
 tmp
+linkedin.yml

data/example-linkedin.yml

@@ -0,0 +1,4 @@
+key: 12345
+secret: ABCDE
+redirect_uri: http://localhost.com
+access_token: an-access-token-if-you-have-one

data/lib/linkedin/api.rb

@@ -0,0 +1,11 @@
+require 'linkedin/api/authentication'
+require 'linkedin/api/profiles'
+require 'linkedin/api/companies'
+require 'linkedin/api/groups'
+require 'linkedin/api/industries'
+require 'linkedin/api/jobs'
+require 'linkedin/api/permissions'
+
+include LinkedIn::API::Authentication
+include LinkedIn::API::Profiles
+include LinkedIn::API::Companies

data/lib/linkedin/api/authentication.rb

@@ -2,7 +2,6 @@ module LinkedIn
   module API
     module Authentication
       attr_reader :state
-      attr_accessor :access_token
 
       def authorize_url(params={})
         params.reverse_merge! defaults(:scope, :state, :redirect_uri)
@@ -15,8 +14,7 @@ module LinkedIn
         params.reverse_merge! defaults(:redirect_uri)
         opts = { mode: :query, param_name: 'oauth2_access_token' }
 
-        token_response = auth_code.get_token authorization_code, params, opts
-        self.access_token = token_response.token
+        self.access_token = auth_code.get_token authorization_code, params, opts
       end
     end
   end

data/lib/linkedin/api/companies.rb

@@ -0,0 +1,14 @@
+module LinkedIn
+  module API
+    module Companies
+      def company(options={})
+        selector = options[:selector].to_param
+
+        fields = options[:fields]
+        fields_string = fields.blank? ? '' : ":(#{Permissions.render_permissions fields})"
+
+        get "v1/companies/#{selector}#{fields_string}"
+      end
+    end
+  end
+end

data/lib/linkedin/api/groups.rb

@@ -0,0 +1,6 @@
+module LinkedIn
+  module API
+    module Groups
+    end
+  end
+end

data/lib/linkedin/api/industries.rb

@@ -0,0 +1,173 @@
+module LinkedIn
+  module API
+    module Industries
+      def self.all
+        INDUSTRIES
+      end
+
+      def self.[](code)
+        find_by_code(code)
+      end
+
+      def self.find_by_code(code)
+        INDUSTRIES.detect { |indust| indust[:code] == code }
+      end
+
+      def self.find_by_group(*groups)
+        INDUSTRIES.reject { |indust| (groups & indust[:group]) != groups }
+      end
+
+      def self.find_by_description(description)
+        INDUSTRIES.detect { |indust| indust[:description].to_s.downcase == description.to_s.downcase }
+      end
+
+      INDUSTRIES = [ { code: 1,   group: %i(gov tech),       description: 'Defense & Space' },
+                     { code: 3,   group: %i(tech),           description: 'Computer Hardware' },
+                     { code: 4,   group: %i(tech),           description: 'Computer Software' },
+                     { code: 5,   group: %i(tech),           description: 'Computer Networking' },
+                     { code: 6,   group: %i(tech),           description: 'Internet' },
+                     { code: 7,   group: %i(tech),           description: 'Semiconductors' },
+                     { code: 8,   group: %i(gov tech),       description: 'Telecommunications' },
+                     { code: 9,   group: %i(leg),            description: 'Law Practice' },
+                     { code: 10,  group: %i(leg),            description: 'Legal Services' },
+                     { code: 11,  group: %i(corp),           description: 'Management Consulting' },
+                     { code: 12,  group: %i(gov hlth tech),  description: 'Biotechnology' },
+                     { code: 13,  group: %i(hlth),           description: 'Medical Practice' },
+                     { code: 14,  group: %i(hlth),           description: 'Hospital & Health Care' },
+                     { code: 15,  group: %i(hlth tech),      description: 'Pharmaceuticals' },
+                     { code: 16,  group: %i(hlth),           description: 'Veterinary' },
+                     { code: 17,  group: %i(hlth),           description: 'Medical Devices' },
+                     { code: 18,  group: %i(good),           description: 'Cosmetics' },
+                     { code: 19,  group: %i(good),           description: 'Apparel & Fashion' },
+                     { code: 20,  group: %i(good rec),       description: 'Sporting Goods' },
+                     { code: 21,  group: %i(good),           description: 'Tobacco' },
+                     { code: 22,  group: %i(good),           description: 'Supermarkets' },
+                     { code: 23,  group: %i(good man serv),  description: 'Food Production' },
+                     { code: 24,  group: %i(good man),       description: 'Consumer Electronics' },
+                     { code: 25,  group: %i(good man),       description: 'Consumer Goods' },
+                     { code: 26,  group: %i(good man),       description: 'Furniture' },
+                     { code: 27,  group: %i(good man),       description: 'Retail' },
+                     { code: 28,  group: %i(med rec),        description: 'Entertainment' },
+                     { code: 29,  group: %i(rec),            description: 'Gambling & Casinos' },
+                     { code: 30,  group: %i(rec serv tran),  description: 'Leisure, Travel & Tourism' },
+                     { code: 31,  group: %i(rec serv tran),  description: 'Hospitality' },
+                     { code: 32,  group: %i(rec serv),       description: 'Restaurants' },
+                     { code: 33,  group: %i(rec),            description: 'Sports' },
+                     { code: 34,  group: %i(rec serv),       description: 'Food & Beverages' },
+                     { code: 35,  group: %i(art med rec),    description: 'Motion Pictures and Film' },
+                     { code: 36,  group: %i(med rec),        description: 'Broadcast Media' },
+                     { code: 37,  group: %i(art med rec),    description: 'Museums and Institutions' },
+                     { code: 38,  group: %i(art med rec),    description: 'Fine Art' },
+                     { code: 39,  group: %i(art med rec),    description: 'Performing Arts' },
+                     { code: 40,  group: %i(rec serv),       description: 'Recreational Facilities and Services' },
+                     { code: 41,  group: %i(fin),            description: 'Banking' },
+                     { code: 42,  group: %i(fin),            description: 'Insurance' },
+                     { code: 43,  group: %i(fin),            description: 'Financial Services' },
+                     { code: 44,  group: %i(cons fin good),  description: 'Real Estate' },
+                     { code: 45,  group: %i(fin),            description: 'Investment Banking' },
+                     { code: 46,  group: %i(fin),            description: 'Investment Management' },
+                     { code: 47,  group: %i(corp fin),       description: 'Accounting' },
+                     { code: 48,  group: %i(cons),           description: 'Construction' },
+                     { code: 49,  group: %i(cons),           description: 'Building Materials' },
+                     { code: 50,  group: %i(cons),           description: 'Architecture & Planning' },
+                     { code: 51,  group: %i(cons gov),       description: 'Civil Engineering' },
+                     { code: 52,  group: %i(gov man),        description: 'Aviation & Aerospace' },
+                     { code: 53,  group: %i(man),            description: 'Automotive' },
+                     { code: 54,  group: %i(man),            description: 'Chemicals' },
+                     { code: 55,  group: %i(man),            description: 'Machinery' },
+                     { code: 56,  group: %i(man),            description: 'Mining & Metals' },
+                     { code: 57,  group: %i(man),            description: 'Oil & Energy' },
+                     { code: 58,  group: %i(man),            description: 'Shipbuilding' },
+                     { code: 59,  group: %i(man),            description: 'Utilities' },
+                     { code: 60,  group: %i(man),            description: 'Textiles' },
+                     { code: 61,  group: %i(man),            description: 'Paper & Forest Products' },
+                     { code: 62,  group: %i(man),            description: 'Railroad Manufacture' },
+                     { code: 63,  group: %i(agr),            description: 'Farming' },
+                     { code: 64,  group: %i(agr),            description: 'Ranching' },
+                     { code: 65,  group: %i(agr),            description: 'Dairy' },
+                     { code: 66,  group: %i(agr),            description: 'Fishery' },
+                     { code: 67,  group: %i(edu),            description: 'Primary/Secondary Education' },
+                     { code: 68,  group: %i(edu),            description: 'Higher Education' },
+                     { code: 69,  group: %i(edu),            description: 'Education Management' },
+                     { code: 70,  group: %i(edu gov),        description: 'Research' },
+                     { code: 71,  group: %i(gov),            description: 'Military' },
+                     { code: 72,  group: %i(gov leg),        description: 'Legislative Office' },
+                     { code: 73,  group: %i(gov leg),        description: 'Judiciary' },
+                     { code: 74,  group: %i(gov),            description: 'International Affairs' },
+                     { code: 75,  group: %i(gov),            description: 'Government Administration' },
+                     { code: 76,  group: %i(gov),            description: 'Executive Office' },
+                     { code: 77,  group: %i(gov leg),        description: 'Law Enforcement' },
+                     { code: 78,  group: %i(gov),            description: 'Public Safety' },
+                     { code: 79,  group: %i(gov),            description: 'Public Policy' },
+                     { code: 80,  group: %i(corp med),       description: 'Marketing and Advertising' },
+                     { code: 81,  group: %i(med rec),        description: 'Newspapers' },
+                     { code: 82,  group: %i(med rec),        description: 'Publishing' },
+                     { code: 83,  group: %i(med rec),        description: 'Printing' },
+                     { code: 84,  group: %i(med serv),       description: 'Information Services' },
+                     { code: 85,  group: %i(med rec serv),   description: 'Libraries' },
+                     { code: 86,  group: %i(org serv),       description: 'Environmental Services' },
+                     { code: 87,  group: %i(serv tran),      description: 'Package/Freight Delivery' },
+                     { code: 88,  group: %i(org serv),       description: 'Individual & Family Services' },
+                     { code: 89,  group: %i(org serv),       description: 'Religious Institutions' },
+                     { code: 90,  group: %i(org serv),       description: 'Civic & Social Organization' },
+                     { code: 91,  group: %i(org serv),       description: 'Consumer Services' },
+                     { code: 92,  group: %i(tran),           description: 'Transportation/Trucking/Railroad' },
+                     { code: 93,  group: %i(tran),           description: 'Warehousing' },
+                     { code: 94,  group: %i(man tech tran),  description: 'Airlines/Aviation' },
+                     { code: 95,  group: %i(tran),           description: 'Maritime' },
+                     { code: 96,  group: %i(tech),           description: 'Information Technology and Services' },
+                     { code: 97,  group: %i(corp),           description: 'Market Research' },
+                     { code: 98,  group: %i(corp),           description: 'Public Relations and Communications' },
+                     { code: 99,  group: %i(art med),        description: 'Design' },
+                     { code: 100, group: %i(org),            description: 'Non-Profit Organization Management' },
+                     { code: 101, group: %i(org),            description: 'Fund-Raising' },
+                     { code: 102, group: %i(corp org),       description: 'Program Development' },
+                     { code: 103, group: %i(art med rec),    description: 'Writing and Editing' },
+                     { code: 104, group: %i(corp),           description: 'Staffing and Recruiting' },
+                     { code: 105, group: %i(corp),           description: 'Professional Training & Coaching' },
+                     { code: 106, group: %i(fin tech),       description: 'Venture Capital & Private Equity' },
+                     { code: 107, group: %i(gov org),        description: 'Political Organization' },
+                     { code: 108, group: %i(corp gov serv),  description: 'Translation and Localization' },
+                     { code: 109, group: %i(med rec),        description: 'Computer Games' },
+                     { code: 110, group: %i(corp rec serv),  description: 'Events Services' },
+                     { code: 111, group: %i(art med rec),    description: 'Arts and Crafts' },
+                     { code: 112, group: %i(good man),       description: 'Electrical/Electronic Manufacturing' },
+                     { code: 113, group: %i(med),            description: 'Online Media' },
+                     { code: 114, group: %i(gov man tech),   description: 'Nanotechnology' },
+                     { code: 115, group: %i(art rec),        description: 'Music' },
+                     { code: 116, group: %i(corp tran),      description: 'Logistics and Supply Chain' },
+                     { code: 117, group: %i(man),            description: 'Plastics' },
+                     { code: 118, group: %i(tech),           description: 'Computer & Network Security' },
+                     { code: 119, group: %i(tech),           description: 'Wireless' },
+                     { code: 120, group: %i(leg org),        description: 'Alternative Dispute Resolution' },
+                     { code: 121, group: %i(corp org serv),  description: 'Security and Investigations' },
+                     { code: 122, group: %i(corp serv),      description: 'Facilities Services' },
+                     { code: 123, group: %i(corp),           description: 'Outsourcing/Offshoring' },
+                     { code: 124, group: %i(hlth rec),       description: 'Health, Wellness and Fitness' },
+                     { code: 125, group: %i(hlth),           description: 'Alternative Medicine' },
+                     { code: 126, group: %i(med rec),        description: 'Media Production' },
+                     { code: 127, group: %i(art med),        description: 'Animation' },
+                     { code: 128, group: %i(cons corp fin),  description: 'Commercial Real Estate' },
+                     { code: 129, group: %i(fin),            description: 'Capital Markets' },
+                     { code: 130, group: %i(gov org),        description: 'Think Tanks' },
+                     { code: 131, group: %i(org),            description: 'Philanthropy' },
+                     { code: 132, group: %i(edu org),        description: 'E-Learning' },
+                     { code: 133, group: %i(good),           description: 'Wholesale' },
+                     { code: 134, group: %i(corp good tran), description: 'Import and Export' },
+                     { code: 135, group: %i(cons gov man),   description: 'Mechanical or Industrial Engineering' },
+                     { code: 136, group: %i(art med rec),    description: 'Photography' },
+                     { code: 137, group: %i(corp),           description: 'Human Resources' },
+                     { code: 138, group: %i(corp man),       description: 'Business Supplies and Equipment' },
+                     { code: 139, group: %i(hlth),           description: 'Mental Health Care' },
+                     { code: 140, group: %i(art med),        description: 'Graphic Design' },
+                     { code: 141, group: %i(gov org tran),   description: 'International Trade and Development' },
+                     { code: 142, group: %i(good man rec),   description: 'Wine and Spirits' },
+                     { code: 143, group: %i(good),           description: 'Luxury Goods & Jewelry' },
+                     { code: 144, group: %i(gov man org),    description: 'Renewables & Environment' },
+                     { code: 145, group: %i(cons man),       description: 'Glass, Ceramics & Concrete' },
+                     { code: 146, group: %i(good man),       description: 'Packaging and Containers' },
+                     { code: 147, group: %i(cons man),       description: 'Industrial Automation' },
+                     { code: 148, group: %i(gov),            description: 'Government Relations' } ]
+    end
+  end
+end

data/lib/linkedin/api/jobs.rb

@@ -0,0 +1,6 @@
+module LinkedIn
+  module API
+    module Jobs
+    end
+  end
+end

data/lib/linkedin/api/permissions.rb

@@ -0,0 +1,43 @@
+require 'byebug'
+module LinkedIn
+  module API
+    module Permissions
+      COMPANY = { 'company' => [ 'id', 'name', 'type', 'size', 'industry', 'ticker' ] }
+      LOCATION = { 'location' => ['name', { 'country' => 'code' } ] }
+      POSITIONS = { 'positions' => [ 'id', 'title', 'summary', 'start-date', 'end-date', 'is-current', COMPANY ] }
+      PROFILE_REQ = { 'api-standard-profile-request' => ['url', 'headers'] }
+
+      PROFILE_BASE = [ 'id', 'first-name', 'last-name','maiden-name', 'formatted-name', 'phonetic-first-name', 
+                       'phonetic-last-name', 'formatted-phonetic-name', 'headline', 'industry', 'distance',
+                       'current-share', 'num-connections', 'num-connections-capped', 'summary', 'specialties',
+                       'picture-url', 'site-standard-profile-request', 'public-profile-url',
+                       LOCATION, POSITIONS, PROFILE_REQ ]
+
+      RELATION = { 'relation-to-viewer' => [ 'num-related-connections', 'related-connections' => PROFILE_BASE ] }
+
+
+      MEMBER_RESOURCES = { 'member-url-resources' => [ 'url', 'name' ] }
+      FULL_BASE = [ 'last-modified-timestamp', 'proposal-comments', 'associations', 'interests', 'publications',
+                    'patents', 'languages', 'skills', 'certifications', 'educations', 'courses', 'volunteer',
+                    'three-current-positions', 'three-past-positions', 'num-recommenders', 'recommendations-received',
+                    'mfeed-rss-url', 'following', 'job-bookmarks', 'suggestions', 'date-of-birth',
+                    'member-url-resources', 'related-profile-views', 'honors-awards' ]
+
+      R_BASICPROFILE = PROFILE_BASE + [ RELATION ]
+      R_EMAIL = [ 'email-address' ]
+      R_FULLPROFILE = FULL_BASE + [ MEMBER_RESOURCES ]
+      R_CONTACTINFO = [ 'phone-numbers', 'bound-account-types', 'im-accounts', 'main-address', 'twitter-accounts', 'primary-twitter-account']
+      R_NETWORK = [ 'connections' ]
+      RW_GROUPS = [ 'group-memberships' ]
+      RW_NUS = [ 'network' ]
+
+      def self.render_permissions (*fields)
+        fields = fields.first if fields.size == 1
+
+        return render_permissions(fields.map { |key, value| "#{key}:(#{render_permissions value})" }) if fields.respond_to? :keys
+        return fields.map { |value| render_permissions value }.join ',' if fields.respond_to? :each
+        fields.to_s
+      end
+    end
+  end
+end

data/lib/linkedin/api/profiles.rb

@@ -0,0 +1,23 @@
+module LinkedIn
+  module API
+    module Profiles
+      def profile(options={})
+        selector = options[:selector]
+        selector_string = '~' if selector.blank?
+        selector_string ||= selector.to_param
+
+        fields = options[:fields]
+        fields_string = fields.blank? ? '' : ":(#{Permissions.render_permissions fields})"
+
+        get "v1/people/#{selector_string}#{fields_string}"
+      end
+
+      def connections(options={})
+        selector = options[:selector].to_param || '~'
+        selector_option = { selector: [ selector, 'connections' ].join('/') }
+
+        profile options.slice(:selector).merge(selector_option)
+      end
+    end
+  end
+end

data/lib/linkedin/base.rb

@@ -0,0 +1,28 @@
+module LinkedIn
+  class Base
+    attr_reader :attributes
+
+    def initialize(attributes={})
+      @attributes = Hashie::Mash.new attributes
+    end
+
+
+    def method_missing(method, *args, &block)
+      return @attributes.send(method, *args, &block) if @attributes.respond_to?(method)
+      super
+    end
+
+    def respond_to?(method, include_all=false)
+      return true if @attributes.respond_to method, include_all
+      super
+    end
+
+    def client
+      LinkedIn.new
+    end
+
+    def self.client
+      LinkedIn.new
+    end
+  end
+end

data/lib/linkedin/client.rb

@@ -1,33 +1,91 @@
-require 'byebug'
-
 module LinkedIn
   class Client
+    extend Forwardable
+
     include Configuration
-    include API::Authentication
+    include API
+
+    attr_reader :access_token
 
-    def initialize(options={})
-      configure options
+    def_delegators :@access_token, :expires?, :expired?, :request
+
+    def initialize(options={}, &block)
+      configure options, &block
+      self.access_token ||= self.config[:access_token].to_s
     end
 
     def connection 
-      OAuth2::Client.new key, secret, oauth2_options
+      @connection ||= OAuth2::Client.new(config.key, config.secret, oauth2_options) do |faraday|
+        faraday.request :url_encoded
+        faraday.request :json
+        faraday.request :linkedin_format, defaults(:request_format)
+
+        faraday.response :linkedin_errors
+        faraday.response :logger, config.logger
+        faraday.response :json, content_type: /\bjson$/
+
+        faraday.adapter :net_http
+      end
+    end
+
+    def access_token=(token)
+      if token.kind_of? String
+        options = { access_token: token, mode: :query, param_name: 'oauth2_access_token' }
+        return @access_token = OAuth2::AccessToken.from_hash(connection, options)
+      end
+
+      @access_token = token
+    end
+
+    def access_token_request(method, path, opts={}, &block)
+      response = access_token.send method, path, opts, &block
+      response.body
+    end
+
+    def method_missing(method, *args, &body)
+      return simple_request(method, args[0], (args[1] || {}), &body) if %i(get post put patch delete headers).include? method
+      super
+    end
+
+    def self.default_config
+      {
+        authorize_path: '/uas/oauth2/authorization',
+        access_token_path: '/uas/oauth2/accessToken',
+        api_host: 'https://api.linkedin.com',
+        auth_host: 'https://www.linkedin.com',
+        request_format: :json,
+
+        key: nil,
+        secret: nil,
+        access_token: nil,
+
+        scope: 'r_basicprofile',
+        state: Utils.generate_random_state,
+        redirect_uri: 'http://localhost',
+
+        logger: Logger.new('/dev/null')
+      }
     end
 
     private
 
+    def simple_request(method, path, options={}, &body)
+      request(method, path, options, &body).body
+    end
+
     def auth_code
       connection.auth_code unless connection.nil?
     end
 
     def oauth2_options
-      { site: options[:api_host],
+      { site: config.api_host,
         authorize_url: url_for(:authorize),
         token_url: url_for(:access_token) }
     end
 
     def url_for(option_key)
-      host = options[:auth_host]
-      path = options["#{option_key}_path".to_sym]
+      host = config.auth_host
+      path = config["#{option_key}_path".to_sym]
       "#{host}#{path}"
     end
   end