linkedin_v2 1.0.0

data/.ruby-version

@@ -0,0 +1 @@
+2.6.3

data/.travis.yml

@@ -0,0 +1,7 @@
+---
+sudo: false
+language: ruby
+cache: bundler
+rvm:
+  - 2.6.2
+before_install: gem install bundler -v 2.0.1

data/Gemfile

@@ -0,0 +1,4 @@
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in linkedin_v2.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,135 @@
+PATH
+  remote: .
+  specs:
+    linkedin_v2 (1.0.0)
+      down (~> 4.8, >= 4.8.1)
+      rest-client (~> 2.0, >= 2.0.2)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.6.0)
+      public_suffix (>= 2.0.2, < 4.0)
+    ast (2.4.0)
+    axiom-types (0.1.1)
+      descendants_tracker (~> 0.0.4)
+      ice_nine (~> 0.11.0)
+      thread_safe (~> 0.3, >= 0.3.1)
+    codeclimate-engine-rb (0.4.1)
+      virtus (~> 1.0)
+    coderay (1.1.2)
+    coercible (1.0.0)
+      descendants_tracker (~> 0.0.1)
+    coveralls (0.8.23)
+      json (>= 1.8, < 3)
+      simplecov (~> 0.16.1)
+      term-ansicolor (~> 1.3)
+      thor (>= 0.19.4, < 2.0)
+      tins (~> 1.6)
+    crack (0.4.3)
+      safe_yaml (~> 1.0.0)
+    descendants_tracker (0.0.4)
+      thread_safe (~> 0.3, >= 0.3.1)
+    diff-lcs (1.3)
+    docile (1.3.2)
+    domain_name (0.5.20190701)
+      unf (>= 0.0.5, < 1.0.0)
+    down (4.8.1)
+      addressable (~> 2.5)
+    equalizer (0.0.11)
+    hashdiff (1.0.0)
+    http-cookie (1.0.3)
+      domain_name (~> 0.5)
+    ice_nine (0.11.2)
+    jaro_winkler (1.5.3)
+    json (2.2.0)
+    kwalify (0.7.2)
+    method_source (0.9.2)
+    mime-types (3.2.2)
+      mime-types-data (~> 3.2015)
+    mime-types-data (3.2019.0331)
+    netrc (0.11.0)
+    parallel (1.17.0)
+    parser (2.6.3.0)
+      ast (~> 2.4.0)
+    pry (0.12.2)
+      coderay (~> 1.1.0)
+      method_source (~> 0.9.0)
+    psych (3.1.0)
+    public_suffix (3.1.1)
+    rainbow (3.0.0)
+    rake (10.5.0)
+    reek (5.4.0)
+      codeclimate-engine-rb (~> 0.4.0)
+      kwalify (~> 0.7.0)
+      parser (>= 2.5.0.0, < 2.7, != 2.5.1.1)
+      psych (~> 3.1.0)
+      rainbow (>= 2.0, < 4.0)
+    rest-client (2.0.2)
+      http-cookie (>= 1.0.2, < 2.0)
+      mime-types (>= 1.16, < 4.0)
+      netrc (~> 0.8)
+    rspec (3.8.0)
+      rspec-core (~> 3.8.0)
+      rspec-expectations (~> 3.8.0)
+      rspec-mocks (~> 3.8.0)
+    rspec-core (3.8.2)
+      rspec-support (~> 3.8.0)
+    rspec-expectations (3.8.4)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.8.0)
+    rspec-mocks (3.8.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.8.0)
+    rspec-support (3.8.2)
+    rubocop (0.73.0)
+      jaro_winkler (~> 1.5.1)
+      parallel (~> 1.10)
+      parser (>= 2.6)
+      rainbow (>= 2.2.2, < 4.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 1.4.0, < 1.7)
+    ruby-progressbar (1.10.1)
+    safe_yaml (1.0.5)
+    simplecov (0.16.1)
+      docile (~> 1.1)
+      json (>= 1.8, < 3)
+      simplecov-html (~> 0.10.0)
+    simplecov-html (0.10.2)
+    term-ansicolor (1.7.1)
+      tins (~> 1.0)
+    thor (0.20.3)
+    thread_safe (0.3.6)
+    tins (1.21.1)
+    unf (0.1.4)
+      unf_ext
+    unf_ext (0.0.7.6)
+    unicode-display_width (1.6.0)
+    vcr (5.0.0)
+    virtus (1.0.5)
+      axiom-types (~> 0.1)
+      coercible (~> 1.0)
+      descendants_tracker (~> 0.0, >= 0.0.3)
+      equalizer (~> 0.0, >= 0.0.9)
+    webmock (3.6.0)
+      addressable (>= 2.3.6)
+      crack (>= 0.3.2)
+      hashdiff (>= 0.4.0, < 2.0.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 2.0)
+  coveralls (~> 0.8.23)
+  linkedin_v2!
+  pry (~> 0.12.2)
+  rake (~> 10.0)
+  reek (~> 5.4)
+  rspec (~> 3.0)
+  rubocop (~> 0.73.0)
+  vcr (~> 5.0)
+  webmock (~> 3.6)
+
+BUNDLED WITH
+   2.0.1

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2019 Lucas Teles
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,38 @@
+# LinkedinV2
+Ruby wrapper for the [V2 LinkedIn API](https://docs.microsoft.com/en-us/linkedin/consumer/integrations/self-serve/sign-in-with-linkedin?context=linkedin/consumer/context). The LinkedinV2 gem provides an easy-to-use wrapper for some LinkedIn's REST APIs.
+
+[![Coverage Status](https://coveralls.io/repos/github/rockcontent/linkedin-api-v2/badge.svg?branch=add_coveralls)](https://coveralls.io/github/rockcontent/linkedin-api-v2?branch=add_coveralls)
+[![Build Status](https://travis-ci.org/rockcontent/linkedin-api-v2.svg?branch=master)](https://travis-ci.org/rockcontent/linkedin-api-v2)
+[![Codacy Badge](https://api.codacy.com/project/badge/Grade/447640e487cb4db793d32a89be154dfe)](https://app.codacy.com/app/lucasteles22/linkedin-api-v2?utm_source=github.com&utm_medium=referral&utm_content=rockcontent/linkedin-api-v2&utm_campaign=Badge_Grade_Settings)
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'linkedin_v2'
+```
+
+And then execute:
+
+```shell
+    $ bundle
+```
+
+Or install it yourself as:
+
+```shell
+    $ gem install linkedin_v2
+```
+
+## Usage
+
+Check our wiki [here](https://github.com/rockcontent/linkedin-api-v2/wiki)
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at [here](https://github.com/rockcontent/linkedin-api-v2).
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "linkedin_v2"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/linkedin_v2/api/medias.rb

@@ -0,0 +1,15 @@
+module LinkedinV2
+  module Api
+    module Medias
+      def upload_image(picture_url:)
+        file = Files::Creator.(picture_url)
+        body = { file: file }
+        path = LinkedinV2::Url::Builder.(:upload_image)
+
+        request(:post, path, body, {}, API_V1_URL)
+      ensure
+        Files::Destroyer.(file)
+      end
+    end
+  end
+end

data/lib/linkedin_v2/api/organizations.rb

@@ -0,0 +1,41 @@
+module LinkedinV2
+  module Api
+    module Organizations
+      ORGANIZATION_ENTITY = "organization".freeze
+
+      # Retrieve information about organizations
+      # https://docs.microsoft.com/en-us/linkedin/marketing/integrations/community-management/organizations/organization-access-control
+      def organizations(projection: nil, start: nil, count: nil)
+        params = { projection: projection, start: start, count: count }
+        path = LinkedinV2::Url::Builder.(:organizations, params)
+
+        request(:get, path)
+      end
+
+      # Retrieve Organization Logos and Cover Photos
+      # https://docs.microsoft.com/en-us/linkedin/marketing/integrations/community-management/organizations/organization-lookup-api#retrieve-organization-logos--cover-photos
+      def company_brand(identifier:, projection: nil)
+        params = { identifier: identifier, projection: projection }
+        path = LinkedinV2::Url::Builder.(:company, params)
+
+        request(:get, path)
+      end
+
+      def add_company_share(**options)
+        attrs = options.merge(entity: ORGANIZATION_ENTITY)
+        body = LinkedinV2::Templates::Payloads::Shares.new(attrs)
+        path = LinkedinV2::Url::Builder.(:shares)
+
+        request(:post, path, body.to_json, post_headers)
+      end
+
+      def add_company_post(**options)
+        attrs = options.merge(entity: ORGANIZATION_ENTITY)
+        body = LinkedinV2::Templates::Payloads::UgcPost.new(attrs)
+        path = LinkedinV2::Url::Builder.(:ugc_post)
+
+        request(:post, path, body.to_json, post_headers)
+      end
+    end
+  end
+end

data/lib/linkedin_v2/api/profiles.rb

@@ -0,0 +1,32 @@
+module LinkedinV2
+  module Api
+    module Profiles
+      PROFILE_ENTITY = "person".freeze
+
+      # Retrieve information about profile
+      # https://docs.microsoft.com/en-us/linkedin/shared/integrations/people/profile-api
+      def me(projection: nil)
+        params = { projection: projection }
+        path = LinkedinV2::Url::Builder.(:me, params)
+
+        request(:get, path)
+      end
+
+      def add_profile_share(**options)
+        attrs = options.merge(entity: PROFILE_ENTITY)
+        body = LinkedinV2::Templates::Payloads::Shares.new(attrs)
+        path = LinkedinV2::Url::Builder.(:shares)
+
+        request(:post, path, body.to_json, post_headers)
+      end
+
+      def add_profile_post(**options)
+        attrs = options.merge(entity: PROFILE_ENTITY)
+        body = LinkedinV2::Templates::Payloads::UgcPost.new(attrs)
+        path = LinkedinV2::Url::Builder.(:ugc_post)
+
+        request(:post, path, body.to_json, post_headers)
+      end
+    end
+  end
+end

data/lib/linkedin_v2/client.rb

@@ -0,0 +1,18 @@
+require_relative "api/organizations"
+require_relative "api/profiles"
+require_relative "api/medias"
+
+module LinkedinV2
+  class Client
+    include LinkedinV2::Helpers::Handler
+    include LinkedinV2::Api::Organizations
+    include LinkedinV2::Api::Profiles
+    include LinkedinV2::Api::Medias
+
+    attr_reader :token
+
+    def initialize(token:)
+      @token = token
+    end
+  end
+end

data/lib/linkedin_v2/error.rb

@@ -0,0 +1,16 @@
+module LinkedinV2
+  class Error < StandardError
+    attr_reader :details
+
+    def initialize(msg = "", details:)
+      @details = details
+      super(msg)
+    end
+  end
+
+  # Url Builder error
+  InvalidEndpointError = Class.new(Error)
+
+  # LinkedIn response error
+  LinkedinResponseError = Class.new(Error)
+end

data/lib/linkedin_v2/files/creator.rb

@@ -0,0 +1,12 @@
+module LinkedinV2
+  module Files
+    class Creator
+      # picture_url: Image URL (png or jpeg) to send to LinkedIn
+      def self.call(picture_url)
+        tempfile = Down.download(picture_url)
+
+        File.new(tempfile.path)
+      end
+    end
+  end
+end

data/lib/linkedin_v2/files/destroyer.rb

@@ -0,0 +1,12 @@
+module LinkedinV2
+  module Files
+    class Destroyer
+      # file: File object
+      def self.call(file)
+        path_to_file = file.path
+
+        File.delete(path_to_file) if File.exist?(path_to_file.to_s)
+      end
+    end
+  end
+end

data/lib/linkedin_v2/files/reader.rb

@@ -0,0 +1,11 @@
+module LinkedinV2
+  module Files
+    class Reader
+      def self.call(path)
+        template_path = File.join(File.dirname(__FILE__), path)
+
+        File.read(template_path)
+      end
+    end
+  end
+end

data/lib/linkedin_v2/helpers/attribute.rb

@@ -0,0 +1,11 @@
+module LinkedinV2
+  module Helpers
+    module Attribute
+      class << self
+        def present?(attr)
+          !attr.to_s.strip.empty?
+        end
+      end
+    end
+  end
+end

data/lib/linkedin_v2/helpers/handler.rb

@@ -0,0 +1,25 @@
+module LinkedinV2
+  module Helpers
+    module Handler
+      def request(method, endpoint, params = {}, additional_headers = {}, api = API_URL)
+        attrs = [ params, additional_headers ].reject(&:empty?)
+
+        JSON.parse(conn(api)[endpoint].public_send(method, *attrs))
+      rescue RestClient::ExceptionWithResponse => exception
+        raise LinkedinResponseError.new("response error", details: exception.response)
+      end
+
+      def conn(api)
+        RestClient::Resource.new(api, headers: headers)
+      end
+
+      def headers
+        { "Authorization": "Bearer #{token}", "Content-Type": "application/json", }
+      end
+
+      def post_headers
+        { "X-Restli-Protocol-Version": "2.0.0" }
+      end
+    end
+  end
+end

data/lib/linkedin_v2/helpers/hash.rb

@@ -0,0 +1,25 @@
+module LinkedinV2
+  module Helpers
+    module Hash
+      class << self
+        def deep_merge(first, second)
+          first.merge(second.to_h, &merger)
+        end
+
+        private
+
+        def merger
+          -> (_key, first_value, second_value) {
+            if ::Hash === first_value && ::Hash === second_value
+              first_value.merge(second_value, &merger)
+            elsif ::Array === first_value && ::Array === second_value
+              first_value | second_value
+            else
+              [ :undefined, nil, :nil ].include?(second_value) ? first_value : second_value
+            end
+          }
+        end
+      end
+    end
+  end
+end

data/lib/linkedin_v2/helpers/url.rb

@@ -0,0 +1,15 @@
+module LinkedinV2
+  module Helpers
+    module Url
+      class << self
+        # Escapes parameters hash on first level
+        def escape(**params)
+          params.inject({}) do |hash, (key, value)|
+            hash[key] = CGI::escape(value.to_s)
+            hash
+          end
+        end
+      end
+    end
+  end
+end

data/lib/linkedin_v2/templates/endpoints/company.erb

@@ -0,0 +1 @@
+/organizations/<%= identifier %>?projection=<%= projection %>

data/lib/linkedin_v2/templates/endpoints/logo.erb

@@ -0,0 +1 @@
+/organizations/<%= identifier %>?projection=(coverPhotoV2(original~:playableStreams,cropped~:playableStreams,cropInfo),logoV2(original~:playableStreams,cropped~:playableStreams,cropInfo))

data/lib/linkedin_v2/templates/endpoints/me.erb

@@ -0,0 +1 @@
+/me?projection=<%= projection %>

data/lib/linkedin_v2/templates/endpoints/organizations.erb

@@ -0,0 +1 @@
+/organizationalEntityAcls?q=roleAssignee&projection=<%= projection %>&start=<%= start %>&count=<%= count %>

data/lib/linkedin_v2/templates/endpoints/shares.erb

@@ -0,0 +1 @@
+/shares

data/lib/linkedin_v2/templates/endpoints/ugc_post.erb

@@ -0,0 +1 @@
+/ugcPosts

data/lib/linkedin_v2/templates/endpoints/upload_image.erb

@@ -0,0 +1 @@
+/media/upload

data/lib/linkedin_v2/templates/payloads/base.rb

@@ -0,0 +1,19 @@
+module LinkedinV2
+  module Templates
+    module Payloads
+      class Base
+        def initialize(**options)
+          @options = options
+        end
+
+        def to_json
+          raise NotImplementedError
+        end
+
+        private
+
+        attr_reader :options
+      end
+    end
+  end
+end

data/lib/linkedin_v2/templates/payloads/shares.rb

@@ -0,0 +1,99 @@
+module LinkedinV2
+  module Templates
+    module Payloads
+      class Shares < Base
+        def initialize(**options)
+          super(options)
+        end
+
+        def to_json
+          payload.to_json
+        end
+
+        private
+
+        def payload
+          response = body
+          if Helpers::Attribute.present?(description)
+            response = Helpers::Hash.deep_merge(response, description_attribute)
+          end
+          if Helpers::Attribute.present?(title)
+            response = Helpers::Hash.deep_merge(response, title_attribute)
+          end
+
+          response
+        end
+
+        def body
+          {
+            "owner" => "urn:li:#{entity}:#{identifier}",
+            "content" => {
+              "contentEntities" => [
+                {
+                  "entityLocation" => url,
+                  "thumbnails" => [
+                    {
+                      "resolvedUrl": thumbnail,
+                    }
+                  ],
+                }
+              ]
+            },
+            "distribution" => {
+              "linkedInDistributionTarget" => {}
+            },
+            "text" => {
+              "text" => text
+            }
+          }
+        end
+
+        attr_reader :options
+
+        def entity
+          options.fetch(:entity)
+        end
+
+        def identifier
+          options.fetch(:identifier)
+        end
+
+        def url
+          options.fetch(:url)
+        end
+
+        def text
+          options.fetch(:text)
+        end
+
+        def thumbnail
+          options.fetch(:thumbnail, nil)
+        end
+
+        def title
+          options.fetch(:title, nil)
+        end
+
+        def description
+          options.fetch(:description, nil)
+        end
+
+        def description_attribute
+          {
+            "content" => {
+              "description" => description,
+            },
+          }
+        end
+
+        def title_attribute
+          {
+            "content" => {
+              "title" => title,
+            },
+          }
+        end
+      end
+    end
+  end
+end