shingara-mongomapper 0.3.3

data/.gitignore

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

data/History

@@ -0,0 +1,70 @@
+0.3.4 (master)
+  * BACKWORDS COMPATIBILITY BREAK: Timestamps are now optional. To use them add timestamps! to your model.
+  * BACKWORDS COMPATIBILITY BREAK: Associations keys are no longer created automatically when you use belongs_to and many. Too much was hidden from the developer. You now have to declare them like key :creator_id, String and such.
+  
+0.3.3 8/16/2009
+  * BACKWORDS COMPATIBILITY BREAK: _id is now once again a string rather than an object id and will stay that way.
+  * Custom id's can now be used because of the change to string id's
+  * Added dynamic finders to document. (dcu)
+  * Added destroy_all, delete_all and nullify for many document association
+  * Added :dependent option for many documents assocation (dcu)
+  * update_attributes now returns true or false instead of the document. (Durran Jordan and me)
+  * Keys no longer require a type
+  * Keys can now be added on the fly using []=
+  
+0.3.2 8/6/2009
+  * 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
+  * id is now included by default with to_json
+  * _id is now always excluded from to_json
+  * Times are now always returned as UTC
+  * Default values are now a bit more intelligent for Array and Hash keys (djsun)
+  * Embedded documents now have _id as well so they can be identified more easily
+  
+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,73 @@
+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.11.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 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
+
+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.3

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,77 @@
+require 'pathname'
+require 'rubygems'
+
+gem 'activesupport'
+gem 'mongodb-mongo', '0.11.1'
+gem 'jnunemaker-validatable', '1.7.2'
+
+require 'activesupport'
+require 'mongo'
+require 'validatable'
+
+dir = Pathname(__FILE__).dirname.expand_path + 'mongomapper'
+
+require dir + 'support'
+
+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 + 'dynamic_finder'
+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)
+  
+  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)
+    @@databases ||= {}
+    unless @@databases.keys.include?(name.to_sym)
+      @@databases[name.to_sym] = MongoMapper.connection.db(name)
+    end
+    @@current_database = @@databases[name.to_sym]
+  end
+
+  def self.database(name=nil)
+    unless name.nil?
+      self.database = name
+    end
+    @@current_database
+  end
+end

data/lib/mongomapper/associations.rb

@@ -0,0 +1,84 @@
+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_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/mongomapper/associations/base.rb

@@ -0,0 +1,69 @@
+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 type_key_name
+        @type_key_name ||= many? ? '_type' : "#{name}_type"
+      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
+              polymorphic? ? ManyPolymorphicProxy : ManyProxy
+            end
+          else
+            polymorphic? ? BelongsToPolymorphicProxy : BelongsToProxy
+          end
+        end # end begin
+      end # end proxy_class
+    end
+  end
+end