kaminari 0.17.0 → 1.0.0.beta2

data/lib/kaminari/helpers/sinatra_helpers.rb

@@ -1,176 +0,0 @@
-require 'active_support/core_ext/object'
-require 'active_support/core_ext/string'
-require 'action_dispatch/http/mime_type'
-
-begin
-
-require 'padrino-helpers'
-module Kaminari::Helpers
-  module SinatraHelpers
-    class << self
-      def registered(app)
-        app.register Padrino::Helpers
-        app.helpers  HelperMethods
-        @app = app
-      end
-
-      def view_paths
-        @app.views
-      end
-
-      alias included registered
-    end
-
-    class ActionViewTemplateProxy
-      include Padrino::Helpers::OutputHelpers
-      include Padrino::Helpers::TagHelpers
-      include Padrino::Helpers::AssetTagHelpers
-      include Padrino::Helpers::FormatHelpers
-      include Padrino::Helpers::TranslationHelpers
-
-      def initialize(opts={})
-        @current_path = opts[:current_path]
-        @param_name = (opts[:param_name] || :page).to_sym
-        @current_params = opts[:current_params]
-        @current_params.delete(@param_name)
-      end
-
-      def render(*args)
-        base = ActionView::Base.new.tap do |a|
-          a.view_paths << SinatraHelpers.view_paths
-          a.view_paths << File.expand_path('../../../../app/views', __FILE__)
-        end
-        base.render(*args)
-      end
-
-      def url_for(params)
-        extra_params = {}
-        if page = params[@param_name] and page != 1
-          extra_params[@param_name] = page
-        end
-        query = @current_params.merge(extra_params)
-        @current_path + (query.empty? ? '' : "?#{query.to_query}")
-      end
-
-      def link_to_unless(condition, name, options = {}, html_options = {}, &block)
-        options = url_for(options) if options.is_a? Hash
-        if condition
-          if block_given?
-            block.arity <= 1 ? capture(name, &block) : capture(name, options, html_options, &block)
-          else
-            name
-          end
-        else
-          link_to(name, options, html_options)
-        end
-      end
-
-      def params
-        @current_params
-      end
-    end
-
-    module HelperMethods
-      # A helper that renders the pagination links - for Sinatra.
-      #
-      #   <%= paginate @articles %>
-      #
-      # ==== Options
-      # * <tt>:window</tt> - The "inner window" size (4 by default).
-      # * <tt>:outer_window</tt> - The "outer window" size (0 by default).
-      # * <tt>:left</tt> - The "left outer window" size (0 by default).
-      # * <tt>:right</tt> - The "right outer window" size (0 by default).
-      # * <tt>:params</tt> - url_for parameters for the links (:id, :locale, etc.)
-      # * <tt>:param_name</tt> - parameter name for page number in the links (:page by default)
-      # * <tt>:remote</tt> - Ajax? (false by default)
-      # * <tt>:ANY_OTHER_VALUES</tt> - Any other hash key & values would be directly passed into each tag as :locals value.
-      def paginate(scope, options = {}, &block)
-        current_path = env['PATH_INFO'] rescue nil
-        current_params = Rack::Utils.parse_query(env['QUERY_STRING']).symbolize_keys rescue {}
-        paginator = Kaminari::Helpers::Paginator.new(
-          ActionViewTemplateProxy.new(:current_params => current_params, :current_path => current_path, :param_name => options[:param_name] || Kaminari.config.param_name),
-          options.reverse_merge(:current_page => scope.current_page, :total_pages => scope.total_pages, :per_page => scope.limit_value, :param_name => Kaminari.config.param_name, :remote => false)
-        )
-        paginator.to_s
-      end
-
-      # A simple "Twitter like" pagination link that creates a link to the previous page.
-      # Works on Sinatra.
-      #
-      # ==== Examples
-      # Basic usage:
-      #
-      #   <%= link_to_previous_page @items, 'Previous Page' %>
-      #
-      # Ajax:
-      #
-      #   <%= link_to_previous_page @items, 'Previous Page', :remote => true %>
-      #
-      # By default, it renders nothing if there are no more results on the previous page.
-      # You can customize this output by passing a parameter <tt>:placeholder</tt>.
-      #
-      #   <%= link_to_previous_page @users, 'Previous Page', :placeholder => %{<span>At the Beginning</span>} %>
-      #
-      def link_to_previous_page(scope, name, options = {})
-        params = options.delete(:params) || (Rack::Utils.parse_query(env['QUERY_STRING']).symbolize_keys rescue {})
-        param_name = options.delete(:param_name) || Kaminari.config.param_name
-        placeholder = options.delete(:placeholder)
-
-        unless scope.first_page?
-          query = params.merge(param_name => scope.prev_page)
-          link_to name, env['PATH_INFO'] + (query.empty? ? '' : "?#{query.to_query}"), options.reverse_merge(:rel => 'previous')
-        else
-          placeholder.to_s.html_safe
-        end
-      end
-
-      # A simple "Twitter like" pagination link that creates a link to the next page.
-      # Works on Sinatra.
-      #
-      # ==== Examples
-      # Basic usage:
-      #
-      #   <%= link_to_next_page @items, 'Next Page' %>
-      #
-      # Ajax:
-      #
-      #   <%= link_to_next_page @items, 'Next Page', :remote => true %>
-      #
-      # By default, it renders nothing if there are no more results on the next page.
-      # You can customize this output by passing a parameter <tt>:placeholder</tt>.
-      #
-      #   <%= link_to_next_page @items, 'Next Page', :placeholder => %{<span>No More Pages</span>} %>
-      #
-      def link_to_next_page(scope, name, options = {})
-        params = options.delete(:params) || (Rack::Utils.parse_query(env['QUERY_STRING']).symbolize_keys rescue {})
-        param_name = options.delete(:param_name) || Kaminari.config.param_name
-        placeholder = options.delete(:placeholder)
-
-        unless scope.last_page?
-          query = params.merge(param_name => scope.next_page)
-          link_to name, env['PATH_INFO'] + (query.empty? ? '' : "?#{query.to_query}"), options.reverse_merge(:rel => 'next')
-        else
-          placeholder.to_s.html_safe
-        end
-      end
-    end
-  end
-end
-
-if defined? I18n
-  I18n.load_path += Dir.glob(File.expand_path('../../../../config/locales/*.yml', __FILE__))
-end
-
-rescue LoadError
-
-$stderr.puts "[!]You should install `padrino-helpers' gem if you want to use kaminari's pagination helpers with Sinatra."
-$stderr.puts "[!]Kaminari::Helpers::SinatraHelper does nothing now..."
-
-module Kaminari::Helpers
-  module SinatraHelper
-    def self.registered(*)
-    end
-  end
-end
-
-end

data/lib/kaminari/helpers/tags.rb

@@ -1,108 +0,0 @@
-module Kaminari
-  module Helpers
-    # A tag stands for an HTML tag inside the paginator.
-    # Basically, a tag has its own partial template file, so every tag can be
-    # rendered into String using its partial template.
-    #
-    # The template file should be placed in your app/views/kaminari/ directory
-    # with underscored class name (besides the "Tag" class. Tag is an abstract
-    # class, so _tag parital is not needed).
-    #   e.g.)  PrevLink  ->  app/views/kaminari/_prev_link.html.erb
-    #
-    # When no matching template were found in your app, the engine's pre
-    # installed template will be used.
-    #   e.g.)  Paginator  ->  $GEM_HOME/kaminari-x.x.x/app/views/kaminari/_paginator.html.erb
-    class Tag
-      def initialize(template, options = {}) #:nodoc:
-        @template, @options = template, options.dup
-        @param_name = @options.delete(:param_name) || Kaminari.config.param_name
-        @theme = @options.delete(:theme)
-        @views_prefix = @options.delete(:views_prefix)
-        @params = template.params
-        # @params in Rails 5 no longer inherits from Hash
-        @params = @params.to_unsafe_h if @params.respond_to?(:to_unsafe_h)
-        @params = @params.except(:script_name).merge(@options.delete(:params) || {})
-      end
-
-      def to_s(locals = {}) #:nodoc:
-        @template.render :partial => partial_path, :locals => @options.merge(locals), :formats => [:html]
-      end
-
-      def page_url_for(page)
-        @template.url_for @params.merge(@param_name => (page <= 1 ? nil : page), :only_path => true)
-      end
-
-      def partial_path
-        [
-         @views_prefix,
-         "kaminari",
-         @theme,
-         self.class.name.demodulize.underscore
-        ].compact.join("/")
-      end
-    end
-
-    # Tag that contains a link
-    module Link
-      # target page number
-      def page
-        raise 'Override page with the actual page value to be a Page.'
-      end
-      # the link's href
-      def url
-        page_url_for page
-      end
-      def to_s(locals = {}) #:nodoc:
-        super locals.merge(:url => url)
-      end
-    end
-
-    # A page
-    class Page < Tag
-      include Link
-      # target page number
-      def page
-        @options[:page]
-      end
-      def to_s(locals = {}) #:nodoc:
-        super locals.merge(:page => page)
-      end
-    end
-
-    # Link with page number that appears at the leftmost
-    class FirstPage < Tag
-      include Link
-      def page #:nodoc:
-        1
-      end
-    end
-
-    # Link with page number that appears at the rightmost
-    class LastPage < Tag
-      include Link
-      def page #:nodoc:
-        @options[:total_pages]
-      end
-    end
-
-    # The "previous" page of the current page
-    class PrevPage < Tag
-      include Link
-      def page #:nodoc:
-        @options[:current_page] - 1
-      end
-    end
-
-    # The "next" page of the current page
-    class NextPage < Tag
-      include Link
-      def page #:nodoc:
-        @options[:current_page] + 1
-      end
-    end
-
-    # Non-link tag that stands for skipped pages...
-    class Gap < Tag
-    end
-  end
-end

data/lib/kaminari/hooks.rb

@@ -1,53 +0,0 @@
-module Kaminari
-  class Hooks
-    def self.init
-      ActiveSupport.on_load(:active_record) do
-        require 'kaminari/models/active_record_extension'
-        ::ActiveRecord::Base.send :include, Kaminari::ActiveRecordExtension
-      end
-
-      # data_mapper
-      begin
-        require 'kaminari/data_mapper'
-      rescue LoadError
-        begin; require 'data_mapper'; rescue LoadError; end
-        if defined? ::DataMapper
-          require 'dm-aggregates'
-          require 'kaminari/models/data_mapper_extension'
-          ::DataMapper::Collection.send :include, Kaminari::DataMapperExtension::Collection
-          ::DataMapper::Model.append_extensions Kaminari::DataMapperExtension::Model
-          # ::DataMapper::Model.send :extend, Kaminari::DataMapperExtension::Model
-        end
-      end
-
-      ## mongoid
-      begin
-        require 'kaminari/mongoid'
-      rescue LoadError
-        begin; require 'mongoid'; rescue LoadError; end
-        if defined? ::Mongoid
-          ActiveSupport::Deprecation.warn 'Kaminari Mongoid support has been extracted to a separate gem, and will be removed in the next 1.0 release. Please bundle kaminari-mongoid gem.'
-          require 'kaminari/models/mongoid_extension'
-          ::Mongoid::Document.send :include, Kaminari::MongoidExtension::Document
-        end
-      end
-
-      ## mongo_mapper
-      ActiveSupport.on_load(:mongo_mapper) do
-        begin
-          require 'kaminari/mongo_mapper'
-        rescue LoadError
-          ActiveSupport::Deprecation.warn 'Kaminari MongoMapper support has been extracted to a separate gem, and will be removed in the next 1.0 release. Please bundle kaminari-mongo_mapper gem.'
-          require 'kaminari/models/mongo_mapper_extension'
-          ::MongoMapper::Document.send :include, Kaminari::MongoMapperExtension::Document
-          ::Plucky::Query.send :include, Kaminari::PluckyCriteriaMethods
-        end
-      end
-      require 'kaminari/models/array_extension'
-
-      ActiveSupport.on_load(:action_view) do
-        ::ActionView::Base.send :include, Kaminari::ActionViewExtension
-      end
-    end
-  end
-end

data/lib/kaminari/models/active_record_extension.rb

@@ -1,22 +0,0 @@
-require 'kaminari/models/active_record_model_extension'
-
-module Kaminari
-  module ActiveRecordExtension
-    extend ActiveSupport::Concern
-
-    module ClassMethods
-      # Future subclasses will pick up the model extension
-      def inherited(kls) #:nodoc:
-        super
-        kls.send(:include, Kaminari::ActiveRecordModelExtension) if kls.superclass == ::ActiveRecord::Base
-      end
-    end
-
-    included do
-      # Existing subclasses pick up the model extension as well
-      self.descendants.each do |kls|
-        kls.send(:include, Kaminari::ActiveRecordModelExtension) if kls.superclass == ::ActiveRecord::Base
-      end
-    end
-  end
-end

data/lib/kaminari/models/active_record_model_extension.rb

@@ -1,22 +0,0 @@
-require 'kaminari/models/active_record_relation_methods'
-
-module Kaminari
-  module ActiveRecordModelExtension
-    extend ActiveSupport::Concern
-
-    included do
-      self.send(:include, Kaminari::ConfigurationMethods)
-
-      # Fetch the values at the specified page number
-      #   Model.page(5)
-      eval <<-RUBY
-        def self.#{Kaminari.config.page_method_name}(num = nil)
-          limit(default_per_page).offset(default_per_page * ((num = num.to_i - 1) < 0 ? 0 : num)).extending do
-            include Kaminari::ActiveRecordRelationMethods
-            include Kaminari::PageScopeMethods
-          end
-        end
-      RUBY
-    end
-  end
-end

data/lib/kaminari/models/active_record_relation_methods.rb

@@ -1,42 +0,0 @@
-module Kaminari
-  module ActiveRecordRelationMethods
-    # a workaround for AR 3.0.x that returns 0 for #count when page > 1
-    # if +limit_value+ is specified, load all the records and count them
-    if ActiveRecord::VERSION::STRING < '3.1'
-      def count(column_name = nil, options = {}) #:nodoc:
-        limit_value && !options[:distinct] ? length : super(column_name, options)
-      end
-    end
-
-    def entry_name
-      model_name.human.downcase
-    end
-
-    def reset #:nodoc:
-      @total_count = nil
-      super
-    end
-
-    def total_count(column_name = :all, options = {}) #:nodoc:
-      # #count overrides the #select which could include generated columns referenced in #order, so skip #order here, where it's irrelevant to the result anyway
-      @total_count ||= begin
-        c = except(:offset, :limit, :order)
-
-        # Remove includes only if they are irrelevant
-        c = c.except(:includes) unless references_eager_loaded_tables?
-
-        # Rails 4.1 removes the `options` argument from AR::Relation#count
-        args = [column_name]
-        args << options if ActiveRecord::VERSION::STRING < '4.1.0'
-
-        # .group returns an OrderdHash that responds to #count
-        c = c.count(*args)
-        if c.is_a?(Hash) || c.is_a?(ActiveSupport::OrderedHash)
-          c.count
-        else
-          c.respond_to?(:count) ? c.count(*args) : c
-        end
-      end
-    end
-  end
-end

data/lib/kaminari/models/array_extension.rb

@@ -1,66 +0,0 @@
-require 'active_support/core_ext/module'
-module Kaminari
-  # Kind of Array that can paginate
-  class PaginatableArray < Array
-    include Kaminari::ConfigurationMethods::ClassMethods
-
-    attr_internal_accessor :limit_value, :offset_value
-
-    # ==== Options
-    # * <tt>:limit</tt> - limit
-    # * <tt>:offset</tt> - offset
-    # * <tt>:total_count</tt> - total_count
-    def initialize(original_array = [], options = {})
-      @_original_array, @_limit_value, @_offset_value, @_total_count, @_padding = original_array, (options[:limit] || default_per_page).to_i, options[:offset].to_i, options[:total_count], options[:padding].to_i
-
-      if options[:limit] && options[:offset]
-        extend Kaminari::PageScopeMethods
-      end
-
-      if @_total_count.present? && @_total_count <= original_array.count
-        original_array = original_array.first(@_total_count)[@_offset_value, @_limit_value]
-      end
-
-      if @_total_count.nil?
-        original_array = original_array[@_offset_value, @_limit_value]
-      end
-
-      super(original_array || [])
-    end
-
-    def entry_name
-      "entry"
-    end
-
-    # items at the specified "page"
-    class_eval <<-RUBY, __FILE__, __LINE__ + 1
-      def #{Kaminari.config.page_method_name}(num = 1)
-        offset(limit_value * ((num = num.to_i - 1) < 0 ? 0 : num))
-      end
-    RUBY
-
-    # returns another chunk of the original array
-    def limit(num)
-      self.class.new @_original_array, :limit => num, :offset => @_offset_value, :total_count => @_total_count, :padding => @_padding
-    end
-
-    # total item numbers of the original array
-    def total_count
-      @_total_count || @_original_array.count
-    end
-
-    # returns another chunk of the original array
-    def offset(num)
-      self.class.new @_original_array, :limit => @_limit_value, :offset => num, :total_count => @_total_count, :padding => @_padding
-    end
-  end
-
-  # Wrap an Array object to make it paginatable
-  # ==== Options
-  # * <tt>:limit</tt> - limit
-  # * <tt>:offset</tt> - offset
-  # * <tt>:total_count</tt> - total_count
-  def self.paginate_array(array, options = {})
-    PaginatableArray.new array, options
-  end
-end