paginate_alphabetically 0.1.2 → 0.2.0

data/README.textile

@@ -21,9 +21,7 @@ end
 
 h3. View (haml example)
   
-bc. %ul.pagination
-  - User.pagination_letters.each do |letter|
-    %li= link_to letter, users_path(:letter => letter)
+bc. = alphabetically_paginate(@users)
 %ul.users
   - @users.each do |user|
     %li= user.surname

data/VERSION

@@ -1 +1 @@
-0.1.2
+0.2.0

data/init.rb

@@ -1,3 +1,5 @@
 require File.expand_path(File.join(File.dirname(__FILE__), 'lib/paginate_alphabetically'))
+require File.expand_path(File.join(File.dirname(__FILE__), 'lib/view_helpers'))
 
 ActiveRecord::Base.extend(PaginateAlphabetically)
+ActionView::Base.class_eval { include PaginateAlphabetically::ViewHelpers }

data/lib/paginate_alphabetically.rb

@@ -10,7 +10,7 @@ module PaginateAlphabetically
     end
 
     def first_letter
-      first_instance = find(:first, :order => @attribute)
+      first_instance = find(:first, :order => @attribute, :conditions => ["#{@attribute.to_s} >= ?", 'a'])
       return 'A' if first_instance.nil?
       first_instance.send(@attribute)[0].chr.upcase
     end

data/lib/view_helpers.rb

@@ -0,0 +1,24 @@
+module PaginateAlphabetically
+  module ViewHelpers
+    def alphabetically_paginate(collection)
+      return "" if collection.empty?
+      available_letters = collection.first.class.pagination_letters
+      content_tag(:ul, alphabetical_links_to(available_letters),
+                  :class => "pagination")
+    end
+    
+    def alphabetical_links_to(available_letters)
+      ('A'..'Z').map do |letter|
+        content_tag(:li, paginated_letter(available_letters, letter))
+      end.join(" ")
+    end
+
+    def paginated_letter(available_letters, letter)
+      if available_letters.include?(letter)
+        link_to(letter, "?letter=#{letter}")
+      else
+        letter
+      end
+    end
+  end
+end

data/test/helper.rb

@@ -4,6 +4,8 @@ require 'active_support/test_case'
 require 'test/unit'
 require 'sqlite3'
 require 'active_record'
+require 'action_view'
+include ActionView::Helpers
 require File.expand_path(File.join(File.dirname(__FILE__), '../init.rb'))
 
 ActiveRecord::Base.establish_connection(
@@ -12,3 +14,10 @@ ActiveRecord::Base.establish_connection(
 )
 
 load File.expand_path(File.join(File.dirname(__FILE__), 'db/schema.rb'))
+
+class Thing < ActiveRecord::Base
+  paginate_alphabetically :by => :name
+end
+
+class Numpty < ActiveRecord::Base
+end

data/test/test_paginate_alphabetically.rb

@@ -1,39 +1,40 @@
 require File.expand_path(File.join(File.dirname(__FILE__), 'helper'))
 
-class Thing < ActiveRecord::Base
-  paginate_alphabetically :by => :name
-end
-
-class Numpty < ActiveRecord::Base
-end
-
 class PaginateAlphabeticallyTest < ActiveSupport::TestCase
   def setup
     %w(one two Three four Five Six).map {|name| Thing.create!(:name => name)}
   end
 
-  def test_pagination_letters
+  test "pagination letters" do
     assert_equal ['F', 'O', 'S', 'T'], Thing.pagination_letters
   end
 
-  def test_first_letter
+  test "first letter" do
+    assert_equal 'F', Thing.first_letter
+  end
+
+  test "first letter is alphabetical" do
+    Thing.create!(:name => ' o noes a space :(')
+    Thing.create!(:name => '1')
+    Thing.create!(:name => '®')
+    Thing.create!(:name => '$')
     assert_equal 'F', Thing.first_letter
   end
 
-  def test_first_letter_when_there_are_no_things
+  test "first letter when there are no things" do
     Thing.destroy_all
     assert_equal 'A', Thing.first_letter
   end
 
-  def test_alphabetical_group_without_specifying_letter
+  test "alphabetical group without specifying letter" do
     assert_equal ['Five', 'four'], Thing.alphabetical_group.map(&:name)
   end
 
-  def test_alphabetical_group_specifying_letter
+  test "alphabetical group specifying letter" do
     assert_equal ['Three', 'two'], Thing.alphabetical_group('t').map(&:name)
   end
 
-  def test_class_without_pagination_has_no_pagination_methods
+  test "class without pagination has no pagination methods" do
     assert_raise NoMethodError do
       Numpty.alphabetical_group
     end

data/test/test_view_helpers.rb

@@ -0,0 +1,34 @@
+require File.expand_path(File.join(File.dirname(__FILE__), 'helper'))
+include PaginateAlphabetically::ViewHelpers
+
+class ViewHelperTest < ActiveSupport::TestCase
+  def setup
+    @result = alphabetically_paginate([Thing.create!(:name => 'a')])
+  end
+
+  test "it includes all the letters" do
+    ('A'..'Z').each do |letter|
+      assert @result.include?(letter)
+    end
+  end
+
+  test "it links to the available letters" do
+    assert @result.include?('<a href="?letter=A">')
+  end
+
+  test "it returns nothing when the collection is empty" do
+    assert_equal "", alphabetically_paginate([])
+  end
+
+  test "it does not link to letters that have no content" do
+    assert_equal false, @result.include?('href="?letter=B"')
+  end
+
+  test "it wraps the letters as list items" do
+    assert @result.include?('<li>B</li>')
+  end
+
+  test "it wraps the result in a ul" do
+    assert @result.include?('<ul class="pagination">')
+  end
+end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: paginate_alphabetically
 version: !ruby/object:Gem::Version 
-  hash: 31
+  hash: 23
   prerelease: false
   segments: 
   - 0
-  - 1
   - 2
-  version: 0.1.2
+  - 0
+  version: 0.2.0
 platform: ruby
 authors: 
 - Eden Development
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-09-08 00:00:00 +01:00
+date: 2010-09-10 00:00:00 +01:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -69,9 +69,11 @@ files:
 - init.rb
 - install.rb
 - lib/paginate_alphabetically.rb
+- lib/view_helpers.rb
 - test/db/schema.rb
 - test/helper.rb
 - test/test_paginate_alphabetically.rb
+- test/test_view_helpers.rb
 - uninstall.rb
 has_rdoc: true
 homepage: http://github.com/edendevelopment/paginate_alphabetically
@@ -111,3 +113,4 @@ test_files:
 - test/db/schema.rb
 - test/helper.rb
 - test/test_paginate_alphabetically.rb
+- test/test_view_helpers.rb