crunchbase 0.2.0 → 0.2.1

data/README.rdoc

@@ -40,6 +40,9 @@ an array.
    first_result = s[0]
    s.each { |result| puts result.name }
   
+The Search will return a list consisting of objects of the SearchResult type. To
+access the full entity object, call the +entity+ method of the SearchResult.
+
 While Search does include the Enumerable module, it does not implement all of 
 the methods of Array. If you need to treat the results as an array in a way not
 supported, you can call +to_ary+; this prefetches all result pages (if they have
@@ -47,7 +50,6 @@ not already been loaded), so it may entail a slight delay, depending on the
 number of results.
 
    all_results = s.to_ary
-   result_slice = s[3..6]
 
 === List all Items
 
@@ -59,9 +61,10 @@ type, you can do so with the +all+ method.
     
 This returns an array containing objects representing each entity. Just like 
 Search, the full item can be grabbed with the +entity+ method. Unlike Search,
-however, all of the items are pre-fetched, so iterating through the list does
-not entail a delay every ten items. Of course, the list is probably enormous,
-so it's little consolation.
+however, all of the result objects are fetched at once, so iterating through the 
+list does not entail a delay every ten items. Of course, the list is enormous
+(the list of all companies returns over 84,500 entries as of this writing), so 
+it's little consolation.
 
 == Copyright
 
@@ -69,4 +72,4 @@ Copyright (c) 2011-12 Tyler Cunnion. This software is made available under the
 MIT/X11 license. See LICENSE.txt for further details.
 
 I am not affiliated in any way with AOL, TechCrunch, Crunchbase, or anyone
-really.
+really.

data/VERSION

@@ -1 +1 @@
-0.2.0
+0.2.1

data/crunchbase.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{crunchbase}
-  s.version = "0.2.0"
+  s.version = "0.2.1"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = [%q{Tyler Cunnion}]
-  s.date = %q{2012-02-28}
+  s.date = %q{2012-03-16}
   s.email = %q{tyler.cunnion@gmail.com}
   s.extra_rdoc_files = [
     "LICENSE.txt",

data/lib/crunchbase.rb

@@ -17,5 +17,5 @@ require 'crunchbase/search_result'
 require 'crunchbase/crunch_exception'
 
 module Crunchbase
-  VERSION = "0.2.0"
-end
+  VERSION = "0.2.1"
+end

data/lib/crunchbase/search.rb

@@ -32,15 +32,20 @@ module Crunchbase
       populate_results(json)
     end
     
-    def [](key)
-      if key.kind_of?(Integer)
-        r = @results[key]
-        unless r.nil? && key < @size
-          r
-        else
-          retrieve_for_index(key)
-          @results[key]
+    def [](*args)
+      case args.length
+      when 1
+        key = args[0]
+        if key.kind_of?(Integer)
+          get_single_key(key)
+        elsif key.kind_of?(Range)
+          get_range(key)
         end
+      when 2
+        start = args[0]
+        length = args[1]
+        start = @size + start if start < 0
+        get_range(start..start+length-1)
       end
     end
     
@@ -59,6 +64,7 @@ module Crunchbase
     
     private
     
+    # Inserts items into the results array from the retrieved search page
     def populate_results(json)
       page = json["page"]
       results = json["results"].map{|r| SearchResult.new(r)}
@@ -66,9 +72,36 @@ module Crunchbase
       @results[start, results.length] = results
     end
     
+    # Retrieves the search page containing the given index
     def retrieve_for_index(index)
       page = (index / 10) + 1
       populate_results(API.search(@query, page))
     end
+
+    # Given one integer key, returns the indexed object from results
+    def get_single_key(key)
+      key = @size+key if key < 0
+      r = @results[key]
+      unless r.nil? && key < @size
+        r
+      else
+        retrieve_for_index(key)
+        @results[key]
+      end
+    end
+
+    # Given a range, returns the array slice of results indicated
+    def get_range(range)
+      r = []
+      enum = range.to_enum
+      begin
+        while (x = enum.next) < @size
+          r << get_single_key(x)
+        end
+      rescue StopIteration
+      end
+      r.empty? ? nil : r
+    end
+    
   end
-end
+end

data/spec/crunchbase/search_spec.rb

@@ -9,6 +9,48 @@ module Crunchbase
       s[0].class.should == SearchResult
     end
     
+    describe "advanced indexing" do
+      before(:all) do
+        @s = Search.find('google')
+      end
+
+      it "should return slices with ranges" do
+        slice = @s[8..11]
+        slice.class.should == Array
+        slice[0].class.should == SearchResult
+      end
+
+      it "should return abbreviated slice for range with upper out of range" do
+        slice = @s[@s.size-3..@s.size+2]
+        slice.length.should == 3
+      end
+
+      it "should return nil for slice out of range" do
+        slice = @s[@s.size..@s.size+4]
+        slice.should == nil
+      end
+
+      it "should slice with two arguments" do
+        start = @s.size / 3
+        slice = @s[start, 5]
+        slice.length.should == 5
+        slice[0].class.should == SearchResult
+      end
+
+      it "should slice with negative start" do
+        slice = @s[-12, 4]
+        slice.length.should == 4
+        slice[0].class.should == SearchResult
+      end
+
+    end #Indexing 
+
+    it "should accept negative indices" do
+      s = Search.find('google')
+      s[-13].should == s[s.size-13]
+      s[-13].class.should == SearchResult
+    end
+    
     it "should return higher search results" do
       s = Search.find('google')
       s[s.size/2].class.should == SearchResult

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: crunchbase
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-02-28 00:00:00.000000000Z
+date: 2012-03-16 00:00:00.000000000Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &70327968354500 !ruby/object:Gem::Requirement
+  requirement: &70161600273460 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +21,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70327968354500
+  version_requirements: *70161600273460
 - !ruby/object:Gem::Dependency
   name: bundler
-  requirement: &70327968353340 !ruby/object:Gem::Requirement
+  requirement: &70161600233040 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -32,10 +32,10 @@ dependencies:
         version: 1.0.0
   type: :development
   prerelease: false
-  version_requirements: *70327968353340
+  version_requirements: *70161600233040
 - !ruby/object:Gem::Dependency
   name: jeweler
-  requirement: &70327968352400 !ruby/object:Gem::Requirement
+  requirement: &70161600230540 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -43,10 +43,10 @@ dependencies:
         version: 1.6.4
   type: :development
   prerelease: false
-  version_requirements: *70327968352400
+  version_requirements: *70161600230540
 - !ruby/object:Gem::Dependency
   name: rcov
-  requirement: &70327968350960 !ruby/object:Gem::Requirement
+  requirement: &70161600229340 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -54,10 +54,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70327968350960
+  version_requirements: *70161600229340
 - !ruby/object:Gem::Dependency
   name: rdoc
-  requirement: &70327968349800 !ruby/object:Gem::Requirement
+  requirement: &70161600227720 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -65,7 +65,7 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70327968349800
+  version_requirements: *70161600227720
 description: 
 email: tyler.cunnion@gmail.com
 executables: []
@@ -125,7 +125,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 2248363577786522930
+      hash: 4593283541442877220
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements: