djsun-mongomapper 0.3.1

data/.gitignore

@@ -0,0 +1,7 @@
+*.sw?
+.DS_Store
+coverage
+rdoc
+pkg
+*~
+*.gem

data/History

@@ -0,0 +1,51 @@
+0.3.2 (master)
+  * Added many polymorphic documents association
+  * Implemented build and create for many and many polymorphic documents
+  * <<, push and concat now work correctly for many and many polymorphic documents
+  * find(:first) now accepts order option
+  
+0.3.1 7/28/2009
+* 1 minor tweak
+  * Removed deep_merge gem as dependency as ActiveSupport has deep_merge that works good enough
+  
+0.3.0 7/28/2009
+* 5 major additions, 3 minor additions, 3 bug fix, and other miscellany
+  * BACKWORDS COMPATIBILITY BREAK: _id is now stored in binary form (recommended by mongodb team) instead of string, api is the same everywhere as before but data stored with string id's previous to change will need to be updated
+  * Added Document#paginate which works just like find but adds pagination (dcu did basics and I pimped)
+  * Added a basic console for playing around with MongoMapper (dcu)
+  * Embedded associations can now be deeply nested (Keith Hanson)
+  * Added support for many polymorphic documents (Felipe Coury and Me)
+  * Fixed bug where conditions that disallowed using $in, $all and $any with an array
+  * Bumped version of validatable so :if validation option supports symbol/string to proc.
+  * Document#create with no attributes now creates a document as long as it is valid
+  * Now defining accessor methods when key is declared rather than using method missing and all that jazz
+  * Attributes now have boolean methods that return true or false based on whether they have value present
+  * Added scoped finds and pagination on many document association.
+  * find first and last now use natural order which is more reliable.
+  * Updated to latest ruby driver (0.10.1)
+  
+
+0.2.0 7/7/2009
+* 2 major additions (observers, associations), several minor additions, and a few bug fixes
+  * Added observers
+  * many now supports embedded docs or docs in another collection (dcu on github)
+  * added belongs_to association (dcu)
+  * added validates_uniqueness_of (dcu)
+  * added :unique key shortcut to add validates_uniqueness_of automatically
+  * now tracking descendants of document (dcu)
+  * added validates_exclusion_of and validates_inclusion_of
+  * Bumped required version of validatable for callback fixes
+  * More thorough use of converting find conditions and options to mongo speak
+  * #attributes= no longer bombs when given nil
+  
+0.1.2 7/3/2009
+* 2 minor changes
+  * Straightened out callbacks and added validate, validate_on_create and validate_on_update.
+  * Attributes passed into attributes= now call writer methods if they exist. This is mostly for virtual attributes.
+  
+0.1.1 6/28/2009
+* 1 minor change
+  * bumped ruby driver to 0.9 and removed hacks I had in while waiting for it
+  
+0.1.0 6/26/2009
+* Initial release

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 John Nunemaker
+
+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.rdoc

@@ -0,0 +1,39 @@
+= MongoMapper
+
+Awesome gem for modeling your domain and storing it in mongo.
+
+Releases are tagged on github and also released as gems on github and rubyforge. Master is pushed to whenever I add a patch or a new feature. To build from master, you can clone the code, generate the updated gemspec, build the gem and install.
+
+* rake gemspec
+* gem build mongomapper.gemspec
+* gem install the gem that was built
+
+== 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 in another branch so I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+== Dependencies
+
+* ActiveSupport (activesupport)
+* Mongo Ruby Driver (mongodb-mongo)
+* My fork of the validatable gem (jnunemaker-validatable)
+
+== Documentation
+
+http://rdoc.info/projects/jnunemaker/mongomapper
+
+== More Info
+
+You can learn more about mongo here:
+http://www.mongodb.org/
+
+You can learn more about the mongo ruby driver here:
+http://github.com/mongodb/mongo-ruby-driver/tree/master
+
+== Copyright
+
+Copyright (c) 2009 John Nunemaker. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,71 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "mongomapper"
+    gem.summary = %Q{Awesome gem for modeling your domain and storing it in mongo}
+    gem.email = "nunemaker@gmail.com"
+    gem.homepage = "http://github.com/jnunemaker/mongomapper"
+    gem.authors = ["John Nunemaker"]
+    gem.rubyforge_project = "mongomapper"
+    
+    gem.add_dependency('activesupport')
+    gem.add_dependency('mongodb-mongo', '0.10.1')
+    gem.add_dependency('jnunemaker-validatable', '1.7.2')
+    
+    gem.add_development_dependency('mocha', '0.9.4')
+    gem.add_development_dependency('jnunemaker-matchy', '0.4.0')
+  end
+
+  Jeweler::RubyforgeTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: sudo gem install jeweler"
+end
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+begin
+  require 'rcov/rcovtask'
+  Rcov::RcovTask.new do |test|
+    test.libs << 'test'
+    test.pattern = 'test/**/test_*.rb'
+    test.verbose = true
+  end
+rescue LoadError
+  task :rcov do
+    abort "RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov"
+  end
+end
+
+begin
+  require 'cucumber/rake/task'
+  Cucumber::Rake::Task.new(:features)
+rescue LoadError
+  task :features do
+    abort "Cucumber is not available. In order to run features, you must: sudo gem install cucumber"
+  end
+end
+
+task :default => :test
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  if File.exist?('VERSION.yml')
+    config = YAML.load(File.read('VERSION.yml'))
+    version = "#{config[:major]}.#{config[:minor]}.#{config[:patch]}"
+  else
+    version = ""
+  end
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "MongoMapper #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.3.1

data/bin/mmconsole

@@ -0,0 +1,56 @@
+#!/usr/bin/env ruby
+$:.unshift File.dirname(__FILE__)+"/../lib"
+
+require 'mongomapper'
+require 'irb'
+
+IRB.setup(nil)
+irb = IRB::Irb.new
+
+IRB.conf[:MAIN_CONTEXT] = irb.context
+
+irb.context.evaluate("require 'irb/completion'", 0)
+irb.context.evaluate(%@
+include XGen::Mongo::Driver
+include MongoMapper
+
+MongoMapper.database = "mmtest"
+$db = MongoMapper.database
+
+@, 0)
+
+puts %@
+Welcome to the MongoMapper Console!
+
+Example 1:
+  things = $db.collection("things")
+  things.insert("name" => "Raw Thing")
+  things.insert("name" => "Another Thing", "date" => Time.now)
+
+  cursor = things.find("name" => "Raw Thing")
+  puts cursor.next_object.inspect
+
+Example 2:
+  class Thing
+    include MongoMapper::Document
+    key :name, String, :required => true
+    key :date, Time
+  end
+
+  thing = Thing.new
+  thing.name = "My thing"
+  thing.date = Time.now
+  thing.save
+
+  all_things = Thing.all
+  puts all_things.map { |object| object.name }.inspect
+
+@
+
+trap("SIGINT") do
+  irb.signal_handle
+end
+catch(:IRB_EXIT) do
+  irb.eval_input
+end
+

data/lib/mongomapper.rb

@@ -0,0 +1,96 @@
+require 'pathname'
+require 'rubygems'
+
+gem 'activesupport'
+gem 'mongodb-mongo', '0.10.1'
+gem 'jnunemaker-validatable', '1.7.2'
+
+require 'activesupport'
+require 'mongo'
+require 'validatable'
+
+class BasicObject #:nodoc:
+  instance_methods.each { |m| undef_method m unless m =~ /^__|instance_eval/ }
+end unless defined?(BasicObject)
+
+class Boolean
+  def self.mm_typecast(value)
+    ['true', 't', '1'].include?(value.to_s.downcase)
+  end
+end
+
+class MongoID < XGen::Mongo::Driver::ObjectID
+  def self.mm_typecast(value)
+    begin
+      if value.is_a?(XGen::Mongo::Driver::ObjectID)
+        value
+      else
+        XGen::Mongo::Driver::ObjectID::from_string(value.to_s)
+      end
+    rescue => exception
+      if exception.message == 'illegal ObjectID format'
+        raise MongoMapper::IllegalID
+      else
+        raise exception
+      end
+    end
+  end
+end
+
+dir = Pathname(__FILE__).dirname.expand_path + 'mongomapper'
+
+require dir + 'associations'
+require dir + 'associations/base'
+
+require dir + 'associations/proxy'
+require dir + 'associations/many_documents_proxy'
+
+require dir + 'associations/belongs_to_proxy'
+require dir + 'associations/belongs_to_polymorphic_proxy'
+require dir + 'associations/many_proxy'
+require dir + 'associations/many_polymorphic_proxy'
+require dir + 'associations/many_embedded_proxy'
+require dir + 'associations/many_embedded_polymorphic_proxy'
+
+require dir + 'callbacks'
+require dir + 'finder_options'
+require dir + 'key'
+require dir + 'observing'
+require dir + 'pagination'
+require dir + 'save_with_validation'
+require dir + 'serialization'
+require dir + 'validations'
+
+require dir + 'rails_compatibility/document'
+require dir + 'rails_compatibility/embedded_document'
+
+require dir + 'embedded_document'
+require dir + 'document'
+
+module MongoMapper
+  DocumentNotFound = Class.new(StandardError)
+  IllegalID        = Class.new(StandardError)
+  
+  DocumentNotValid = Class.new(StandardError) do
+    def initialize(document)
+      @document = document
+      super("Validation failed: #{@document.errors.full_messages.join(", ")}")
+    end
+  end
+
+  def self.connection
+    @@connection ||= XGen::Mongo::Driver::Mongo.new
+  end
+
+  def self.connection=(new_connection)
+    @@connection = new_connection
+  end
+
+  def self.database=(name)
+    @@database = MongoMapper.connection.db(name)
+  end
+
+  def self.database
+    @@database
+  end
+end

data/lib/mongomapper/associations.rb

@@ -0,0 +1,61 @@
+module MongoMapper
+  module Associations
+    module ClassMethods
+      def belongs_to(association_id, options = {})
+        create_association(:belongs_to, association_id, options)        
+        self
+      end
+
+      def many(association_id, options = {})
+        create_association(:many, association_id, options)        
+        self
+      end
+
+      def associations
+        @associations ||= HashWithIndifferentAccess.new
+      end
+
+      private
+        def create_association(type, name, options)
+          association = Associations::Base.new(type, name, options)
+          associations[association.name] = association
+          define_association_methods(association)
+          define_association_keys(association)
+          association
+        end
+        
+        def define_association_methods(association)
+          define_method(association.name) do
+            get_proxy(association)
+          end
+          
+          define_method("#{association.name}=") do |value|
+            get_proxy(association).replace(value)
+            value
+          end
+        end
+        
+        def define_association_keys(association)
+          if association.belongs_to?
+            key(association.belongs_to_key_name, String)
+            key(association.type_key_name, String) if association.polymorphic?            
+          end
+          
+          if association.many? && association.polymorphic?
+            association.klass.send(:key, association.type_key_name, String)
+          end
+        end
+    end
+
+    module InstanceMethods
+      def get_proxy(association)
+        unless proxy = self.instance_variable_get(association.ivar)
+          proxy = association.proxy_class.new(self, association)
+          self.instance_variable_set(association.ivar, proxy)
+        end
+        
+        proxy
+      end
+    end
+  end
+end

data/lib/mongomapper/associations/base.rb

@@ -0,0 +1,71 @@
+module MongoMapper
+  module Associations
+    class Base
+      attr_reader :type, :name, :options
+
+      def initialize(type, name, options = {})
+        @options = options
+        @type = type
+        @name = name
+      end
+      
+      def class_name
+        @class_name ||= begin
+          if cn = options[:class_name]
+            cn
+          elsif many?
+            name.to_s.singularize.camelize
+          else
+            name.to_s.camelize
+          end
+        end
+      end
+      
+      def klass
+        @klass ||= class_name.constantize
+      end
+      
+      def many?
+        @many_type ||= @type == :many
+      end
+      
+      def belongs_to?
+        @belongs_to_type ||= @type == :belongs_to
+      end
+      
+      def polymorphic?
+        !!@options[:polymorphic]
+      end
+      
+      def type_key_name
+        @type_key_name ||= many? ? '_type' : "#{name}_type"
+      end
+      
+      def belongs_to_key_name
+        "#{name}_id"
+      end
+      
+      def ivar
+        @ivar ||= "@_#{name}"
+      end
+      
+      def embeddable?
+        many? && klass.embeddable?
+      end
+
+      def proxy_class
+        @proxy_class ||= begin
+          if many?
+            if self.klass.embeddable?
+              polymorphic? ? ManyEmbeddedPolymorphicProxy : ManyEmbeddedProxy
+            else
+              polymorphic? ? ManyPolymorphicProxy : ManyProxy
+            end
+          else
+            polymorphic? ? BelongsToPolymorphicProxy : BelongsToProxy
+          end
+        end # end begin
+      end # end proxy_class
+    end
+  end
+end