analysand 1.0.1 → 1.1.0

data/spec/analysand/view_streaming_spec.rb

@@ -0,0 +1,122 @@
+require 'spec_helper'
+
+require 'analysand/database'
+require 'benchmark'
+
+require File.expand_path('../a_response', __FILE__)
+
+module Analysand
+  describe Database do
+    let(:db) { Database.new(database_uri) }
+    let(:row_count) { 10000 }
+
+    before(:all) do
+      WebMock.disable!
+    end
+
+    after(:all) do
+      WebMock.enable!
+    end
+
+    before(:all) do
+      clean_databases!
+
+      doc = {
+        'views' => {
+          'a_view' => {
+            'map' => %Q{
+              function (doc) {
+                var i;
+
+                for(i = 0; i < #{row_count}; i++) {
+                  emit(doc['_id'], i);
+                }
+              }
+            }
+          }
+        }
+      }
+
+      db.put!('_design/doc', doc, admin_credentials)
+      db.put!('abc123', {}, admin_credentials)
+    end
+
+    shared_examples_for 'a view streamer' do
+      def get_view(options = {})
+        db.send(method, 'doc/a_view', options)
+      end
+
+      describe 'response' do
+        it_should_behave_like 'a response' do
+          let(:response) { get_view(:stream => true) }
+        end
+      end
+
+      it 'returns all rows in order' do
+        resp = get_view(:stream => true)
+
+        resp.rows.map { |r| r['value'] }.should == (0...row_count).to_a
+      end
+
+      it 'yields docs' do
+        resp = get_view(:include_docs => true, :stream => true)
+
+        resp.docs.take(10).all? { |d| d.has_key?('_id') }.should be_true
+      end
+
+      it 'returns rows as soon as possible' do
+        # first, make sure the view's built
+        db.head('_design/doc/_view/a_view', admin_credentials)
+
+        streamed = Benchmark.realtime do
+          resp = get_view(:stream => true)
+          resp.rows.take(10)
+        end
+
+        read_everything = Benchmark.realtime do
+          resp = get_view
+          resp.rows.take(10)
+        end
+
+        streamed.should_not be_within(0.5).of(read_everything)
+      end
+
+      it 'returns view metadata' do
+        resp = get_view(:stream => true)
+
+        resp.total_rows.should == row_count
+        resp.offset.should == 0
+      end
+
+      describe '#each' do
+        it 'returns an Enumerator if no block is given' do
+          resp = get_view(:stream => true)
+
+          resp.rows.each.should be_instance_of(Enumerator)
+        end
+      end
+    end
+
+    describe '#view in streaming mode' do
+      it_should_behave_like 'a view streamer' do
+        let(:method) { :view }
+      end
+
+      it 'returns error codes from failures' do
+        resp = db.view('doc/nonexistent', :stream => true)
+
+        resp.code.should == '404'
+      end
+    end
+
+    describe '#view! in streaming mode' do
+      it_should_behave_like 'a view streamer' do
+        let(:method) { :view! }
+      end
+
+      it 'raises CannotAccessView on failure' do
+        lambda { db.view!('doc/nonexistent', :stream => true) }.should raise_error(CannotAccessView)
+      end
+    end
+  end
+end

data/spec/fixtures/vcr_cassettes/view.yml

@@ -0,0 +1,40 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: http://localhost:5984/analysand_test/_design/doc/_view/a_view
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Accept:
+      - ! '*/*'
+      User-Agent:
+      - Ruby
+      Connection:
+      - keep-alive
+      Keep-Alive:
+      - 30
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Transfer-Encoding:
+      - chunked
+      Server:
+      - CouchDB/1.2.0 (Erlang OTP/R15B)
+      Etag:
+      - ! '"D4N5T8QITOHPR5PN1FFNNQ9JA"'
+      Date:
+      - Fri, 02 Nov 2012 14:33:24 GMT
+      Content-Type:
+      - text/plain; charset=utf-8
+      Cache-Control:
+      - must-revalidate
+    body:
+      encoding: US-ASCII
+      string: ! "{\"total_rows\":1,\"offset\":0,\"rows\":[\r\n{\"id\":\"abc123\",\"key\":\"abc123\",\"value\":1}\r\n]}\n"
+    http_version: 
+  recorded_at: Fri, 02 Nov 2012 14:33:24 GMT
+recorded_with: VCR 2.3.0

data/spec/support/database_access.rb

@@ -32,8 +32,8 @@ module DatabaseAccess
   ##
   # Resets member and admin lists for the test database to [].
   def clear_security
-    set_security({ 'users' => [], 'roles' => [] },
-                 { 'users' => [], 'roles' => [] })
+    set_security({ 'names' => [], 'roles' => [] },
+                 { 'names' => [], 'roles' => [] })
   end
 end
 

metadata

@@ -1,192 +1,208 @@
 --- !ruby/object:Gem::Specification
 name: analysand
 version: !ruby/object:Gem::Version
+  version: 1.1.0
   prerelease: 
-  version: 1.0.1
 platform: ruby
 authors:
 - David Yip
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-10-01 00:00:00.000000000 Z
+date: 2012-11-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  prerelease: false
   name: celluloid
-  type: :runtime
-  version_requirements: !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
+    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0.12'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
     none: false
-  requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0.12'
-    none: false
 - !ruby/object:Gem::Dependency
-  prerelease: false
   name: celluloid-io
-  type: :runtime
-  version_requirements: !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
+    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
     none: false
-  requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
-    none: false
 - !ruby/object:Gem::Dependency
-  prerelease: false
   name: http_parser.rb
-  type: :runtime
-  version_requirements: !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
+    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
     none: false
-  requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
-    none: false
 - !ruby/object:Gem::Dependency
-  prerelease: false
   name: json
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :runtime
+  prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
+    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
-    none: false
+- !ruby/object:Gem::Dependency
+  name: json-stream
   requirement: !ruby/object:Gem::Requirement
+    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
-    none: false
-- !ruby/object:Gem::Dependency
-  prerelease: false
-  name: net-http-persistent
   type: :runtime
+  prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
+    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
-    none: false
+- !ruby/object:Gem::Dependency
+  name: net-http-persistent
   requirement: !ruby/object:Gem::Requirement
+    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
-    none: false
-- !ruby/object:Gem::Dependency
-  prerelease: false
-  name: rack
   type: :runtime
+  prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
+    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
-    none: false
+- !ruby/object:Gem::Dependency
+  name: rack
   requirement: !ruby/object:Gem::Requirement
+    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
-    none: false
-- !ruby/object:Gem::Dependency
-  prerelease: false
-  name: yajl-ruby
   type: :runtime
+  prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
+    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
-    none: false
+- !ruby/object:Gem::Dependency
+  name: yajl-ruby
   requirement: !ruby/object:Gem::Requirement
+    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
-    none: false
-- !ruby/object:Gem::Dependency
+  type: :runtime
   prerelease: false
-  name: rake
-  type: :development
   version_requirements: !ruby/object:Gem::Requirement
+    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
-    none: false
+- !ruby/object:Gem::Dependency
+  name: rake
   requirement: !ruby/object:Gem::Requirement
+    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
-    none: false
-- !ruby/object:Gem::Dependency
-  prerelease: false
-  name: rspec
   type: :development
+  prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
+    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
-    none: false
+- !ruby/object:Gem::Dependency
+  name: rspec
   requirement: !ruby/object:Gem::Requirement
+    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
-    none: false
-- !ruby/object:Gem::Dependency
-  prerelease: false
-  name: vcr
   type: :development
+  prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
+    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
-    none: false
+- !ruby/object:Gem::Dependency
+  name: vcr
   requirement: !ruby/object:Gem::Requirement
+    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
-    none: false
-- !ruby/object:Gem::Dependency
-  prerelease: false
-  name: webmock
   type: :development
+  prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
+    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
-    none: false
+- !ruby/object:Gem::Dependency
+  name: webmock
   requirement: !ruby/object:Gem::Requirement
+    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
     none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 description: A terrible burden for a couch
 email:
 - yipdw@member.fsf.org
@@ -198,6 +214,7 @@ files:
 - .gitignore
 - .rspec
 - .travis.yml
+- CHANGELOG
 - Gemfile
 - LICENSE
 - README
@@ -211,10 +228,16 @@ files:
 - lib/analysand/database.rb
 - lib/analysand/errors.rb
 - lib/analysand/instance.rb
+- lib/analysand/reading.rb
 - lib/analysand/response.rb
+- lib/analysand/streaming_view_response.rb
 - lib/analysand/version.rb
 - lib/analysand/view_response.rb
+- lib/analysand/view_streaming/builder.rb
+- lib/analysand/viewing.rb
+- lib/analysand/writing.rb
 - script/setup_database.rb
+- spec/analysand/a_response.rb
 - spec/analysand/a_session_grantor.rb
 - spec/analysand/change_watcher_spec.rb
 - spec/analysand/database_spec.rb
@@ -222,37 +245,37 @@ files:
 - spec/analysand/instance_spec.rb
 - spec/analysand/response_spec.rb
 - spec/analysand/view_response_spec.rb
+- spec/analysand/view_streaming/builder_spec.rb
+- spec/analysand/view_streaming_spec.rb
 - spec/fixtures/vcr_cassettes/get_session_does_not_refresh_cookie.yml
 - spec/fixtures/vcr_cassettes/get_session_refreshes_cookie.yml
 - spec/fixtures/vcr_cassettes/head_request_with_etag.yml
+- spec/fixtures/vcr_cassettes/view.yml
 - spec/spec_helper.rb
 - spec/support/database_access.rb
 - spec/support/example_isolation.rb
 - spec/support/test_parameters.rb
-homepage: ''
+homepage: https://github.com/yipdw/analysand
 licenses: []
 post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
-      segments:
-      - 0
-      version: '0'
-      hash: 2002549777813010636
-  none: false
+      version: '1.9'
 required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
+      version: '0'
       segments:
       - 0
-      version: '0'
-      hash: 2002549777813010636
-  none: false
+      hash: 1636075710604712169
 requirements: []
 rubyforge_project: 
 rubygems_version: 1.8.24
@@ -260,6 +283,7 @@ signing_key:
 specification_version: 3
 summary: A CouchDB client of dubious worth
 test_files:
+- spec/analysand/a_response.rb
 - spec/analysand/a_session_grantor.rb
 - spec/analysand/change_watcher_spec.rb
 - spec/analysand/database_spec.rb
@@ -267,9 +291,12 @@ test_files:
 - spec/analysand/instance_spec.rb
 - spec/analysand/response_spec.rb
 - spec/analysand/view_response_spec.rb
+- spec/analysand/view_streaming/builder_spec.rb
+- spec/analysand/view_streaming_spec.rb
 - spec/fixtures/vcr_cassettes/get_session_does_not_refresh_cookie.yml
 - spec/fixtures/vcr_cassettes/get_session_refreshes_cookie.yml
 - spec/fixtures/vcr_cassettes/head_request_with_etag.yml
+- spec/fixtures/vcr_cassettes/view.yml
 - spec/spec_helper.rb
 - spec/support/database_access.rb
 - spec/support/example_isolation.rb