linkedin-ruby 0.1.0

data/lib/linked_in/people.rb

@@ -0,0 +1,62 @@
+require 'time'
+module LinkedIn
+  # People APIs
+  #
+  # @see http://developer.linkedin.com/documents/people People API
+  # @see http://developer.linkedin.com/documents/profile-fields Profile Fields
+  # @see http://developer.linkedin.com/documents/field-selectors Field Selectors
+  # @see http://developer.linkedin.com/documents/accessing-out-network-profiles Accessing Out of Network Profiles
+  class People < APIResource
+
+    # @!macro multi_profile_options
+    #   @options opts [Array]  :urls A list of profile urls
+    #   @options opts [Array]  :ids List of LinkedIn IDs
+    #
+    # @!macro new profile_args
+    #   @overload profile()
+    #     Fetches your own profile
+    #   @overload profile(id_or_url, opts)
+    #     Fetches the profile of another user
+    #     @param [String] id_or_url a LinkedIn id or a profile URL
+    #     @param [Hash] opts more profile options
+    #     @macro profile_options
+    #   @overload profile(opts)
+    #     Fetches the profile of another user
+    #     @param [Hash] opts profile options
+    #     @macro profile_options
+    #   @return [LinkedIn::Mash]
+
+    # Retrieve a member's LinkedIn profile.
+    #
+    # Required permissions: r_basicprofile, r_fullprofile
+    #
+    # @see http://developer.linkedin.com/documents/profile-api
+    # @macro profile_args
+    # @macro multi_profile_options
+    def profile(id = {}, options = {})
+      options = parse_id(id, options)
+      path = profile_path(options)
+      get(path, options)
+    end
+
+    private ##############################################################
+
+
+    def parse_id(id, options)
+      if id.is_a? String
+        if id.downcase =~ /linkedin\.com/
+          options[:url] = id
+        else
+          options[:id] = id
+        end
+      elsif id.is_a? Hash
+        options = id
+        # else
+        #   options = {}
+      end
+
+      return options
+    end
+
+  end
+end

data/lib/linked_in/raise_error.rb

@@ -0,0 +1,16 @@
+require 'faraday'
+
+module LinkedIn
+  class RaiseError < Faraday::Response::RaiseError
+    def on_complete(response)
+      status_code = response.status.to_i
+      if status_code == 403 && response.body =~ /throttle/i
+        raise LinkedIn::ThrottleError
+      else
+        super
+      end
+    end
+  end
+end
+
+Faraday::Response.register_middleware :linkedin_raise_error => LinkedIn::RaiseError

data/lib/linked_in/share_and_social_stream.rb

@@ -0,0 +1,47 @@
+module LinkedIn
+  # Share and Social Stream APIs
+  #
+  # @see https://developer.linkedin.com/docs/guide/v2/shares
+  # @see https://developer.linkedin.com/docs/guide/v2/shares/share-api
+  # @see https://developer.linkedin.com/docs/guide/v2/shares/network-update-social-actions
+  #
+  # LinkedIn's v2 API adherence to the documentation is shaky at best. Several of
+  # the calls simply don't work if you, e.g., pass the URN in as a path element
+  # for a resource - you have to use the ids=[URN] format w/ a single URN. Or
+  # sometimes passing in an "actor" parameter in the request body simply doesn't
+  # work, and you have to pass it in as a URL parameter. What you see in this
+  # file is the result of trial-and-error getting these endpoints to work, and the
+  # inconsistency is usually a result of either misunderstanding the docs or the
+  # API not working as advertised. It's also a bit unclear when the API wants
+  # an activity URN vs, e.g., an article URN. Caveat emptor.
+  #
+  # [(contribute here)](https://github.com/mallowtechdev/linkedin-ruby)
+  class ShareAndSocialStream < APIResource
+
+    # Create one share from a person, organization, or organizationBrand.
+    #
+    # Permissions:
+    #  1.) For personal shares, you may only post shares as the authorized member.
+    #  2.) For organization shares, you may only post shares as an organization for which the
+    #      authorized member is an administrator.
+    #
+    # @see https://developer.linkedin.com/docs/guide/v2/shares/share-api#post
+    #
+    # @option options [String] :owner, the URN of the entity posting the share.
+    # @return [LinkedIn::Mash]
+    #
+    def share(options = {})
+      path = '/shares'
+      defaults = {distribution:
+                      {
+                          linkedInDistributionTarget:
+                              {
+                                  visibleToGuest: true
+                              }
+                      }
+      }
+      post(path, MultiJson.dump(defaults.merge(options)), 'Content-Type' => 'application/json')
+    end
+
+  end
+end

data/lib/linked_in/version.rb

@@ -0,0 +1,3 @@
+module LinkedIn
+  VERSION = "0.1.0"
+end

data/lib/linkedin-ruby.rb

@@ -0,0 +1,47 @@
+require 'oauth2'
+
+require 'linked_in/errors'
+require 'linked_in/raise_error'
+require 'linked_in/version'
+require 'linked_in/configuration'
+
+# Responsible for all authentication
+# LinkedIn::OAuth2 inherits from OAuth2::Client
+require 'linked_in/oauth2'
+
+# Wraps a LinkedIn-specifc API connection
+# LinkedIn::Connection inherits from Faraday::Connection
+require 'faraday'
+require 'linked_in/connection'
+
+# Data object to wrap API access token
+require 'linked_in/access_token'
+
+# Coerces LinkedIn JSON to a nice Ruby hash
+# LinkedIn::Mash inherits from Hashie::Mash
+require 'hashie'
+require 'linked_in/mash'
+
+# Endpoints inherit from APIResource
+require 'linked_in/api_resource'
+
+# All of the endpoints
+require 'linked_in/people'
+require 'linked_in/organizations'
+require 'linked_in/share_and_social_stream'
+
+# The primary API object that makes requests.
+# It composes in all of the endpoints
+require 'linked_in/api'
+
+module LinkedIn
+  @config = Configuration.new
+
+  class << self
+    attr_accessor :config
+  end
+
+  def self.configure
+    yield self.config
+  end
+end

data/linkedin-ruby.gemspec

@@ -0,0 +1,50 @@
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'linked_in/version'
+
+Gem::Specification.new do |spec|
+  spec.name = 'linkedin-ruby'
+  spec.version = LinkedIn::VERSION
+  spec.authors = ['MallowTech Developers']
+  spec.email = ['developers@mallow-tech.com']
+
+  spec.summary = 'Ruby wrapper for the LinkedIn 2.0 API'
+  spec.description = spec.summary
+  spec.homepage = 'https://github.com/mallowtechdev/linkedin-ruby'
+
+  # Prevent pushing this gem to RubyGems.org. To allow pushes either set the 'allowed_push_host'
+  # # to allow pushing to a single host or delete this section to allow pushing to any host.
+  # if spec.respond_to?(:metadata)
+  #   spec.metadata["allowed_push_host"] = "TODO: Set to 'http://mygemserver.com'"
+  #
+  #   spec.metadata["homepage_uri"] = spec.homepage
+  #   spec.metadata["source_code_uri"] = "TODO: Put your gem's public repo URL here."
+  #   spec.metadata["changelog_uri"] = "TODO: Put your gem's CHANGELOG.md URL here."
+  # else
+  #   raise "RubyGems 2.0 or newer is required to protect against " \
+  #     "public gem pushes."
+  # end
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = Dir.chdir(File.expand_path('..', __FILE__)) do
+    `git ls-files -z`.split("\x0").reject {|f| f.match(%r{^(test|spec|features)/})}
+  end
+  spec.bindir = 'exe'
+  spec.executables = spec.files.grep(%r{^exe/}) {|f| File.basename(f)}
+  spec.require_paths = ['lib']
+
+  spec.required_ruby_version = '>= 1.9.3'
+
+  spec.add_dependency 'faraday', '~> 0.15'
+  spec.add_dependency 'hashie', '~> 3.2'
+  spec.add_dependency 'oauth2', '~> 1.4'
+
+  spec.add_development_dependency 'bundler', '~> 1.16'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rspec', '~> 3.0'
+
+  # We use VCR to mock LinkedIn API calls
+  spec.add_development_dependency 'vcr'
+  spec.add_development_dependency 'webmock'
+end

metadata

@@ -0,0 +1,178 @@
+--- !ruby/object:Gem::Specification
+name: linkedin-ruby
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- MallowTech Developers
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2019-05-07 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.15'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.15'
+- !ruby/object:Gem::Dependency
+  name: hashie
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+- !ruby/object:Gem::Dependency
+  name: oauth2
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: vcr
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Ruby wrapper for the LinkedIn 2.0 API
+email:
+- developers@mallow-tech.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- CODE_OF_CONDUCT.md
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- lib/linked_in/access_token.rb
+- lib/linked_in/api.rb
+- lib/linked_in/api_resource.rb
+- lib/linked_in/configuration.rb
+- lib/linked_in/connection.rb
+- lib/linked_in/errors.rb
+- lib/linked_in/mash.rb
+- lib/linked_in/oauth2.rb
+- lib/linked_in/organizations.rb
+- lib/linked_in/people.rb
+- lib/linked_in/raise_error.rb
+- lib/linked_in/share_and_social_stream.rb
+- lib/linked_in/version.rb
+- lib/linkedin-ruby.rb
+- linkedin-ruby.gemspec
+homepage: https://github.com/mallowtechdev/linkedin-ruby
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 1.9.3
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.7.8
+signing_key: 
+specification_version: 4
+summary: Ruby wrapper for the LinkedIn 2.0 API
+test_files: []