breadcrumbs_on_rails 0.1.1

data/CHANGELOG.rdoc

@@ -0,0 +1,16 @@
+= Changelog
+
+
+== Release 0.1.1
+
+* ADDED: documentation file.
+
+* CHANGED: run test against Rails ~> 2.3.0 but ensure compatibility with Rails 2.2.x.
+
+* CHANGED: Removed BUILD and STATUS constants. Added Version::ALPHA constant to be used when I need to package prereleases (see RubyGem --prerelease flag).
+
+
+== Release 0.1.0
+
+* Initial version
+

data/LICENSE.rdoc

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Simone Carletti
+
+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.

data/Manifest

@@ -0,0 +1,19 @@
+CHANGELOG.rdoc
+init.rb
+install.rb
+lib/breadcrumbs_on_rails/breadcrumbs.rb
+lib/breadcrumbs_on_rails/controller_mixin.rb
+lib/breadcrumbs_on_rails/version.rb
+lib/breadcrumbs_on_rails.rb
+LICENSE.rdoc
+Manifest
+rails/init.rb
+Rakefile
+README.rdoc
+tasks/tabs_on_rails_tasks.rake
+test/breadcrumbs_on_rails_test.rb
+test/builder_test.rb
+test/element_test.rb
+test/simple_builder_test.rb
+test/test_helper.rb
+uninstall.rb

data/README.rdoc

@@ -0,0 +1,67 @@
+= Breadcrumbs On Rails
+
+BreadcrumbsOnRails is a simple Ruby on Rails plugin for creating and managing a breadcrumb navigation for a Rails project.
+It provides helpers for creating navigation elements with a flexible interface.
+
+Note. This documentation file is a work in progress. Please be patient.
+
+
+== Requirements
+
+* Ruby >= 1.8.6
+* Rails >= 2.2
+
+
+== Rails Installation
+
+=== As a Gem
+
+This is the preferred way to install BreadcrumbsOnRails and the best way if you want install a stable version.
+The GEM is hosted on {Gemcutter}[http://gemcutter.org/gems/tabs_on_rails].
+
+  $ gem install breadcrumbs_on_rails --source http://gemcutter.org/
+
+With Rails >= 2.2, you can specify the GEM dependency in your environment.rb file so that Rails will automatically check the requirement on startup.
+
+  Rails::Initializer.run do |config|
+    
+    # other configurations
+    # ...
+    
+    config.gem "breadcrumbs_on_rails", :source => "http://gemcutter.org/"
+    
+  end
+
+=== As a Plugin
+
+This is the preferred way if you want to live on the edge and install a development version.
+
+  $ script/plugin install git://github.com/weppos/breadcrumbs_on_rails.git
+
+
+== Usage
+
+...
+
+
+== Documentation
+
+The library is still under development and this README file might not be contain the latest changes.
+For the full documentation, development roadmap and more information please visit the {project page}[http://code.simonecarletti.com/wiki/breadonrails].
+
+
+== Credits
+
+Author:: {Simone Carletti}[http://www.simonecarletti.com/] <weppos@weppos.net>
+
+
+== Resources
+
+* {Homepage}[http://code.simonecarletti.com/breadonrails]
+* {GitHub}[http://github.com/weppos/breadcrumbs_on_rails/]
+
+
+== License
+
+Copyright (c) 2009 Simone Carletti, BreadcrumbsOnRails is released under the MIT license.
+

data/Rakefile

@@ -0,0 +1,48 @@
+$:.unshift(File.dirname(__FILE__) + "/lib")
+
+require 'rubygems'
+require 'rake'
+require 'echoe'
+require 'breadcrumbs_on_rails'
+
+
+PKG_NAME    = ENV['PKG_NAME']    || BreadcrumbsOnRails::GEM
+PKG_VERSION = ENV['PKG_VERSION'] || BreadcrumbsOnRails::VERSION
+RUBYFORGE_PROJECT = nil
+
+if ENV['SNAPSHOT'].to_i == 1
+  PKG_VERSION << "." << Time.now.utc.strftime("%Y%m%d%H%M%S")
+end
+
+
+Echoe.new(PKG_NAME, PKG_VERSION) do |p|
+  p.author        = "Simone Carletti"
+  p.email         = "weppos@weppos.net"
+  p.summary       = "A simple Ruby on Rails plugin for creating and managing a breadcrumb navigation."
+  p.url           = "http://code.simonecarletti.com/breadonrails"
+  p.description   = <<-EOD
+    BreadcrumbsOnRails is a simple Ruby on Rails plugin for creating and managing \
+    a breadcrumb navigation for a Rails project. \
+    It provides helpers for creating navigation elements with a flexible interface.
+  EOD
+  p.project       = RUBYFORGE_PROJECT
+
+  p.need_zip      = true
+
+  p.development_dependencies += ["rake  ~>0.8.7",
+                                 "echoe ~>3.2.0"]
+
+  p.rcov_options  = ["-Itest -x Rakefile,rcov,json,mocha,rack,actionpack,activesupport"]
+end
+
+
+begin
+  require 'code_statistics'
+  desc "Show library's code statistics"
+  task :stats do
+    CodeStatistics.new(["BreadcrumbsOnRails", "lib"],
+                       ["Tests", "test"]).to_s
+  end
+rescue LoadError
+  puts "CodeStatistics (Rails) is not available"
+end

data/breadcrumbs_on_rails.gemspec

@@ -0,0 +1,37 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{breadcrumbs_on_rails}
+  s.version = "0.1.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Simone Carletti"]
+  s.date = %q{2009-11-27}
+  s.description = %q{    BreadcrumbsOnRails is a simple Ruby on Rails plugin for creating and managing     a breadcrumb navigation for a Rails project.     It provides helpers for creating navigation elements with a flexible interface.
+}
+  s.email = %q{weppos@weppos.net}
+  s.extra_rdoc_files = ["CHANGELOG.rdoc", "lib/breadcrumbs_on_rails/breadcrumbs.rb", "lib/breadcrumbs_on_rails/controller_mixin.rb", "lib/breadcrumbs_on_rails/version.rb", "lib/breadcrumbs_on_rails.rb", "LICENSE.rdoc", "README.rdoc", "tasks/tabs_on_rails_tasks.rake"]
+  s.files = ["CHANGELOG.rdoc", "init.rb", "install.rb", "lib/breadcrumbs_on_rails/breadcrumbs.rb", "lib/breadcrumbs_on_rails/controller_mixin.rb", "lib/breadcrumbs_on_rails/version.rb", "lib/breadcrumbs_on_rails.rb", "LICENSE.rdoc", "Manifest", "rails/init.rb", "Rakefile", "README.rdoc", "tasks/tabs_on_rails_tasks.rake", "test/breadcrumbs_on_rails_test.rb", "test/builder_test.rb", "test/element_test.rb", "test/simple_builder_test.rb", "test/test_helper.rb", "uninstall.rb", "breadcrumbs_on_rails.gemspec"]
+  s.homepage = %q{http://code.simonecarletti.com/breadonrails}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Breadcrumbs_on_rails", "--main", "README.rdoc"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{A simple Ruby on Rails plugin for creating and managing a breadcrumb navigation.}
+  s.test_files = ["test/breadcrumbs_on_rails_test.rb", "test/builder_test.rb", "test/element_test.rb", "test/simple_builder_test.rb", "test/test_helper.rb"]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<rake>, ["~> 0.8.7"])
+      s.add_development_dependency(%q<echoe>, ["~> 3.2.0"])
+    else
+      s.add_dependency(%q<rake>, ["~> 0.8.7"])
+      s.add_dependency(%q<echoe>, ["~> 3.2.0"])
+    end
+  else
+    s.add_dependency(%q<rake>, ["~> 0.8.7"])
+    s.add_dependency(%q<echoe>, ["~> 3.2.0"])
+  end
+end

data/init.rb

@@ -0,0 +1 @@
+require File.join(File.dirname(__FILE__), 'rails', 'init')

data/install.rb

@@ -0,0 +1 @@
+# Install hook code here

data/lib/breadcrumbs_on_rails.rb

@@ -0,0 +1,28 @@
+# 
+# = Breadcrumbs On Rails
+#
+# A simple Ruby on Rails plugin for creating and managing a breadcrumb navigation.
+# 
+#
+# Category::    Rails
+# Package::     BreadcrumbsOnRails
+# Author::      Simone Carletti <weppos@weppos.net>
+# License::     MIT License
+#
+#--
+# SVN: $Id$
+#++
+
+
+require 'breadcrumbs_on_rails/controller_mixin'
+require 'breadcrumbs_on_rails/breadcrumbs'
+require 'breadcrumbs_on_rails/version'
+
+
+module BreadcrumbsOnRails
+  
+  NAME            = 'Breadcrumbs on Rails'
+  GEM             = 'breadcrumbs_on_rails'
+  AUTHORS         = ['Simone Carletti <weppos@weppos.net>']
+  
+end

data/lib/breadcrumbs_on_rails/breadcrumbs.rb

@@ -0,0 +1,139 @@
+# 
+# = Breadcrumbs On Rails
+#
+# A simple Ruby on Rails plugin for creating and managing a breadcrumb navigation.
+# 
+#
+# Category::    Rails
+# Package::     BreadcrumbsOnRails
+# Author::      Simone Carletti <weppos@weppos.net>
+# License::     MIT License
+#
+#--
+# SVN: $Id$
+#++
+
+
+module BreadcrumbsOnRails
+  
+  module Breadcrumbs
+
+    # 
+    # = Builder
+    #
+    # The Builder class represents the abstract class for any custom Builder.
+    #
+    # To create a custom Builder, just extend this class
+    # and implement the following abstract methods:
+    #
+    # render::
+    #   Renders and returns the collection of navigation elements
+    #
+    class Builder
+
+      # Initializes a new Builder with <tt>context</tt>,
+      # <tt>element</tt> and <tt>options</tt>.
+      #
+      # context::
+      #   The view context, that is current Rails Template instance
+      # elements::
+      #   The collection of Elements
+      # options::
+      #   Hash with optional prefereces or settings to customize the rendering behavior
+      #
+      def initialize(context, elements, options = {})
+        @context  = context
+        @elements = elements
+        @options  = options
+      end
+
+      # Renders Elements and returns the Breadcrumb navigation for the view.
+      #
+      # ==== Raises
+      #
+      # NotImplemented:: you should implement this method in your custom Builder.
+      #
+      def render
+        raise NotImplementedError
+      end
+
+      
+      protected
+
+        def compute_name(element)
+          case name = element.name
+            when Symbol
+              @context.send(name)
+            when Proc
+              name.call(@context)
+            else
+              name.to_s
+          end
+        end
+
+        def compute_path(element)
+          case path = element.path
+            when Symbol
+              @context.send(path)
+            when Proc
+              path.call(@context)
+            when Hash
+              @context.url_for(path)
+            else
+              path.to_s
+          end
+
+        end
+
+    end
+
+
+    #
+    # = SimpleBuilder
+    #
+    # The SimpleBuilder is the default breadcrumb builder.
+    # It provides basic functionalities to render a breadcrumb navigation.
+    #
+    # The SimpleBuilder accepts a limited set of options.
+    # If you need more flexibility, create a custom Builder and
+    # pass the option :builder => BuilderClass to the render_breadcrumbs helper method. 
+    #
+    class SimpleBuilder < Builder
+
+      def render
+        @elements.collect do |element|
+          render_element(element)
+        end.join(@options[:separator] || " &raquo; ")
+      end
+
+      def render_element(element)
+        content = @context.link_to_unless_current(compute_name(element), compute_path(element))
+        if @options[:tag]
+          @context.content_tag(@options[:tag], content)
+        else
+          content
+        end
+      end
+
+    end
+
+
+    # = Element
+    #
+    # Represents a navigation element (probably a breadcrumb level)
+    # in the breadcrumb collection.
+    #
+    class Element
+
+      attr_accessor :name, :path
+
+      def initialize(name, path)
+        self.name = name
+        self.path = path
+      end
+
+    end
+    
+  end
+  
+end

data/lib/breadcrumbs_on_rails/controller_mixin.rb

@@ -0,0 +1,107 @@
+# 
+# = Breadcrumbs On Rails
+#
+# A simple Ruby on Rails plugin for creating and managing a breadcrumb navigation.
+# 
+#
+# Category::    Rails
+# Package::     BreadcrumbsOnRails
+# Author::      Simone Carletti <weppos@weppos.net>
+# License::     MIT License
+#
+#--
+# SVN: $Id$
+#++
+
+
+module BreadcrumbsOnRails
+  
+  module ControllerMixin
+    
+    def self.included(base)
+      base.extend         ClassMethods
+      base.send :helper,  HelperMethods
+      base.class_eval do
+        include       InstanceMethods
+        helper        HelperMethods
+        helper_method :add_breadcrumb, :breadcrumbs
+      end
+    end
+
+    module Utils
+
+      def self.instance_proc(string)
+        if string.kind_of?(String)
+          proc { |controller| controller.instance_eval(string) }
+        else
+          string
+        end
+      end
+
+      # This is an horrible method with an horrible name.
+      #
+      # convert_to_set_of_strings(nil, [:foo, :bar])
+      # # => nil
+      # convert_to_set_of_strings(true, [:foo, :bar])
+      # # => ["foo", "bar"]
+      # convert_to_set_of_strings(:foo, [:foo, :bar])
+      # # => ["foo"]
+      # convert_to_set_of_strings([:foo, :bar, :baz], [:foo, :bar])
+      # # => ["foo", "bar", "baz"]
+      #
+      def self.convert_to_set_of_strings(value, keys)
+        if value == true
+          keys.map(&:to_s).to_set
+        elsif value
+          Array(value).map(&:to_s).to_set
+        end
+      end
+
+    end
+
+    module ClassMethods
+
+      def add_breadcrumb(name, path, options = {})
+        # This isn't really nice here
+        if eval = Utils.convert_to_set_of_strings(options.delete(:eval), %w(name path))
+          name = Utils.instance_proc(name) if eval.include?("name")
+          path = Utils.instance_proc(path) if eval.include?("path")
+        end
+
+        before_filter(options) do |controller|
+          controller.send(:add_breadcrumb, name, path)
+        end
+      end
+
+    end
+
+    module InstanceMethods
+      protected
+
+      def add_breadcrumb(name, path)
+        self.breadcrumbs << Breadcrumbs::Element.new(name, path)
+      end
+
+      def breadcrumbs
+        @breadcrumbs ||= []
+      end
+
+    end
+
+    module HelperMethods
+
+      def render_breadcrumbs(options = {}, &block)
+        builder = (options.delete(:builder) || Breadcrumbs::SimpleBuilder).new(self, breadcrumbs, options)
+        content = builder.render
+        if block_given?
+          concat(capture(content, &block))
+        else
+          content
+        end
+      end  
+      
+    end
+  
+  end
+  
+end

data/lib/breadcrumbs_on_rails/version.rb

@@ -0,0 +1,30 @@
+# 
+# = Breadcrumbs On Rails
+#
+# A simple Ruby on Rails plugin for creating and managing a breadcrumb navigation.
+# 
+#
+# Category::    Rails
+# Package::     BreadcrumbsOnRails
+# Author::      Simone Carletti <weppos@weppos.net>
+# License::     MIT License
+#
+#--
+# SVN: $Id$
+#++
+
+
+module BreadcrumbsOnRails
+
+  module Version
+    MAJOR = 0
+    MINOR = 1
+    PATCH = 1
+    ALPHA = nil
+
+    STRING = [MAJOR, MINOR, PATCH, ALPHA].compact.join('.')
+  end
+
+  VERSION = Version::STRING
+
+end

data/rails/init.rb

@@ -0,0 +1,5 @@
+require 'breadcrumbs_on_rails'
+
+ActionController::Base.send :include, BreadcrumbsOnRails::ControllerMixin
+
+RAILS_DEFAULT_LOGGER.info("** BreadcrumbsOnRails: initialized properly") if defined?(RAILS_DEFAULT_LOGGER)

data/tasks/tabs_on_rails_tasks.rake

@@ -0,0 +1,4 @@
+# desc "Explaining what the task does"
+# task :breadcrumbs_on_rails do
+#   # Task goes here
+# end

data/test/breadcrumbs_on_rails_test.rb

@@ -0,0 +1,9 @@
+require 'test_helper'
+
+class BreadcrumbsOnRailsTest < ActiveSupport::TestCase
+
+  def test_nothing_because_I_have_the_other_test_files
+    assert true
+  end
+
+end

data/test/builder_test.rb

@@ -0,0 +1,112 @@
+require 'test_helper'
+
+
+class BuilderTest < ActiveSupport::TestCase
+
+  class TestTemplate
+    include ActionView::Helpers::TagHelper
+    include ActionView::Helpers::UrlHelper
+
+    def url_for(params)
+      "http://localhost?" + params.to_param
+    end
+
+    protected
+
+      def method_for_name
+        "name from symbol"
+      end
+
+      def proc_for_name
+        "name from proc"
+      end
+
+      def method_for_path
+        "http://localhost/#symbol"
+      end
+
+      def proc_for_path
+        "http://localhost/#proc"
+      end
+
+  end
+  
+
+  def setup
+    @template = TestTemplate.new
+    @element  = BreadcrumbsOnRails::Breadcrumbs::Element.new(nil, nil)
+  end
+
+
+  def test_initialize_should_require_context_and_elements
+    assert_raise(ArgumentError) { BreadcrumbsOnRails::Breadcrumbs::Builder.new }
+    assert_raise(ArgumentError) { BreadcrumbsOnRails::Breadcrumbs::Builder.new(@template) }
+    assert_nothing_raised { BreadcrumbsOnRails::Breadcrumbs::Builder.new(@template, []) }
+  end
+
+  def test_initialize_should_allow_options
+    assert_nothing_raised { BreadcrumbsOnRails::Breadcrumbs::Builder.new(@template, [], {}) }
+  end
+
+  def test_initialize_should_set_context
+    @builder  = BreadcrumbsOnRails::Breadcrumbs::Builder.new(@template, [])
+    assert_equal(@template, @builder.instance_variable_get(:'@context'))
+  end
+
+  def test_initialize_should_set_elements
+    @builder  = BreadcrumbsOnRails::Breadcrumbs::Builder.new(@template, [1, 2])
+    assert_equal([1, 2], @builder.instance_variable_get(:'@elements'))
+  end
+
+
+  def test_compute_name_with_symbol
+    @builder  = BreadcrumbsOnRails::Breadcrumbs::Builder.new(@template, [])
+    @element  = BreadcrumbsOnRails::Breadcrumbs::Element.new(:method_for_name, nil)
+
+    assert_equal("name from symbol", @builder.send(:compute_name, @element))
+  end
+
+  def test_compute_name_with_proc
+    @builder  = BreadcrumbsOnRails::Breadcrumbs::Builder.new(@template, [])
+    @element  = BreadcrumbsOnRails::Breadcrumbs::Element.new(proc { |template| template.send(:proc_for_name) }, nil)
+
+    assert_equal("name from proc", @builder.send(:compute_name, @element))
+  end
+
+  def test_compute_name_with_string
+    @builder  = BreadcrumbsOnRails::Breadcrumbs::Builder.new(@template, [])
+    @element  = BreadcrumbsOnRails::Breadcrumbs::Element.new("name from string", nil)
+
+    assert_equal("name from string", @builder.send(:compute_name, @element))
+  end
+
+
+  def test_compute_path_with_symbol
+    @builder  = BreadcrumbsOnRails::Breadcrumbs::Builder.new(@template, [])
+    @element  = BreadcrumbsOnRails::Breadcrumbs::Element.new(nil, :method_for_path)
+
+    assert_equal("http://localhost/#symbol", @builder.send(:compute_path, @element))
+  end
+
+  def test_compute_path_with_proc
+    @builder  = BreadcrumbsOnRails::Breadcrumbs::Builder.new(@template, [])
+    @element  = BreadcrumbsOnRails::Breadcrumbs::Element.new(nil, proc { |template| template.send(:proc_for_path) })
+
+    assert_equal("http://localhost/#proc", @builder.send(:compute_path, @element))
+  end
+
+  def test_compute_path_with_hash
+    @builder  = BreadcrumbsOnRails::Breadcrumbs::Builder.new(@template, [])
+    @element  = BreadcrumbsOnRails::Breadcrumbs::Element.new(nil, { :foo => "bar" })
+
+    assert_equal("http://localhost?foo=bar", @builder.send(:compute_path, @element))
+  end
+
+  def test_compute_path_with_string
+    @builder  = BreadcrumbsOnRails::Breadcrumbs::Builder.new(@template, [])
+    @element  = BreadcrumbsOnRails::Breadcrumbs::Element.new(nil, "http://localhost/#string")
+
+    assert_equal("http://localhost/#string", @builder.send(:compute_path, @element))
+  end
+
+end

data/test/element_test.rb

@@ -0,0 +1,34 @@
+require 'test_helper'
+
+class ElementTest < ActiveSupport::TestCase
+
+  def test_initialize_should_require_name_and_path
+    assert_raise(ArgumentError) { BreadcrumbsOnRails::Breadcrumbs::Element.new }
+    assert_raise(ArgumentError) { BreadcrumbsOnRails::Breadcrumbs::Element.new(nil) }
+    assert_nothing_raised { BreadcrumbsOnRails::Breadcrumbs::Element.new(nil, nil) }
+  end
+
+  def test_initialize_should_set_name
+    element = BreadcrumbsOnRails::Breadcrumbs::Element.new(:fooname, nil)
+    assert_equal :fooname, element.name
+  end
+
+  def test_initialize_should_set_path
+    element = BreadcrumbsOnRails::Breadcrumbs::Element.new(nil, :foopath)
+    assert_equal :foopath, element.path
+  end
+
+
+  def test_name
+    element = BreadcrumbsOnRails::Breadcrumbs::Element.new(nil, nil)
+    element.name = :the_name
+    assert_equal :the_name, element.name
+  end
+
+  def test_path
+    element = BreadcrumbsOnRails::Breadcrumbs::Element.new(nil, nil)
+    element.path = { :controller => "index", :action => "index" }
+    assert_equal({ :controller => "index", :action => "index" }, element.path)
+  end
+
+end

data/test/simple_builder_test.rb

@@ -0,0 +1,75 @@
+require 'test_helper'
+
+
+class SimpleBuilderTest < ActionView::TestCase
+
+  class TestTemplate
+    include ActionView::Helpers::TagHelper
+    include ActionView::Helpers::UrlHelper
+  end
+
+  
+  def setup
+    @template = TestTemplate.new
+  end
+
+  def test_render_should_be_implemented
+    assert_nothing_raised { simplebuilder(@template, []).render }
+  end
+
+
+  def test_render_with_0_elements
+    assert_equal("", simplebuilder(@template, []).render)
+  end
+
+  def test_render_with_0_elements_and_separator
+    assert_equal("", simplebuilder(@template, [], :separator => "-").render)
+  end
+
+
+  def test_render_with_1_element
+    @template.expects(:current_page?).times(1).returns(false)
+    assert_dom_equal("<a href=\"/element/1\">Element 1</a>",
+                     simplebuilder(@template, generate_elements(1)).render)
+  end
+
+  def test_render_with_1_element_and_separator
+    @template.expects(:current_page?).times(1).returns(false)
+    assert_dom_equal("<a href=\"/element/1\">Element 1</a>",
+                     simplebuilder(@template, generate_elements(1), :separator => "-").render)
+  end
+
+
+  def test_render
+    @template.expects(:current_page?).times(2).returns(false)
+    assert_dom_equal("<a href=\"/element/1\">Element 1</a> &raquo; <a href=\"/element/2\">Element 2</a>",
+                     simplebuilder(@template, generate_elements(2)).render)
+  end
+
+  def test_render_with_separator
+    @template.expects(:current_page?).times(2).returns(false)
+    assert_dom_equal("<a href=\"/element/1\">Element 1</a> - <a href=\"/element/2\">Element 2</a>",
+                     simplebuilder(@template, generate_elements(2), :separator => " - ").render)
+  end
+
+  def test_render_with_current_page
+    @template.expects(:current_page?).times(2).returns(false, true)
+    assert_dom_equal("<a href=\"/element/1\">Element 1</a> &raquo; Element 2",
+                     simplebuilder(@template, generate_elements(2)).render)
+  end
+
+
+  protected
+
+    def simplebuilder(*args)
+      BreadcrumbsOnRails::Breadcrumbs::SimpleBuilder.new(*args)
+    end
+
+    def generate_elements(number)
+      (1..number).collect do |index|
+        BreadcrumbsOnRails::Breadcrumbs::Element.new("Element #{index}", "/element/#{index}")
+      end
+    end
+
+
+end

data/test/test_helper.rb

@@ -0,0 +1,23 @@
+require 'rubygems'
+gem     'rails', '~>2.3.0'
+gem     'mocha', '~>0.9.7'
+
+# Remember! Due to some Mocha internal changes,
+# Rails 2.2.x requires Mocha 0.9.5 and
+# Rails 2.3.x requires Mocha 0.9.7 
+# gem     'rails', '2.2.2'
+# gem     'mocha', '0.9.5'
+
+require 'test/unit'
+require 'active_support'
+require 'action_controller'
+require 'action_view/test_case'
+
+$:.unshift File.dirname(__FILE__) + '/../lib'
+require    File.dirname(__FILE__) + '/../init.rb'
+
+RAILS_ROOT = '.'    unless defined? RAILS_ROOT
+RAILS_ENV  = 'test' unless defined? RAILS_ENV
+
+ActionController::Base.logger = nil
+ActionController::Routing::Routes.reload rescue nil

data/uninstall.rb

@@ -0,0 +1 @@
+# Uninstall hook code here

metadata

@@ -0,0 +1,109 @@
+--- !ruby/object:Gem::Specification 
+name: breadcrumbs_on_rails
+version: !ruby/object:Gem::Version 
+  version: 0.1.1
+platform: ruby
+authors: 
+- Simone Carletti
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-11-27 00:00:00 +01:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rake
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 0.8.7
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: echoe
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 3.2.0
+    version: 
+description: "    BreadcrumbsOnRails is a simple Ruby on Rails plugin for creating and managing     a breadcrumb navigation for a Rails project.     It provides helpers for creating navigation elements with a flexible interface.\n"
+email: weppos@weppos.net
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- CHANGELOG.rdoc
+- lib/breadcrumbs_on_rails/breadcrumbs.rb
+- lib/breadcrumbs_on_rails/controller_mixin.rb
+- lib/breadcrumbs_on_rails/version.rb
+- lib/breadcrumbs_on_rails.rb
+- LICENSE.rdoc
+- README.rdoc
+- tasks/tabs_on_rails_tasks.rake
+files: 
+- CHANGELOG.rdoc
+- init.rb
+- install.rb
+- lib/breadcrumbs_on_rails/breadcrumbs.rb
+- lib/breadcrumbs_on_rails/controller_mixin.rb
+- lib/breadcrumbs_on_rails/version.rb
+- lib/breadcrumbs_on_rails.rb
+- LICENSE.rdoc
+- Manifest
+- rails/init.rb
+- Rakefile
+- README.rdoc
+- tasks/tabs_on_rails_tasks.rake
+- test/breadcrumbs_on_rails_test.rb
+- test/builder_test.rb
+- test/element_test.rb
+- test/simple_builder_test.rb
+- test/test_helper.rb
+- uninstall.rb
+- breadcrumbs_on_rails.gemspec
+has_rdoc: true
+homepage: http://code.simonecarletti.com/breadonrails
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --inline-source
+- --title
+- Breadcrumbs_on_rails
+- --main
+- README.rdoc
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "1.2"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: A simple Ruby on Rails plugin for creating and managing a breadcrumb navigation.
+test_files: 
+- test/breadcrumbs_on_rails_test.rb
+- test/builder_test.rb
+- test/element_test.rb
+- test/simple_builder_test.rb
+- test/test_helper.rb