mongo_doc_rails2 0.6.1

data/lib/mongoid/criterion/optional.rb

@@ -0,0 +1,136 @@
+# encoding: utf-8
+module Mongoid #:nodoc:
+  module Criterion #:nodoc:
+    module Optional
+      # Tells the criteria that the cursor that gets returned needs to be
+      # cached. This is so multiple iterations don't hit the database multiple
+      # times, however this is not advisable when working with large data sets
+      # as the entire results will get stored in memory.
+      #
+      # Example:
+      #
+      # <tt>criteria.cache</tt>
+      def cache
+        @options.merge!(:cache => true); self
+      end
+
+      # Will return true if the cache option has been set.
+      #
+      # Example:
+      #
+      # <tt>criteria.cached?</tt>
+      def cached?
+        @options[:cache] == true
+      end
+
+      # Flags the criteria to execute against a read-only slave in the pool
+      # instead of master.
+      #
+      # Example:
+      #
+      # <tt>criteria.enslave</tt>
+      def enslave
+        @options.merge!(:enslave => true); self
+      end
+
+      # Will return true if the criteria is enslaved.
+      #
+      # Example:
+      #
+      # <tt>criteria.enslaved?</tt>
+      def enslaved?
+        @options[:enslave] == true
+      end
+
+      # Adds a criterion to the +Criteria+ that specifies additional options
+      # to be passed to the Ruby driver, in the exact format for the driver.
+      #
+      # Options:
+      #
+      # extras: A +Hash+ that gets set to the driver options.
+      #
+      # Example:
+      #
+      # <tt>criteria.extras(:limit => 20, :skip => 40)</tt>
+      #
+      # Returns: <tt>self</tt>
+      def extras(extras)
+        @options.merge!(extras); filter_options; self
+      end
+
+      # Adds a criterion to the +Criteria+ that specifies an id that must be matched.
+      #
+      # Options:
+      #
+      # object_id: A +String+ representation of a <tt>BSON::ObjectID</tt>
+      #
+      # Example:
+      #
+      # <tt>criteria.id("4ab2bc4b8ad548971900005c")</tt>
+      #
+      # Returns: <tt>self</tt>
+      def id(*args)
+        (args.flatten.size > 1) ? self.in(:_id => args.flatten) : (@selector[:_id] = args.first)
+        self
+      end
+
+      # Adds a criterion to the +Criteria+ that specifies the maximum number of
+      # results to return. This is mostly used in conjunction with <tt>skip()</tt>
+      # to handle paginated results.
+      #
+      # Options:
+      #
+      # value: An +Integer+ specifying the max number of results. Defaults to 20.
+      #
+      # Example:
+      #
+      # <tt>criteria.limit(100)</tt>
+      #
+      # Returns: <tt>self</tt>
+      def limit(value = 20)
+        @options[:limit] = value; self
+      end
+
+      # Returns the offset option. If a per_page option is in the list then it
+      # will replace it with a skip parameter and return the same value. Defaults
+      # to 20 if nothing was provided.
+      def offset(*args)
+        args.size > 0 ? skip(args.first) : @options[:skip]
+      end
+
+      # Adds a criterion to the +Criteria+ that specifies the sort order of
+      # the returned documents in the database. Similar to a SQL "ORDER BY".
+      #
+      # Options:
+      #
+      # params: An +Array+ of [field, direction] sorting pairs.
+      #
+      # Example:
+      #
+      # <tt>criteria.order_by([[:field1, :asc], [:field2, :desc]])</tt>
+      #
+      # Returns: <tt>self</tt>
+      def order_by(params = [])
+        @options[:sort] = params; self
+      end
+
+      # Adds a criterion to the +Criteria+ that specifies how many results to skip
+      # when returning Documents. This is mostly used in conjunction with
+      # <tt>limit()</tt> to handle paginated results, and is similar to the
+      # traditional "offset" parameter.
+      #
+      # Options:
+      #
+      # value: An +Integer+ specifying the number of results to skip. Defaults to 0.
+      #
+      # Example:
+      #
+      # <tt>criteria.skip(20)</tt>
+      #
+      # Returns: <tt>self</tt>
+      def skip(value = 0)
+        @options[:skip] = value; self
+      end
+    end
+  end
+end

data/lib/mongoid/extensions/hash/criteria_helpers.rb

@@ -0,0 +1,20 @@
+# encoding: utf-8
+module Mongoid #:nodoc:
+  module Extensions #:nodoc:
+    module Hash #:nodoc:
+      module CriteriaHelpers #:nodoc:
+        def expand_complex_criteria
+          hsh = {}
+          self.each_pair do |k,v|
+            if k.class == Mongoid::Criterion::Complex
+              hsh[k.key] = {"$#{k.operator}" => v}
+            else
+              hsh[k] = v
+            end
+          end
+          hsh
+        end
+      end
+    end
+  end
+end

data/lib/mongoid/extensions/symbol/inflections.rb

@@ -0,0 +1,36 @@
+# encoding: utf-8
+module Mongoid #:nodoc:
+  module Extensions #:nodoc:
+    module Symbol #:nodoc:
+      module Inflections #:nodoc:
+
+        REVERSALS = {
+          :asc => :desc,
+          :ascending => :descending,
+          :desc => :asc,
+          :descending => :ascending
+        }
+
+        def invert
+          REVERSALS[self]
+        end
+
+        def singular?
+          to_s.singular?
+        end
+
+        def plural?
+          to_s.plural?
+        end
+
+        ["gt", "lt", "gte", "lte", "ne", "in", "nin", "mod", "all", "size", "exists"].each do |oper|
+          class_eval <<-OPERATORS
+            def #{oper}
+              Criterion::Complex.new(:key => self, :operator => "#{oper}")
+            end
+          OPERATORS
+        end
+      end
+    end
+  end
+end

data/lib/mongoid/matchers/all.rb

@@ -0,0 +1,11 @@
+# encoding: utf-8
+module Mongoid #:nodoc:
+  module Matchers #:nodoc:
+    class All < Default
+      # Return true if the attribute and first value in the hash are equal.
+      def matches?(value)
+        @attribute == value.values.first
+      end
+    end
+  end
+end

data/lib/mongoid/matchers/default.rb

@@ -0,0 +1,26 @@
+# encoding: utf-8
+module Mongoid #:nodoc:
+  module Matchers #:nodoc:
+    class Default
+      # Creating a new matcher only requires the value.
+      def initialize(attribute)
+        @attribute = attribute
+      end
+      # Return true if the attribute and value are equal.
+      def matches?(value)
+        @attribute == value
+      end
+
+      protected
+      # Return the first value in the hash.
+      def first(value)
+        value.values.first
+      end
+
+      # If object exists then compare, else return false
+      def determine(value, operator)
+        @attribute ? @attribute.send(operator, first(value)) : false
+      end
+    end
+  end
+end

data/lib/mongoid/matchers/exists.rb

@@ -0,0 +1,13 @@
+# encoding: utf-8
+module Mongoid #:nodoc:
+  module Matchers #:nodoc:
+    class Exists < Default
+      # Return true if the attribute exists and checking for existence or
+      # return true if the attribute does not exist and checking for
+      # non-existence.
+      def matches?(value)
+        @attribute.nil? != value.values.first
+      end
+    end
+  end
+end

data/lib/mongoid/matchers/gt.rb

@@ -0,0 +1,11 @@
+# encoding: utf-8
+module Mongoid #:nodoc:
+  module Matchers #:nodoc:
+    class Gt < Default
+      # Return true if the attribute is greater than the value.
+      def matches?(value)
+        determine(value, :>)
+      end
+    end
+  end
+end

data/lib/mongoid/matchers/gte.rb

@@ -0,0 +1,11 @@
+# encoding: utf-8
+module Mongoid #:nodoc:
+  module Matchers #:nodoc:
+    class Gte < Default
+      # Return true if the attribute is greater than or equal to the value.
+      def matches?(value)
+        determine(value, :>=)
+      end
+    end
+  end
+end

data/lib/mongoid/matchers/in.rb

@@ -0,0 +1,11 @@
+# encoding: utf-8
+module Mongoid #:nodoc:
+  module Matchers #:nodoc:
+    class In < Default
+      # Return true if the attribute is in the values.
+      def matches?(value)
+        value.values.first.include?(@attribute)
+      end
+    end
+  end
+end

data/lib/mongoid/matchers/lt.rb

@@ -0,0 +1,11 @@
+# encoding: utf-8
+module Mongoid #:nodoc:
+  module Matchers #:nodoc:
+    class Lt < Default
+      # Return true if the attribute is less than the value.
+      def matches?(value)
+        determine(value, :<)
+      end
+    end
+  end
+end

data/lib/mongoid/matchers/lte.rb

@@ -0,0 +1,11 @@
+# encoding: utf-8
+module Mongoid #:nodoc:
+  module Matchers #:nodoc:
+    class Lte < Default
+      # Return true if the attribute is less than or equal to the value.
+      def matches?(value)
+        determine(value, :<=)
+      end
+    end
+  end
+end

data/lib/mongoid/matchers/ne.rb

@@ -0,0 +1,11 @@
+# encoding: utf-8
+module Mongoid #:nodoc:
+  module Matchers #:nodoc:
+    class Ne < Default
+      # Return true if the attribute and first value are not equal.
+      def matches?(value)
+        @attribute != value.values.first
+      end
+    end
+  end
+end

data/lib/mongoid/matchers/nin.rb

@@ -0,0 +1,11 @@
+# encoding: utf-8
+module Mongoid #:nodoc:
+  module Matchers #:nodoc:
+    class Nin < Default
+      # Return true if the attribute is not in the value list.
+      def matches?(value)
+        !value.values.first.include?(@attribute)
+      end
+    end
+  end
+end

data/lib/mongoid/matchers/size.rb

@@ -0,0 +1,11 @@
+# encoding: utf-8
+module Mongoid #:nodoc:
+  module Matchers #:nodoc:
+    class Size < Default
+      # Return true if the attribute size is equal to the first value.
+      def matches?(value)
+        @attribute.size == value.values.first
+      end
+    end
+  end
+end

data/mongo_doc_rails2.gemspec

@@ -0,0 +1,237 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{mongo_doc_rails2}
+  s.version = "0.6.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Les Hill"]
+  s.date = %q{2010-05-10}
+  s.description = %q{ODM for MongoDB - for Rails 2.3.x}
+  s.email = %q{leshill@gmail.com}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.textile",
+     "TODO"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "HISTORY.md",
+     "LICENSE",
+     "README.textile",
+     "Rakefile",
+     "TODO",
+     "VERSION",
+     "data/.gitignore",
+     "examples/simple_document.rb",
+     "examples/simple_object.rb",
+     "features/collections.feature",
+     "features/embed_hash.feature",
+     "features/finders.feature",
+     "features/indexes.feature",
+     "features/mongodb.yml",
+     "features/mongodoc_base.feature",
+     "features/new_record.feature",
+     "features/partial_updates.feature",
+     "features/removing_documents.feature",
+     "features/saving_an_object.feature",
+     "features/scopes.feature",
+     "features/step_definitions/collection_steps.rb",
+     "features/step_definitions/document_steps.rb",
+     "features/step_definitions/documents.rb",
+     "features/step_definitions/embed_hash_steps.rb",
+     "features/step_definitions/finder_steps.rb",
+     "features/step_definitions/index_steps.rb",
+     "features/step_definitions/json_steps.rb",
+     "features/step_definitions/object_steps.rb",
+     "features/step_definitions/objects.rb",
+     "features/step_definitions/partial_update_steps.rb",
+     "features/step_definitions/query_steps.rb",
+     "features/step_definitions/removing_documents_steps.rb",
+     "features/step_definitions/scope_steps.rb",
+     "features/step_definitions/string_casting_steps.rb",
+     "features/step_definitions/util_steps.rb",
+     "features/string_casting.feature",
+     "features/support/support.rb",
+     "features/using_criteria.feature",
+     "lib/mongo_doc.rb",
+     "lib/mongo_doc/associations.rb",
+     "lib/mongo_doc/associations/collection_proxy.rb",
+     "lib/mongo_doc/associations/document_proxy.rb",
+     "lib/mongo_doc/associations/hash_proxy.rb",
+     "lib/mongo_doc/associations/proxy_base.rb",
+     "lib/mongo_doc/attributes.rb",
+     "lib/mongo_doc/bson.rb",
+     "lib/mongo_doc/collection.rb",
+     "lib/mongo_doc/connection.rb",
+     "lib/mongo_doc/contexts.rb",
+     "lib/mongo_doc/contexts/ids.rb",
+     "lib/mongo_doc/contexts/mongo.rb",
+     "lib/mongo_doc/criteria.rb",
+     "lib/mongo_doc/cursor.rb",
+     "lib/mongo_doc/document.rb",
+     "lib/mongo_doc/ext.rb",
+     "lib/mongo_doc/ext/array.rb",
+     "lib/mongo_doc/ext/binary.rb",
+     "lib/mongo_doc/ext/boolean_class.rb",
+     "lib/mongo_doc/ext/date.rb",
+     "lib/mongo_doc/ext/date_time.rb",
+     "lib/mongo_doc/ext/dbref.rb",
+     "lib/mongo_doc/ext/hash.rb",
+     "lib/mongo_doc/ext/min_max_keys.rb",
+     "lib/mongo_doc/ext/nil_class.rb",
+     "lib/mongo_doc/ext/numeric.rb",
+     "lib/mongo_doc/ext/object.rb",
+     "lib/mongo_doc/ext/object_id.rb",
+     "lib/mongo_doc/ext/regexp.rb",
+     "lib/mongo_doc/ext/string.rb",
+     "lib/mongo_doc/ext/symbol.rb",
+     "lib/mongo_doc/ext/time.rb",
+     "lib/mongo_doc/finders.rb",
+     "lib/mongo_doc/index.rb",
+     "lib/mongo_doc/matchers.rb",
+     "lib/mongo_doc/root.rb",
+     "lib/mongo_doc/scope.rb",
+     "lib/mongo_doc/validations.rb",
+     "lib/mongo_doc/validations/macros.rb",
+     "lib/mongo_doc/validations/validates_embedded.rb",
+     "lib/mongoid/contexts/enumerable.rb",
+     "lib/mongoid/contexts/paging.rb",
+     "lib/mongoid/criteria.rb",
+     "lib/mongoid/criterion/complex.rb",
+     "lib/mongoid/criterion/exclusion.rb",
+     "lib/mongoid/criterion/inclusion.rb",
+     "lib/mongoid/criterion/optional.rb",
+     "lib/mongoid/extensions/hash/criteria_helpers.rb",
+     "lib/mongoid/extensions/symbol/inflections.rb",
+     "lib/mongoid/matchers/all.rb",
+     "lib/mongoid/matchers/default.rb",
+     "lib/mongoid/matchers/exists.rb",
+     "lib/mongoid/matchers/gt.rb",
+     "lib/mongoid/matchers/gte.rb",
+     "lib/mongoid/matchers/in.rb",
+     "lib/mongoid/matchers/lt.rb",
+     "lib/mongoid/matchers/lte.rb",
+     "lib/mongoid/matchers/ne.rb",
+     "lib/mongoid/matchers/nin.rb",
+     "lib/mongoid/matchers/size.rb",
+     "mongo_doc_rails2.gemspec",
+     "mongod.example.yml",
+     "mongodb.example.yml",
+     "perf/mongo_doc_object.rb",
+     "perf/mongo_document.rb",
+     "perf/ruby_driver.rb",
+     "script/console",
+     "spec/array_including_argument_matcher.rb",
+     "spec/associations/collection_proxy_spec.rb",
+     "spec/associations/document_proxy_spec.rb",
+     "spec/associations/hash_proxy_spec.rb",
+     "spec/associations/proxy_base_spec.rb",
+     "spec/associations_spec.rb",
+     "spec/attributes_accessor_spec.rb",
+     "spec/attributes_spec.rb",
+     "spec/bson_matchers.rb",
+     "spec/bson_spec.rb",
+     "spec/collection_spec.rb",
+     "spec/connection_spec.rb",
+     "spec/contexts/ids_spec.rb",
+     "spec/contexts/mongo_spec.rb",
+     "spec/contexts_spec.rb",
+     "spec/criteria_spec.rb",
+     "spec/cursor_spec.rb",
+     "spec/document_ext.rb",
+     "spec/document_spec.rb",
+     "spec/embedded_save_spec.rb",
+     "spec/ext_spec.rb",
+     "spec/finders_spec.rb",
+     "spec/hash_matchers.rb",
+     "spec/index_spec.rb",
+     "spec/matchers_spec.rb",
+     "spec/mongodb.yml",
+     "spec/mongodb_pairs.yml",
+     "spec/new_record_spec.rb",
+     "spec/root_spec.rb",
+     "spec/scope_spec.rb",
+     "spec/spec.opts",
+     "spec/spec_helper.rb",
+     "spec/validations_spec.rb"
+  ]
+  s.homepage = %q{http://github.com/leshill/mongodoc}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.6}
+  s.summary = %q{ODM for MongoDB - for Rails 2.3.x}
+  s.test_files = [
+    "spec/array_including_argument_matcher.rb",
+     "spec/associations/collection_proxy_spec.rb",
+     "spec/associations/document_proxy_spec.rb",
+     "spec/associations/hash_proxy_spec.rb",
+     "spec/associations/proxy_base_spec.rb",
+     "spec/associations_spec.rb",
+     "spec/attributes_accessor_spec.rb",
+     "spec/attributes_spec.rb",
+     "spec/bson_matchers.rb",
+     "spec/bson_spec.rb",
+     "spec/collection_spec.rb",
+     "spec/connection_spec.rb",
+     "spec/contexts/ids_spec.rb",
+     "spec/contexts/mongo_spec.rb",
+     "spec/contexts_spec.rb",
+     "spec/criteria_spec.rb",
+     "spec/cursor_spec.rb",
+     "spec/document_ext.rb",
+     "spec/document_spec.rb",
+     "spec/embedded_save_spec.rb",
+     "spec/ext_spec.rb",
+     "spec/finders_spec.rb",
+     "spec/hash_matchers.rb",
+     "spec/index_spec.rb",
+     "spec/matchers_spec.rb",
+     "spec/new_record_spec.rb",
+     "spec/root_spec.rb",
+     "spec/scope_spec.rb",
+     "spec/spec_helper.rb",
+     "spec/validations_spec.rb",
+     "examples/simple_document.rb",
+     "examples/simple_object.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<activesupport>, [">= 2.3.4"])
+      s.add_runtime_dependency(%q<mongo>, ["= 1.0.1"])
+      s.add_runtime_dependency(%q<bson>, ["= 1.0.1"])
+      s.add_runtime_dependency(%q<bson_ext>, ["= 1.0.1"])
+      s.add_runtime_dependency(%q<durran-validatable>, ["= 2.0.1"])
+      s.add_runtime_dependency(%q<leshill-will_paginate>, ["= 2.3.11"])
+      s.add_development_dependency(%q<rspec>, ["= 1.3.0"])
+      s.add_development_dependency(%q<cucumber>, [">= 0.6.2"])
+    else
+      s.add_dependency(%q<activesupport>, [">= 2.3.4"])
+      s.add_dependency(%q<mongo>, ["= 1.0.1"])
+      s.add_dependency(%q<bson>, ["= 1.0.1"])
+      s.add_dependency(%q<bson_ext>, ["= 1.0.1"])
+      s.add_dependency(%q<durran-validatable>, ["= 2.0.1"])
+      s.add_dependency(%q<leshill-will_paginate>, ["= 2.3.11"])
+      s.add_dependency(%q<rspec>, ["= 1.3.0"])
+      s.add_dependency(%q<cucumber>, [">= 0.6.2"])
+    end
+  else
+    s.add_dependency(%q<activesupport>, [">= 2.3.4"])
+    s.add_dependency(%q<mongo>, ["= 1.0.1"])
+    s.add_dependency(%q<bson>, ["= 1.0.1"])
+    s.add_dependency(%q<bson_ext>, ["= 1.0.1"])
+    s.add_dependency(%q<durran-validatable>, ["= 2.0.1"])
+    s.add_dependency(%q<leshill-will_paginate>, ["= 2.3.11"])
+    s.add_dependency(%q<rspec>, ["= 1.3.0"])
+    s.add_dependency(%q<cucumber>, [">= 0.6.2"])
+  end
+end
+