mongo_doc_rails2 0.6.1

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,8 @@
+*.sw?
+.DS_Store
+.rvmrc
+coverage
+rdoc
+pkg
+mongod.yml
+nohup.out

data/HISTORY.md

@@ -0,0 +1,11 @@
+## 0.5.0 to 0.5.5
+
+* update to ruby driver 0.20.1 and the new bson gems
+* require MongoDB 1.4
+* can be used with ActiveSupport 2 or 3
+* Rails3 support with [MongoDoc-Rails](http://github.com/leshill/mongo_doc-rails) thanks to elliotcm
+
+## 0.4.2
+
+* `Document#update_attributes` uses $ positional operator when used from within an embed_many association
+* Require MongoDB 1.3.4 or greater

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Les Hill
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.textile

@@ -0,0 +1,185 @@
+h1. MongoDoc
+
+Version: Hurricane (0.6.1) 2010/05/10
+
+h2. Notes
+
+This version of MongoDoc is for Rails v2.3.x[1].
+
+h2. Quick Start
+
+* install MongoDB (at least 1.4.0)
+* install the Ruby driver @gem install mongo@
+* install MongoDoc @gem install mongo_doc_rails2@
+* run an example from this directory @ruby -Ilib examples/simple_object.rb@
+
+h2. Introduction
+
+MongoDoc is a simple and easy to use ActiveRecord-like object mapper for "mongoDB":http://www.mongodb.org in Ruby.
+
+MongoDoc is _also_ an extension of the "Mongo Ruby Driver":http://github.com/mongodb/mongo-ruby-driver making it a  snap to get Ruby in and out of mongoDB.
+
+MongoDoc is *not* ActiveRecord for mongoDB.  We do not have callbacks, nor do we have dynamic finders.  We do have associations, named scopes, and other features.
+
+MongoDoc *is* simple, easy-to-use, and fast. This version works with Rails 2.3.x.
+
+MongoDoc is designed to work with document data, if you are looking to map relational data in mongoDB, you will have to look elsewhere.
+
+h2. Ruby objects in mongoDB
+
+Lets just get right into it and save some Ruby objects in mongoDB!
+
+bc.. class Contact
+  attr_accessor :name, :addresses, :interests
+end
+
+class Address
+  attr_accessor :street, :city, :state, :zip, :phone_number
+end
+
+p. With MongoDoc, instead of saving JSON[2], we can save an object directly:
+
+bc.. contact = Contact.new
+contact.name = 'Hashrocket'
+contact.interests = ['ruby', 'rails', 'agile']
+
+address = Address.new
+address.street = '320 First Street North, #712'
+address.city = 'Jacksonville Beach'
+address.state = 'FL'
+address.zip = '32250'
+address.phone_number = '877 885 8846'
+contact.addresses = [address]
+
+collection.save(contact)
+
+p. We can query using the powerful mongoDB query syntax, and have it return Ruby objects:
+
+bc.. in_fl = collection.where('addresses.state' => 'FL')
+in_fl_hashrocket = in_fl.where('name' => /rocket/)
+puts in_fl_hashrocket.first.addresses.first.phone_number
+
+p. Take a look in the examples directory for more code.
+
+h2. Mapping Documents
+
+MongoDoc provides ActiveRecord-like persistence, associations, named scopes, and validations (from "Validatable":http://github.com/durran/validatable) as well as a mongoDB query language (from "Mongoid":http://mongoid.org/home). MongoDoc also plays nicely with Rails.
+
+@MongoDoc::Document@ provides all these features as a mixin.  A @MongoDoc::Document@ can either be a top-level mongoDB document, or an embedded document contained within a top-level document. Top-level documents are stored in collections named after their class: @Contact@ objects are stored in the 'contacts' collection (much like ActiveRecord).
+
+Lets define a @Contact@ document with an @Address@ embedded document:
+
+bc.. class Address
+  include MongoDoc::Document
+
+  attr_accessor :street
+  attr_accessor :city
+  attr_accessor :state
+  attr_accessor :zip_code
+  attr_accessor :phone_number
+end
+
+class Contact
+  include MongoDoc::Document
+
+  attr_accessor :name
+  attr_accessor :interests
+  embed_many :addresses
+
+  scope :in_state, lambda {|state| where('addresses.state' => state)}
+end
+
+p. Since a mongoDB document has no fixed schema, we define the composition of a document directly in our classes. We can also specify associations using @embed@, @embed_many@, and @embed_hash@ (similar to ActiveRecord's @has_one@ and @has_many@.
+
+Building and saving a document is easy:
+
+bc.. contact = Contact.new(:name => 'Hashrocket', :interests => ['ruby', 'rails', 'agile'])
+contact.addresses << Address.new(:street => '320 1st Street North, #712',
+  :city => 'Jacksonville Beach',
+  :state => 'FL',
+  :zip_code => '32250',
+  :phone_number => '877 885 8846')
+contact.save
+
+p. Now that we have some data, we can query using our named scope:
+
+bc.. hashrocket_in_fl = Contact.in_state('FL').where(:name => /rocket/)
+hashrocket_address = hashrocket_in_fl.first.addresses.first
+
+p. And we can even perform partial updates:
+
+bc. hashrocket_address.update_attributes(:street => '320 First Street North, #712')
+
+h2. Installation
+
+MongoDoc *requires* mongoDB v1.4.0 or later.
+
+bc. gem install mongo_doc_rails2
+
+h2. Connecting
+
+By default, MongoDoc will read its configuration from @./mongodb.yml@. If that file does not exist, it will attempt to connect to a standard MongoDB local server setup and use a database name of @"mongodoc"@.
+
+h3. With Rails
+
+If you are using Rails, MongoDoc will look for its configuration in @config/mongodb.yml@. If that file does not exist, it will attempt to connect to a standard MongoDB local server setup and use a database name of @#{Rails.root.basename}_#{Rails.env}@.
+
+h3. Database configuration file
+
+The file is similar to the Rails database.yml file, with environment definitions containing the database configuration attributes. For example:
+
+bc. development:
+  name: development
+  host: localhost
+  port: 27017
+  options:
+    auto_reconnect: true
+test:
+  name: test
+  host: localhost
+  port: 27017
+  options:
+    auto_reconnect: true
+
+If you are not using Rails, the default environment is @development@ and you can set the current environment in your code:
+
+bc. MongoDoc::Connection.env = 'test'
+
+You can also change the location of the configuration file:
+
+bc. MongoDoc::Connection.config_path = './config/mongodb.yml'
+
+h3. Programmatically setting the database connection information
+
+Finally, if you do not want to use the database configuration file, you can also set the database name, host, port, options, and strict values directly; for example, to set the database name to @stats@:
+
+bc. MongoDoc::Connection.name = 'stats'
+
+h2. Credits
+
+Les Hill, leshill on github
+
+h3. Thanks
+
+Thanks to Sandro and Durran for some great conversations and some lovely code.
+
+Thanks to Elliot for pushing me to get Rails 3 support
+
+h2. Note on Patches/Pull Requests
+
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but
+  bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+h2. Copyright
+
+Copyright (c) 2009 - 2010 Les Hill. See LICENSE for details.
+
+fn1. If you are using Rails 3.x you need to be using the @mongo_doc@ gem from the master branch on "github":http://github.com/leshill/mongodoc .
+
+fn2. The Ruby driver exposes an API that understands JSON.

data/Rakefile

@@ -0,0 +1,188 @@
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "mongo_doc_rails2"
+    gem.summary = %Q{ODM for MongoDB - for Rails 2.3.x}
+    gem.description = %Q{ODM for MongoDB - for Rails 2.3.x}
+    gem.email = "leshill@gmail.com"
+    gem.homepage = "http://github.com/leshill/mongodoc"
+    gem.authors = ["Les Hill"]
+    gem.add_dependency "activesupport", ">= 2.3.4"
+    gem.add_dependency "mongo", "= 1.0.1"
+    gem.add_dependency "bson", "= 1.0.1"
+    gem.add_dependency "bson_ext", "= 1.0.1"
+    gem.add_dependency "durran-validatable", "= 2.0.1"
+    gem.add_dependency "leshill-will_paginate", "= 2.3.11"
+    gem.add_development_dependency "rspec", "= 1.3.0"
+    gem.add_development_dependency "cucumber", ">= 0.6.2"
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: sudo gem install jeweler"
+end
+
+require 'cucumber/rake/task'
+Cucumber::Rake::Task.new(:features) do |t|
+  t.cucumber_opts = "--format pretty --tag ~@wip"
+end
+
+namespace :cucumber do
+  Cucumber::Rake::Task.new(:wip) do |t|
+    t.cucumber_opts = "--format pretty --tag @wip"
+  end
+end
+
+require 'spec/rake/spectask'
+Spec::Rake::SpecTask.new(:spec) do |spec|
+  spec.spec_opts = ['--options', "#{File.expand_path(File.dirname(__FILE__))}/spec/spec.opts"]
+  spec.libs << 'lib' << 'spec'
+  spec.spec_files = FileList['spec/**/*_spec.rb']
+end
+
+Spec::Rake::SpecTask.new(:rcov) do |spec|
+  spec.spec_opts = ['--options', "#{File.expand_path(File.dirname(__FILE__))}/spec/spec.opts"]
+  spec.libs << 'lib' << 'spec'
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :spec => :check_dependencies
+
+task :default => :spec
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  if File.exist?('VERSION')
+    version = File.read('VERSION')
+  else
+    version = ""
+  end
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "MongoDoc #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+namespace :mongo do
+  desc 'Start mongod'
+  task :start do
+    default_config = { "dbpath" => "/data/db" }
+    config = begin
+      YAML.load_file(File.join(File.dirname(__FILE__), 'mongod.yml'))
+    rescue Exception => e
+      {}
+    end
+    config = default_config.merge(config)
+    sh("nohup #{config['mongod'] || 'mongod'} --dbpath #{config['dbpath']} &")
+    puts "\n"
+  end
+end
+
+namespace :mongoid do
+  desc 'Sync criteria from Mongoid'
+  task :sync do
+    require 'pathname'
+
+    src_dir = Pathname.new('../durran-mongoid/lib/mongoid')
+    dest_dir = Pathname.new('lib/mongoid')
+    dest_dir.mkpath
+    %w(criteria.rb contexts/paging.rb contexts/enumerable.rb criterion extensions/symbol/inflections.rb extensions/hash/criteria_helpers.rb matchers).each do |f|
+      src = src_dir + f
+      if src.directory?
+        FileUtils.cp_r(src, dest_dir)
+      else
+        dest = dest_dir + f
+        dest.dirname.mkpath
+        FileUtils.cp(src, dest)
+      end
+    end
+  end
+end
+
+namespace :bench do
+  desc 'Run benchmark for MongoDoc'
+  task 'mongo_doc' do
+    $LOAD_PATH.unshift(File.join(File.dirname(__FILE__), 'lib'))
+    require 'perf/mongo_document'
+    benchmark("MongoDoc saving documents", MongoDocument.new)
+  end
+
+  desc 'Run benchmark for MongoDoc Object'
+  task 'mongo_object' do
+    $LOAD_PATH.unshift(File.join(File.dirname(__FILE__), 'lib'))
+    require 'perf/mongo_doc_object'
+    benchmark("MongoDoc saving objects", MongoDocObject.new)
+  end
+
+  desc 'Run profiler for driver'
+  task 'driver' do
+    $LOAD_PATH.unshift(File.join(File.dirname(__FILE__), 'lib'))
+    require 'perf/ruby_driver'
+    benchmark("Ruby driver saving hashes", RubyDriver.new)
+  end
+end
+
+namespace :prof do
+  desc 'Run profiler for MongoDoc'
+  task 'mongo_doc' do
+    $LOAD_PATH.unshift(File.join(File.dirname(__FILE__), 'lib'))
+    require 'perf/mongo_document'
+    profile("MongoDoc saving documents", MongoDocument.new)
+  end
+
+  desc 'Run profiler for MongoDoc Object'
+  task 'mongo_object' do
+    $LOAD_PATH.unshift(File.join(File.dirname(__FILE__), 'lib'))
+    require 'perf/mongo_doc_object'
+    profile("MongoDoc saving objects", MongoDocObject.new)
+  end
+
+  desc 'Run profiler for driver'
+  task 'driver' do
+    $LOAD_PATH.unshift(File.join(File.dirname(__FILE__), 'lib'))
+    require 'perf/ruby_driver'
+    profile("Ruby driver saving hashes", RubyDriver.new)
+  end
+
+  def benchmark(what, runner)
+    puts "Benchmark: " + what
+
+    runner.generate(10000)
+
+    Benchmark.bm do |bm|
+      bm.report(what + " writes") do
+        runner.writes(10000)
+      end
+    end
+
+    Benchmark.bm do |bm|
+      bm.report(what + " reads") do
+        runner.reads(10000)
+      end
+    end
+
+    Benchmark.bm do |bm|
+      bm.report(what + " query") do
+        runner.query_all
+      end
+    end
+  end
+
+  def profile(what, runner)
+    puts "Profiling: " + what
+    RubyProf.start
+
+    runner.generate(1000)
+    runner.writes(1000)
+    runner.reads(1000)
+    runner.query_all
+
+    result = RubyProf.stop
+    printer = RubyProf::FlatPrinter.new(result)
+    printer.print(STDOUT, 0)
+  end
+end
+

data/TODO

@@ -0,0 +1,40 @@
+As of 2010-03-06
+
+Associations
+------------
+
+Pull associations out of attributes and refactor
+
+Criteria
+--------
+
+Make critieria module; include into CriteriaProxy, Association?
+page, per_page, paginate shuould be wrapped or not?
+
+Contexts
+--------
+
+Extract Mongo context as module, Document#collection => klass.collection Collection#collection => klass
+
+Documentation
+-------------
+
+How to get started with Rails
+
+Dynamic Attributes
+------------------
+
+Document#[] => reads attribute
+Document#[]= => writes attribute
+Document#dynamic_attributes => key, value for each dynamic attribute
+Document#dynamic_attribute_names => list of dynamic attribute names
+
+Validations
+-----------
+
+validates_hash_keys :has_hash_name, :in => [array of names]
+
+
+Q
+-
+What is Criteria#ids