crunchbase 0.3.0 → 0.4.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 75f6513e17d35d263ca659edccd32390cf2e69a8
+  data.tar.gz: 21e3fd611e361296911d0ca4dba27b2061852fca
+SHA512:
+  metadata.gz: ceb82a4cdd8e27e6ece53db621c3e0b17122a4d60c7f46f9178a84d282e131d17828661eb2c25715651c471a0504e9e9df7c3628f5b4bfe906a1f6458e794613
+  data.tar.gz: 04e6e289b6b883676722495abe2406ce0a996e9bf505278a4b67f364d488c40d8d525f1f87e1e5fb172662d24bc27b9d6ff30eb2290720bcdd090ab38bc0201e

data/README.rdoc

@@ -36,7 +36,12 @@ the actual data.
 Searching the Crunchbase is possible with the Search class.
 
    s = Crunchbase::Search.find("widgets")
-   
+
+You can also search by location using the Location class. Searches can be by city,
+state, zip, country-code, etc.
+
+   l = Crunchbase::Location.geo("San Francisco")
+
 You can access the search results by treating the returned Search instance as
 an array.
 

data/lib/crunchbase.rb

@@ -1,6 +1,9 @@
 require 'crunchbase/api'
 require 'crunchbase/cb_object'
 require 'crunchbase/date_methods'
+require 'crunchbase/array_from_list'
+require 'crunchbase/image'
+require 'crunchbase/milestone'
 require 'crunchbase/company'
 require 'crunchbase/financial_organization'
 require 'crunchbase/investment'
@@ -17,5 +20,5 @@ require 'crunchbase/search_result'
 require 'crunchbase/crunch_exception'
 
 module Crunchbase
-  VERSION = "0.3.0"
+  VERSION = "0.4.0"
 end

data/lib/crunchbase/api.rb

@@ -56,6 +56,13 @@ module Crunchbase
       get_json_response(uri)
     end
 
+    # Fetches URI for geographic search interface
+    def self.geo(query, page=1)
+      require "cgi"
+      uri = CB_URL + "search.js?geo=#{CGI.escape(query)}&page=#{page}"
+      get_json_response(uri)
+    end
+
     # Searches for a permalink in a particular category.
     def self.permalink(parameters, category)
       require "cgi"

data/lib/crunchbase/array_from_list.rb

@@ -0,0 +1,9 @@
+module Crunchbase
+    module ArrayFromList
+        # Takes a list (directly from the JSON hash) and returns an
+        # array of instances of the class
+        def array_from_list(list)
+            list.map {|l| self.new(l) }
+        end
+    end
+end

data/lib/crunchbase/cb_object.rb

@@ -9,12 +9,12 @@ module Crunchbase
     
     # Returns an array of tags
     def tags
-      @tag_list.respond_to?('split') ? @tag_list.split(', ') : []
+      @tag_list.respond_to?('split') ? @tag_list.split(/,\s*/) : []
     end
     
     # Returns an array of aliases
     def aliases
-      @alias_list.respond_to?('split') ? @alias_list.split(", ") : []
+      @alias_list.respond_to?('split') ? @alias_list.split(/,\s*/) : []
     end
     
     # Factory method to return an instance from a permalink  
@@ -24,10 +24,14 @@ module Crunchbase
       return e
     end
     
+    # Finds an entity by its name. Uses two HTTP requests; one to find the
+    # permalink, and another to request the actual entity.
     def self.find(name)
       get(API.permalink({name: name}, self::ENT_PLURAL)["permalink"])
     end
     
+    # Requests a list of all entities of a given type. Returns the list as an
+    # array of EntityListItems.
     def self.all
       all = API.all(self::ENT_PLURAL).map do |ent|
         ent["namespace"] = self::ENT_NAME
@@ -45,4 +49,4 @@ module Crunchbase
     end
     
   end
-end
+end

data/lib/crunchbase/company.rb

@@ -11,10 +11,11 @@ module Crunchbase
     attr_reader :name, :permalink, :crunchbase_url, :homepage_url, :blog_url,
       :blog_feed_url, :twitter_username, :category_code, :number_of_employees,
       :deadpooled_url, :email_address, :phone_number, :description, 
-      :created_at, :updated_at, :overview, :image, :relationships, 
-      :competitions, :providerships, :total_money_raised, :funding_rounds, 
-      :investments, :acquisition, :acquisitions, :offices, :milestones, :ipo, 
-      :video_embeds, :screenshots, :external_links
+      :created_at, :updated_at, :overview, :image, :competitions, 
+      :total_money_raised, :funding_rounds, :acquisition, :acquisitions,
+      :offices, :ipo, :video_embeds, :screenshots, :external_links,
+      :deadpooled_year, :deadpooled_month, :deadpooled_day,
+      :founded_year, :founded_month, :founded_day
     
     def initialize(json)
       @name = json["name"]
@@ -41,29 +42,54 @@ module Crunchbase
       @created_at = DateTime.parse(json["created_at"])
       @updated_at = DateTime.parse(json["updated_at"])
       @overview = json["overview"]
-      @image = json["image"]
+      @image = Image.create(json["image"])
       @products_list = json["products"]
-      @relationships = Relationship.array_from_relationship_list(json["relationships"]) if json["relationships"]
+      @relationships_list = json["relationships"]
       @competitions = json["competitions"]
-      @providerships = Relationship.array_from_relationship_list(json["providerships"]) if json["providerships"]
+      @providerships_list = json["providerships"]
       @total_money_raised = json["total_money_raised"]
       @funding_rounds = json["funding_rounds"]
-      @investments = Investment.array_from_investment_list(json['investments']) if json['investments']
+      @investments_list = json['investments']
       @acquisition = json["acquisition"]
       @acquisitions = json["acquisitions"]
       @offices = json["offices"]
-      @milestones = json["milestones"]
+      @milestones_list = json["milestones"]
       @ipo = json["ipo"]
       @video_embeds = json["video_embeds"]
       @screenshots = json["screenshots"]
       @external_links = json["external_links"]
     end
+
+    def relationships
+      @relationships ||= Relationship.array_from_list(@relationships_list)
+    end
+
+    def providerships
+      @providerships ||= Relationship.array_from_list(@providerships_list)
+    end
+
+    def investments
+      @investments ||= Investment.array_from_list(@investments_list)
+    end
+
+    def milestones
+      @milestones ||= Milestone.array_from_list(@milestones_list)
+    end
+
+    def founded?
+      !!(@founded_year || @founded_month || @founded_day)
+    end
     
     # Returns the date the company was founded, or nil if not provided.
     def founded
       @founded ||= date_from_components(@founded_year, @founded_month, @founded_day)   
     end
     
+    # Returns whether the company has a deadpooled date component
+    def deadpooled?
+      !!(@deadpooled_year || @deadpooled_month || @deadpooled_day)
+    end
+
     # Returns the date the company was deadpooled, or nil if not provided.
     def deadpooled
       @deadpooled ||= date_from_components(@deadpooled_year, @deadpooled_month, @deadpooled_day)

data/lib/crunchbase/financial_organization.rb

@@ -11,8 +11,8 @@ module Crunchbase
     attr_reader :name, :permalink, :crunchbase_url, :homepage_url, :blog_url,
       :blog_feed_url, :twitter_username, :phone_number, :description,
       :email_address, :number_of_employees, :created_at, :updated_at, 
-      :overview, :image, :offices, :relationships, :investments, :milestones, 
-      :providerships, :funds, :video_embeds, :external_links
+      :overview, :image, :offices, :funds, :video_embeds, :external_links,
+      :founded_year, :founded_month, :founded_day
     
     def initialize(json)
       @name = json['name']
@@ -34,17 +34,37 @@ module Crunchbase
       @created_at = DateTime.parse(json["created_at"])
       @updated_at = DateTime.parse(json["updated_at"])
       @overview = json['overview']
-      @image = json['image']
+      @image = Image.create(json['image'])
       @offices = json['offices']
-      @relationships = Relationship.array_from_relationship_list(json["relationships"]) if json["relationships"]
-      @investments = Investment.array_from_investment_list(json['investments']) if json['investments']
-      @milestones = json['milestones']
-      @providerships = Relationship.array_from_relationship_list(json['providerships']) if json["providerships"]
+      @relationships_list = json["relationships"]
+      @investments_list = json['investments']
+      @milestones_list = json['milestones']
+      @providerships_list = json["providerships"]
       @funds = json['funds']
       @video_embeds = json['video_embeds']
       @external_links = json['external_links']
     end
     
+    def relationships
+      @relationships ||= Relationship.array_from_list(@relationships_list)
+    end
+
+    def providerships
+      @providerships ||= Relationship.array_from_list(@providerships_list)
+    end
+
+    def investments
+      @investments ||= Investment.array_from_list(@investments_list)
+    end
+
+    def milestones
+      @milestones ||= Milestone.array_from_list(@milestones_list)
+    end
+
+    def founded?
+      !!(@founded_year || @founded_month || @founded_day)
+    end
+
     # Returns the date the financial org was founded, or nil if not provided.
     def founded
       @founded ||= date_from_components(@founded_year, @founded_month, @founded_day)    

data/lib/crunchbase/image.rb

@@ -0,0 +1,36 @@
+module Crunchbase
+    class Image
+        
+        def self.create(hash)
+            hash ? self.new(hash) : nil
+        end
+
+        attr_reader :attribution, :sizes
+
+        def initialize(hash)
+            return nil unless hash
+            @attribution = hash['attribution']
+            @sizes = hash['available_sizes'].map{|s| ImageSize.new(s)}.sort
+        end
+    end
+
+    class ImageSize
+        include Comparable
+
+        attr_reader :height, :width, :url
+
+        def <=>(anOther)
+            pixels <=> anOther.pixels
+        end
+
+        def initialize(ary)
+            @width = ary[0][0]
+            @height = ary[0][1]
+            @url = ary[1]
+        end
+        
+        def pixels
+            return @width * @height
+        end
+    end
+end

data/lib/crunchbase/investment.rb

@@ -2,15 +2,13 @@ module Crunchbase
   class Investment
     
     include Crunchbase::DateMethods
+    self.extend Crunchbase::ArrayFromList
     
     attr_reader :funding_round_code, :funding_source_url,
       :funding_source_description, :raised_amount, :raised_currency_code, 
+      :funded_year, :funded_month, :funded_day,
       :company_name, :company_permalink
     
-    def self.array_from_investment_list(list)
-      list.map{|l| self.new(l)}
-    end
-    
     def initialize(hash)
       hash = hash["funding_round"]
       @funding_round_code = hash["round_code"]
@@ -32,10 +30,14 @@ module Crunchbase
       @company = Company.get(@company_permalink)
       return @company
     end
+
+    def funded_date?
+      !!(@funded_year || @funded_month || @funded_day)
+    end
     
     def funded_date
       @funded_date ||= date_from_components(@funded_year, @funded_month, @funded_day)
     end
       
   end
-end
+end

data/lib/crunchbase/milestone.rb

@@ -0,0 +1,33 @@
+module Crunchbase
+  class Milestone
+    attr_reader :description, :source_url, :source_text, 
+      :source_description, :stoneable_type, :stoned_value,
+      :stoned_value_type, :stoned_acquirer,
+      :stoned_year, :stoned_month, :stoned_year
+
+    include Crunchbase::DateMethods
+    self.extend Crunchbase::ArrayFromList
+    
+    def initialize(obj)
+      @description = obj['description']
+      @stoned_year = obj['stoned_year']
+      @stoned_month = obj['stoned_month']
+      @stoned_day = obj['stoned_day']
+      @source_url = obj['source_url']
+      @source_text = obj['source_text']
+      @source_description = obj['source_description']
+      @stoneable_type = obj['stoneable_type']
+      @stoned_value = obj['stoned_value']
+      @stoned_value_type = obj['stoned_value_type']
+      @stoned_acquirer = obj['stoned_acquirer']
+    end
+
+    def date?
+      !!(@stoned_year || @stoned_month || @stoned_day)
+    end
+
+    def date 
+      @date ||= date_from_components(@stoned_year, @stoned_month, @stoned_day)
+    end
+  end
+end

data/lib/crunchbase/person.rb

@@ -10,8 +10,8 @@ module Crunchbase
     attr_reader :first_name, :last_name, :permalink, :crunchbase_url,
       :homepage_url, :birthplace, :twitter_username, :blog_url, :blog_feed_url,
       :affiliation_name, :created_at, :updated_at, :overview, :created_at, 
-      :updated_at, :overview, :relationships, :investments, :milestones, 
-      :video_embeds, :external_links, :web_presences
+      :updated_at, :image, :video_embeds, :external_links, :web_presences,
+      :born_year, :born_month, :born_day
 
     def self.find(first_name, last_name)
       get(API.permalink({first_name: first_name, last_name: last_name}, "people")["permalink"])
@@ -36,15 +36,31 @@ module Crunchbase
       @created_at = DateTime.parse(json["created_at"])
       @updated_at = DateTime.parse(json["updated_at"])
       @overview = json["overview"]
-      
-      @relationships = Relationship.array_from_relationship_list(json["relationships"]) if json["relationships"]
-      @investments = Investment.array_from_investment_list(json["investments"]) if json["investments"]
-      @milestones = json["milestones"]
+      @image = Image.create(json["image"])
+      @relationships_list = json["relationships"]
+      @investments_list = json["investments"]
+      @milestones_list = json["milestones"]
       @video_embeds = json["video_embeds"]
       @external_links = json["external_links"]
       @web_presences = json["web_presences"]
     end
     
+    def relationships
+      @relationships ||= Relationship.array_from_list(@relationships_list)
+    end
+
+    def investments
+      @investments ||= Investment.array_from_list(@investments_list)
+    end
+
+    def milestones
+      @milestones ||= Milestone.array_from_list(@milestones_list)
+    end
+
+    def born?
+      !!(@born_year || @born_month || @born_day)
+    end
+    
     # Returns a date object, or nil if Date cannot be created from
     # provided information.
     def born

data/lib/crunchbase/product.rb

@@ -9,9 +9,10 @@ module Crunchbase
     
     attr_reader :name, :permalink, :crunchbase_url, :homepage_url, :blog_url,
       :blog_feed_url, :twitter_username, :stage_code, :deadpooled_url,
+      :deadpooled_year, :deadpooled_month, :deadpooled_day,
+      :launched_year, :launched_month, :launched_day,
       :invite_share_url, :created_at, :updated_at, :overview, :image, 
-      :company_permalink, :company_name, :milestones, :video_embeds, 
-      :external_links
+      :company_permalink, :company_name, :video_embeds, :external_links
     
     def initialize(json)
       @name = json['name']
@@ -35,18 +36,30 @@ module Crunchbase
       @created_at = DateTime.parse(json['created_at'])
       @updated_at = DateTime.parse(json['updated_at'])
       @overview = json['overview']
-      @image = json['image']
+      @image = Image.create(json["image"])
       @company_permalink = json['company']['permalink']
       @company_name = json['company']['name']
-      @milestones = json['milestones']
+      @milestones_list = json['milestones']
       @video_embeds = json['video_embeds']
       @external_links = json['external_links']
     end
       
+    def milestones
+      @milestones ||= Milestone.array_from_list(@milestones_list)
+    end
+
+    def deadpooled?
+      !!(@deadpooled_year || @deadpooled_month || @deadpooled_day)
+    end
+    
     # Returns the date the product was deadpooled, or nil if not provided.
     def deadpooled
       @deadpooled ||= date_from_components(@deadpooled_year, @deadpooled_month, @deadpooled_day)
     end    
+
+    def launched?
+      !!(@launched_year || @launched_month || @launched_day)
+    end
     
     # Returns the date the product was launched, or nil if not provided.
     def launched

data/lib/crunchbase/relationship.rb

@@ -7,7 +7,7 @@ module Crunchbase
     
     # Takes a relationship list (directly from the JSON hash) and returns an
     # array of instances of Relationship subclasses.
-    def self.array_from_relationship_list(list)
+    def self.array_from_list(list)
       list.map do |l|
         if l["person"]
           PersonRelationship.new(l)
@@ -37,4 +37,4 @@ module Crunchbase
       @is_past
     end    
   end
-end
+end