typo 5.3 → 5.4

data/vendor/plugins/will_paginate/lib/will_paginate/array.rb

@@ -1,16 +0,0 @@
-require 'will_paginate/collection'
-
-# http://www.desimcadam.com/archives/8
-Array.class_eval do
-  def paginate(options = {})
-    raise ArgumentError, "parameter hash expected (got #{options.inspect})" unless Hash === options
-    
-    WillPaginate::Collection.create(
-        options[:page] || 1,
-        options[:per_page] || 30,
-        options[:total_entries] || self.length
-    ) { |pager|
-      pager.replace self[pager.offset, pager.per_page].to_a
-    }
-  end
-end

data/vendor/plugins/will_paginate/lib/will_paginate/collection.rb

@@ -1,146 +0,0 @@
-module WillPaginate
-  # = Invalid page number error
-  # This is an ArgumentError raised in case a page was requested that is either
-  # zero or negative number. You should decide how do deal with such errors in
-  # the controller.
-  #
-  # If you're using Rails 2, then this error will automatically get handled like
-  # 404 Not Found. The hook is in "will_paginate.rb":
-  #
-  #   ActionController::Base.rescue_responses['WillPaginate::InvalidPage'] = :not_found
-  #
-  # If you don't like this, use your preffered method of rescuing exceptions in
-  # public from your controllers to handle this differently. The +rescue_from+
-  # method is a nice addition to Rails 2.
-  #
-  # This error is *not* raised when a page further than the last page is
-  # requested. Use <tt>WillPaginate::Collection#out_of_bounds?</tt> method to
-  # check for those cases and manually deal with them as you see fit.
-  class InvalidPage < ArgumentError
-    def initialize(page, page_num)
-      super "#{page.inspect} given as value, which translates to '#{page_num}' as page number"
-    end
-  end
-  
-  # = The key to pagination
-  # Arrays returned from paginating finds are, in fact, instances of this little
-  # class. You may think of WillPaginate::Collection as an ordinary array with
-  # some extra properties. Those properties are used by view helpers to generate
-  # correct page links.
-  #
-  # WillPaginate::Collection also assists in rolling out your own pagination
-  # solutions: see +create+.
-  # 
-  # If you are writing a library that provides a collection which you would like
-  # to conform to this API, you don't have to copy these methods over; simply
-  # make your plugin/gem dependant on the "mislav-will_paginate" gem:
-  #
-  #   gem 'mislav-will_paginate'
-  #   require 'will_paginate/collection'
-  #   
-  #   # WillPaginate::Collection is now available for use
-  class Collection < Array
-    attr_reader :current_page, :per_page, :total_entries, :total_pages
-
-    # Arguments to the constructor are the current page number, per-page limit
-    # and the total number of entries. The last argument is optional because it
-    # is best to do lazy counting; in other words, count *conditionally* after
-    # populating the collection using the +replace+ method.
-    def initialize(page, per_page, total = nil)
-      @current_page = page.to_i
-      raise InvalidPage.new(page, @current_page) if @current_page < 1
-      @per_page = per_page.to_i
-      raise ArgumentError, "`per_page` setting cannot be less than 1 (#{@per_page} given)" if @per_page < 1
-      
-      self.total_entries = total if total
-    end
-
-    # Just like +new+, but yields the object after instantiation and returns it
-    # afterwards. This is very useful for manual pagination:
-    #
-    #   @entries = WillPaginate::Collection.create(1, 10) do |pager|
-    #     result = Post.find(:all, :limit => pager.per_page, :offset => pager.offset)
-    #     # inject the result array into the paginated collection:
-    #     pager.replace(result)
-    #
-    #     unless pager.total_entries
-    #       # the pager didn't manage to guess the total count, do it manually
-    #       pager.total_entries = Post.count
-    #     end
-    #   end
-    #
-    # The possibilities with this are endless. For another example, here is how
-    # WillPaginate used to define pagination for Array instances:
-    #
-    #   Array.class_eval do
-    #     def paginate(page = 1, per_page = 15)
-    #       WillPaginate::Collection.create(page, per_page, size) do |pager|
-    #         pager.replace self[pager.offset, pager.per_page].to_a
-    #       end
-    #     end
-    #   end
-    #
-    # The Array#paginate API has since then changed, but this still serves as a
-    # fine example of WillPaginate::Collection usage.
-    def self.create(page, per_page, total = nil, &block)
-      pager = new(page, per_page, total)
-      yield pager
-      pager
-    end
-
-    # Helper method that is true when someone tries to fetch a page with a
-    # larger number than the last page. Can be used in combination with flashes
-    # and redirecting.
-    def out_of_bounds?
-      current_page > total_pages
-    end
-
-    # Current offset of the paginated collection. If we're on the first page,
-    # it is always 0. If we're on the 2nd page and there are 30 entries per page,
-    # the offset is 30. This property is useful if you want to render ordinals
-    # side by side with records in the view: simply start with offset + 1.
-    def offset
-      (current_page - 1) * per_page
-    end
-
-    # current_page - 1 or nil if there is no previous page
-    def previous_page
-      current_page > 1 ? (current_page - 1) : nil
-    end
-
-    # current_page + 1 or nil if there is no next page
-    def next_page
-      current_page < total_pages ? (current_page + 1) : nil
-    end
-    
-    # sets the <tt>total_entries</tt> property and calculates <tt>total_pages</tt>
-    def total_entries=(number)
-      @total_entries = number.to_i
-      @total_pages   = (@total_entries / per_page.to_f).ceil
-    end
-
-    # This is a magic wrapper for the original Array#replace method. It serves
-    # for populating the paginated collection after initialization.
-    #
-    # Why magic? Because it tries to guess the total number of entries judging
-    # by the size of given array. If it is shorter than +per_page+ limit, then we
-    # know we're on the last page. This trick is very useful for avoiding
-    # unnecessary hits to the database to do the counting after we fetched the
-    # data for the current page.
-    #
-    # However, after using +replace+ you should always test the value of
-    # +total_entries+ and set it to a proper value if it's +nil+. See the example
-    # in +create+.
-    def replace(array)
-      result = super
-      
-      # The collection is shorter then page limit? Rejoice, because
-      # then we know that we are on the last page!
-      if total_entries.nil? and length < per_page and (current_page == 1 or length > 0)
-        self.total_entries = offset + length
-      end
-
-      result
-    end
-  end
-end

data/vendor/plugins/will_paginate/lib/will_paginate/core_ext.rb

@@ -1,32 +0,0 @@
-require 'set'
-require 'will_paginate/array'
-
-unless Hash.instance_methods.include? 'except'
-  Hash.class_eval do
-    # Returns a new hash without the given keys.
-    def except(*keys)
-      rejected = Set.new(respond_to?(:convert_key) ? keys.map { |key| convert_key(key) } : keys)
-      reject { |key,| rejected.include?(key) }
-    end
- 
-    # Replaces the hash without only the given keys.
-    def except!(*keys)
-      replace(except(*keys))
-    end
-  end
-end
-
-unless Hash.instance_methods.include? 'slice'
-  Hash.class_eval do
-    # Returns a new hash with only the given keys.
-    def slice(*keys)
-      allowed = Set.new(respond_to?(:convert_key) ? keys.map { |key| convert_key(key) } : keys)
-      reject { |key,| !allowed.include?(key) }
-    end
-
-    # Replaces the hash with only the given keys.
-    def slice!(*keys)
-      replace(slice(*keys))
-    end
-  end
-end

data/vendor/plugins/will_paginate/lib/will_paginate/finder.rb

@@ -1,260 +0,0 @@
-require 'will_paginate/core_ext'
-
-module WillPaginate
-  # A mixin for ActiveRecord::Base. Provides +per_page+ class method
-  # and hooks things up to provide paginating finders.
-  #
-  # Find out more in WillPaginate::Finder::ClassMethods
-  #
-  module Finder
-    def self.included(base)
-      base.extend ClassMethods
-      class << base
-        alias_method_chain :method_missing, :paginate
-        # alias_method_chain :find_every,     :paginate
-        define_method(:per_page) { 30 } unless respond_to?(:per_page)
-      end
-    end
-
-    # = Paginating finders for ActiveRecord models
-    # 
-    # WillPaginate adds +paginate+, +per_page+ and other methods to
-    # ActiveRecord::Base class methods and associations. It also hooks into
-    # +method_missing+ to intercept pagination calls to dynamic finders such as
-    # +paginate_by_user_id+ and translate them to ordinary finders
-    # (+find_all_by_user_id+ in this case).
-    # 
-    # In short, paginating finders are equivalent to ActiveRecord finders; the
-    # only difference is that we start with "paginate" instead of "find" and
-    # that <tt>:page</tt> is required parameter:
-    #
-    #   @posts = Post.paginate :all, :page => params[:page], :order => 'created_at DESC'
-    # 
-    # In paginating finders, "all" is implicit. There is no sense in paginating
-    # a single record, right? So, you can drop the <tt>:all</tt> argument:
-    # 
-    #   Post.paginate(...)              =>  Post.find :all
-    #   Post.paginate_all_by_something  =>  Post.find_all_by_something
-    #   Post.paginate_by_something      =>  Post.find_all_by_something
-    #
-    # == The importance of the <tt>:order</tt> parameter
-    #
-    # In ActiveRecord finders, <tt>:order</tt> parameter specifies columns for
-    # the <tt>ORDER BY</tt> clause in SQL. It is important to have it, since
-    # pagination only makes sense with ordered sets. Without the <tt>ORDER
-    # BY</tt> clause, databases aren't required to do consistent ordering when
-    # performing <tt>SELECT</tt> queries; this is especially true for
-    # PostgreSQL.
-    #
-    # Therefore, make sure you are doing ordering on a column that makes the
-    # most sense in the current context. Make that obvious to the user, also.
-    # For perfomance reasons you will also want to add an index to that column.
-    module ClassMethods
-      # This is the main paginating finder.
-      #
-      # == Special parameters for paginating finders
-      # * <tt>:page</tt> -- REQUIRED, but defaults to 1 if false or nil
-      # * <tt>:per_page</tt> -- defaults to <tt>CurrentModel.per_page</tt> (which is 30 if not overridden)
-      # * <tt>:total_entries</tt> -- use only if you manually count total entries
-      # * <tt>:count</tt> -- additional options that are passed on to +count+
-      # * <tt>:finder</tt> -- name of the ActiveRecord finder used (default: "find")
-      #
-      # All other options (+conditions+, +order+, ...) are forwarded to +find+
-      # and +count+ calls.
-      def paginate(*args, &block)
-        options = args.pop
-        page, per_page, total_entries = wp_parse_options(options)
-        finder = (options[:finder] || 'find').to_s
-
-        if finder == 'find'
-          # an array of IDs may have been given:
-          total_entries ||= (Array === args.first and args.first.size)
-          # :all is implicit
-          args.unshift(:all) if args.empty?
-        end
-
-        WillPaginate::Collection.create(page, per_page, total_entries) do |pager|
-          count_options = options.except :page, :per_page, :total_entries, :finder
-          find_options = count_options.except(:count).update(:offset => pager.offset, :limit => pager.per_page) 
-          
-          args << find_options
-          # @options_from_last_find = nil
-          pager.replace send(finder, *args, &block)
-          
-          # magic counting for user convenience:
-          pager.total_entries = wp_count(count_options, args, finder) unless pager.total_entries
-        end
-      end
-
-      # Iterates through all records by loading one page at a time. This is useful
-      # for migrations or any other use case where you don't want to load all the
-      # records in memory at once.
-      #
-      # It uses +paginate+ internally; therefore it accepts all of its options.
-      # You can specify a starting page with <tt>:page</tt> (default is 1). Default
-      # <tt>:order</tt> is <tt>"id"</tt>, override if necessary.
-      #
-      # See {Faking Cursors in ActiveRecord}[http://weblog.jamisbuck.org/2007/4/6/faking-cursors-in-activerecord]
-      # where Jamis Buck describes this and a more efficient way for MySQL.
-      def paginated_each(options = {}, &block)
-        options = { :order => 'id', :page => 1 }.merge options
-        options[:page] = options[:page].to_i
-        options[:total_entries] = 0 # skip the individual count queries
-        total = 0
-        
-        begin 
-          collection = paginate(options)
-          with_exclusive_scope(:find => {}) do
-            # using exclusive scope so that the block is yielded in scope-free context
-            total += collection.each(&block).size
-          end
-          options[:page] += 1
-        end until collection.size < collection.per_page
-        
-        total
-      end
-      
-      # Wraps +find_by_sql+ by simply adding LIMIT and OFFSET to your SQL string
-      # based on the params otherwise used by paginating finds: +page+ and
-      # +per_page+.
-      #
-      # Example:
-      # 
-      #   @developers = Developer.paginate_by_sql ['select * from developers where salary > ?', 80000],
-      #                          :page => params[:page], :per_page => 3
-      #
-      # A query for counting rows will automatically be generated if you don't
-      # supply <tt>:total_entries</tt>. If you experience problems with this
-      # generated SQL, you might want to perform the count manually in your
-      # application.
-      # 
-      def paginate_by_sql(sql, options)
-        WillPaginate::Collection.create(*wp_parse_options(options)) do |pager|
-          query = sanitize_sql(sql.dup)
-          original_query = query.dup
-          # add limit, offset
-          add_limit! query, :offset => pager.offset, :limit => pager.per_page
-          # perfom the find
-          pager.replace find_by_sql(query)
-          
-          unless pager.total_entries
-            count_query = original_query.sub /\bORDER\s+BY\s+[\w`,\s]+$/mi, ''
-            count_query = "SELECT COUNT(*) FROM (#{count_query})"
-            
-            unless ['oracle', 'oci'].include?(self.connection.adapter_name.downcase)
-              count_query << ' AS count_table'
-            end
-            # perform the count query
-            pager.total_entries = count_by_sql(count_query)
-          end
-        end
-      end
-
-      def respond_to?(method, include_priv = false) #:nodoc:
-        case method.to_sym
-        when :paginate, :paginate_by_sql
-          true
-        else
-          super(method.to_s.sub(/^paginate/, 'find'), include_priv)
-        end
-      end
-
-    protected
-      
-      def method_missing_with_paginate(method, *args, &block) #:nodoc:
-        # did somebody tried to paginate? if not, let them be
-        unless method.to_s.index('paginate') == 0
-          return method_missing_without_paginate(method, *args, &block) 
-        end
-        
-        # paginate finders are really just find_* with limit and offset
-        finder = method.to_s.sub('paginate', 'find')
-        finder.sub!('find', 'find_all') if finder.index('find_by_') == 0
-        
-        options = args.pop
-        raise ArgumentError, 'parameter hash expected' unless options.respond_to? :symbolize_keys
-        options = options.dup
-        options[:finder] = finder
-        args << options
-        
-        paginate(*args, &block)
-      end
-
-      # Does the not-so-trivial job of finding out the total number of entries
-      # in the database. It relies on the ActiveRecord +count+ method.
-      def wp_count(options, args, finder)
-        excludees = [:count, :order, :limit, :offset, :readonly]
-        excludees << :from unless ActiveRecord::Calculations::CALCULATIONS_OPTIONS.include?(:from)
-
-        # we may be in a model or an association proxy
-        klass = (@owner and @reflection) ? @reflection.klass : self
-
-        # Use :select from scope if it isn't already present.
-        options[:select] = scope(:find, :select) unless options[:select]
-
-        if options[:select] and options[:select] =~ /^\s*DISTINCT\b/i
-          # Remove quoting and check for table_name.*-like statement.
-          if options[:select].gsub('`', '') =~ /\w+\.\*/
-            options[:select] = "DISTINCT #{klass.table_name}.#{klass.primary_key}"
-          end
-        else
-          excludees << :select # only exclude the select param if it doesn't begin with DISTINCT
-        end
-
-        # count expects (almost) the same options as find
-        count_options = options.except *excludees
-
-        # merge the hash found in :count
-        # this allows you to specify :select, :order, or anything else just for the count query
-        count_options.update options[:count] if options[:count]
-
-        # forget about includes if they are irrelevant (Rails 2.1)
-        if count_options[:include] and
-            klass.private_methods.include?('references_eager_loaded_tables?') and
-            !klass.send(:references_eager_loaded_tables?, count_options)
-          count_options.delete :include
-        end
-
-        # we may have to scope ...
-        counter = Proc.new { count(count_options) }
-
-        count = if finder.index('find_') == 0 and klass.respond_to?(scoper = finder.sub('find', 'with'))
-                  # scope_out adds a 'with_finder' method which acts like with_scope, if it's present
-                  # then execute the count with the scoping provided by the with_finder
-                  send(scoper, &counter)
-                elsif finder =~ /^find_(all_by|by)_([_a-zA-Z]\w*)$/
-                  # extract conditions from calls like "paginate_by_foo_and_bar"
-                  attribute_names = $2.split('_and_')
-                  conditions = construct_attributes_from_arguments(attribute_names, args)
-                  with_scope(:find => { :conditions => conditions }, &counter)
-                else
-                  counter.call
-                end
-
-        count.respond_to?(:length) ? count.length : count
-      end
-
-      def wp_parse_options(options) #:nodoc:
-        raise ArgumentError, 'parameter hash expected' unless options.respond_to? :symbolize_keys
-        options = options.symbolize_keys
-        raise ArgumentError, ':page parameter required' unless options.key? :page
-        
-        if options[:count] and options[:total_entries]
-          raise ArgumentError, ':count and :total_entries are mutually exclusive'
-        end
-
-        page     = options[:page] || 1
-        per_page = options[:per_page] || self.per_page
-        total    = options[:total_entries]
-        [page, per_page, total]
-      end
-
-    private
-
-      # def find_every_with_paginate(options)
-      #   @options_from_last_find = options
-      #   find_every_without_paginate(options)
-      # end
-    end
-  end
-end