zdzolton-cambric 0.5.0 → 0.6.0

data/VERSION

@@ -1 +1 @@
-0.5.0
+0.6.0

data/cambric.gemspec

@@ -2,11 +2,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{cambric}
-  s.version = "0.5.0"
+  s.version = "0.6.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Zachary Zolton", "Geoff Buesing"]
-  s.date = %q{2009-05-29}
+  s.date = %q{2009-06-02}
   s.email = %q{zachary.zolton@gmail.com}
   s.extra_rdoc_files = [
     "LICENSE",
@@ -21,8 +21,18 @@ Gem::Specification.new do |s|
      "VERSION",
      "cambric.gemspec",
      "lib/cambric.rb",
-     "spec/cambric_spec.rb",
+     "lib/cambric/assume_design_doc_name.rb",
+     "lib/cambric/configurator.rb",
+     "lib/cambric/test_helpers.rb",
+     "spec/cambric/assume_design_doc_name_spec.rb",
+     "spec/cambric/cambric_spec.rb",
+     "spec/cambric/configurator_spec.rb",
+     "spec/cambric/test_helpers_spec.rb",
      "spec/fixtures/twitter-clone/tweets/views/by_follower_and_created_at/map.js",
+     "spec/fixtures/twitter-clone/users/views/bad/map.js",
+     "spec/fixtures/twitter-clone/users/views/bad/reduce.js",
+     "spec/fixtures/twitter-clone/users/views/followers/map.js",
+     "spec/fixtures/twitter-clone/users/views/followers/reduce.js",
      "spec/spec.opts",
      "spec/spec_helper.rb"
   ]
@@ -32,7 +42,10 @@ Gem::Specification.new do |s|
   s.rubygems_version = %q{1.3.3}
   s.summary = %q{Opinionated management and usage of CouchDB from your Ruby apps.}
   s.test_files = [
-    "spec/cambric_spec.rb",
+    "spec/cambric/assume_design_doc_name_spec.rb",
+     "spec/cambric/cambric_spec.rb",
+     "spec/cambric/configurator_spec.rb",
+     "spec/cambric/test_helpers_spec.rb",
      "spec/spec_helper.rb"
   ]
 

data/lib/cambric/assume_design_doc_name.rb

@@ -0,0 +1,15 @@
+module Cambric
+  module AssumeDesignDocName
+
+    attr_accessor :cambric_design_doc_name
+  
+    def view name, options={}, &block
+      super "#{@cambric_design_doc_name}/#{name}", options, &block
+    end
+    
+    def cambric_design_doc
+      get "_design/#{@cambric_design_doc_name}"
+    end
+  
+  end
+end

data/lib/cambric/configurator.rb

@@ -0,0 +1,34 @@
+module Cambric
+  class Configurator
+  
+    attr_accessor :design_doc_name, :db_dir, :environment, :databases
+  
+    def initialize
+      @design_doc_name = 'cambric'
+      @db_dir = 'cambric'
+      @environment = 'development'
+      @databases = {}
+    end
+  
+    def initialize_databases
+      dbs_by_name = {}
+      @databases.each_pair do |db,urls_by_env|
+        urls_by_env.keys.map!{ |env| env.to_sym }
+        uri = URI.parse urls_by_env[@environment.to_sym]
+        dbs_by_name[db.to_sym] = initialize_database uri
+      end
+      dbs_by_name
+    end
+  
+  private
+
+    def initialize_database uri
+      server = CouchRest.new("#{uri.scheme}://#{uri.host}:#{uri.port}")
+      database = server.database uri.path.gsub(/^\//, '')
+      database.extend ::Cambric::AssumeDesignDocName
+      database.cambric_design_doc_name = @design_doc_name
+      database
+    end
+  
+  end
+end

data/lib/cambric/test_helpers.rb

@@ -0,0 +1,96 @@
+require 'open3'
+
+module Cambric
+  module TestHelpers
+    
+    class ReduceError < RuntimeError ; end
+    
+    def execute_map db, view, doc
+      view_functions = Cambric[db].cambric_design_doc['views'][view.to_s]
+      execute_js <<-CODE
+        var emittedKeyValuePairs = [];
+        function emit(key, value) {
+          emittedKeyValuePairs.push({ 'key': key, 'value': value });
+        }
+        var mapFunction = #{view_functions['map']};
+        try { mapFunction(#{doc.to_json}); } catch (e) {}
+        returnValueToRuby(emittedKeyValuePairs);
+      CODE
+    end
+
+    def execute_reduce db, view, options
+      view_functions = Cambric[db].cambric_design_doc['views'][view.to_s]
+      options = { :rereduce => false }.merge(options)
+      execute_js <<-CODE
+        var reduceFunction = #{view_functions['reduce']};
+        try {
+          returnValueToRuby(reduceFunction(
+            #{(options[:keys] || []).to_json},
+            #{(options[:values] || []).to_json},
+            #{options[:rereduce]}
+          ));
+        } catch (error) {
+          raiseErrorToRuby(error);
+        }
+      CODE
+    end
+    
+  private
+
+    def execute_js code
+      output = nil
+      Open3.popen3 'js' do |stdin, stdout, stderr|
+        stdin.puts HELPER_FUNCTIONS
+        stdin.puts code
+        stdin.close
+        output = JSON.parse(stdout.read)
+      end
+      raise ReduceError, output['error'] if output.has_key?('error')
+      output['result']
+    end
+
+    HELPER_FUNCTIONS = <<-HELPERS
+      function sum(values) { 
+        var total = 0;
+        values.forEach(function(v) { total += v; });
+        return total;
+      }
+
+      function toJSON(obj) {
+       switch (typeof obj) {
+        case 'object':
+         if (obj) {
+          var list = [];
+          if (obj instanceof Array) {
+           for (var i=0;i < obj.length;i++) {
+            list.push(toJSON(obj[i]));
+           }
+           return '[' + list.join(',') + ']';
+          } else {
+           for (var prop in obj) {
+            list.push('"' + prop + '":' + toJSON(obj[prop]));
+           }
+           return '{' + list.join(',') + '}';
+          }
+         } else {
+          return 'null';
+         }
+        case 'string':
+         return '"' + obj.replace(/(["'])/g, '\\'') + '"';
+        case 'number':
+        case 'boolean':
+         return new String(obj);
+       }
+      }
+
+      function returnValueToRuby(value) {
+        print(toJSON({ 'result': value }));
+      }
+      
+      function raiseErrorToRuby(error) {
+        print(toJSON({ 'error': error['message'] }));
+      }
+    HELPERS
+    
+  end
+end

data/lib/cambric.rb

@@ -1,6 +1,8 @@
 require 'couchrest'
 require 'uri'
 
+Dir.glob(File.join(File.dirname(__FILE__), 'cambric/**.rb')).each{ |f| require f }
+
 module Cambric
   
   def self.design_doc_name
@@ -66,46 +68,3 @@ private
   end
     
 end
-
-class Cambric::Configurator
-  
-  attr_accessor :design_doc_name, :db_dir, :environment, :databases
-  
-  def initialize
-    @design_doc_name = 'cambric'
-    @db_dir = 'cambric'
-    @environment = 'development'
-    @databases = {}
-  end
-  
-  def initialize_databases
-    dbs_by_name = {}
-    @databases.each_pair do |db,urls_by_env|
-      urls_by_env.keys.map!{ |env| env.to_sym }
-      uri = URI.parse urls_by_env[@environment.to_sym]
-      dbs_by_name[db.to_sym] = initialize_database uri
-    end
-    dbs_by_name
-  end
-  
-private
-
-  def initialize_database uri
-    server = CouchRest.new("#{uri.scheme}://#{uri.host}:#{uri.port}")
-    database = server.database uri.path.gsub(/^\//, '')
-    database.extend ::Cambric::AssumeDesignDocName
-    database.cambric_design_doc_name = @design_doc_name
-    database
-  end
-  
-end
-
-module Cambric::AssumeDesignDocName
-
-  attr_accessor :cambric_design_doc_name
-  
-  def view name, options={}, &block
-    super "#{@cambric_design_doc_name}/#{name}", options, &block
-  end
-  
-end

data/spec/cambric/assume_design_doc_name_spec.rb

@@ -0,0 +1,22 @@
+require File.expand_path(File.join(File.dirname(__FILE__), '../spec_helper'))
+
+describe Cambric::AssumeDesignDocName do
+  
+  describe "after pushing design docs" do
+    before :all do
+      configure_twitter_clone
+      Cambric.prepare_databases!
+    end
+    
+    after(:all){ delete_twitter_clone_databases }
+    
+    it "should be able to query view without re-specifying design doc name" do
+      Cambric[:tweets].view 'by_follower_and_created_at'
+    end
+    
+    it "should get the design doc specified by configuration" do
+      Cambric[:tweets].cambric_design_doc.should_not be_nil
+    end
+  end
+  
+end

data/spec/{cambric_spec.rb → cambric/cambric_spec.rb}

@@ -1,30 +1,6 @@
-require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+require File.expand_path(File.join(File.dirname(__FILE__), '../spec_helper'))
 require 'uri'
 
-TWITTER_CLONE_DATABASES = {
-  :users => {
-    :development => 'http://127.0.0.1:5984/users-development',
-    :test => 'http://127.0.0.1:5984/users-testing'
-  },
-  :tweets => {
-    :development => 'http://127.0.0.1:5984/tweets-development',
-    :test => 'http://127.0.0.1:5984/tweets-testing'
-  }
-}
-
-def configure_twitter_clone
-  Cambric.configure do |config|
-    config.design_doc_name = 'twitter-clone'
-    config.db_dir = 'spec/fixtures/twitter-clone'
-    config.environment = 'test'
-    config.databases = TWITTER_CLONE_DATABASES
-  end
-end
-
-def delete_twitter_clone_databases
-  %w(users tweets).each{ |db| Cambric[db].delete! rescue nil }
-end
-
 describe Cambric do
   
   describe "after configuring without a block" do
@@ -141,10 +117,6 @@ describe Cambric do
       design_doc = Cambric[:tweets].get("_design/twitter-clone")
       design_doc['views']['by_follower_and_created_at'].should_not be_nil
     end
-  
-    it "should be able to query view without re-specifying design doc name" do
-      Cambric[:tweets].view 'by_follower_and_created_at'
-    end
   end
   
   describe "when the design doc already exists" do
@@ -211,34 +183,3 @@ describe Cambric do
   end
 
 end
-
-describe Cambric::Configurator do
-  before :all do
-    @config = Cambric::Configurator.new
-  end
-
-  it "should default its design doc name to 'cambric'" do
-    @config.design_doc_name.should == 'cambric'
-  end
-
-  it "should default to 'cambric' for the database directory" do
-    @config.db_dir.should == 'cambric'
-  end
-
-  it "should default to 'development' for the environment" do
-    @config.environment.should == 'development'
-  end
-  
-  describe "when retrieving the configured CouchRest::Database instances" do
-    before :all do
-      @config.databases = TWITTER_CLONE_DATABASES
-      @dbs = @config.initialize_databases
-    end
-    
-    it "should have the expected URLs for development environment" do
-      %w(users tweets).each do |db|
-        @dbs[db.to_sym].uri.should == "http://127.0.0.1:5984/#{db}-development"
-      end
-    end
-  end
-end

data/spec/cambric/configurator_spec.rb

@@ -0,0 +1,32 @@
+require File.expand_path(File.join(File.dirname(__FILE__), '../spec_helper'))
+
+describe Cambric::Configurator do
+  before :all do
+    @config = Cambric::Configurator.new
+  end
+
+  it "should default its design doc name to 'cambric'" do
+    @config.design_doc_name.should == 'cambric'
+  end
+
+  it "should default to 'cambric' for the database directory" do
+    @config.db_dir.should == 'cambric'
+  end
+
+  it "should default to 'development' for the environment" do
+    @config.environment.should == 'development'
+  end
+  
+  describe "when retrieving the configured CouchRest::Database instances" do
+    before :all do
+      @config.databases = TWITTER_CLONE_DATABASES
+      @dbs = @config.initialize_databases
+    end
+    
+    it "should have the expected URLs for development environment" do
+      %w(users tweets).each do |db|
+        @dbs[db.to_sym].uri.should == "http://127.0.0.1:5984/#{db}-development"
+      end
+    end
+  end
+end

data/spec/cambric/test_helpers_spec.rb

@@ -0,0 +1,51 @@
+require File.expand_path(File.join(File.dirname(__FILE__), '../spec_helper'))
+
+describe Cambric::TestHelpers do
+  
+  include Cambric::TestHelpers
+  
+  before :all do
+    configure_twitter_clone
+    Cambric.prepare_databases!
+  end
+  
+  after(:all){ delete_twitter_clone_databases }
+  
+  describe "testing a view's map function" do
+    it "should return an array, with an element for each call to emit()" do
+      kv_pairs = execute_map :users, :followers,
+                             '_id' => 'poddle', 'following' => ['jack', 'russel']
+      kv_pairs.size.should == 2
+      kv_pairs[0]['key'].should == 'jack'
+      kv_pairs[1]['key'].should == 'russel'
+      kv_pairs[0]['value'].should == 'poddle'
+      kv_pairs[1]['value'].should == 'poddle'
+    end
+    
+    it "should return an empty array when documents cause an exception" do
+      kv_pairs = execute_map :users, :bad, "doesn't" => 'matter'
+      kv_pairs.length.should == 1
+    end
+  end
+  
+  describe "testing a view's reduce function" do
+    
+    it "should default to false for rereduce" do
+      result = execute_reduce :users, :followers, :values => ['dr', 'quinn', 'medicine', 'woman']
+      result.should == 4
+    end
+    
+    it "should be able to execute a rereduce" do
+      result = execute_reduce :users, :followers, :values => [4, 5, 6], :rereduce => true
+      result.should == 15 
+    end
+    
+    it "should forward exceptions to Ruby" do
+      lambda do
+        execute_reduce :users, :bad, :values => ['what', 'ever']
+      end.should raise_error(Cambric::TestHelpers::ReduceError)
+    end
+    
+  end
+
+end

data/spec/fixtures/twitter-clone/users/views/bad/map.js

@@ -0,0 +1,7 @@
+function(doc) {
+  // This should be returned:
+  emit(4, 5);
+  
+  // This should not:
+  emit(doc['some_non_existant_property'].length, null);
+}

data/spec/fixtures/twitter-clone/users/views/bad/reduce.js

@@ -0,0 +1,4 @@
+function(key, values) {
+  // This should throw an error:
+  return values[0]['some_non_existant_property'].length;
+}

data/spec/fixtures/twitter-clone/users/views/followers/map.js

@@ -0,0 +1,6 @@
+function(doc) {
+  // FYI: This example assumes we're using usernames as the doc ID.
+  doc['following'].forEach(function(user) {
+    emit(user, doc['_id']);
+  });
+}

data/spec/fixtures/twitter-clone/users/views/followers/reduce.js

@@ -0,0 +1,7 @@
+function(keys, values, rereduce) {
+  if (rereduce) {
+    return sum(values);
+  } else {
+    return values.length;
+  }
+}

data/spec/spec_helper.rb

@@ -12,12 +12,34 @@ $LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
 
 require 'cambric'
 
-FIXTURES_PATH = './spec/fixtures'
+##############
 
-def load_fixture *path
-  open(File.expand_path(File.join %w(spec fixtures) + path))
+TWITTER_CLONE_DATABASES = {
+  :users => {
+    :development => 'http://127.0.0.1:5984/users-development',
+    :test => 'http://127.0.0.1:5984/users-testing'
+  },
+  :tweets => {
+    :development => 'http://127.0.0.1:5984/tweets-development',
+    :test => 'http://127.0.0.1:5984/tweets-testing'
+  }
+}
+
+def configure_twitter_clone
+  Cambric.configure do |config|
+    config.design_doc_name = 'twitter-clone'
+    config.db_dir = 'spec/fixtures/twitter-clone'
+    config.environment = 'test'
+    config.databases = TWITTER_CLONE_DATABASES
+  end
+end
+
+def delete_twitter_clone_databases
+  %w(users tweets).each{ |db| Cambric[db].delete! rescue nil }
 end
 
+#############
+
 Spec::Runner.configure do |config|
   
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: zdzolton-cambric
 version: !ruby/object:Gem::Version 
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors: 
 - Zachary Zolton
@@ -10,7 +10,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-05-29 00:00:00 -07:00
+date: 2009-06-02 00:00:00 -07:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -41,8 +41,18 @@ files:
 - VERSION
 - cambric.gemspec
 - lib/cambric.rb
-- spec/cambric_spec.rb
+- lib/cambric/assume_design_doc_name.rb
+- lib/cambric/configurator.rb
+- lib/cambric/test_helpers.rb
+- spec/cambric/assume_design_doc_name_spec.rb
+- spec/cambric/cambric_spec.rb
+- spec/cambric/configurator_spec.rb
+- spec/cambric/test_helpers_spec.rb
 - spec/fixtures/twitter-clone/tweets/views/by_follower_and_created_at/map.js
+- spec/fixtures/twitter-clone/users/views/bad/map.js
+- spec/fixtures/twitter-clone/users/views/bad/reduce.js
+- spec/fixtures/twitter-clone/users/views/followers/map.js
+- spec/fixtures/twitter-clone/users/views/followers/reduce.js
 - spec/spec.opts
 - spec/spec_helper.rb
 has_rdoc: false
@@ -72,5 +82,8 @@ signing_key:
 specification_version: 3
 summary: Opinionated management and usage of CouchDB from your Ruby apps.
 test_files: 
-- spec/cambric_spec.rb
+- spec/cambric/assume_design_doc_name_spec.rb
+- spec/cambric/cambric_spec.rb
+- spec/cambric/configurator_spec.rb
+- spec/cambric/test_helpers_spec.rb
 - spec/spec_helper.rb