mongo_mapper 0.5.0

data/.gitignore

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

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 mongo_mapper.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,87 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "mongo_mapper"
+    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('mongo', '0.15')
+    gem.add_dependency('jnunemaker-validatable', '1.7.3')
+    
+    gem.add_development_dependency('mocha', '0.9.4')
+    gem.add_development_dependency('jnunemaker-matchy', '0.4.0')
+  end
+  
+  Jeweler::RubyforgeTasks.new do |rubyforge|
+    rubyforge.doc_task = "rdoc"
+  end
+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
+
+namespace :test do
+  Rake::TestTask.new(:units) do |test|
+    test.libs << 'lib' << 'test'
+    test.pattern = 'test/unit/**/test_*.rb'
+    test.verbose = true
+  end
+  
+  Rake::TestTask.new(:functionals) do |test|
+    test.libs << 'lib' << 'test'
+    test.pattern = 'test/functional/**/test_*.rb'
+    test.verbose = true
+  end
+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.5.0

data/bin/mmconsole

@@ -0,0 +1,55 @@
+#!/usr/bin/env ruby
+$:.unshift File.dirname(__FILE__)+"/../lib"
+
+require 'mongo_mapper'
+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 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/mongo_mapper.rb

@@ -0,0 +1,92 @@
+require 'rubygems'
+
+gem 'activesupport'
+gem 'mongo', '0.15'
+gem 'jnunemaker-validatable', '1.7.3'
+
+require 'activesupport'
+require 'mongo'
+require 'validatable'
+
+module MongoMapper
+  DocumentNotFound  = 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 ||= Mongo::Connection.new
+  end
+
+  def self.connection=(new_connection)
+    @@connection = new_connection
+  end
+
+  def self.database=(name)
+    @@database = nil
+    @@database_name = name
+  end
+
+  def self.database
+    if @@database_name.blank?
+      raise 'You forgot to set the default database name: MongoMapper.database = "foobar"'
+    end
+    
+    @@database ||= MongoMapper.connection.db(@@database_name)
+  end
+  
+  module Finders
+    def dynamic_find(finder, args)
+      attributes = {}
+      find_options = args.extract_options!.deep_merge(:conditions => attributes)
+
+      finder.attributes.each_with_index do |attr, index|
+        attributes[attr] = args[index]
+      end
+
+      result = find(finder.finder, find_options)
+
+      if result.nil?
+        if finder.bang
+          raise DocumentNotFound, "Couldn't find Document with #{attributes.inspect} in collection named #{collection.name}"
+        end
+
+        if finder.instantiator
+          self.send(finder.instantiator, attributes)
+        end
+      else
+        result
+      end
+    end
+  end
+end
+
+require 'mongo_mapper/support'
+require 'mongo_mapper/associations'
+require 'mongo_mapper/associations/base'
+require 'mongo_mapper/associations/proxy'
+require 'mongo_mapper/associations/many_documents_proxy'
+require 'mongo_mapper/associations/belongs_to_proxy'
+require 'mongo_mapper/associations/belongs_to_polymorphic_proxy'
+require 'mongo_mapper/associations/many_proxy'
+require 'mongo_mapper/associations/many_polymorphic_proxy'
+require 'mongo_mapper/associations/many_embedded_proxy'
+require 'mongo_mapper/associations/many_embedded_polymorphic_proxy'
+require 'mongo_mapper/associations/many_documents_as_proxy'
+require 'mongo_mapper/callbacks'
+require 'mongo_mapper/finder_options'
+require 'mongo_mapper/dynamic_finder'
+require 'mongo_mapper/key'
+require 'mongo_mapper/observing'
+require 'mongo_mapper/pagination'
+require 'mongo_mapper/save_with_validation'
+require 'mongo_mapper/serialization'
+require 'mongo_mapper/validations'
+require 'mongo_mapper/rails_compatibility/document'
+require 'mongo_mapper/rails_compatibility/embedded_document'
+require 'mongo_mapper/embedded_document'
+require 'mongo_mapper/document'

data/lib/mongo_mapper/associations.rb

@@ -0,0 +1,86 @@
+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 ||= self.superclass.respond_to?(:associations) ? 
+                            self.superclass.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_dependent_callback(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_dependent_callback(association)
+          if association.options[:dependent]
+            if association.many?
+              define_dependent_callback_for_many(association)
+            elsif association.belongs_to?
+              define_dependent_callback_for_belongs_to(association)
+            end
+          end
+        end
+
+        def define_dependent_callback_for_many(association)
+          return if association.embeddable?
+
+          after_destroy do |doc|
+            case association.options[:dependent]
+            when :destroy
+              doc.get_proxy(association).destroy_all
+            when :delete_all
+              doc.get_proxy(association).delete_all
+            when :nullify
+              doc.get_proxy(association).nullify
+            end
+          end
+        end
+
+        def define_dependent_callback_for_belongs_to(association)
+          after_destroy do |doc|
+            case association.options[:dependent]
+            when :destroy
+              doc.get_proxy(association).destroy
+            end
+          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) if !frozen?
+        end
+
+        proxy
+      end
+    end
+  end
+end

data/lib/mongo_mapper/associations/base.rb

@@ -0,0 +1,83 @@
+module MongoMapper
+  module Associations
+    class Base
+      attr_reader :type, :name, :options
+
+      def initialize(type, name, options = {})
+        @type, @name, @options = type, name, options
+      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 as?
+        !!@options[:as]
+      end
+
+      def type_key_name
+        @type_key_name ||= many? ? '_type' : "#{as}_type"
+      end
+
+      def as
+        @options[:as] || self.name
+      end
+
+      def foreign_key
+        @options[:foreign_key] || "#{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
+              if polymorphic?
+                ManyPolymorphicProxy
+              elsif as?
+                ManyDocumentsAsProxy
+              else
+                ManyProxy
+              end
+            end
+          else
+            polymorphic? ? BelongsToPolymorphicProxy : BelongsToProxy
+          end
+        end # end begin
+      end # end proxy_class
+    end
+  end
+end