jrun-couchrest 0.2.1.1 → 0.12.6

data/lib/couchrest/mixins/views.rb

@@ -1,168 +0,0 @@
-module CouchRest
-  module Mixins
-    module Views
-      
-      def self.included(base)
-        base.extend(ClassMethods)
-        base.send(:class_inheritable_accessor, :design_doc)
-        base.send(:class_inheritable_accessor, :design_doc_slug_cache)
-        base.send(:class_inheritable_accessor, :design_doc_fresh)
-      end
-      
-      module ClassMethods
-        
-        # Define a CouchDB view. The name of the view will be the concatenation
-        # of <tt>by</tt> and the keys joined by <tt>_and_</tt>
-        #  
-        # ==== Example views:
-        #  
-        #   class Post
-        #     # view with default options
-        #     # query with Post.by_date
-        #     view_by :date, :descending => true
-        #  
-        #     # view with compound sort-keys
-        #     # query with Post.by_user_id_and_date
-        #     view_by :user_id, :date
-        #  
-        #     # view with custom map/reduce functions
-        #     # query with Post.by_tags :reduce => true
-        #     view_by :tags,                                                
-        #       :map =>                                                     
-        #         "function(doc) {                                          
-        #           if (doc['couchrest-type'] == 'Post' && doc.tags) {                   
-        #             doc.tags.forEach(function(tag){                       
-        #               emit(doc.tag, 1);                                   
-        #             });                                                   
-        #           }                                                       
-        #         }",                                                       
-        #       :reduce =>                                                  
-        #         "function(keys, values, rereduce) {                       
-        #           return sum(values);                                     
-        #         }"                                                        
-        #   end
-        #  
-        # <tt>view_by :date</tt> will create a view defined by this Javascript
-        # function:
-        #  
-        #   function(doc) {
-        #     if (doc['couchrest-type'] == 'Post' && doc.date) {
-        #       emit(doc.date, null);
-        #     }
-        #   }
-        #  
-        # It can be queried by calling <tt>Post.by_date</tt> which accepts all
-        # valid options for CouchRest::Database#view. In addition, calling with
-        # the <tt>:raw => true</tt> option will return the view rows
-        # themselves. By default <tt>Post.by_date</tt> will return the
-        # documents included in the generated view.
-        #  
-        # CouchRest::Database#view options can be applied at view definition
-        # time as defaults, and they will be curried and used at view query
-        # time. Or they can be overridden at query time.
-        #  
-        # Custom views can be queried with <tt>:reduce => true</tt> to return
-        # reduce results. The default for custom views is to query with
-        # <tt>:reduce => false</tt>.
-        #  
-        # Views are generated (on a per-model basis) lazily on first-access.
-        # This means that if you are deploying changes to a view, the views for
-        # that model won't be available until generation is complete. This can
-        # take some time with large databases. Strategies are in the works.
-        #  
-        # To understand the capabilities of this view system more compeletly,
-        # it is recommended that you read the RSpec file at
-        # <tt>spec/core/model_spec.rb</tt>.
-
-        def view_by(*keys)
-          self.design_doc ||= Design.new(default_design_doc)
-          opts = keys.pop if keys.last.is_a?(Hash)
-          opts ||= {}
-          ducktype = opts.delete(:ducktype)
-          unless ducktype || opts[:map]
-            opts[:guards] ||= []
-            opts[:guards].push "(doc['couchrest-type'] == '#{self.to_s}')"
-          end
-          keys.push opts
-          self.design_doc.view_by(*keys)
-          self.design_doc_fresh = false
-        end
-
-        # returns stored defaults if the there is a view named this in the design doc
-        def has_view?(view)
-          view = view.to_s
-          design_doc && design_doc['views'] && design_doc['views'][view]
-        end
-
-        # Dispatches to any named view.
-        def view(name, query={}, &block)
-          unless design_doc_fresh
-            refresh_design_doc
-          end
-          query[:raw] = true if query[:reduce]        
-          raw = query.delete(:raw)
-          fetch_view_with_docs(name, query, raw, &block)
-        end
-
-        def all_design_doc_versions
-          database.documents :startkey => "_design/#{self.to_s}-", 
-            :endkey => "_design/#{self.to_s}-\u9999"
-        end
-
-        # Deletes any non-current design docs that were created by this class. 
-        # Running this when you're deployed version of your application is steadily 
-        # and consistently using the latest code, is the way to clear out old design 
-        # docs. Running it to early could mean that live code has to regenerate
-        # potentially large indexes.
-        def cleanup_design_docs!
-          ddocs = all_design_doc_versions
-          ddocs["rows"].each do |row|
-            if (row['id'] != design_doc_id)
-              database.delete_doc({
-                "_id" => row['id'],
-                "_rev" => row['value']['rev']
-              })
-            end
-          end
-        end
-
-        private
-
-        def fetch_view_with_docs(name, opts, raw=false, &block)
-          if raw || (opts.has_key?(:include_docs) && opts[:include_docs] == false)
-            fetch_view(name, opts, &block)
-          else
-            begin
-              view = fetch_view name, opts.merge({:include_docs => true}), &block
-              view['rows'].collect{|r|new(r['doc'])} if view['rows']
-            rescue
-              # fallback for old versions of couchdb that don't 
-              # have include_docs support
-              view = fetch_view(name, opts, &block)
-              view['rows'].collect{|r|new(database.get(r['id']))} if view['rows']
-            end
-          end
-        end
-
-        def fetch_view view_name, opts, &block
-          retryable = true
-          begin
-            design_doc.view(view_name, opts, &block)
-            # the design doc could have been deleted by a rouge process
-          rescue RestClient::ResourceNotFound => e
-            if retryable
-              refresh_design_doc
-              retryable = false
-              retry
-            else
-              raise e
-            end
-          end
-        end
-        
-      end # module ClassMethods
-      
-      
-    end
-  end
-end

data/lib/couchrest/mixins.rb

@@ -1,4 +0,0 @@
-mixins_dir = File.join(File.dirname(__FILE__), 'mixins')
-
-require File.join(mixins_dir, 'attachments')
-require File.join(mixins_dir, 'callbacks')

data/lib/couchrest/more/casted_model.rb

@@ -1,28 +0,0 @@
-require File.join(File.dirname(__FILE__), '..', 'mixins', 'properties')
-
-module CouchRest
-  module CastedModel
-    
-    def self.included(base)
-      base.send(:include, CouchRest::Mixins::Properties)
-      base.send(:attr_accessor, :casted_by)
-    end
-    
-    def initialize(keys={})
-      super
-      keys.each do |k,v|
-        self[k.to_s] = v
-      end if keys
-      apply_defaults # defined in CouchRest::Mixins::Properties
-      # cast_keys      # defined in CouchRest::Mixins::Properties
-    end
-    
-    def []= key, value
-      super(key.to_s, value)
-    end
-    
-    def [] key
-      super(key.to_s)
-    end
-  end
-end

data/lib/couchrest/more/extended_document.rb

@@ -1,217 +0,0 @@
-begin
-  # still required for Time parsing and pluralization in the validation
-  require 'extlib'
-rescue 
-  puts "CouchRest::ExtendedDocument still requires extlib (not for much longer). This is left out of the gemspec on purpose."
-  raise
-end
-
-require 'mime/types'
-require File.join(File.dirname(__FILE__), "property")
-require File.join(File.dirname(__FILE__), '..', 'mixins', 'extended_document_mixins')
-
-module CouchRest
-  
-  # Same as CouchRest::Document but with properties and validations
-  class ExtendedDocument < Document
-    include CouchRest::Callbacks
-    include CouchRest::Mixins::DocumentQueries    
-    include CouchRest::Mixins::Views
-    include CouchRest::Mixins::DesignDoc
-    include CouchRest::Mixins::ExtendedAttachments
-    
-    def self.inherited(subklass)
-      subklass.send(:include, CouchRest::Mixins::Properties)
-    end
-    
-    # Accessors
-    attr_accessor :casted_by
-    
-    # Callbacks
-    define_callbacks :create
-    define_callbacks :save
-    define_callbacks :update
-    define_callbacks :destroy
-    
-    def initialize(passed_keys={})
-      apply_defaults # defined in CouchRest::Mixins::Properties
-      super
-      cast_keys      # defined in CouchRest::Mixins::Properties
-      unless self['_id'] && self['_rev']
-        self['couchrest-type'] = self.class.to_s
-      end
-    end
-    
-    
-    # Automatically set <tt>updated_at</tt> and <tt>created_at</tt> fields
-    # on the document whenever saving occurs. CouchRest uses a pretty
-    # decent time format by default. See Time#to_json
-    def self.timestamps!
-      class_eval <<-EOS, __FILE__, __LINE__
-        property(:updated_at, :read_only => true, :cast_as => 'Time', :auto_validation => false)
-        property(:created_at, :read_only => true, :cast_as => 'Time', :auto_validation => false)
-        
-        save_callback :before do |object|
-          object['updated_at'] = Time.now
-          object['created_at'] = object['updated_at'] if object.new_document?
-        end
-      EOS
-    end
-  
-    # Name a method that will be called before the document is first saved,
-    # which returns a string to be used for the document's <tt>_id</tt>.
-    # Because CouchDB enforces a constraint that each id must be unique,
-    # this can be used to enforce eg: uniq usernames. Note that this id
-    # must be globally unique across all document types which share a
-    # database, so if you'd like to scope uniqueness to this class, you
-    # should use the class name as part of the unique id.
-    def self.unique_id method = nil, &block
-      if method
-        define_method :set_unique_id do
-          self['_id'] ||= self.send(method)
-        end
-      elsif block
-        define_method :set_unique_id do
-          uniqid = block.call(self)
-          raise ArgumentError, "unique_id block must not return nil" if uniqid.nil?
-          self['_id'] ||= uniqid
-        end
-      end
-    end
-    
-    # Temp solution to make the view_by methods available
-    def self.method_missing(m, *args)
-      if has_view?(m)
-        query = args.shift || {}
-        view(m, query, *args)
-      else
-        super
-      end
-    end
-    
-    ### instance methods
-    
-    # Returns the Class properties
-    #
-    # ==== Returns
-    # Array:: the list of properties for the instance
-    def properties
-      self.class.properties
-    end
-    
-    # Takes a hash as argument, and applies the values by using writer methods
-    # for each key. It doesn't save the document at the end. Raises a NoMethodError if the corresponding methods are
-    # missing. In case of error, no attributes are changed.    
-    def update_attributes_without_saving(hash)
-      hash.each do |k, v|
-        raise NoMethodError, "#{k}= method not available, use property :#{k}" unless self.respond_to?("#{k}=")
-      end      
-      hash.each do |k, v|
-        self.send("#{k}=",v)
-      end
-    end
-
-    # Takes a hash as argument, and applies the values by using writer methods
-    # for each key. Raises a NoMethodError if the corresponding methods are
-    # missing. In case of error, no attributes are changed.
-    def update_attributes(hash)
-      update_attributes_without_saving hash
-      save
-    end
-
-    # for compatibility with old-school frameworks
-    alias :new_record? :new_document?
-    
-    # Trigger the callbacks (before, after, around)
-    # and create the document
-    # It's important to have a create callback since you can't check if a document
-    # was new after you saved it
-    #
-    # When creating a document, both the create and the save callbacks will be triggered.
-    def create(bulk = false)
-      caught = catch(:halt)  do
-        _run_create_callbacks do
-            _run_save_callbacks do
-              create_without_callbacks(bulk)
-          end
-        end
-      end
-    end
-    
-    # unlike save, create returns the newly created document
-    def create_without_callbacks(bulk =false)
-      raise ArgumentError, "a document requires a database to be created to (The document or the #{self.class} default database were not set)" unless database
-      set_unique_id if new_document? && self.respond_to?(:set_unique_id)
-      result = database.save_doc(self, bulk)
-      (result["ok"] == true) ? self : false
-    end
-    
-    # Creates the document in the db. Raises an exception
-    # if the document is not created properly.
-    def create!
-      raise "#{self.inspect} failed to save" unless self.create
-    end
-    
-    # Trigger the callbacks (before, after, around)
-    # only if the document isn't new
-    def update(bulk = false)
-      caught = catch(:halt)  do
-        if self.new_document?
-          save(bulk)
-        else
-          _run_update_callbacks do
-            _run_save_callbacks do
-              save_without_callbacks(bulk)
-            end
-          end
-        end
-      end
-    end
-    
-    # Trigger the callbacks (before, after, around)
-    # and save the document
-    def save(bulk = false)
-      caught = catch(:halt)  do
-        if self.new_document?
-          _run_save_callbacks do
-            save_without_callbacks(bulk)
-          end
-        else
-          update(bulk)
-        end
-      end
-    end
-    
-    # Overridden to set the unique ID.
-    # Returns a boolean value
-    def save_without_callbacks(bulk = false)
-      raise ArgumentError, "a document requires a database to be saved to (The document or the #{self.class} default database were not set)" unless database
-      set_unique_id if new_document? && self.respond_to?(:set_unique_id)
-      result = database.save_doc(self, bulk)
-      result["ok"] == true
-    end
-    
-    # Saves the document to the db using save. Raises an exception
-    # if the document is not saved properly.
-    def save!
-      raise "#{self.inspect} failed to save" unless self.save
-    end
-
-    # Deletes the document from the database. Runs the :destroy callbacks.
-    # Removes the <tt>_id</tt> and <tt>_rev</tt> fields, preparing the
-    # document to be saved to a new <tt>_id</tt>.
-    def destroy(bulk=false)
-      caught = catch(:halt)  do
-        _run_destroy_callbacks do
-          result = database.delete_doc(self, bulk)
-          if result['ok']
-            self['_rev'] = nil
-            self['_id'] = nil
-          end
-          result['ok']
-        end
-      end
-    end
-    
-  end
-end

data/lib/couchrest/more/property.rb

@@ -1,40 +0,0 @@
-module CouchRest
-  
-  # Basic attribute support for adding getter/setter + validation
-  class Property
-    attr_reader :name, :type, :read_only, :alias, :default, :casted, :init_method, :options
-    
-    # attribute to define
-    def initialize(name, type = nil, options = {})
-      @name = name.to_s
-      parse_type(type)
-      parse_options(options)
-      self
-    end
-    
-    
-    private
-    
-      def parse_type(type)
-        if type.nil?
-          @type = 'String'
-        elsif type.is_a?(Array) && type.empty?
-          @type = 'Array'
-        else
-          @type = type.is_a?(Array) ? [type.first.to_s] : type.to_s
-        end
-      end
-      
-      def parse_options(options)
-        return if options.empty?
-        @validation_format  = options.delete(:format)     if options[:format]
-        @read_only          = options.delete(:read_only)  if options[:read_only]
-        @alias              = options.delete(:alias)      if options[:alias]
-        @default            = options.delete(:default)    if options[:default]
-        @casted             = options[:casted] ? true : false
-        @init_method        = options[:send] ? options.delete(:send) : 'new'
-        @options            = options
-      end
-    
-  end
-end

data/lib/couchrest/support/blank.rb

@@ -1,42 +0,0 @@
-# blank? methods for several different class types
-class Object
-  # Returns true if the object is nil or empty (if applicable)
-  def blank?
-    nil? || (respond_to?(:empty?) && empty?)
-  end
-end # class Object
-
-class Numeric
-  # Numerics can't be blank
-  def blank?
-    false
-  end
-end # class Numeric
-
-class NilClass
-  # Nils are always blank
-  def blank?
-    true
-  end
-end # class NilClass
-
-class TrueClass
-  # True is not blank.
-  def blank?
-    false
-  end
-end # class TrueClass
-
-class FalseClass
-  # False is always blank.
-  def blank?
-    true
-  end
-end # class FalseClass
-
-class String
-  # Strips out whitespace then tests if the string is empty.
-  def blank?
-    strip.empty?
-  end
-end # class String

data/lib/couchrest/support/class.rb

@@ -1,191 +0,0 @@
-# Copyright (c) 2004-2008 David Heinemeier Hansson
-#
-# 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.
- 
-# Allows attributes to be shared within an inheritance hierarchy, but where
-# each descendant gets a copy of their parents' attributes, instead of just a
-# pointer to the same. This means that the child can add elements to, for
-# example, an array without those additions being shared with either their
-# parent, siblings, or children, which is unlike the regular class-level
-# attributes that are shared across the entire hierarchy.
-module CouchRest
-  module ClassExtension
-    def self.included(base)
-      if CouchRest::ClassExtension::InstanceMethods.instance_methods.all? {|m| base.respond_to?(m)}
-        # do nothing
-      elsif CouchRest::ClassExtension::InstanceMethods.instance_methods.any? {|m| base.respond_to?(m)}
-        raise RuntimeError, "Conflicting extentions to Class, work it out"
-      else
-        base.send(:include, CouchRest::ClassExtension::InstanceMethods)
-      end
-    end
-    
-    module InstanceMethods
-      # Defines class-level and instance-level attribute reader.
-      #
-      # @param *syms<Array> Array of attributes to define reader for.
-      # @return <Array[#to_s]> List of attributes that were made into cattr_readers
-      #
-      # @api public
-      #
-      # @todo Is this inconsistent in that it does not allow you to prevent
-      # an instance_reader via :instance_reader => false
-      def cattr_reader(*syms)
-        syms.flatten.each do |sym|
-          next if sym.is_a?(Hash)
-          class_eval(<<-RUBY, __FILE__, __LINE__ + 1)
-    unless defined? @@#{sym}
-    @@#{sym} = nil
-    end
- 
-    def self.#{sym}
-    @@#{sym}
-    end
- 
-    def #{sym}
-    @@#{sym}
-    end
-    RUBY
-        end
-      end
- 
-      # Defines class-level (and optionally instance-level) attribute writer.
-      #
-      # @param <Array[*#to_s, Hash{:instance_writer => Boolean}]> Array of attributes to define writer for.
-      # @option syms :instance_writer<Boolean> if true, instance-level attribute writer is defined.
-      # @return <Array[#to_s]> List of attributes that were made into cattr_writers
-      #
-      # @api public
-      def cattr_writer(*syms)
-        options = syms.last.is_a?(Hash) ? syms.pop : {}
-        syms.flatten.each do |sym|
-          class_eval(<<-RUBY, __FILE__, __LINE__ + 1)
-    unless defined? @@#{sym}
-    @@#{sym} = nil
-    end
- 
-    def self.#{sym}=(obj)
-    @@#{sym} = obj
-    end
-    RUBY
- 
-          unless options[:instance_writer] == false
-            class_eval(<<-RUBY, __FILE__, __LINE__ + 1)
-    def #{sym}=(obj)
-    @@#{sym} = obj
-    end
-    RUBY
-          end
-        end
-      end
- 
-      # Defines class-level (and optionally instance-level) attribute accessor.
-      #
-      # @param *syms<Array[*#to_s, Hash{:instance_writer => Boolean}]> Array of attributes to define accessor for.
-      # @option syms :instance_writer<Boolean> if true, instance-level attribute writer is defined.
-      # @return <Array[#to_s]> List of attributes that were made into accessors
-      #
-      # @api public
-      def cattr_accessor(*syms)
-        cattr_reader(*syms)
-        cattr_writer(*syms)
-      end
- 
-      # Defines class-level inheritable attribute reader. Attributes are available to subclasses,
-      # each subclass has a copy of parent's attribute.
-      #
-      # @param *syms<Array[#to_s]> Array of attributes to define inheritable reader for.
-      # @return <Array[#to_s]> Array of attributes converted into inheritable_readers.
-      #
-      # @api public
-      #
-      # @todo Do we want to block instance_reader via :instance_reader => false
-      # @todo It would be preferable that we do something with a Hash passed in
-      # (error out or do the same as other methods above) instead of silently
-      # moving on). In particular, this makes the return value of this function
-      # less useful.
-      def class_inheritable_reader(*ivars)
-        instance_reader = ivars.pop[:reader] if ivars.last.is_a?(Hash)
- 
-        ivars.each do |ivar|
-          self.class_eval <<-RUBY, __FILE__, __LINE__ + 1
-    def self.#{ivar}
-    return @#{ivar} if self.object_id == #{self.object_id} || defined?(@#{ivar})
-    ivar = superclass.#{ivar}
-    return nil if ivar.nil? && !#{self}.instance_variable_defined?("@#{ivar}")
-    @#{ivar} = ivar && !ivar.is_a?(Module) && !ivar.is_a?(Numeric) && !ivar.is_a?(TrueClass) && !ivar.is_a?(FalseClass) && !ivar.is_a?(Symbol) ? ivar.dup : ivar
-    end
-    RUBY
-          unless instance_reader == false
-            self.class_eval <<-RUBY, __FILE__, __LINE__ + 1
-    def #{ivar}
-    self.class.#{ivar}
-    end
-    RUBY
-          end
-        end
-      end
- 
-      # Defines class-level inheritable attribute writer. Attributes are available to subclasses,
-      # each subclass has a copy of parent's attribute.
-      #
-      # @param *syms<Array[*#to_s, Hash{:instance_writer => Boolean}]> Array of attributes to
-      # define inheritable writer for.
-      # @option syms :instance_writer<Boolean> if true, instance-level inheritable attribute writer is defined.
-      # @return <Array[#to_s]> An Array of the attributes that were made into inheritable writers.
-      #
-      # @api public
-      #
-      # @todo We need a style for class_eval <<-HEREDOC. I'd like to make it
-      # class_eval(<<-RUBY, __FILE__, __LINE__), but we should codify it somewhere.
-      def class_inheritable_writer(*ivars)
-        instance_writer = ivars.pop[:instance_writer] if ivars.last.is_a?(Hash)
-        ivars.each do |ivar|
-          self.class_eval <<-RUBY, __FILE__, __LINE__ + 1
-    def self.#{ivar}=(obj)
-    @#{ivar} = obj
-    end
-    RUBY
-          unless instance_writer == false
-            self.class_eval <<-RUBY, __FILE__, __LINE__ + 1
-    def #{ivar}=(obj) self.class.#{ivar} = obj end
-    RUBY
-          end
-        end
-      end
- 
-      # Defines class-level inheritable attribute accessor. Attributes are available to subclasses,
-      # each subclass has a copy of parent's attribute.
-      #
-      # @param *syms<Array[*#to_s, Hash{:instance_writer => Boolean}]> Array of attributes to
-      # define inheritable accessor for.
-      # @option syms :instance_writer<Boolean> if true, instance-level inheritable attribute writer is defined.
-      # @return <Array[#to_s]> An Array of attributes turned into inheritable accessors.
-      #
-      # @api public
-      def class_inheritable_accessor(*syms)
-        class_inheritable_reader(*syms)
-        class_inheritable_writer(*syms)
-      end
-    end
-  end
-end
-
-Class.send(:include, CouchRest::ClassExtension)