crunchbase4 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4317bd93d0d27af2af5fa3ee7ecfb5bfd2c4c9b37ab8a17d11d5db5730985e26
-  data.tar.gz: 8b961f21ae443862cd22fd22595c1f69c7519745461eb07a112c628b83d3746a
+  metadata.gz: 116da8bf7036e9d4dba37ed63c85c7fa7cf44fa11c16f291045db209f4ab81b2
+  data.tar.gz: cb9d52123e679160e5055c6aeefbcf30be6924499f050105fa723c9412988587
 SHA512:
-  metadata.gz: ad8b0f747d0df8c38d1f4c0f14468c753e4473d9ac581593739a7cf1ae0e0abadd593fc214760efc3e713bfeb70a37096cd5373de5e205e53081a2f2fe8741db
-  data.tar.gz: ab491bf0ac55c60c649c338d58f1cd83b8ca2aa2af7bb214ef2f782d9a7f2d02831e2c864b782b5febe7ef4ae4de1b8401476bd6c918118ef737869c0764f8a6
+  metadata.gz: a9cb04ffe4ed809a86743d76f2c815616b1d19ee132bf44fe04dc0fcd0d69265871cd4a827083a591630a9514c2f9d07c441a5bc9461ab14c4b3b31f021fc6bf
+  data.tar.gz: 66a0327303a29efc601bac09788f8cd363bde4aedb0245f56d85d6c39eae02f531e1cbae6bd21db3c01e140e27a5c0f70c6bee069b761364902b69b2d3d194b9

data/.rubocop_todo.yml

@@ -9,7 +9,7 @@
 # Offense count: 2
 # Configuration parameters: IgnoredMethods.
 Metrics/AbcSize:
-  Max: 17
+  Max: 30
 
 # Offense count: 1
 # Configuration parameters: CountComments.
@@ -33,3 +33,8 @@ Metrics/PerceivedComplexity:
 
 Metrics/BlockLength:
   Max: 200
+  Exclude:
+    - spec/entities/client_spec.rb
+
+Layout/LineLength:
+  Max: 200

data/Gemfile.lock

@@ -3,6 +3,7 @@ PATH
   specs:
     crunchbase4 (0.1.0)
       faraday
+      faraday_curl
       faraday_middleware
 
 GEM
@@ -17,6 +18,8 @@ GEM
     diff-lcs (1.3)
     faraday (1.0.1)
       multipart-post (>= 1.2, < 3)
+    faraday_curl (0.0.2)
+      faraday (>= 0.9.0)
     faraday_middleware (1.0.0)
       faraday (~> 1.0)
     hashdiff (1.0.1)

data/README.md

@@ -1,10 +1,9 @@
 # Crunchbase
 
-A Ruby Library for Crunchbase API v4 -  [CB-v4 Doc](https://app.swaggerhub.com/apis/Crunchbase/crunchbase-enterprise_api/1.0.1)
+Crunchbase is a ruby wrapper base on Crunchbase V4 API. It provides easy to get the API data by each endpoint. [CB-v4 doc](https://app.swaggerhub.com/apis/Crunchbase/crunchbase-enterprise_api/1.0.1)
 
 [![Gem Version](https://badge.fury.io/rb/crunchbase4.svg)](https://badge.fury.io/rb/crunchbase4)
 [![Build Status](https://travis-ci.org/encoreshao/crunchbase4.svg?branch=master)](https://travis-ci.org/encoreshao/crunchbase4)
-[![Coverage Status](https://coveralls.io/repos/github/encoreshao/crunchbase4/badge.svg)](https://coveralls.io/github/encoreshao/crunchbase4)
 
 ## Installation
 
@@ -18,9 +17,13 @@ And then execute:
 
     $ bundle install
 
-## Usage
+Or install it yourself as:
+
+    $ gem install crunchbase4
 
-## Configure your API certificate
+## Getting Started
+
+### Configure your API certificate
 
 ```
 require 'crunchbase4'
@@ -35,23 +38,27 @@ OR
 Crunchbase.config.user_key = CB_CONFIG['user_key']
 ```
 
-## get the organization data
+## Usage
+
+### The first step is to build an API client
 
 ```
 pry(main)> client = Crunchbase::Client.new
+```
+
+### Entity
+
+####  Get the organization data
+
+```
 pry(main)> response = client.organization('ekohe')
-=> #<Crunchbase::Entities::Organization:0x00007fbc5cfdf2f8
- @acquirer_identifier=nil,
- @aliases=nil,
+=> #<Crunchbase::Models::Organization:0x00007fbc5cfdf2f8
  @categories=["Apps", "Artificial Intelligence", "Big Data", "E-Commerce", "Enterprise Software", "FinTech", "iOS", "Retail", "UX Design"],
  @category_groups=["Apps", "Artificial Intelligence", "Commerce and Shopping", "Data and Analytics", "Design", "Financial Services", "Mobile", "Platforms", "Science and Engineering", "Software"],
- @closed_on=nil,
  @company_type="for_profit",
  @contact_email="info@ekohe.com",
  @created_at="2013-05-14T14:28:38Z",
- @delisted_on=nil,
- @demo_days=nil,
- @description=
+ ...
  ...>
 pry(main)> response.name
 => "Ekohe"
@@ -59,28 +66,22 @@ pry(main)> response.permalink
 => "ekohe"
 ```
 
-OR if you want to get the json data, please call `response.as_json` in your project.
-
+Or, if you want to use json data, please call `response.as_json` in your project.
 
-## get the person data
+#### Get the person data
 
 ```
-pry(main)> client = Crunchbase::Client.new
 pry(main)> response = client.person('mark-zuckerberg')
-=> #<Crunchbase::Entities::Person:0x00007ffbf201d178
+=> #<Crunchbase::Models::Person:0x00007ffbf201d178
  @aliases=["Zuck"],
  @born_on="1984-05-14",
  @created_at="2007-05-26T04:51:46Z",
- @description=
-  "Mark Zuckerberg is the founder and CEO of Facebook, which he started in his college dorm room in 2004 with roomates Dustin Moskovitz and Chris Hughes and from New York.\r\n\r\nZuckerberg is responsible for setting the overall direction and product strategy for the company. He leads the design of Facebook's service and development of its core technology and infrastructure. Mark studied computer science at Harvard University before moving the company to Palo Alto, California.\r\n\r\nEarlier in life, Zuckerberg developed a music recommendation system called Synapse and a peer-to-peer client called Wirehog. However, he abandoned both to pursue new projects.\r\n\r\nZuckerberg attended Harvard University and studied computer science before founding Facebook.\r\n\r\nWhile at Harvard, Zuckerberg created Facemash, a website that compared students' dorm photos side-by-side in a fashion similar to HOT or NOT. Harvard administration was not amused, and Zuckerberg faced subsequent disciplinary action. Less than three months later, he launched Facebook.\r\n\r\nIn September 2010, Zuckerberg donated $100 million to the Newark Public School System to help renovate and revamp the system.\r\n\r\nZuckerberg won the 2007 Crunchie Award for 'Best Startup CEO.' He was the Time Magazine 2010 Person Of The Year. He also won the 2012 Crunchie Award for CEO of the year.",
- @died_on=nil,
  @entity_def_id="person",
  @entity_id="mark-zuckerberg",
  @facebook="https://www.facebook.com/zuck",
  @facet_ids=["investor", "rank"],
  @first_name="Mark",
  @gender="male",
- @identifier="Mark Zuckerberg",
 ...>
 pry(main)> response.name
 => "Mark Zuckerberg"
@@ -88,52 +89,219 @@ pry(main)> response.permalink
 => "mark-zuckerberg"
 ```
 
-OR if you want to get the json data, please call `response.as_json` in your project.
-
-```
-pry(main)> response.as_json
-=> {:born_on=>"1984-05-14",
- :created_at=>"2007-05-26T04:51:46Z",
- :died_on=>nil,
- :entity_def_id=>"person",
- :facebook=>"https://www.facebook.com/zuck",
- :facet_ids=>["investor", "rank"],
- :first_name=>"Mark",
- :gender=>"male",
- :identifier=>"Mark Zuckerberg",
- :image_id=>"v1448830269/gzcifut4c2xah95x0ewd.jpg",
- :image_url=>"https://res.cloudinary.com/crunchbase-production/image/upload/v1448830269/gzcifut4c2xah95x0ewd.jpg",
- :investor_stage=>["seed"],
- :investor_type=>["investment_partner", "angel"],
- :last_name=>"Zuckerberg",
- :layout_id=>"investor",
- :linkedin=>nil,
- :location_group_identifiers=>["San Francisco Bay Area", "Silicon Valley", "West Coast", "Western US"],
- :location_identifiers=>["Palo Alto", "California", "United States", "North America"],
- :middle_name=>nil,
- :num_articles=>31046,
- :num_current_advisor_jobs=>4,
- :num_current_jobs=>7,
- :num_event_appearances=>6,
- :num_exits=>nil,
+#### Get the funding round data
+
+```
+=> #<Crunchbase::Client:0x00007f8806824c28>
+pry(main)> response = client.funding_round('371c20af-8aa9-4bcb-a8da-0694d138f247')
+=> #<Crunchbase::Models::FundingRound:0x00007f8806b55ca8
+ @announced_on="2013-06-30",
+ @closed_on=nil,
+ @created_at="2020-04-02T12:17:59Z",
+ @entity_def_id="funding_round",
+ @funded_organization_categories=nil,
+ @funded_organization_description="Facebook is an online social networking service that enables its users to connect with friends and family.",
+ @funded_organization_funding_stage="ipo",
+ @funded_organization_funding_total=2335700000,
+ @funded_organization_identifier="Facebook",
+ @funded_organization_location=["Menlo Park", "California", "United States", "North America"],
+ @funded_organization_revenue_range="r_10000000",
  ....>
+pry(main)> response.name
+=> "Secondary Market - Facebook"
+pry(main)> response.uuid
+=> "371c20af-8aa9-4bcb-a8da-0694d138f247"
+```
+
+#### Get the acquisition data
+
+```
+pry(main)> response = client.acquisition('7638eae9-07b7-4fc6-ad20-5d99de3ff928')
+=> #<Crunchbase::Models::Acquisition:0x00007fa01134da60
+ @acquiree_categories=["Communities", "Internet", "Photo Sharing", "Publishing", "Search Engine", "Social Media"],
+ @acquiree_funding_total=150949998,
+ @acquiree_identifier="Giphy",
+ @acquiree_last_funding_type="series_d",
+ @acquiree_locations=["New York", "New York", "United States", "North America"],
+ ...>
+pry(main)> response.uuid
+=> "7638eae9-07b7-4fc6-ad20-5d99de3ff928"
+pry(main)> response.acquiree_funding_total
+=> 150949998
 ```
 
+#### Get the press reference data
+
+```
+pry(main)> response = client.press_reference('0171b30e-9cf8-4ad5-8288-2993e4308e0f')
+=> #<Crunchbase::Models::PressReference:0x00007fce2d33dbc0
+ @activity_entities=["Facebook", "General Atlantic", "KKR", "Reliance Industries", "Vista Equity Partners"],
+ @author=nil,
+ @created_at="2020-06-05T17:41:10Z",
+ @entity_def_id="press_reference",
+ @identifier="Jio Platforms to receive $1.2b from Abu Dhabi’s sovereign investment firm",
+ @posted_on="2020-06-05",
+ @publisher="Tech in Asia",
+ @thumbnail_url="https://cdn.techinasia.com/wp-content/uploads/2016/07/Flickr_-_World_Economic_Forum_-_Ambani.jpg",
+ @title="Jio Platforms to receive $1.2b from Abu Dhabi’s sovereign investment firm",
+ @updated_at="2020-06-05T17:41:10Z",
+ @url="https://ift.tt/3cByFh1",
+ @uuid="0171b30e-9cf8-4ad5-8288-2993e4308e0f">
+```
+
+#### Get the investment data
+
+```
+pry(main)> response = client.investment('1368da0c-07b0-46ef-9a86-b518367e60d6')
+=> #<Crunchbase::Models::Investment:0x00007f8c15105830
+ @announced_on="2013-06-30",
+ @created_at="2020-04-02T12:17:59Z",
+ @entity_def_id="investment",
+ @funding_round_identifier="Secondary Market - Facebook",
+ @funding_round_money_raised=nil,
+ @identifier="Jean-Brice Abrial investment in Secondary Market - Facebook",
+ @investor_identifier="Jean-Brice Abrial",
+ @investor_stage=["early_stage_venture", "seed"],
+ @investor_type=["angel"],
+ @is_lead_investor=nil,
+ @money_invested=1500000.0,
+ @name="Jean-Brice Abrial investment in Secondary Market - Facebook",
+ @organization_identifier="Facebook",
+ @partner_identifiers=nil,
+ @permalink="jean-brice-abrial-invested-in-facebook-secondary-market--371c20af--1368da0c",
+ @updated_at="2020-04-02T12:17:59Z",
+ @uuid="1368da0c-07b0-46ef-9a86-b518367e60d6">
+```
+
+### Search
+
+* Search query parameters for each endpoint
+
+```
+{
+  "field_ids": [],
+  "query": [],
+  "order": [],
+  "limit": 0
+}
+```
+
+#### Search organizations by query conditions and order
+
+* Step1: Needs to build the query conditions
+
+```
+query_data = {
+  'field_ids' => %w[
+    name
+    website
+    uuid
+    short_description
+    company_type
+  ],
+  'order' => [
+    {
+      'field_id' => 'company_type',
+      'sort' => 'asc'
+    }
+  ],
+  'query' => [
+    {
+      'type' => 'predicate',
+      'field_id' => 'funding_total',
+      'operator_id' => 'between',
+      'values' => [
+        {
+          'value' => 1_000_000,
+          'currency' => 'usd'
+        },
+        {
+          'value' => 10_000_000,
+          'currency' => 'usd'
+        }
+      ]
+    },
+    {
+      'type' => 'predicate',
+      'field_id' => 'facet_ids',
+      'operator_id' => 'includes',
+      'values' => %w[company investor]
+    }
+  ],
+  'limit' => 4
+}
+```
+
+* Use `client` to send a request and parse response
+
+```
+pry(main)> response = client.search_organizations(query_data)
+=> #<Crunchbase::Searches::Client:0x00007fdfc1ad6eb8
+ @conditions=
+  {"field_ids"=>["name", "website", "uuid", "short_description", "company_type"],
+   "order"=>[{"field_id"=>"company_type", "sort"=>"asc"}],
+   "query"=>
+    [{"type"=>"predicate", "field_id"=>"funding_total", "operator_id"=>"between", "values"=>[{"value"=>1000000, "currency"=>"usd"}, {"value"=>10000000, "currency"=>"usd"}]},
+     {"type"=>"predicate", "field_id"=>"facet_ids", "operator_id"=>"includes", "values"=>["company", "investor"]}],
+   "limit"=>4},
+ @count=4,
+ @entities=
+  [#<Crunchbase::Models::Organization:0x00007fdfc1b06460
+    @company_type="for_profit",
+    @name="360VUZ",
+    @short_description="360VUZ is an immersive virtual video mobile app that enables users to teleport from their smartphone in 360°",
+    @uuid="cb32a4d7-2bd0-1727-a055-63aa6a545380",
+    @website="http://www.360VUZ.com">,
+   #<Crunchbase::Models::Organization:0x00007fdfc1b05b78
+    @company_type="for_profit",
+    @name="HATCHER+",
+    @short_description="Hatcher+ is a data-driven venture investment platform.",
+    @uuid="a0ed41b8-8031-adad-dbb3-2e8f8e1e6848",
+    @website="https://h2.hatcher.com">,
+   #<Crunchbase::Models::Organization:0x00007fdfc1b05290
+    @company_type="for_profit",
+    @name="Merck",
+    @short_description="Merck is a biopharmaceutical company that offers medicines and vaccines for various diseases.",
+    @uuid="2f9b212a-d3aa-a8c2-6317-516127c8ba88",
+    @website="http://www.merck.com">,
+   #<Crunchbase::Models::Organization:0x00007fdfc1b049a8
+    @company_type="for_profit",
+    @name="Archistar.ai",
+    @short_description="World-first artificial intelligence helping professionals find development sites, assess for feasibility and generate architectural designs",
+    @uuid="3be8b43a-1143-4e26-8ecb-660a5a78edc5",
+    @website="https://archistar.ai/">],
+ @entity_type="organization",
+ @kclass_name=Crunchbase::Models::Organization,
+ @total_count=44871>
+```
+
+- Get all entities:     `response.entities`
+- Get total count:      `response.total_count`
+- Get entities count:   `response.count`
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+### Examples of API requests
 
-## Contributing
+```
+Crunchbase.config.user_key = 'user_key'
+client = Crunchbase::Client.new
+response = client.organization('ekohe')
+response = client.person('mark-zuckerberg')
+response = client.funding_round('371c20af8aa94bcba8da0694d138f247')
+response = client.acquisition('7638eae9-07b7-4fc6-ad20-5d99de3ff928')
+```
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/encoreshao/crunchbase4. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/encoreshao/crunchbase4/blob/master/CODE_OF_CONDUCT.md).
+## Contributing
 
+Bug reports and pull requests are welcome on GitHub at https://github.com/ekohe/crunchbase4. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/ekohe/crunchbase4/blob/master/CODE_OF_CONDUCT.md).
 
 ## License
 
-The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+Crunchbase is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
 
 ## Code of Conduct
 
-Everyone interacting in the Crunchbase project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/encoreshao/crunchbase4/blob/master/CODE_OF_CONDUCT.md).
+Everyone interacting in the Crunchbase project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/ekohe/crunchbase4/blob/master/CODE_OF_CONDUCT.md).

data/crunchbase4.gemspec

@@ -6,11 +6,11 @@ Gem::Specification.new do |spec|
   spec.name          = 'crunchbase4'
   spec.version       = Crunchbase::VERSION
   spec.authors       = ['Encore Shao']
-  spec.email         = ['encore.shao@gmail.com']
+  spec.email         = ['encore@ekohe.com']
 
-  spec.summary       = 'Ruby Library for Crunchbase API Version 4.0'
-  spec.description   = 'A Ruby wrapper for Crunchbase API version 4.0, crunchbase build new API interface by GraphQL'
-  spec.homepage      = 'https://github.com/encoreshao/crunchbase4'
+  spec.summary       = 'Crunchbase is a ruby wrapper base on Crunchbase V4 API'
+  spec.description   = 'Crunchbase is a ruby wrapper base on Crunchbase V4 API. It provides easy to get the API data by each endpoint. '
+  spec.homepage      = 'https://github.com/ekohe/crunchbase4'
   spec.license       = 'MIT'
   spec.required_ruby_version = Gem::Requirement.new('>= 2.3.0')
   spec.post_install_message = 'Thanks for installing!'
@@ -18,8 +18,8 @@ Gem::Specification.new do |spec|
   spec.metadata['allowed_push_host'] = 'https://rubygems.org'
 
   spec.metadata['homepage_uri'] = spec.homepage
-  spec.metadata['source_code_uri'] = 'https://github.com/encoreshao/crunchbase4'
-  spec.metadata['changelog_uri'] = 'https://github.com/encoreshao/crunchbase4/CHANGELOG.md'
+  spec.metadata['source_code_uri'] = 'https://github.com/ekohe/crunchbase4'
+  spec.metadata['changelog_uri'] = 'https://github.com/ekohe/crunchbase4/CHANGELOG.md'
 
   # 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.
@@ -32,6 +32,7 @@ Gem::Specification.new do |spec|
   spec.require_paths = ['lib']
 
   spec.add_dependency 'faraday'
+  spec.add_dependency 'faraday_curl'
   spec.add_dependency 'faraday_middleware'
 
   # VCR for testing APIs

data/lib/crunchbase.rb

@@ -3,12 +3,10 @@
 require 'crunchbase/version'
 
 require 'crunchbase/config'
-require 'crunchbase/utilities'
 require 'crunchbase/client'
 require 'crunchbase/entities'
 require 'crunchbase/searches'
 require 'crunchbase/models'
-require 'crunchbase/errors'
 
 module Crunchbase
   API_VERSION   = 'v4'

data/lib/crunchbase/client.rb

@@ -1,47 +1,12 @@
 # frozen_string_literal: true
 
+require_relative 'utilities/entity_endpoints'
+require_relative 'utilities/search_endpoints'
+
 module Crunchbase
   # API Request
   class Client
-    # API Parameters
-    #
-    #   entity_id:  UUID or permalink of desired entity
-    #   card_id:    A card to include on the resulting entity
-    #   order:      Field name with order direction (asc/desc)
-    #   limit:      Number of rows to return. Default is 100, min is 1, max is 100.
-    def organization(entity_id, card_id: nil)
-      kobject = entities('Organization', entity_id)
-      return kobject.fetch if card_id.nil?
-
-      kobject.cards(card_id)
-    end
-
-    # Fetching all cards of organization
-    def organization_cards(entity_id, cards: [])
-      entities('Organization', entity_id).fetch_cards(cards)
-    end
-
-    def person(entity_id, card_id: nil)
-      kobject = entities('Person', entity_id)
-      return kobject.fetch if card_id.nil?
-
-      kobject.cards(card_id)
-    end
-
-    # Fetching all cards of people
-    def person_cards(entity_id)
-      entities('Person', entity_id).fetch_cards
-    end
-
-    def searches(keyword, _scope: nil)
-      Crunchbase::Searches::Organization.new('name', keyword)
-    end
-
-    private
-
-    def entities(kclass_name, entity_id)
-      model_name = Kernel.const_get("Crunchbase::Models::#{kclass_name}")
-      Crunchbase::Entities::Client.new(entity_id, model_name)
-    end
+    include Utilities::EntityEndpoints
+    include Utilities::SearchEndpoints
   end
 end

data/lib/crunchbase/config.rb

@@ -7,7 +7,7 @@ module Crunchbase
   # Config
   class Config
     include Singleton
-    attr_accessor :user_key
+    attr_accessor :user_key, :debug
   end
 
   def self.config

data/lib/crunchbase/entities/client.rb

@@ -1,49 +1,51 @@
 # frozen_string_literal: true
 
+require_relative '../utilities/request'
+require_relative '../utilities/cb_model'
+
 module Crunchbase
   # Whole entities endpoints
   module Entities
     # Send request for entities endpoints
     class Client
       include ::Crunchbase::Utilities::Request
-
-      attr_reader :object
+      include ::Crunchbase::Utilities::CbModel
 
       ROOT_LIST = 'entities'
 
-      def initialize(entity_id, model_name)
+      def initialize(entity_id, entity_type)
         @entity_id = entity_id
-        @object = model_name.new
+        @entity_type = entity_type
       end
 
       # Will include all attribute from API document
       def fetch
-        object.parse_response(entity(
-                                root_uri,
-                                field_ids: object.field_ids.join(',')
-                              ))
+        cbobject.parse_response(entity(
+                                  root_uri,
+                                  field_ids: cbobject.field_ids.join(',')
+                                ))
       end
 
       # Only include a part basis fields of endpoint
       def fetch_cards(card_names = [])
-        object.parse_cards_response(entity(
-                                      root_uri,
-                                      field_ids: object.basis_fields.join(','),
-                                      cards: (object.full_cards & card_names).join(',')
-                                    ))
+        cbobject.parse_cards_response(entity(
+                                        root_uri,
+                                        field_ids: cbobject.basis_fields.join(','),
+                                        cards: (cbobject.full_cards & card_names).join(',')
+                                      ))
       end
 
       def cards(card_id)
-        object.parse_response(entity(
-                                root_uri(name: __method__, id: card_id)
-                              ))
+        cbobject.parse_response(entity(
+                                  root_uri(name: __method__, id: card_id)
+                                ))
       end
 
       private
 
       def root_uri(args = {})
         [
-          ROOT_LIST, object.class::RESOURCE_LIST,
+          ROOT_LIST, kclass_name::RESOURCE_LIST,
           @entity_id, args[:name], args[:id]
         ].compact.join('/')
       end

data/lib/crunchbase/models.rb

@@ -7,6 +7,7 @@ module Crunchbase
     autoload :Organization,                 'crunchbase/models/organization'
     autoload :Person,                       'crunchbase/models/person'
     autoload :FundingRound,                 'crunchbase/models/funding_round'
+    autoload :Acquisition,                  'crunchbase/models/acquisition'
     autoload :Investment,                   'crunchbase/models/investment'
     autoload :PressReference,               'crunchbase/models/press_reference'
     autoload :CategoryGroup,                'crunchbase/models/category_group'

data/lib/crunchbase/models/acquisition.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module Crunchbase
+  # Get the Entities data from API
+  module Models
+    # Get the person data from API
+    class Acquisition < Entity
+      RESOURCE_LIST = 'acquisitions'
+
+      def field_ids
+        %w[
+          acquiree_categories
+          acquiree_last_funding_type
+          acquiree_locations
+          acquiree_num_funding_rounds
+          acquiree_revenue_range
+          acquiree_short_description
+          acquirer_categories
+          acquirer_funding_total
+          acquirer_identifier
+          acquirer_locations
+          acquirer_num_funding_rounds
+          acquirer_short_description
+          created_at
+          disposition_of_acquired
+          entity_def_id
+          num_relationships
+          rank
+          rank_acquisition
+          status
+          terms
+          updated_at
+        ] + basis_fields
+      end
+
+      def basis_fields
+        %w[
+          uuid
+          permalink
+          identifier
+          announced_on
+          completed_on
+          acquisition_type
+          price
+          short_description
+          acquiree_funding_total
+          acquiree_identifier
+          acquirer_revenue_range
+        ]
+      end
+
+      def full_cards
+        %w[
+          acquiree_organization
+          acquirer_organization
+          press_references
+        ]
+      end
+    end
+  end
+end

data/lib/crunchbase/models/entity.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require_relative '../utilities/response'
+
 module Crunchbase
   # Get the Organization data from API
   module Models
@@ -11,8 +13,10 @@ module Crunchbase
         field_ids.map(&:to_sym)
       end
 
-      def parse_response(response)
-        dynamic_attributes(self, field_ids, response.dig('properties'))
+      def parse_response(response, request_field_ids = [])
+        extract_fields = (request_field_ids.empty? ? field_ids : request_field_ids)
+
+        dynamic_attributes(self, extract_fields, response.dig('properties'))
       end
 
       def parse_cards_response(response)

data/lib/crunchbase/models/funding_round.rb

@@ -25,7 +25,6 @@ module Crunchbase
           lead_investor_identifiers
           num_partners
           num_relationships
-          permalink
           pre_money_valuation
           rank
           rank_funding_round
@@ -37,6 +36,7 @@ module Crunchbase
         %w[
           uuid
           name
+          permalink
           announced_on
           closed_on
           investment_stage

data/lib/crunchbase/searches/client.rb

@@ -1,29 +1,80 @@
 # frozen_string_literal: true
 
+require_relative '../utilities/request'
+require_relative '../utilities/cb_model'
+
 module Crunchbase
   # Whole Searches endpoints
   module Searches
     # Send request for entities endpoints
+    #
+    # API doc:
+    #   https://app.swaggerhub.com/apis-docs/Crunchbase/crunchbase-enterprise_api/1.0.1#/Search/post_searches_organizations
+    #
+    # Notes
+    #   1. Only can filter `Searchable: Yes` fields
+    #   2. 'name', 'website' can not use
     class Client
       include ::Crunchbase::Utilities::Request
+      include ::Crunchbase::Utilities::CbModel
+
+      attr_accessor :total_count, :count, :entities, :entity_type, :conditions
 
       ROOT_LIST = 'searches'
       LIMIT = 100
 
-      def initialize(field_id, value)
-        @field_id = field_id
-        @value = value
+      def initialize(conditions, entity_type)
+        @conditions = conditions
+        @entity_type = entity_type
       end
 
       # Will include all attribute from API document
-      def search
-        search(root_uri, query_conditions)
+      def searches
+        wrapping!(
+          search(
+            root_uri,
+            data_raw.to_s.gsub('=>', ':')
+          )
+        )
       end
 
       private
 
+      def wrapping!(response)
+        query_results = search_results(response.dig('entities'))
+
+        self.total_count  = response['count']
+        self.entities     = query_results
+        self.count        = query_results.size
+        self
+      end
+
+      def search_results(entities)
+        entities.each_with_object([]) do |entity, objects|
+          objects << cbobject.parse_response(entity, field_ids)
+        end
+      end
+
       def root_uri
-        [ROOT_LIST, endpoint].compact.join('/')
+        [ROOT_LIST, kclass_name::RESOURCE_LIST].compact.join('/')
+      end
+
+      # Post request raw datas
+      def field_ids
+        @conditions['field_ids'] || cbobject.basis_fields
+      end
+
+      def limit
+        @conditions['limit'] || LIMIT
+      end
+
+      def data_raw
+        {
+          'field_ids' => field_ids,
+          'order' => @conditions['order'],
+          'query' => @conditions['query'],
+          'limit' => limit
+        }
       end
     end
   end

data/lib/crunchbase/utilities/cb_model.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Crunchbase
+  # Utilities
+  module Utilities
+    # API Request
+    module CbModel
+      attr_accessor :entity_type
+
+      module_function
+
+      def cbobject
+        kclass_name.new
+      end
+
+      def kclass_name
+        @kclass_name ||= exact_kclass_object
+      end
+
+      def exact_kclass_object
+        return entity_type if entity_type.is_a?(Class)
+
+        cb_type = [
+          'Crunchbase',
+          'Models',
+          entity_type.split('_').map(&:capitalize).join
+        ].join('::')
+        Kernel.const_get("::#{cb_type}")
+      end
+    end
+  end
+end

data/lib/crunchbase/utilities/entity_endpoints.rb

@@ -0,0 +1,91 @@
+# frozen_string_literal: true
+
+module Crunchbase
+  # Utilities
+  module Utilities
+    # All Entity API endpoints
+    module EntityEndpoints
+      # For Entity
+      #
+      # API Parameters
+      #
+      #   entity_id:  UUID or permalink of desired entity
+      #   card_id:    A card to include on the resulting entity
+      #   order:      Field name with order direction (asc/desc)
+      #   limit:      Number of rows to return. Default is 100, min is 1, max is 100.
+
+      # Lookup an Organization or single card
+      def organization(entity_id, card_id: nil)
+        lookup_for('organization', entity_id, card_id)
+      end
+
+      # Lookup Organization's all cards
+      def organization_cards(entity_id, cards: [])
+        entities('organization', entity_id).fetch_cards(cards)
+      end
+
+      # Lookup a Person or single card
+      def person(entity_id, card_id: nil)
+        lookup_for('person', entity_id, card_id)
+      end
+
+      # Lookup Person's all cards
+      def person_cards(entity_id)
+        entities('person', entity_id).fetch_cards
+      end
+
+      # Lookup a Funding Round or single card
+      def funding_round(entity_id, card_id: nil)
+        lookup_for('funding_round', entity_id, card_id)
+      end
+
+      # Lookup Funding Round's all cards
+      def funding_round_cards(entity_id)
+        entities('funding_round', entity_id).fetch_cards
+      end
+
+      # Lookup an Acquisition or Single card
+      def acquisition(entity_id, card_id: nil)
+        lookup_for('acquisition', entity_id, card_id)
+      end
+
+      # Lookup Acquisition's all card
+      def acquisition_cards(entity_id)
+        entities('acquisition', entity_id).fetch_cards
+      end
+
+      # Lookup an Investment or Single card
+      def investment(entity_id, card_id: nil)
+        lookup_for('investment', entity_id, card_id)
+      end
+
+      # Lookup Investment's all card
+      def investment_cards(entity_id)
+        entities('investment', entity_id).fetch_cards
+      end
+
+      # Lookup an PressReference or Single card
+      def press_reference(entity_id, card_id: nil)
+        lookup_for('press_reference', entity_id, card_id)
+      end
+
+      # Lookup PressReference's all card
+      def press_reference_cards(entity_id)
+        entities('press_reference', entity_id).fetch_cards
+      end
+
+      private
+
+      def entities(entity_type, entity_id)
+        Crunchbase::Entities::Client.new(entity_id, entity_type)
+      end
+
+      def lookup_for(entity_type, entity_id, card_id)
+        kobject = entities(entity_type, entity_id)
+        return kobject.fetch if card_id.nil?
+
+        kobject.cards(card_id)
+      end
+    end
+  end
+end

data/lib/crunchbase/utilities/request.rb

@@ -2,6 +2,9 @@
 
 require 'faraday'
 require 'faraday_middleware'
+require 'faraday_curl'
+require 'logger'
+require_relative '../errors'
 
 module Crunchbase
   # Utilities
@@ -10,10 +13,14 @@ module Crunchbase
     module Request
       module_function
 
+      # Entity endpoints
+      #
+      #   https://app.swaggerhub.com/apis-docs/Crunchbase/crunchbase-enterprise_api/1.0.1#/Entity/get_entities_organizations__entity_id_
       def entity(uri, *args)
         response = Faraday.new(url: BASE_URI, headers: headers) do |faraday|
           faraday.adapter Faraday.default_adapter
           faraday.response :json
+          faraday.response :logger, ::Logger.new(STDOUT), bodies: true if debug_mode?
         end.get(uri, *args)
 
         return response.body if response.status == 200
@@ -21,10 +28,15 @@ module Crunchbase
         raise Error, response.reason_phrase
       end
 
+      # Search endpoints
+      #
+      #   https://app.swaggerhub.com/apis-docs/Crunchbase/crunchbase-enterprise_api/1.0.1#/Search/post_searches_organizations
       def search(uri, args)
-        response = Faraday.new(url: BASE_URI, headers: headers) do |faraday|
+        response = Faraday.new(url: BASE_URI, headers: post_headers) do |faraday|
           faraday.adapter Faraday.default_adapter
           faraday.response :json
+          faraday.request :curl, ::Logger.new(STDOUT), :warn if debug_mode?
+          faraday.response :logger, ::Logger.new(STDOUT), bodies: true if debug_mode?
         end.post(uri, args)
 
         return response.body if response.status == 200
@@ -34,6 +46,16 @@ module Crunchbase
 
       private
 
+      def debug_mode?
+        Crunchbase.config.debug || false
+      end
+
+      def post_headers
+        headers.merge(
+          'Content-Type' => 'application/json'
+        )
+      end
+
       def headers
         {
           'X-cb-user-key' => Crunchbase.config.user_key

data/lib/crunchbase/utilities/response.rb

@@ -10,18 +10,20 @@ module Crunchbase
       def dynamic_attributes(object, attribute_names, response)
         attribute_names.each do |attribute_name|
           attribute_value = field_value(attribute_name, response)
+          dynamic_define_method(object, attribute_name, attribute_value)
+        end
 
-          # Manually creates methods for both getter and setter and then
-          #   sends a message to the new setter with the attribute_value
-          object.class.send(:define_method, "#{attribute_name}=".to_sym) do |value|
-            instance_variable_set('@' + attribute_name, value)
-          end
+        [attribute_names & special_attributes].flatten.each do |attribute_name|
+          attribute_names.delete(attribute_name)
+          hash_datas = response&.dig(attribute_name)
 
-          object.class.send(:define_method, attribute_name.to_sym) do
-            instance_variable_get('@' + attribute_name.to_s)
-          end
+          values = hash_datas&.map { |k, v| v if %w[uuid permalink].include?(k) }&.compact || []
+          dynamic_define_method(object, attribute_name, values)
+          hash_datas&.keys&.each do |key|
+            next unless %w[uuid permalink].include?(key)
 
-          object.send("#{attribute_name}=".to_sym, attribute_value)
+            dynamic_define_method(object, key, hash_datas&.dig(key))
+          end
         end
 
         object
@@ -29,13 +31,32 @@ module Crunchbase
 
       private
 
+      def dynamic_define_method(object, attribute_name, attribute_value)
+        # Manually creates methods for both getter and setter and then
+        #   sends a message to the new setter with the attribute_value
+        object.class.send(:define_method, "#{attribute_name}=".to_sym) do |value|
+          instance_variable_set('@' + attribute_name, value)
+        end
+
+        object.class.send(:define_method, attribute_name.to_sym) do
+          instance_variable_get('@' + attribute_name.to_s)
+        end
+
+        object.send("#{attribute_name}=".to_sym, attribute_value)
+      end
+
+      # This is hash attributes
+      #
+      #   1. identifier
+      def special_attributes
+        %w[identifier]
+      end
+
       def field_value(name, data)
         value = data.dig(name)
 
         return value if value.nil? || value.is_a?(String)
-        if value.is_a?(Array) && value[0].is_a?(Hash) && value[0].keys.include?('value')
-          return value.collect { |e| e.dig('value') }
-        end
+        return value.collect { |e| e.dig('value') } if value.is_a?(Array) && value[0].is_a?(Hash) && value[0].keys.include?('value')
         return value.dig('value') if value.is_a?(Hash) && value.keys.include?('value')
 
         value

data/lib/crunchbase/utilities/search_endpoints.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Crunchbase
+  # Utilities
+  module Utilities
+    # All Searches API endpoint
+    module SearchEndpoints
+      # For Searches
+      def search_organizations(raw_data)
+        searches(raw_data, 'organization').searches
+      end
+
+      def search_funding_rounds(raw_data)
+        searches(raw_data, 'funding_round').searches
+      end
+
+      private
+
+      def searches(raw_data, scope_name)
+        Crunchbase::Searches::Client.new(raw_data, scope_name)
+      end
+    end
+  end
+end

data/lib/crunchbase/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Crunchbase
-  VERSION = '0.1.0'
+  VERSION = '0.1.1'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: crunchbase4
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Encore Shao
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-06-04 00:00:00.000000000 Z
+date: 2020-06-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -24,6 +24,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: faraday_curl
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: faraday_middleware
   requirement: !ruby/object:Gem::Requirement
@@ -94,10 +108,10 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description: A Ruby wrapper for Crunchbase API version 4.0, crunchbase build new API
-  interface by GraphQL
+description: 'Crunchbase is a ruby wrapper base on Crunchbase V4 API. It provides
+  easy to get the API data by each endpoint. '
 email:
-- encore.shao@gmail.com
+- encore@ekohe.com
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -124,6 +138,7 @@ files:
 - lib/crunchbase/entities/client.rb
 - lib/crunchbase/errors.rb
 - lib/crunchbase/models.rb
+- lib/crunchbase/models/acquisition.rb
 - lib/crunchbase/models/category.rb
 - lib/crunchbase/models/category_group.rb
 - lib/crunchbase/models/entity.rb
@@ -134,19 +149,21 @@ files:
 - lib/crunchbase/models/press_reference.rb
 - lib/crunchbase/searches.rb
 - lib/crunchbase/searches/client.rb
-- lib/crunchbase/searches/organization.rb
 - lib/crunchbase/utilities.rb
+- lib/crunchbase/utilities/cb_model.rb
+- lib/crunchbase/utilities/entity_endpoints.rb
 - lib/crunchbase/utilities/request.rb
 - lib/crunchbase/utilities/response.rb
+- lib/crunchbase/utilities/search_endpoints.rb
 - lib/crunchbase/version.rb
-homepage: https://github.com/encoreshao/crunchbase4
+homepage: https://github.com/ekohe/crunchbase4
 licenses:
 - MIT
 metadata:
   allowed_push_host: https://rubygems.org
-  homepage_uri: https://github.com/encoreshao/crunchbase4
-  source_code_uri: https://github.com/encoreshao/crunchbase4
-  changelog_uri: https://github.com/encoreshao/crunchbase4/CHANGELOG.md
+  homepage_uri: https://github.com/ekohe/crunchbase4
+  source_code_uri: https://github.com/ekohe/crunchbase4
+  changelog_uri: https://github.com/ekohe/crunchbase4/CHANGELOG.md
 post_install_message: Thanks for installing!
 rdoc_options: []
 require_paths:
@@ -165,5 +182,5 @@ requirements: []
 rubygems_version: 3.0.3
 signing_key: 
 specification_version: 4
-summary: Ruby Library for Crunchbase API Version 4.0
+summary: Crunchbase is a ruby wrapper base on Crunchbase V4 API
 test_files: []

data/lib/crunchbase/searches/organization.rb

@@ -1,52 +0,0 @@
-# frozen_string_literal: true
-
-module Crunchbase
-  # Whole Searches endpoints
-  module Searches
-    # Send request for entities endpoints
-    class Organization < Client
-      include ::Crunchbase::Utilities::Request
-
-      def endpoint
-        ::Crunchbase::Models::Organization::RESOURCE_LIST
-      end
-
-      def query_conditions
-        {
-          "field_ids": field_ids,
-          "order": orders,
-          "query": conditions,
-          "limit": LIMIT
-        }
-      end
-
-      private
-
-      def field_ids
-        ::Crunchbase::Models::Organization.new.basis_fields
-      end
-
-      def orders
-        [
-          {
-            "field_id": 'name',
-            "sort": 'asc'
-          }
-        ]
-      end
-
-      def conditions
-        [
-          {
-            "type": 'predicate',
-            "field_id": @field,
-            "operator_id": 'includes',
-            "values": [
-              @value
-            ]
-          }
-        ]
-      end
-    end
-  end
-end