ludy 0.1.1 → 0.1.2

data/CHANGES

@@ -1,5 +1,11 @@
 = ludy changes history
 
+== ludy 0.1.2, 2008.01.17
+
+* aims to add functional stuffs, list comprehension is working in progress
+* Paginator series are added.
+* more rdocs are added.
+
 == ludy 0.1.1, 2008.01.10
 
 * add Array#tail and Array#map_with_index to make the task of

data/Manifest.txt

@@ -30,6 +30,7 @@ lib/ludy/deprecated/this.rb
 lib/ludy/deprecated/untranspose.rb
 lib/ludy/deprecated/unzip.rb
 lib/ludy/dices.rb
+lib/ludy/helpers/check_box.rb
 lib/ludy/kernel.rb
 lib/ludy/kernel/defun.rb
 lib/ludy/kernel/ergo.rb
@@ -40,7 +41,9 @@ lib/ludy/kernel/public_send.rb
 lib/ludy/kernel/singleton_method.rb
 lib/ludy/kernel/tap.rb
 lib/ludy/lazy.rb
+lib/ludy/list.rb
 lib/ludy/message_dispatcher.rb
+lib/ludy/paginator.rb
 lib/ludy/pattern_matcher.rb
 lib/ludy/proc.rb
 lib/ludy/proc/bind.rb
@@ -91,6 +94,7 @@ test/test_defun.rb
 test/test_dices.rb
 test/test_kernel.rb
 test/test_lazy.rb
+test/test_paginator.rb
 test/test_proc.rb
 test/test_symbol.rb
 test/test_variable.rb

data/README

@@ -1,4 +1,4 @@
-= ludy 0.1.1
+= ludy 0.1.2
     by Lin Jen-Shin (a.k.a. godfat 真常)
     strip any number: 18god29fat7029 (at] godfat32 -dooot- 20org
     http://ludy.rubyforge.org
@@ -6,13 +6,14 @@
 
 == DESCRIPTION:
   
-Aims to extend Ruby standard library, providing some useful tools that's not existed in the standard library.
+Aims to extend Ruby standard library, providing some useful tools that's not existed in the standard library, especially for functional programming.
 
 == FEATURES:
 
-* ludy standard library extension
-* puzzle_generator
-* c++ erb meta-programming
+1. ludy standard library extension, especially for functional programming.
+2. rails/array paginator, included since 0.1.2
+3. c++ erb meta-programming, included since 0.1.0
+4. puzzle_generator, included since 0.0.8
 
 == SYNOPSIS:
 
@@ -74,6 +75,28 @@ y_combinator:
   }]
   assert_equal(3628800, fact[10])
 
+paginator:
+  pager = Ludy::RailsPaginator.new(Topic)
+  pager = Ludy::ArrayPaginator.new(TestPaginator.data)
+  # or the most flexible paginator:
+  pager = Ludy::Paginator.new(
+  lambda{ |offset, per_page|
+    # if for rails,
+    # Data.find :all, :offset => offset, :limit => per_page
+    TestPaginator.data[offset, per_page]
+  }, lambda{
+    # if for rails,
+    # Data.count
+    TestPaginator.data.size
+  })
+  pager.per_page = 10
+
+  pager.page(1)
+  pager[1] # same as above
+  pager.page(2).next_page.prev_page.each{|e| e} # you can enumerate
+  pager[3].map{|e| e*2}
+  pager.size # number of pages
+  pager.inject(0){|r, i| r += i.inject &:+ } # total sum of all data
 
 ludy tasks:
 

data/Rakefile

@@ -12,7 +12,7 @@ task :default do
 end
 
 PROJ.name = 'ludy'
-PROJ.summary = 'Aims to extend Ruby standard library, providing some useful tools that\'s not existed in the standard library.'
+PROJ.summary = 'Aims to extend Ruby standard library, providing some useful tools that\'s not existed in the standard library, especially for functional programming.'
 PROJ.authors = 'Lin Jen-Shin (a.k.a. godfat 真常)'
 PROJ.email = 'strip any number: 18god29fat7029 (at] godfat32 -dooot- 20org'
 PROJ.url = 'http://ludy.rubyforge.org/'
@@ -20,7 +20,7 @@ PROJ.description = paragraphs_of('README', 1).join("\n\n")
 PROJ.changes = paragraphs_of('CHANGES', 0..1).join("\n\n")
 PROJ.rubyforge_name = 'ludy'
 
-PROJ.version = '0.1.1'
+PROJ.version = '0.1.2'
 PROJ.exclude << '.DS_Store' << '^tmp'
 PROJ.dependencies << 'rake'
 

data/TODO

@@ -3,3 +3,10 @@
 * chain travel
 * method hook
 * more rdoc
+
+* list comprehension List[lambda{|x,y|[x,y*2]}, (0..1), (2..3), lambda{|x,y|x!=y}]
+* better namespace
+* extract Array's methods to Enumerable
+
+* table showing, with pad.
+* rails multiple layout

data/lib/ludy/helpers/check_box.rb

@@ -0,0 +1,24 @@
+
+module Ludy
+  # check box helper for html view generation.
+  #  require 'ludy/helpers/check_box'
+  #  module ApplicationHelper
+  #    include Ludy::CheckBox
+  #  end
+  module CheckBox
+    # create a link respond to onclick and <em>check</em> all check_box for all
+    # specified elements.
+    #  id_and_or_class, e.g., #form_inviting input.check_box_friend
+    #                         ^^^^^id  elements^^^ ^^^^^^^^^^^class
+    def check_all text, id_and_or_class
+      "<a href=\"#\" onclick=\"$$('#{id_and_or_class}').each(function(box){box.checked='checked'});return false;\">#{text}</a>"
+    end
+    # create a link respond to onclick and <em>uncheck</em> all check_box for all
+    # specified elements.
+    #  id_and_or_class, e.g., #form_inviting input.check_box_friend
+    #                         ^^^^^id  elements^^^ ^^^^^^^^^^^class
+    def uncheck_all text, id_and_or_class
+      "<a href=\"#\" onclick=\"$$('#{id_and_or_class}').each(function(box){box.checked=''});return false;\">#{text}</a>"
+    end
+  end
+end

data/lib/ludy/kernel/public_send.rb

@@ -1,6 +1,6 @@
 
-module Kernel
-  if RUBY_VERSION < '1.9.0'
+if RUBY_VERSION < '1.9.0'
+  module Kernel
     # it would be defined if RUBY_VERSION < '1.9.0', see rdoc in ruby 1.9
     def public_send msg, *args, &block
       if self.respond_to? msg

data/lib/ludy/list.rb

@@ -0,0 +1,21 @@
+
+module Ludy
+  # fib = 0 : 1 : [x+y | (x, y) <- zip fib (tail fib)]
+  # combos = List[->(x,y){[x,y]}, 0..1, 2..3]
+  class List # :nodoc:
+    private :initialize
+    class << self
+      def [] target, *args
+        raise ArgumentError.new("you need at least #{target.arity} arguments(sources) for #{target}") if args.size < target.arity
+        sources = args[0...target.arity]
+        conditions = args[target.arity..-1]
+        create_array sources, conditions
+      end
+
+      private
+      def create_array sources, conditions
+        sources.traspose.flatten
+      end
+    end
+  end
+end

data/lib/ludy/paginator.rb

@@ -0,0 +1,118 @@
+
+require 'ludy/kernel/public_send' if RUBY_VERSION < '1.9.0'
+
+module Ludy
+  # which was produced by Paginator#page / Paginator#[],
+  # representing page that contained target data.
+  # it would use lazy fetching, whenever you need the data,
+  # the fetcher would be invoked that time. whenever the data
+  # was fetched, it won't fetch again. it you need refetch,
+  # call Page#fetch
+  class Page
+    undef_method :to_a if RUBY_VERSION < '1.9.0'
+    attr_reader :pager
+    # don't create a page instance yourself unless you have to
+    def initialize pager, page; @pager, @page = pager, page; end
+    # return the page instance next to this page
+    def next_page; @pager.page(@page+1); end
+    # return the page instance prev to this page
+    def prev_page; @pager.page(@page-1); end
+    # if the page numbers and the pagers are equal,
+    # then the pages are equal.
+    def == rhs
+      @page  == rhs.instance_variable_get('@page' ) and
+      @pager == rhs.instance_variable_get('@pager')
+    end
+    # explicitly fetch the data from pager
+    def fetch; @data = @pager.fetcher[@pager.offset(@page), @pager.per_page]; end
+    # get the data fetched from pager
+    def data; @data ||= fetch; end
+    # any other method call would delegate to the data,
+    # e.g., each, to_a, map, first, method_you_defined, etc.
+    def method_missing msg, *args, &block
+      self.data.public_send msg, *args, &block
+    end
+  end
+  # paginator is something help you paginate the data,
+  # through the fetcher and counter you pass in.
+  # e.g., for a array, the fetcher would be array[offset, per_page],
+  # the counter would be array.size. and for rails' model,
+  # fetcher would be Model.find :all, :offset => offset, :limit => per_page.
+  # see ArrayPaginator and RailsPaginator, if you just simply need them or
+  # have a look at the source code for example usage for Paginator.
+  class Paginator
+    include Enumerable
+    attr_accessor :per_page, :fetcher, :counter
+    #  fetcher is function that fetch the data,
+    #  counter is function that count the data.
+    # the default per_page is 20. you can reset per_page property later.
+    def initialize fetcher, counter
+      @per_page = 20
+      @fetcher = fetcher
+      @counter = counter
+    end
+    # if two paginators are equal, then the properties of
+    # per_page, fetcher, counter are all equal.
+    def == rhs
+      self.per_page == rhs.per_page and
+      self.fetcher  == rhs.fetcher  and
+      self.counter  == rhs.counter
+    end
+    # for each page...
+    def each; 1.upto(size){ |i| yield page(i) }; end
+    # return all pages in an array
+    def to_a; map{|e|e}; end
+    alias_method :pages, :to_a
+    # create page instance by page number.
+    # if page number you specified was not existed,
+    # nil would be returned. note, page start at 1, not zero.
+    def page page
+      offset = (page-1)*@per_page
+      size = @counter.call
+      return nil unless page > 0 and offset <= size
+      Page.new self, page
+    end
+    # return the number of pages
+    def size
+      (@counter.call/@per_page.to_f).ceil
+    end
+    alias_method :[], :page
+    # get the offset property about the page.
+    # it is simply (page-1)*@per_page
+    def offset page
+      (page-1)*@per_page
+    end
+  end
+  # rails paginator was provided for convenience,
+  # it wraps Paginator for you, and you can just pass the model class to it.
+  # you don't have to care about the fetcher and counter.
+  # additionally, you can pass other options to rails paginator,
+  # they would be used in find options. e.g.,
+  #  RailsPaginator.new Model, :order => 'created_at DESC'
+  # would invoke Model.find :all, :offset => ?, :limit => ?, order => 'created_at DESC'
+  class RailsPaginator < Paginator
+    attr_reader :model_class
+    def initialize model_class, opts = {}
+      @model_class = model_class
+      super(lambda{ |offset, per_page|
+        @model_class.find :all, opts.merge(:offset => offset, :limit => per_page)
+      }, lambda{
+        @model_class.count
+      })
+    end
+  end
+  # array paginator would just simply assume your data is an array,
+  # and create pages simply for your_data[offset, per_page]
+  # if your data is much more complex, use Paginator instead of this
+  class ArrayPaginator < Paginator
+    attr_reader :data
+    def initialize data
+      @data = data
+      super(lambda{ |offset, per_page|
+        @data[offset, per_page]
+      }, lambda{
+        @data.size
+      })
+    end
+  end
+end

data/lib/ludy/symbol/to_proc.rb

@@ -1,6 +1,6 @@
 
-class Symbol
-  if RUBY_VERSION < '1.9.0'
+if RUBY_VERSION < '1.9.0'
+  class Symbol
     # it would be defined if RUBY_VERSION < '1.9.0', see rdoc in ruby 1.9
     def to_proc; lambda{ |*args| args.shift.__send__ self, *args }; end
   end

data/spec/ludy_spec.rb

@@ -1,6 +1,6 @@
 
 # bowling.rb
-class Bowling
+class Bowling # :nodoc:
   def hit(pins)
   end
 

data/test/test_paginator.rb

@@ -0,0 +1,60 @@
+
+require File.join(File.dirname(__FILE__), '..', 'lib', 'ludy/test/helper')
+require 'ludy/paginator'
+require 'ludy/symbol/to_proc' if RUBY_VERSION < '1.9.0'
+
+class TestPaginator < Test::Unit::TestCase
+  def self.data; @data ||= (0..100).to_a; end
+  def for_pager pager
+    # assume data.size is 101, data is [0,1,2,3...]
+    pager.per_page = 10
+    assert_equal 11, pager.size
+
+    assert_nil pager[0]
+    assert_equal((0..9).to_a, pager.page(1).to_a)
+    assert_equal((10..19).to_a, pager[2].to_a)
+    assert_equal(20, pager.page(3).first)
+    assert_equal((90..99).to_a, pager[10].to_a)
+    assert_equal([100], pager.page(11).to_a)
+    assert_nil(pager.page(12))
+
+    assert_equal(pager[1], pager[2].prev_page)
+    assert_equal(pager.page(11), pager[10].next_page)
+    assert_nil(pager[1].prev_page)
+    assert_nil(pager[10].next_page.next_page)
+
+    assert_equal pager[4].data, pager[4].fetch
+    assert_equal(pager[1], pager.pages.first)
+    assert_equal(pager[2], pager.to_a[1])
+    assert_equal(5050, pager.inject(0){|r, i| r += i.inject(&:+) })
+  end
+  def test_basic
+    pager = Ludy::Paginator.new(
+    lambda{ |offset, per_page|
+      # if for rails,
+      # Data.find :all, :offset => offset, :limit => per_page
+      TestPaginator.data[offset, per_page]
+    }, lambda{
+      # if for rails,
+      # Data.count
+      TestPaginator.data.size
+    })
+    for_pager pager
+  end
+  class Topic
+    class << self
+      def count
+        101
+      end
+      def find all, opts = {}
+        TestPaginator.data[opts[:offset], opts[:limit]]
+      end
+    end
+  end
+  def test_for_rails
+    for_pager Ludy::RailsPaginator.new(Topic)
+  end
+  def test_for_array
+    for_pager Ludy::ArrayPaginator.new(TestPaginator.data)
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: ludy
 version: !ruby/object:Gem::Version 
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors: 
 - "Lin Jen-Shin (a.k.a. godfat \xE7\x9C\x9F\xE5\xB8\xB8)"
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2008-01-10 00:00:00 +08:00
+date: 2008-01-17 00:00:00 +08:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -21,7 +21,7 @@ dependencies:
       - !ruby/object:Gem::Version 
         version: "0"
     version: 
-description: "== DESCRIPTION:  Aims to extend Ruby standard library, providing some useful tools that's not existed in the standard library."
+description: "== DESCRIPTION:  Aims to extend Ruby standard library, providing some useful tools that's not existed in the standard library, especially for functional programming."
 email: "strip any number: 18god29fat7029 (at] godfat32 -dooot- 20org"
 executables: 
 - ludy
@@ -75,6 +75,7 @@ files:
 - lib/ludy/deprecated/untranspose.rb
 - lib/ludy/deprecated/unzip.rb
 - lib/ludy/dices.rb
+- lib/ludy/helpers/check_box.rb
 - lib/ludy/kernel.rb
 - lib/ludy/kernel/defun.rb
 - lib/ludy/kernel/ergo.rb
@@ -85,7 +86,9 @@ files:
 - lib/ludy/kernel/singleton_method.rb
 - lib/ludy/kernel/tap.rb
 - lib/ludy/lazy.rb
+- lib/ludy/list.rb
 - lib/ludy/message_dispatcher.rb
+- lib/ludy/paginator.rb
 - lib/ludy/pattern_matcher.rb
 - lib/ludy/proc.rb
 - lib/ludy/proc/bind.rb
@@ -136,6 +139,7 @@ files:
 - test/test_dices.rb
 - test/test_kernel.rb
 - test/test_lazy.rb
+- test/test_paginator.rb
 - test/test_proc.rb
 - test/test_symbol.rb
 - test/test_variable.rb
@@ -167,7 +171,7 @@ rubyforge_project: ludy
 rubygems_version: 1.0.1
 signing_key: 
 specification_version: 2
-summary: Aims to extend Ruby standard library, providing some useful tools that's not existed in the standard library.
+summary: Aims to extend Ruby standard library, providing some useful tools that's not existed in the standard library, especially for functional programming.
 test_files: 
 - test/test_all.rb
 - test/test_array.rb
@@ -176,6 +180,7 @@ test_files:
 - test/test_dices.rb
 - test/test_kernel.rb
 - test/test_lazy.rb
+- test/test_paginator.rb
 - test/test_proc.rb
 - test/test_symbol.rb
 - test/test_variable.rb