peopledatalabs 1.0.4 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1e90cb306466c21bc1a3ea7f1b20aa847caa6d35407b5994b9b116693a9ac8c6
-  data.tar.gz: 2a8d78cd61c7273c56382ca000f56f26ebc7f33701625c58f2236feade30fe3f
+  metadata.gz: dcb0f2f6c5fe56216eaddb042b16fc105686ab2be354fe26f04e4bfe5948e69f
+  data.tar.gz: a101dbec0783f6fb2c2a3164a768f8acce0a13a8231e659dc647e9f85309f592
 SHA512:
-  metadata.gz: c6bf87839450649eb8a335c66a5da21bf7014fb6355a47f578a09faf5d9c98d04d029fda1191c999a50eed808c7b99523414b75b3ad3e6a6e7baba6b244b1bc2
-  data.tar.gz: 3d3882243f63423c55ab43ee2c240c836777dbf450e0c9cdd07c9be12e5a04246d9504565259a7e093bf8f7689282501432a98c4b9b888ba5d5c6dd47c1bb386
+  metadata.gz: b34e354eddf849a0da5734321c551557228066af39d5b7c870cf0f7ac5e4d8a966d1a134c6e8ea59017b2016b69b856c1a80f08f92400bbe2c86d8d9e8f5aa1f
+  data.tar.gz: 8239c66f3480b7e1022fd98774f0bfea305c745f06af7e1290baedf193c7e26c6134ae5ab29ffd89ba24642d51832c640874a4bc8e3fa120f4c6d9d8e8b8ed9c

data/.gitignore

@@ -14,6 +14,7 @@
 /test/version_tmp/
 /tmp/
 /.idea
+.env
 
 
 # Used by dotenv library to load environment variables.

data/README.md

@@ -24,8 +24,10 @@ This library bundles up PDL API requests into simple function calls, making it e
 ## Table of Contents
 - [🔧 Installation](#installation)
 - [🚀 Usage](#usage)
+- [🏝 Sandbox Usage](#sandbox)
 - [🌐 Endpoints](#endpoints)
 - [📘 Documentation](#documentation)
+- [⚠️ Upgrading from v1.X.X to v2.0.0](#upgrading)
 
 ## Installation <a name="installation"></a>
 
@@ -58,19 +60,19 @@ Peopledatalabs.api_key = 'api_key'
 
 Then, send requests to any PDL API Endpoint:
 
-**Getting Person Data**
+**Using Person APIs**
 ```ruby
 # By Enrichment
 Peopledatalabs::Enrichment.person(params: { phone: '4155688415' })
 
 # By Bulk Enrichment
-Peopledatalabs::Bulk.people(params: {requests: [{params: {profile: ['linkedin.com/in/seanthorne']}}, {params: {profile: ['linkedin.com/in/randrewn']}}]})
+Peopledatalabs::Bulk.person(params: {requests: [{params: {profile: ['linkedin.com/in/seanthorne']}}, {params: {profile: ['linkedin.com/in/randrewn']}}]})
 
 # By Search (SQL)
-Peopledatalabs::Search.people(searchType: 'sql', query: "SELECT * FROM person WHERE job_company_name='people data labs'")
+Peopledatalabs::Search.person(searchType: 'sql', query: "SELECT * FROM person WHERE job_company_name='people data labs'")
 
 # By Search (Elasticsearch)
-Peopledatalabs::Search.people(searchType: 'elastic', query: {"query": {"term": {"job_company_name": "people data labs"}}})
+Peopledatalabs::Search.person(searchType: 'elastic', query: {"query": {"term": {"job_company_name": "people data labs"}}})
 
 # By PDL_ID
 Peopledatalabs::Retrieve.person(person_id: 'qEnOZ5Oh0poWnQ1luFBfVw_0000')
@@ -79,7 +81,7 @@ Peopledatalabs::Retrieve.person(person_id: 'qEnOZ5Oh0poWnQ1luFBfVw_0000')
 Peopledatalabs::Identify.person(params: { name: 'sean thorne' })
 ```
 
-**Getting Company Data**
+**Using Company APIs**
 ```ruby
 # By Enrichment
 Peopledatalabs::Enrichment.company(params: { website: 'peopledatalabs.com' })
@@ -91,11 +93,14 @@ Peopledatalabs::Search.company(searchType: 'sql', query: "SELECT * FROM company
 Peopledatalabs::Search.company(searchType: 'elastic', query: {"query": "must": [{"term": {"tags": "big data"}}, {"term": {"industry": "financial services"}}, {"term": {"location_country": "united states"}}]})
 ```
 
-**Using Supporting APIs**
+**Using Autocomplete API**
 ```ruby
 # Get Autocomplete Suggestions
 Peopledatalabs::Autocomplete.retrieve(field: 'title', text: 'full', size: 10)
+```
 
+**Using Cleaner APIs**
+```ruby
 # Clean Raw Company Strings
 Peopledatalabs::Cleaner.company(kind: 'name', value: 'peOple DaTa LabS')
 
@@ -106,13 +111,31 @@ Peopledatalabs::Cleaner.location(value: '455 Market Street, San Francisco, Calif
 Peopledatalabs::Cleaner.school(kind: 'name', value: 'university of oregon')
 ```
 
+**Using Job Title Enrichment API**
+```ruby
+# Get Job Title Enrichment
+Peopledatalabs::JobTitle.retrieve(job_title: 'data scientist')
+```
+
+**Using Skill Enrichment API**
+```ruby
+# Get Skill Enrichment
+Peopledatalabs::Skill.retrieve(skill: 'c++')
+```
+
+## 🏝 Sandbox Usage <a name="sandbox"></a>
+```ruby
+# To enable sandbox usage, use the following flag
+Peopledatalabs.sandbox = true
+```
+
 ## 🌐 Endpoints <a name="endpoints"></a>
 
 **Person Endpoints**
 | API Endpoint | peopledatalabs Function |
 |-|-|
 | [Person Enrichment API](https://docs.peopledatalabs.com/docs/enrichment-api) | `Peopledatalabs::Enrichment.person(...params)` |
-| [Person Bulk Person Enrichment API](https://docs.peopledatalabs.com/docs/bulk-enrichment-api) | `Peopledatalabs::Bulk.people(...records)` |
+| [Person Bulk Person Enrichment API](https://docs.peopledatalabs.com/docs/bulk-enrichment-api) | `Peopledatalabs::Bulk.person(...records)` |
 | [Person Search API](https://docs.peopledatalabs.com/docs/search-api) | `Peopledatalabs::Search.person(...params)` |
 | [Person Retrieve API](https://docs.peopledatalabs.com/docs/person-retrieve-api) | `Peopledatalabs::Autocomplete.retrieve(...params)` |
 | [Person Identify API](https://docs.peopledatalabs.com/docs/identify-api) | `Peopledatalabs::Identify.person(...params)` |
@@ -130,7 +153,8 @@ Peopledatalabs::Cleaner.school(kind: 'name', value: 'university of oregon')
 | [Company Cleaner API](https://docs.peopledatalabs.com/docs/cleaner-apis#companyclean) | `Peopledatalabs::Cleaner.company(...params)` |
 | [Location Cleaner API](https://docs.peopledatalabs.com/docs/cleaner-apis#locationclean) | `Peopledatalabs::Cleaner.location(...params)` |
 | [School Cleaner API](https://docs.peopledatalabs.com/docs/cleaner-apis#schoolclean) | `Peopledatalabs::Cleaner.school(...params)` |
-
+| [Job Title Enrichment API](https://docs.peopledatalabs.com/docs/job-title-enrichment-api) | `Peopledatalabs::JobTitle.retrieve(...params)` |
+| [Skill Enrichment API](https://docs.peopledatalabs.com/docs/skill-enrichment-api) | `Peopledatalabs::Skill.retrieve(...params)` |
 
 ## 📘 Documentation <a name="documentation"></a>
 
@@ -151,3 +175,10 @@ Conversely, this would be **invalid** because `fake_parameter` is not an input p
 ```ruby
 Peopledatalabs::Identify.person(params: { fake_parameter: 'anything' })
 ```
+
+## ⚠️ Upgrading from v1.X.X to v2.0.0 <a name="upgrading"></a>
+
+Bulk Person and Person Search now use .person instead of .people
+
+i.e. Peopledatalabs::Bulk.people(...records) is now Peopledatalabs::Bulk.person(...records)
+<br />i.e. Peopledatalabs::Search.people(...params) is now Peopledatalabs::Search.person(...params)

data/lib/peopledatalabs/api_resource.rb

@@ -81,6 +81,16 @@ module Peopledatalabs
         elsif (!VALID_AUTOCOMPLETE_FIELDS.include?(field))
           result = { 'status' => 400, 'message' => "Field should be one of: #{VALID_AUTOCOMPLETE_FIELDS.join(', ')}" }
         end
+      elsif path.include? '/job_title'
+        field = params['job_title']
+        if (!field)
+          result = { 'status' => 400, 'message' => 'Missing job_title' }
+        end
+      elsif path.include? '/skill'
+        field = params['skill']
+        if (!field)
+          result = { 'status' => 400, 'message' => 'Missing skill' }
+        end
       end
       result
     end

data/lib/peopledatalabs/configuration.rb

@@ -3,7 +3,7 @@
 module Peopledatalabs
   class Configuration
     attr_accessor :api_key
-    attr_accessor :api_base
+    attr_accessor :sandbox
     attr_accessor :read_timeout
 
     def self.setup
@@ -13,10 +13,13 @@ module Peopledatalabs
     end
 
     def initialize
-      @api_base = "https://api.peopledatalabs.com"
       @read_timeout = 10
       @api_key ||= ENV['PDL_API_KEY']
+      @sanbox = false
     end
 
+    def api_base
+      sandbox ? 'https://sandbox.api.peopledatalabs.com' : 'https://api.peopledatalabs.com'
+    end
   end
 end

data/lib/peopledatalabs/resources/bulk.rb

@@ -2,7 +2,7 @@
 
 module Peopledatalabs
   class Bulk < APIResource
-    def self.people(params:)
+    def self.person(params:)
       headers = {
         'Accept-Encoding' => 'gzip',
         'User-Agent' => 'PDL-RUBY-SDK',

data/lib/peopledatalabs/resources/jobtitle.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Peopledatalabs
+    class JobTitle < APIResource
+      def self.retrieve(job_title:, pretty: false)
+  
+        params = {
+          'job_title' => job_title,
+          'pretty' => pretty,
+        };
+  
+        headers = {
+          'Accept-Encoding' => 'gzip',
+          'User-Agent' => 'PDL-RUBY-SDK',
+        }
+        get(path: '/v5/job_title/enrich', headers: headers, params: params)
+      end
+    end
+  end
+  

data/lib/peopledatalabs/resources/search.rb

@@ -2,7 +2,7 @@
 
 module Peopledatalabs
   class Search < APIResource
-    def self.people(searchType:, query: , titlecase: false, dataset: 'all', size: 10, pretty: false, scroll_token: nil)
+    def self.person(searchType:, query: , titlecase: false, dataset: 'all', size: 10, pretty: false, scroll_token: nil)
       search(searchType: searchType,
              query: query,
              titlecase: titlecase,

data/lib/peopledatalabs/resources/skill.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Peopledatalabs
+    class Skill < APIResource
+      def self.retrieve(skill:, pretty: false)
+  
+        params = {
+          'skill' => skill,
+          'pretty' => pretty,
+        };
+  
+        headers = {
+          'Accept-Encoding' => 'gzip',
+          'User-Agent' => 'PDL-RUBY-SDK',
+        }
+        get(path: '/v5/skill/enrich', headers: headers, params: params)
+      end
+    end
+  end
+  

data/lib/peopledatalabs/version.rb

@@ -1,3 +1,3 @@
 module Peopledatalabs
-  VERSION = "1.0.4"
+  VERSION = "2.0.0"
 end

data/lib/peopledatalabs.rb

@@ -10,10 +10,12 @@ require 'peopledatalabs/resources/enrichment'
 require 'peopledatalabs/resources/identify'
 require 'peopledatalabs/resources/retrieve'
 require 'peopledatalabs/resources/bulk'
+require 'peopledatalabs/resources/jobtitle'
+require 'peopledatalabs/resources/skill'
 
 
 # gem build peopledatalabs.gemspec
-# gem install ./peopledatalabs-1.0.4.gem
+# gem install ./peopledatalabs-2.0.0.gem
 # irb
 # require 'peopledatalabs'
 # rake spec PDL_API_KEY=API_KEY
@@ -21,20 +23,24 @@ require 'peopledatalabs/resources/bulk'
 # Usage
 # First set api key
 # Peopledatalabs.api_key = 'api_key'
+# # Can set sandbox to true. Defaults to false
+# # Peopledatalabs.sandbox = false
 # Examples Calls:
 # Peopledatalabs::Cleaner.company(kind: 'website', value: 'peopledatalabs.com')
 # Peopledatalabs::Cleaner.school(kind: 'profile', value: 'linkedin.com/school/ucla')
 # Peopledatalabs::Cleaner.location(value: '239 NW 13th Ave, Portland, Oregon 97209, US')
-# Peopledatalabs::Search.people(searchType: 'elastic', query: {"query": {"term": {"job_company_name": "people data labs"}}})
-# Peopledatalabs::Search.people(searchType: 'sql', query: "SELECT * FROM person WHERE job_company_name='people data labs'")
+# Peopledatalabs::Search.person(searchType: 'elastic', query: {"query": {"term": {"job_company_name": "people data labs"}}})
+# Peopledatalabs::Search.person(searchType: 'sql', query: "SELECT * FROM person WHERE job_company_name='people data labs'")
 # Peopledatalabs::Autocomplete.retrieve(field: 'school', text: 'university of michigan')
 # Peopledatalabs::Enrichment.person(params: { name: 'Jennifer C. Jackson', locality: 'Boise' })
-# Peopledatalabs::Bulk.people(params: {requests: [{params: {profile: ['linkedin.com/in/seanthorne']}}, {params: {profile: ['linkedin.com/in/randrewn']}}]})
+# Peopledatalabs::Bulk.person(params: {requests: [{params: {profile: ['linkedin.com/in/seanthorne']}}, {params: {profile: ['linkedin.com/in/randrewn']}}]})
 # Peopledatalabs::Enrichment.company(params: { name: 'Google, Inc.', ticker: 'GOOGL'})
 # Peopledatalabs::Identify.person(params: { name: 'Jennifer C. Jackson', location: 'Medford, OR USA' })
 # Peopledatalabs::Retrieve.person(person_id: 'qEnOZ5Oh0poWnQ1luFBfVw_0000')
 # Peopledatalabs::Search.company(searchType: 'sql', size: 10, query: "SELECT * FROM company WHERE tags='big data' AND industry='financial services' AND location.country='united states';")
 # Peopledatalabs::Search.company(searchType: 'elastic', size: 10, query: { query: { bool: { must: [{term: {location_country: 'mexico'}}, {term: {job_title_role: 'health'}}, {exists: {field: 'phone_numbers'}}]}}})
+# Peopledatalabs::JobTitle.retrieve(job_title: 'data scientist')
+# Peopledatalabs::Skill.retrieve(skill: 'c++')
 
 module Peopledatalabs
   class Error < StandardError; end
@@ -47,8 +53,9 @@ module Peopledatalabs
     attr_reader :config
 
     def_delegators :@config, :api_key, :api_key=
-    def_delegators :@config, :api_base, :api_base=
+    def_delegators :@config, :sandbox, :sandbox=
     def_delegators :@config, :read_timeout, :read_timeout=
+    def_delegators :@config, :api_base
   end
 end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: peopledatalabs
 version: !ruby/object:Gem::Version
-  version: 1.0.4
+  version: 2.0.0
 platform: ruby
 authors:
 - People Data Labs
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2022-07-22 00:00:00.000000000 Z
+date: 2022-08-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -111,8 +111,10 @@ files:
 - lib/peopledatalabs/resources/cleaner.rb
 - lib/peopledatalabs/resources/enrichment.rb
 - lib/peopledatalabs/resources/identify.rb
+- lib/peopledatalabs/resources/jobtitle.rb
 - lib/peopledatalabs/resources/retrieve.rb
 - lib/peopledatalabs/resources/search.rb
+- lib/peopledatalabs/resources/skill.rb
 - lib/peopledatalabs/version.rb
 - peopledatalabs.gemspec
 homepage: https://www.peopledatalabs.com