crumble 0.1.0

data/.gitignore

@@ -0,0 +1,2 @@
+pkg
+crumble.gemspec

data/README.md

@@ -0,0 +1,124 @@
+Crumble - It's like breadcrumbs for your Rails application!
+
+It's a tiny combination of a helper and a simple configuration class to make breadcrumbs cool, because they're not.
+
+Installation
+============
+
+The gem is hosted on gemcutter, so if you haven’t already, add it as a gem source:
+
+    gem sources -a http://gemcutter.org/
+
+Then install the Formtastic gem (recommended):
+
+    gem install crumble
+
+Alternatively you can also install it as a Rails plugin:
+
+    script/plugin install git://github.com/mattmatt/crumble.git
+
+Requires Rails 2.3.
+
+Note: If you have configured Rails to reload all plugins in development mode, then putting your breadcrumbs configuration into an initializer won't work, since the classes, and therefore the breadcrumbs configuration will be unloaded after the request, and not be reloaded before the next one.
+
+This will cause the problem. Either disable it, or let Rails use the default, which is to not reload plugins.
+
+    config.reload_plugins = true
+
+Usage
+=====
+
+I wanted to have a rather simple API to configure breadcrumbs, so I made one. Basically you configure your breadcrumbs in an initializers, e.g. config/initializers/breadcrumbs.rb like so:
+
+    Breadcrumb.configure do
+      # Specify name, link title and the URL to link to
+      crumb :profile, "Your Profile", :account_url
+      crumb :root, "Home", :root_url
+      
+      # Specify controller, action, and an array of the crumbs you specified above
+      trail :accounts, :show, [:root, :profile]
+      trail :home, :index, [:root]
+      
+      # Specify the delimiter for the crumbs
+      delimit_with "/"
+    end
+
+You can hand over parameters to the URL generator methods, the parameters are expected to exist as instance variables in your controller/helper:
+
+    crumb :blog_comment, "Your Profile", :blog_comment_url, :blog, :comment
+
+If you need to fetch a nested object from an existing one, you can do it with nested hashes, nesting knowing now boundaries, as long as a tree of objects conforming to them (in this case @user.blog.name) exists:
+
+    crumb :blog, "Your Blog", :blog_url, :user => {:blog => :name}
+    crumb :blog, "Your Blog", :blog_url, :user => :blog
+
+If you really need to (only if you really, really need to), you can specify a string to be eval'd at runtime as parameter for the URL method. Brace yourself, it's not pretty:
+
+    crumb :blog, "Your Blog", :blog_url, '@user.blog'
+
+You can also add URL parameters derived from the parameters of the current request:
+
+    crumb :search, "Search", :new_search_url, :params => :q
+
+Arrays of parameters work too:
+
+    crumb :search, "Search", :new_search_url, :params => [:q, :country]
+
+And nested parameters:
+
+    crumb :search, "Search", :new_search_url, :params => {:search => :q}
+
+If you want to make the link title content dynamic, just use single quotes and rely on interpolation, you just need to ensure the interpolated code exists in the context of your helpers:
+
+    crumb :search, 'Search (Keywords: #{params[:q]})', :new_search_url, :params => :q
+
+If you don't want to specify any URL method at all, just use :current, it'll just use all the parameters of the current action, of course being aware that you can't have an URL method called current to rely on. But who would do that anyway?
+
+    crumb :search, 'Search (Keywords: #{params[:q]})', :current
+
+You can base trails on conditions using :unless and :if. Both need to point to a method that exists in the context of the view.
+
+    trail :home, :index, [:root], :unless => :logged_in?
+    trail :home, :index, [:your_account], :if => :logged_in?
+
+Alternatively you can specify a block that takes the controller as an argument.
+
+    trail :home, :index, [:your_account], :if => lambda {|controller| controller.logged_in?}
+
+Your trails can also relate to a bunch of actions, just specify an array instead.
+
+    trail :profiles, [:show, :edit], [:profile]
+
+To keep your breadcrumbs definition neat and tidy, wrap them based on their context with a handy method called, you guessed it, context:
+
+    context "user profile" do
+      trail :home, :index, [:root], :unless => :logged_in?
+      trail :home, :index, [:your_account], :if => :logged_in?
+    end
+
+Dump your trails and crumbs in there and bask in the glory of an easier readable crumbs definition.
+
+If you don't want to have the last crumb linked, no problem at all, we can do that too:
+
+    Breadcrumb.configure do
+      dont_link_last_crumb
+    end
+
+Yep, that's it. Include that in your breadcrumbs definition and you're done.
+Then, in your views, just insert the following:
+
+    <%= crumbs %>
+
+If your trails reference non-existing crumbs, the plugin will raise an error telling you where in your configuration the illegal reference was made.
+
+Future
+======
+
+If you think something's missing, let me know at <meyer@paperplanes.de>, or even better, send patches, including tests.
+
+License
+=======
+
+MIT
+
+(c) 2009 [Mathias Meyer](http://www.paperplanes.de)

data/Rakefile

@@ -0,0 +1,23 @@
+require 'rubygems'
+require 'rake'
+require "spec/rake/spectask"
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "crumble"
+    gem.summary = %Q{Crumble - It's like breadcrumbs for your Rails application!}
+    gem.description = %Q{How did these breadcrumbs in your Rails application? Oh right, with this plugin!}
+    gem.email = "meyer@paperplanes.de"
+    gem.homepage = "http://github.com/mattmatt/crumble"
+    gem.authors = ["Mathias Meyer"]
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: sudo gem install jeweler"
+end
+
+desc "Run all specs"
+Spec::Rake::SpecTask.new("spec") do |t|
+  t.spec_files = FileList["spec/*.rb"]
+end

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/app/helpers/breadcrumbs_helper.rb

@@ -0,0 +1,89 @@
+module BreadcrumbsHelper
+  def crumbs
+    (Breadcrumb.instance.trails || []).each do |trail|
+      if trail.controller.to_sym == params[:controller].to_sym and
+        trail.action.to_sym == params[:action].to_sym
+        next unless trail.condition_met?(self)
+        return calculate_breadcrumb_trail(trail.trail)
+      end
+    end
+    ""
+  end
+  
+  def calculate_breadcrumb_trail(trail)
+    breadcrumb_trail = []
+    trail.each do |crummy|
+      crumb = Breadcrumb.instance.crumbs[crummy]
+      if not Breadcrumb.instance.last_crumb_linked? and crummy == trail.last
+        breadcrumb_trail << eval(%Q{"#{crumb.title}"})
+      else
+        breadcrumb_trail << link_to(eval(%Q{"#{crumb.title}"}), fetch_crumb_url(crumb))
+      end
+    end
+    breadcrumb_trail.join(Breadcrumb.instance.delimiter)
+  end
+  
+  def fetch_parameterized_crumb_url(crumb)
+    case crumb.params
+    when Hash
+      if crumb.params[:params]
+        send(crumb.url, fetch_parameters_recursive(crumb.params[:params]))
+      else
+        result = instance_eval("@#{assemble_crumb_url_parameter(crumb.params).join(".")}")
+        send(crumb.url, result)
+      end
+    else
+      if crumb.url == :current
+        params
+      else
+        prams = crumb.params.collect do |name|
+          case name
+          when Symbol
+            instance_variable_get("@#{name}")
+          when String
+            instance_eval(name)
+          end
+        end
+        send(crumb.url, *prams)
+      end
+    end
+  end
+  
+  def fetch_crumb_url(crumb)
+    if crumb.params
+      fetch_parameterized_crumb_url(crumb)
+    else
+      send(crumb.url)
+    end
+  end
+  
+  def fetch_parameters_recursive(params_hash, parent = nil)
+    parameters = {}
+    case params_hash
+    when Symbol
+      parameters[params_hash] = (parent || params)[params_hash]
+    when Array
+      params_hash.each do |pram|
+        parameter = (parent || params)[pram]
+        parameters[pram] = parameter unless parameter.blank?
+      end
+    when Hash
+      params_hash.each do |pram, nested|
+        parameters[pram] = fetch_parameters_recursive(nested, params[pram])
+      end
+    end
+    parameters
+  end
+  
+  def assemble_crumb_url_parameter(params)
+    result = []
+    params.to_a.flatten.collect do |step|
+      result << if step.is_a?(Hash)
+        assemble_crumb_url_parameter(step)
+      else
+        step
+      end
+    end
+    result
+  end
+end

data/lib/breadcrumb.rb

@@ -0,0 +1,91 @@
+require 'singleton'
+
+class Breadcrumb
+  include Singleton
+  Trail = Struct.new(:controller, :action, :trail, :options, :line) do
+    def condition_met?(obj)
+      if options[:if]
+        evaluate(obj, options[:if])
+      elsif options[:unless]
+        !evaluate(obj, options[:unless])
+      else
+        true
+      end
+    end
+    
+    def evaluate(obj, condition)
+      if condition.respond_to?(:call)
+        condition.call(obj.controller)
+      else
+        obj.send(condition)
+      end
+    end
+  end
+  
+  Crumb = Struct.new(:name, :title, :url, :params)
+  
+  attr_accessor :trails, :crumbs, :delimiter
+  
+  def initialize
+    @last_crumb_linked = true
+  end
+  
+  def self.configure(&blk)
+    instance.crumbs = {}
+    instance.trails = []
+    instance.instance_eval &blk
+    instance.validate
+  end
+  
+  def trail(controller, actions, trail, options = {})
+    @trails ||= []
+    actions = Array(actions)
+    actions.each do |action|
+      @trails << Trail.new(controller, action, trail, options, caller[2].split(":")[1])
+    end
+  end
+  
+  def crumb(name, title, url, *params)
+    params = params.first if params.any? && params.first.is_a?(Hash)
+    @crumbs ||= {}
+    @crumbs[name] = Crumb.new(name, title, url, params)
+  end
+  
+  def context(name)
+    yield
+  end
+  
+  def delimit_with(delimiter)
+    @delimiter = delimiter
+  end
+  
+  def dont_link_last_crumb
+    @last_crumb_linked = false
+  end
+
+  def link_last_crumb
+    @last_crumb_linked = true
+  end
+  
+  def last_crumb_linked?
+    @last_crumb_linked
+  end
+  
+  def validate
+    invalid_trails = []
+    trails.each do |trail|
+      trail.trail.collect do |t|
+        invalid_trails << [trail, t] if crumbs[t].nil?
+      end
+    end
+    
+    if invalid_trails.any?
+      messages = []
+      invalid_trails.each do |trail|
+        messages << "Trail for #{trail.first.controller}/#{trail.first.action} references non-existing crumb '#{trail.last}' (configuration file line: #{trail.first.line})"
+      end
+      raise messages.join("\n")
+    end
+  end
+  
+end

data/rails/init.rb

@@ -0,0 +1 @@
+require File.join(File.dirname(__FILE__), *%w[.. lib breadcrumb])

data/spec/breadcrumb_spec.rb

@@ -0,0 +1,84 @@
+require File.dirname(__FILE__) + '/spec_helper'
+
+describe Breadcrumb do
+  describe "when configuring the instance" do
+    it "should add trails" do
+      Breadcrumb.configure do
+        crumb :profile, "Public Profile", :user_url, :user
+        crumb :your_account, "Public Profile", :user_url, :user
+        
+        trail :accounts, :edit, [:profile, :your_account]
+      end
+      
+      trail = Breadcrumb.instance.trails.last
+      trail.controller.should == :accounts
+      trail.action.should == :edit
+      trail.trail.should == [:profile, :your_account]
+    end
+    
+    it "should add crumbs" do
+      Breadcrumb.configure do
+        crumb :profile, "Public Profile", :user_url, :user
+      end
+      
+      profile = Breadcrumb.instance.crumbs[:profile]
+      profile.title.should == "Public Profile"
+      profile.url.should == :user_url
+      profile.params.should == [:user]
+    end
+    
+    it "should store the delimiter" do
+      Breadcrumb.configure do
+        delimit_with "/"
+      end
+      
+      Breadcrumb.instance.delimiter.should == "/"
+    end
+    
+    it "should set the flag not to link the last crumb" do
+      Breadcrumb.configure do
+        dont_link_last_crumb
+      end
+      
+      Breadcrumb.instance.last_crumb_linked?.should == false
+    end
+
+    it "should unset the flag not to link the last crumb" do
+      Breadcrumb.configure do
+        link_last_crumb
+      end
+      
+      Breadcrumb.instance.last_crumb_linked?.should == true
+    end
+    
+    it "should support contexts" do
+      Breadcrumb.configure do
+        context "user profile" do
+          crumb :profile, "Public Profile", :user_url, :user
+        end
+      end
+      
+      profile = Breadcrumb.instance.crumbs[:profile]
+      profile.title.should == "Public Profile"
+      profile.url.should == :user_url
+      profile.params.should == [:user]
+    end
+    
+    it "should not accept non-existing trails in crumb definitions" do
+      lambda {
+        Breadcrumb.configure do
+          trail :accounts, :edit, [:profile]
+        end
+      }.should raise_error(RuntimeError, "Trail for accounts/edit references non-existing crumb 'profile' (configuration file line: 70)")
+    end
+    
+    it "should include errors for multiple missing crumb definitions" do
+      lambda {
+        Breadcrumb.configure do
+          trail :accounts, :edit, [:profile]
+          trail :accounts, :show, [:profile]
+        end
+      }.should raise_error(RuntimeError, "Trail for accounts/edit references non-existing crumb 'profile' (configuration file line: 78)\nTrail for accounts/show references non-existing crumb 'profile' (configuration file line: 79)")
+    end
+  end
+end

data/spec/breadcrumbs_helper_spec.rb

@@ -0,0 +1,335 @@
+require File.dirname(__FILE__) + '/spec_helper'
+
+require 'active_support'
+require 'action_view/helpers/url_helper'
+
+describe BreadcrumbsHelper do
+  include ActionView::Helpers::UrlHelper
+  include ActionView::Helpers::TagHelper
+  include BreadcrumbsHelper
+
+  attr_accessor :params
+  
+  def controller
+    self
+  end
+  
+  before(:each) do
+    @params = {}
+    @user = User.new("jonathan")
+    @article = Article.new(1)
+    Breadcrumb.configure do
+      delimit_with " / "
+      link_last_crumb
+    end
+  end
+  
+  describe "when getting the breadcrumbs" do
+    before(:each) do
+    end
+    
+    it "should calculate the urls in the breadcrumbs" do
+      Breadcrumb.configure do
+        crumb :your_account, "Your Account", :edit_account_url
+        trail :accounts, :index, [:your_account]
+      end
+      params[:controller] = 'accounts'
+      params[:action] = 'index'
+      crumbs.should == %Q{<a href="http://test.host/account/edit">Your Account</a>}
+    end
+    
+    it "should support fetching an instance variable" do
+      Breadcrumb.configure do
+        crumb :profile, "Public Profile", :user_url, :user
+        trail :accounts, :edit, [:profile]
+      end
+      params[:controller] = 'accounts'
+      params[:action] = 'edit'
+      crumbs.should == %Q{<a href="http://test.host/f/jonathan">Public Profile</a>}
+    end
+    
+    it "should support fetching multiple instance variables" do
+      Breadcrumb.configure do
+        trail :accounts, :profile, [:your_article]
+        crumb :your_article, "Your Article", :user_article_url, :user, :article
+      end
+        
+      params[:controller] = 'accounts'
+      params[:action] = 'profile'
+      crumbs.should == %Q{<a href="http://test.host/f/jonathan/articles/1">Your Article</a>}
+    end
+    
+    it "should join multiple crumbs with a /" do
+      Breadcrumb.configure do
+        trail :accounts, :show, [:profile, :your_account]
+        crumb :profile, "Public Profile", :user_url, :user
+        crumb :your_account, "Your Account", :edit_account_url
+      end
+      
+      params[:controller] = 'accounts'
+      params[:action] = 'show'
+      crumbs.should == %Q{<a href="http://test.host/f/jonathan">Public Profile</a> / <a href="http://test.host/account/edit">Your Account</a>}
+    end
+    
+    it "should return an empty string for no matches" do
+      Breadcrumb.configure do
+      end
+      params[:controller] = 'accounts'
+      params[:action] = 'sho'
+      crumbs.should == ""
+    end
+    
+    it "should add parameters to the url" do
+      Breadcrumb.configure do
+        crumb :search, "Search", :search_url, :params => :q
+        trail :search, :new, [:search]
+      end
+      
+      params[:controller] = 'search'
+      params[:action] = 'new'
+      params[:q] = 'google'
+      crumbs.should == %Q{<a href="http://test.host/search?q=google">Search</a>}
+    end
+    
+    it "should add multiple parameters to the url" do
+      Breadcrumb.configure do
+        crumb :search, "Search", :search_url, :params => [:q, :country]
+        trail :search, :new, [:search]
+      end
+      
+      params[:controller] = 'search'
+      params[:action] = 'new'
+      params[:country] = 'Germany'
+      params[:q] = 'google'
+      crumbs.should == %Q{<a href="http://test.host/search?q=google&amp;country=Germany">Search</a>}
+    end
+    
+    it "should eval single quoted title strings and interpolate them" do
+      Breadcrumb.configure do
+        crumb :search_results, 'Search Results (#{@query})', :search_url, :query
+        trail :search, :create, [:search_results]
+      end
+      
+      params[:controller] = 'search'
+      params[:action] = 'create'
+
+      @query = 'google'
+      crumbs.should == %Q{<a href="http://test.host/search/google">Search Results (google)</a>}
+    end
+    
+    it "should support a list of actions to configure a trail" do
+      Breadcrumb.configure do
+        crumb :search_results, 'Search Results (#{@query})', :search_url
+        trail :search, [:create, :new], [:search_results]
+      end
+      
+      params[:controller] = 'search'
+      params[:action] = 'create'
+      crumbs.should == %Q{<a href="http://test.host/search/">Search Results ()</a>}
+      
+      params[:action] = 'new'
+      crumbs.should == %Q{<a href="http://test.host/search/">Search Results ()</a>}
+    end
+    
+    it "should support using the current url instead of a predefined one" do
+      Breadcrumb.configure do
+        crumb :search_results, 'Search Results (#{@query})', :current
+        trail :search, [:create, :new], [:search_results]
+      end
+      
+      params[:controller] = 'search'
+      params[:action] = 'new'
+      crumbs.should == %Q{<a href="http://test.host/search/new">Search Results ()</a>}
+    end
+    
+    it "should not consider a trail when it has an :if condition and it's not met" do
+      Breadcrumb.configure do
+        crumb :search_results, 'Search Results', :current
+        trail :search, [:create, :new], [:search_results], :if => :is_it_false?
+      end
+      
+      params[:controller] = 'search'
+      params[:action] = 'new'
+      crumbs.should == ""
+    end
+
+    it "should consider a trail when it has an :if condition and it's met" do
+      Breadcrumb.configure do
+        crumb :search_results, 'Search Results', :current
+        trail :search, [:create, :new], [:search_results], :if => :its_true!
+      end
+      
+      params[:controller] = 'search'
+      params[:action] = 'new'
+      crumbs.should == %Q{<a href="http://test.host/search/new">Search Results</a>}
+    end
+
+    it "should not consider a trail when it has an :unless condition and it's not met" do
+      Breadcrumb.configure do
+        crumb :search_results, 'Search Results', :current
+        trail :search, [:create, :new], [:search_results], :unless => :its_true!
+      end
+      
+      params[:controller] = 'search'
+      params[:action] = 'new'
+      crumbs.should == ""
+    end
+
+    it "should consider a trail when it has an :unless condition and it's met" do
+      Breadcrumb.configure do
+        crumb :search_results, 'Search Results', :current
+        trail :search, [:create, :new], [:search_results], :unless => :is_it_false?
+      end
+      
+      params[:controller] = 'search'
+      params[:action] = 'new'
+      crumbs.should == %Q{<a href="http://test.host/search/new">Search Results</a>}
+    end
+    
+    it "should call blocks as :unless parameters" do
+      Breadcrumb.configure do
+        crumb :search_results, 'Search Results', :current
+        trail :search, [:create, :new], [:search_results], :unless => lambda {|controller| controller.its_true!}
+      end
+      
+      params[:controller] = 'search'
+      params[:action] = 'new'
+      crumbs.should == ""
+    end
+
+    it "should call blocks as :if parameters" do
+      Breadcrumb.configure do
+        crumb :search_results, 'Search Results', :current
+        trail :search, [:create, :new], [:search_results], :if => lambda {|controller| controller.its_true!}
+      end
+      
+      params[:controller] = 'search'
+      params[:action] = 'new'
+      crumbs.should == "<a href=\"http://test.host/search/new\">Search Results</a>"
+    end
+    
+    it "should support resolving parameters for url methods derived from a string" do
+      Breadcrumb.configure do
+        crumb :search_results, 'Search Results', :search_url, "@user.login"
+        trail :search, [:create, :new], [:search_results]
+      end
+      
+      params[:controller] = 'search'
+      params[:action] = 'new'
+      crumbs.should == %Q{<a href="http://test.host/search/jonathan">Search Results</a>}
+    end
+
+    it "should support resolving parameters for url methods derived from a hash pointing to an object hierarchy" do
+      Breadcrumb.configure do
+        crumb :search_results, 'Search Results', :search_url, :user => :login
+        trail :search, [:create, :new], [:search_results]
+      end
+      
+      params[:controller] = 'search'
+      params[:action] = 'new'
+      crumbs.should == %Q{<a href="http://test.host/search/jonathan">Search Results</a>}
+    end
+
+    it "should support resolving parameters for url methods derived from a hash pointing to a nested object hierarchy" do
+      Breadcrumb.configure do
+        crumb :search_results, 'Search Results', :search_url, :user => {:login => :to_s}
+        trail :search, [:create, :new], [:search_results]
+      end
+      
+      params[:controller] = 'search'
+      params[:action] = 'new'
+      crumbs.should == %Q{<a href="http://test.host/search/jonathan">Search Results</a>}
+    end
+    
+    it "should return the same breadcrumbs on subsequent calls" do
+      Breadcrumb.configure do
+        crumb :your_account, "Your Account", :edit_account_url
+        trail :accounts, :index, [:your_account]
+      end
+      params[:controller] = 'accounts'
+      params[:action] = 'index'
+      once = crumbs
+      twice = crumbs
+      once.should == twice
+    end
+    
+    it "should not link the last link when the option was specified" do
+      Breadcrumb.configure do
+        trail :accounts, :show, [:profile, :your_account]
+        crumb :profile, "Public Profile", :user_url, :user
+        crumb :your_account, "Your Account", :edit_account_url
+        dont_link_last_crumb
+      end
+      
+      params[:controller] = 'accounts'
+      params[:action] = 'show'
+      crumbs.should == %Q{<a href="http://test.host/f/jonathan">Public Profile</a> / Your Account}
+    end
+
+    it "should not link the last link when the option was specified and only one crumb is in the trail" do
+      Breadcrumb.configure do
+        trail :accounts, :show, [:profile]
+        crumb :profile, "Public Profile", :user_url, :user
+        dont_link_last_crumb
+      end
+      
+      params[:controller] = 'accounts'
+      params[:action] = 'show'
+      crumbs.should == %Q{Public Profile}
+    end
+    
+    describe "when fetching parameters" do
+      it "should support nested parameter attributes" do
+        Breadcrumb.configure do
+          crumb :nested_search, "Search", :search_url, :params => {:search => :q}
+          trail :search, :new, [:nested_search]
+        end
+      
+        params[:controller] = "search"
+        params[:action] = 'new'
+        params[:search] = {:q => "google", :country => "Germany"}
+      
+        fetch_parameters_recursive({:search => [:q, :country]}).should == {:search => {:q => "google", :country => "Germany"}}
+      end
+      
+      it "should support nested array parameters" do
+        Breadcrumb.configure do
+          crumb :nested_search, "Search", :search_url, :params => {:search => :q}
+          trail :search, :new, [:nested_search]
+        end
+
+        params[:controller] = "search"
+        params[:action] = 'new'
+        params[:search] = {:q => "google", :country => ["Germany", "Australia"]}
+
+        fetch_parameters_recursive({:search => [:q, :country]}).should == {:search => {:q => "google", :country => ["Germany", "Australia"]}}
+      end
+
+      it "should not include empty parameters" do
+        Breadcrumb.configure do
+          crumb :nested_search, "Search", :search_url, :params => {:search => :q}
+          trail :search, :new, [:nested_search]
+        end
+
+        params[:controller] = "search"
+        params[:action] = 'new'
+        params[:search] = {:q => ""}
+
+        fetch_parameters_recursive({:search => [:q, :country]}).should == {:search => {}}
+      end
+      
+      it "should not include empty parameters with nested hashes" do
+        Breadcrumb.configure do
+          crumb :nested_search, "Search", :search_url, :params => {:search => :q}
+          trail :search, :new, [:nested_search]
+        end
+
+        params[:controller] = "search"
+        params[:action] = 'new'
+        params[:search] = {:q => "google", :country => []}
+
+        fetch_parameters_recursive({:search => [:q, :country]}).should == {:search => {:q => "google"}}
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,62 @@
+require 'rubygems'
+gem 'rspec'
+
+require "#{File.dirname(__FILE__)}/../app/helpers/breadcrumbs_helper"
+require "#{File.dirname(__FILE__)}/../lib/breadcrumb"
+
+Spec::Runner.configure do |config|
+
+  config.before(:each) do
+    @old_trails = Breadcrumb.instance.trails
+    Breadcrumb.instance.trails = nil
+  
+    @old_crumbs = Breadcrumb.instance.crumbs
+    Breadcrumb.instance.crumbs = nil
+  end
+  
+  config.after(:each) do
+    Breadcrumb.instance.crumbs = @old_crumbs
+    Breadcrumb.instance.trails = @old_trails
+  end
+
+  public
+  
+  def edit_account_url
+    "http://test.host/account/edit"
+  end
+  
+  def user_url(user)
+    "http://test.host/f/#{user.login}"
+  end
+  
+  def user_article_url(user, article)
+    "http://test.host/f/#{user.login}/articles/#{article.id}"
+  end
+  
+  def search_url(params = nil)
+    if params.is_a?(Hash)
+      "http://test.host/search?#{params.collect{|key, value| "#{key.to_s}=#{value}"}.join('&')}"
+    else
+      "http://test.host/search/#{params}"
+    end
+  end
+  
+  def url_for(params)
+    if params.is_a?(Hash)
+      "http://test.host/#{params[:controller]}/#{params[:action]}"
+    else
+      super
+    end
+  end
+  
+  def is_it_false?
+    false
+  end
+  
+  def its_true!
+    true
+  end
+  
+  User = Struct.new(:login)
+  Article = Struct.new(:id)
+end

metadata

@@ -0,0 +1,66 @@
+--- !ruby/object:Gem::Specification 
+name: crumble
+version: !ruby/object:Gem::Version 
+  version: 0.1.0
+platform: ruby
+authors: 
+- Mathias Meyer
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-11-18 00:00:00 +01:00
+default_executable: 
+dependencies: []
+
+description: How did these breadcrumbs in your Rails application? Oh right, with this plugin!
+email: meyer@paperplanes.de
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.md
+files: 
+- .gitignore
+- README.md
+- Rakefile
+- VERSION
+- app/helpers/breadcrumbs_helper.rb
+- lib/breadcrumb.rb
+- rails/init.rb
+- spec/breadcrumb_spec.rb
+- spec/breadcrumbs_helper_spec.rb
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: http://github.com/mattmatt/crumble
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+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: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Crumble - It's like breadcrumbs for your Rails application!
+test_files: 
+- spec/breadcrumb_spec.rb
+- spec/breadcrumbs_helper_spec.rb
+- spec/spec_helper.rb