ariane 0.0.1

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/COPYING

@@ -0,0 +1,13 @@
+Copyright (c) 2012, Simon COURTOIS
+
+Permission to use, copy, modify, and/or distribute this software for any purpose
+with or without fee is hereby granted, provided that the above copyright notice
+and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS
+OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
+TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF
+THIS SOFTWARE.

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in ariane.gemspec
+gemspec

data/README.md

@@ -0,0 +1,196 @@
+# Ariane
+
+Ariane is a flexible breadcrumb system for Rails. And it's fully compatible with 
+the [Twitter Bootstrap](http://twitter.github.com/bootstrap/) !
+
+## Installation
+
+Add the following line to your `Gemfile`:
+
+``` ruby
+gem 'ariane'
+```
+
+## Requirements
+
+* Ruby >= 1.9.x
+
+## Quickstart
+
+To get started, define a before_filter in your `ApplicationController` and use
+it to add the first entry:
+
+``` ruby
+class ApplicationController < ActionController::Base
+  before_filter :set_ariane
+
+  protected
+
+  def set_ariane
+    ariane.add 'Home', root_path
+  end
+end
+```
+
+You can then add more entries from your other controllers:
+
+``` ruby
+class OtherController < ApplicationController
+  protected
+
+  def set_ariane
+    super
+    ariane.add 'Other', other_path
+  end
+end
+```
+
+Then in your layout, simply call `ariane.render` to see the magic happen:
+
+``` erb
+<%= ariane.render %>
+```
+
+This will render the following:
+
+``` html
+<ul class="breadcrumb">
+  <li>
+    <a href="/">Home</a>
+    <span class="divider">/</span>
+  </li>
+  <li class="active">Other</li>
+</ul>
+```
+## ariane.add
+
+`ariane.add` takes two arguments, both being optional.
+
+* `text` is the text to use as link text
+* `url` is the path to where you want the link to point
+
+Note that if you don't set the url, the text will simply be rendered as is.
+
+Alternatively, you can pass a block to `ariane.add`. The block will receive the new crumb as argument.
+
+``` ruby
+ariane.add do |crumb|
+  crumb.text = 'Home'
+  crumb.url  = root_path
+end
+```
+
+## Customize the output
+
+Ariane provides a set of renderers you can use to generate the output. To see
+the options you can use with each renderer, take a look at the wiki.
+
+The default renderer is `HTMLList` but you can select another one.
+
+### Using ariane.render
+
+You can choose the renderer when calling `ariane.render` by passing it as the
+first argument:
+
+``` erb
+<%= ariane.render(Ariane::Render::HTML) %>
+```
+
+This will render the following text:
+
+``` html
+<p class="breadcrumb">
+  <a href="/">Home</a> / Other
+</p>
+```
+
+### Using an initializer
+
+You may also choose to set the renderer when Rails is loaded:
+
+``` ruby
+# config/initializers/ariane.rb
+Ariane.configure do |config|
+  config.default_renderer = Ariane::Render::HTML
+end
+```
+
+If you want further customization, you can instanciate the renderer and then use
+it in `Ariane.configure`.
+
+``` ruby
+# config/initializers/ariane.rb
+rndr = Ariane::Render::HTML.new(divider: ' | ')
+
+Ariane.configure do |config|
+  config.default_renderer = rndr
+end
+```
+
+Calling `ariane.render` will output the following HTML:
+
+```
+<p class="breadcrumb">
+  <a href="/">Home</a> | Other
+</p>
+```
+
+## Bring your own Renderer
+
+Ariane is flexible enough to let you define or extend renderers.
+
+``` ruby
+class HTMLOrderedList < Ariane::Render::HTMLList
+  def list(crumbs)
+    content_tag(:ol, class: options[:list_class]) do
+      raw items(crumbs)
+    end
+  end
+
+  def divider
+    content_tag(:span, '|', class: 'separator')
+  end
+end
+```
+
+This example is simple but shows that you can touch pretty anything in the
+renderers.
+
+Now if you call
+
+``` erb
+<%= ariane.render(HTMLOrderedList) %>
+```
+
+You'll obtain the following HTML:
+
+``` html
+<ol class="breadcrumb">
+  <li>
+    <a href="/">Home</a>
+    <span class="separator">|</span>
+  </li>
+  <li class="active">Other</li>
+</ul>
+```
+
+### Create a renderer from scratch
+
+You can create a complete renderer, simply take a look at
+`lib/ariane/render/html.rb` for a complete example implementation.
+
+## Boring legal stuff
+
+Copyright (c) 2012, Simon COURTOIS
+
+Permission to use, copy, modify, and/or distribute this software for any purpose
+with or without fee is hereby granted, provided that the above copyright notice
+and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS
+OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
+TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF
+THIS SOFTWARE.

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/ariane.gemspec

@@ -0,0 +1,25 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "ariane/version"
+
+Gem::Specification.new do |s|
+  s.name        = "ariane"
+  s.version     = Ariane::VERSION
+  s.authors     = ["Simon COURTOIS"]
+  s.email       = ["scourtois@cubyx.fr"]
+  s.homepage    = "http://github.com/simonc/ariane"
+  s.summary     = "A flexible breadcrumb system for Rails, fully compatible " \
+                  "with the Twitter Bootstrap."
+  s.description = "Ariane is a flexible breadcrumb system for Rails. It is "  \
+                  "fully compatible with the Twitter Bootstrap and can be "   \
+                  "adapted to any kind of output."
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_dependency "actionpack",    ">= 2.3.0"
+  s.add_dependency "activesupport", ">= 2.3.0"
+  s.add_development_dependency "rspec"
+end

data/lib/ariane.rb

@@ -0,0 +1,49 @@
+require 'ariane/version'
+require 'ariane/crumb'
+require 'ariane/breadcrumb'
+require 'ariane/render'
+
+require 'ariane/rails' if defined?(Rails)
+
+module Ariane
+  class << self
+    attr_accessor :request
+
+    def configure
+      yield self
+    end
+
+    def request_env=(environment)
+      @request_env = environment
+      @request_env[:breadcrumb] ||= Breadcrumb.new
+    end
+
+    def request_env
+      @request_env if defined?(@request_env)
+    end
+
+    def request
+      @request_id if defined? @request_id
+    end
+
+    def request=(request_id)
+      @request_id = request_id
+    end
+
+    def breadcrumb
+      @request_env[:breadcrumb]
+    end
+
+    def breadcrumb=(breadcrumb)
+      @request_env[:breadcrumb] = breadcrumb
+    end
+
+    def default_renderer
+      @default_renderer ||= Ariane::Render::HTMLList.new
+    end
+
+    def default_renderer=(renderer)
+      @default_renderer = renderer.is_a?(Class) ? renderer.new : renderer
+    end
+  end
+end

data/lib/ariane/breadcrumb.rb

@@ -0,0 +1,21 @@
+require 'ariane/crumb'
+
+module Ariane
+  class Breadcrumb
+    def crumbs
+      @crumbs ||= []
+    end
+
+    def add(text='', url=nil, &block)
+      new_crumb = Crumb.new(text, url)
+      yield new_crumb if block_given?
+      crumbs << new_crumb
+    end
+
+    def render(renderer=nil)
+      renderer ||= Ariane.default_renderer
+      renderer = renderer.new if renderer.is_a?(Class)
+      renderer.render(crumbs)
+    end
+  end
+end

data/lib/ariane/crumb.rb

@@ -0,0 +1,12 @@
+require 'delegate'
+
+module Ariane
+  class Crumb
+    attr_accessor :text, :url
+
+    def initialize(text='', url=nil)
+      @text = text
+      @url  = url
+    end
+  end
+end

data/lib/ariane/rails.rb

@@ -0,0 +1,2 @@
+require 'ariane/rails/controller_helper'
+require 'ariane/rails/view_helper'

data/lib/ariane/rails/controller_helper.rb

@@ -0,0 +1,15 @@
+module Ariane
+  module ControllerHelper
+    def ariane
+      if !Ariane.request_env || Ariane.request != request.object_id
+        Ariane.request     = request.object_id
+        Ariane.request_env = request.env
+        Ariane.breadcrumb  = Breadcrumb.new
+      end
+
+      Ariane.request_env[:breadcrumb]
+    end
+  end
+end
+
+ActionController::Base.send :include, Ariane::ControllerHelper

data/lib/ariane/rails/view_helper.rb

@@ -0,0 +1,9 @@
+module Ariane
+  module ViewHelper
+    def ariane
+      Ariane.breadcrumb
+    end
+  end
+end
+
+ActionView::Base.send :include, Ariane::ViewHelper

data/lib/ariane/render.rb

@@ -0,0 +1,3 @@
+require 'ariane/render/base'
+require 'ariane/render/html'
+require 'ariane/render/html_list'

data/lib/ariane/render/base.rb

@@ -0,0 +1,23 @@
+module Ariane
+  module Render
+
+    class Base
+      attr_accessor :options
+
+      def initialize(options={})
+        @options = {
+          divider: divider
+        }.merge(options)
+      end
+
+      def render(crumbs)
+        raise 'the render method is not implemented in your Ariane renderer'
+      end
+
+      def divider
+        ' / '
+      end
+    end
+
+  end
+end

data/lib/ariane/render/html.rb

@@ -0,0 +1,69 @@
+require 'ariane/render/base'
+require 'action_view'
+
+module Ariane
+  module Render
+
+    class HTML < Base
+      include ActionView::Helpers::TagHelper
+      include ActionView::Helpers::UrlHelper
+      include ActionView::Helpers::OutputSafetyHelper
+
+      attr_accessor :output_buffer
+
+      def initialize(options={})
+        options = {
+          active_class: 'active',
+          link_active:  false,
+          link_class:   nil,
+          list_class:   'breadcrumb',
+          list_id:      nil
+        }.merge(options)
+
+        super(options)
+      end
+
+      def render(crumbs)
+        list(crumbs).html_safe
+      end
+
+      def list(crumbs)
+        content_tag(:p, id: options[:list_id], class: options[:list_class]) do
+          raw items(crumbs)
+        end
+      end
+
+      def items(crumbs)
+        crumbs.inject('') do |out, crumb|
+          active = crumb == crumbs.last
+          out << item(crumb, active)
+          out
+        end
+      end
+
+      def item(crumb, active=false)
+        out = link(crumb, active)
+        out << divider if divider && !active
+        out
+      end
+
+      def link(crumb, active=false)
+        classes = options[:link_class]
+
+        if active && options[:active_class]
+          classes ||= ''
+          classes << options[:active_class]
+        end
+
+        link_active = !active || options[:link_active]
+        if crumb.url && link_active
+          link = link_to crumb.text, crumb.url, class: classes
+        else
+          link = crumb.text
+        end
+        link
+      end
+    end
+
+  end
+end

data/lib/ariane/render/html_list.rb

@@ -0,0 +1,52 @@
+require 'ariane/render/html'
+
+module Ariane
+  module Render
+
+    class HTMLList < HTML
+      def initialize(options={})
+        options = {
+          item_class: nil
+        }.merge(options)
+
+        super(options)
+      end
+
+      def list(crumbs)
+        content_tag(:ul, id: options[:list_id], class: options[:list_class]) do
+          raw items(crumbs)
+        end
+      end
+
+      def item(crumb, active=false)
+        classes = options[:item_class]
+
+        if active && options[:active_class]
+          classes ||= ''
+          classes << options[:active_class]
+        end
+
+        content_tag(:li, class: classes) do
+          out = link(crumb, active)
+          out << divider if divider && !active
+          out
+        end
+      end
+
+      def link(crumb, active=false)
+        link_active = !active || options[:link_active]
+        if crumb.url && link_active
+          link = link_to crumb.text, crumb.url, class: options[:link_class]
+        else
+          link = crumb.text
+        end
+        link
+      end
+
+      def divider
+        content_tag(:span, '/', class: 'divider')
+      end
+    end
+
+  end
+end

data/lib/ariane/version.rb

@@ -0,0 +1,3 @@
+module Ariane
+  VERSION = "0.0.1"
+end

data/spec/ariane/breadcrumb_spec.rb

@@ -0,0 +1,64 @@
+require 'ariane'
+
+module Ariane
+  describe Breadcrumb do
+    describe "#crumbs" do
+      it "has a crumbs method that returns an Enumerable" do
+        Breadcrumb.new.crumbs.is_a?(Enumerable).should be_true
+      end
+
+      it "set the crumbs to an empty Enumerable by default" do
+        crumbs = Breadcrumb.new.crumbs
+        crumbs.respond_to?(:count).should be_true
+        crumbs.count.should be(0)
+      end
+    end
+
+    describe "#add" do
+      it "creates a new crumb and push it to crumbs" do
+        breadcrumb = Breadcrumb.new
+        breadcrumb.add 'text', 'url'
+        breadcrumb.crumbs.count.should be(1)
+        breadcrumb.crumbs.last.text.should == 'text'
+        breadcrumb.crumbs.last.url.should  == 'url'
+      end
+
+      it "yields passing the new crumb if a block is given" do
+        breadcrumb = Breadcrumb.new
+        breadcrumb.add 'text' do |crumb|
+          crumb.url = 'url'
+        end
+        breadcrumb.crumbs.last.url.should == 'url'
+      end
+    end
+
+    describe "#render" do
+      let(:test_renderer_class) { double('renderer_clas') }
+      let(:test_renderer)       { double('renderer')      }
+
+      it "uses Ariane's default renderer if none is passed as argument" do
+        Ariane.default_renderer = test_renderer
+        breadcrumb = Breadcrumb.new
+        breadcrumb.add 'text', 'url'
+        test_renderer.should_receive(:render)
+        breadcrumb.render
+      end
+
+      it "instanciates the renderer if a class is given" do
+        test_renderer_class.stub(:"is_a?").with(Class).and_return(true)
+        test_renderer_class.stub(:new).and_return(test_renderer)
+
+        test_renderer_class.should_receive(:new)
+        test_renderer.should_receive(:render).with([])
+        Breadcrumb.new.render(test_renderer_class)
+      end
+
+      it "calls render on the renderer, passing it the cumbs" do
+        breadcrumb = Breadcrumb.new
+        breadcrumb.add 'text', 'url'
+        test_renderer.should_receive(:render).with(breadcrumb.crumbs)
+        breadcrumb.render(test_renderer)
+      end
+    end
+  end
+end

data/spec/ariane/crumb_spec.rb

@@ -0,0 +1,34 @@
+require 'ariane/crumb'
+
+module Ariane
+  describe Crumb do
+    it "has a text attribute" do
+      Crumb.new.respond_to?(:text)
+    end
+
+    it "sets text as an empty string by default" do
+      Crumb.new.text.should == ''
+    end
+
+    it "has a setter for the text attribute" do
+      crumb = Crumb.new
+      crumb.text = 'test'
+      crumb.text.should == 'test'
+    end
+
+
+    it "has an url attribute" do
+      Crumb.new.respond_to?(:url)
+    end
+
+    it "sets url as nil by default" do
+      Crumb.new.url.should be_nil
+    end
+
+    it "has a setter for the url attribute" do
+      crumb = Crumb.new
+      crumb.url = '/'
+      crumb.url.should == '/'
+    end
+  end
+end

data/spec/ariane/render/base_spec.rb

@@ -0,0 +1,46 @@
+require 'ariane/render/base'
+
+module Ariane
+  module Render
+
+    describe Base do
+      it "has an options attribute" do
+        Base.new.respond_to?(:options).should be_true
+      end
+
+      it "has a setter for the options attribute" do
+        base = Base.new
+        base.options = { test: 42 }
+        base.options.should == { test: 42 }
+      end
+
+      describe "#initialize" do
+        it "sets the default options" do
+          Base.new.options.should == { divider: ' / ' }
+        end
+
+        it "calls divider to set the default divider" do
+          base = Base.new
+          base.options[:divider].should == base.divider
+        end
+
+        it "merges the options passed as argument to the default ones" do
+          Base.new(test: 42).options.should == { divider: ' / ', test: 42 }
+        end
+      end
+
+      describe "render" do
+        it "raises an exceptions when called" do
+          expect { Base.new.render }.to raise_error
+        end
+      end
+
+      describe "divider" do
+        it "returns the default divider" do
+          Base.new.divider.should == ' / '
+        end
+      end
+    end
+
+  end
+end

data/spec/ariane/render/html_list_spec.rb

@@ -0,0 +1,99 @@
+require 'ariane/render/html_list'
+
+module Ariane
+  module Render
+
+    describe HTMLList do
+      describe "#initialize" do
+        it "sets default options" do
+          HTMLList.new.options.has_key?(:item_class).should be_true
+        end
+
+        it "merges the options passed as argument to the default ones" do
+          html_list = HTMLList.new(item_class: 'test')
+          html_list.options[:item_class].should == 'test'
+          html_list.options[:list_class].should == 'breadcrumb'
+        end
+
+        it "calls uses HTML default options" do
+          html      = HTML.new
+          html_list = HTMLList.new
+          html_list.options[:list_class].should == html.options[:list_class]
+        end
+      end
+
+      describe "#list" do
+        it "returns an HTML list with list_id and list_class" do
+          html_list = HTMLList.new(list_id: 'test')
+          html_list.list([]).should == '<ul class="breadcrumb" id="test"></ul>'
+        end
+
+        it "returns an HTML list containing crumbs" do
+          html_list = HTMLList.new
+          crumbs = [Crumb.new('text', 'url')]
+          html_list.list(crumbs).should =~ %r[<ul class="breadcrumb">.*li.*</ul>]
+        end
+      end
+
+      describe "#item" do
+        before :each do
+          @html_list = HTMLList.new
+          @crumb     = Crumb.new 'text', 'url'
+        end
+
+        it "returns the crumb in a formatted form" do
+          @html_list.item(@crumb).should =~ %r[^<li><a href="url">text</a>]
+        end
+
+        it "appends the divider to the crumb" do
+          @html_list.item(@crumb).should =~ %r[<span class="divider">/</span></li>$]
+        end
+
+        it "does not append the divider if the crumb is active" do
+          @html_list.item(@crumb, true).should_not =~ %r[<span class="divider">/</span></li>$]
+        end
+      end
+
+      describe "#link" do
+        before do
+          @html_list = HTMLList.new
+          @crumb = Crumb.new 'text', 'url'
+        end
+
+        it "returns the link for the crumb" do
+          @html_list.link(@crumb).should == '<a href="url">text</a>'
+        end
+
+        it "sets the link class" do
+          @html_list.options[:link_class] = 'test'
+          @html_list.link(@crumb).should == '<a href="url" class="test">text</a>'
+        end
+
+        it "returns a link if the crumb has an url" do
+          @html_list.link(@crumb).should == '<a href="url">text</a>'
+        end
+
+        it "returns a link if the crumb is active and link_active is true" do
+          @html_list.options[:link_active] = true
+          @html_list.link(@crumb, true).should =~ /<a /
+        end
+
+        it "returns crumb's text if the crumb has no url" do
+          @crumb.url = nil
+          @html_list.link(@crumb).should == @crumb.text
+        end
+
+        it "returns crumb's text if the crumb is active and link_active is false" do
+          @html_list.link(@crumb, true).should == @crumb.text
+        end
+      end
+
+      describe "#divider" do
+        it "returns the HTML list divider" do
+          HTMLList.new.divider.should == '<span class="divider">/</span>'
+        end
+      end
+    end
+
+  end
+end

data/spec/ariane/render/html_spec.rb

@@ -0,0 +1,128 @@
+require 'ariane/render/html'
+
+module Ariane
+  module Render
+
+    describe HTML do
+      it "has an output_buffer" do
+        HTML.new.respond_to?(:output_buffer)
+      end
+
+      it "has a setter for the output_buffer" do
+        HTML.new.respond_to?(:"output_buffer=")
+      end
+
+      describe "#initialize" do
+        it "sets default options" do
+          HTML.new.options[:list_class].should == 'breadcrumb'
+        end
+
+        it "merges the options passed as argument to the default ones" do
+          html = HTML.new(list_id: 'test')
+          html.options[:list_id].should    == 'test'
+          html.options[:list_class].should == 'breadcrumb'
+        end
+
+        it "calls uses Base default options" do
+          HTML.new.options[:divider].should == ' / '
+        end
+      end
+
+      describe "#render" do
+        it "returns an html_safe string" do
+          html = HTML.new
+          html.stub(:list).and_return('test')
+          html.render([]).html_safe?.should be_true
+        end
+      end
+
+      describe "#list" do
+        it "returns an HTML paragraph with list_id and list_class" do
+          html = HTML.new(list_id: 'test')
+          html.list([]).should == '<p class="breadcrumb" id="test"></p>'
+        end
+
+        it "returns an HTML paragraph containing crumbs" do
+          html   = HTML.new
+          crumbs = [Crumb.new('text1', 'url1'), Crumb.new('text2', 'url2')]
+          html.list(crumbs).should == '<p class="breadcrumb"><a href="url1">text1</a> / text2</p>'
+        end
+      end
+
+      describe "#items" do
+        it "returns all crumbs in a formatted form" do
+          html   = HTML.new
+          crumbs = [Crumb.new('text1', 'url1'), Crumb.new('text2', 'url2')]
+          html.items(crumbs).should == '<a href="url1">text1</a> / text2'
+        end
+
+        it "sets the active flag for the last item" do
+          html   = HTML.new
+          crumbs = [Crumb.new('text', 'url'), Crumb.new('text', 'url')]
+          html.should_receive(:item).with(crumbs.first, false).and_return('')
+          html.should_receive(:item).with(crumbs.last, true).and_return('')
+          html.items(crumbs)
+        end
+      end
+
+      describe "#item" do
+        before :each do
+          @html  = HTML.new
+          @crumb = Crumb.new 'text', 'url'
+        end
+
+        it "returns the crumb in a formatted form" do
+          @html.item(@crumb).should =~ %r[^<a href="url">text</a>]
+        end
+
+        it "appends the divider to the crumb" do
+          @html.item(@crumb).should =~ %r[ / $]
+        end
+
+        it "does not append the divider if the crumb is active" do
+          @html.item(@crumb, true).should_not =~ %r[ / $]
+        end
+      end
+
+      describe "#link" do
+        before do
+          @html  = HTML.new
+          @crumb = Crumb.new 'text', 'url'
+        end
+
+        it "returns the link for the crumb" do
+          @html.link(@crumb).should == '<a href="url">text</a>'
+        end
+
+        it "sets the link class" do
+          @html.options[:link_class] = 'test'
+          @html.link(@crumb).should == '<a href="url" class="test">text</a>'
+        end
+
+        it "sets the active class when the crumb is active and link_active is true" do
+          @html.options[:link_active] = true
+          @html.link(@crumb, true).should == '<a href="url" class="active">text</a>'
+        end
+
+        it "returns a link if the crumb has an url" do
+          @html.link(@crumb).should == '<a href="url">text</a>'
+        end
+
+        it "returns a link if the crumb is active and link_active is true" do
+          @html.options[:link_active] = true
+          @html.link(@crumb, true).should =~ /<a /
+        end
+
+        it "returns crumb's text if the crumb has no url" do
+          @crumb.url = nil
+          @html.link(@crumb).should == @crumb.text
+        end
+
+        it "returns crumb's text if the crumb is active and link_active is false" do
+          @html.link(@crumb, true).should == @crumb.text
+        end
+      end
+    end
+
+  end
+end

data/spec/ariane_spec.rb

@@ -0,0 +1,52 @@
+require 'ariane'
+
+describe Ariane do
+  before :each do
+    Ariane.request_env      = {}
+    Ariane.default_renderer = nil
+  end
+
+  describe "#configure" do
+    it "passes Ariane to the given block" do
+      Ariane.configure do |config|
+        config.default_renderer = 'test_renderer'
+      end
+      Ariane.default_renderer.should == 'test_renderer'
+    end
+  end
+
+  describe "#request_env=" do
+    it "sets the breacrumb env variable" do
+      Ariane.request_env = {}
+      Ariane.request_env[:breadcrumb].should_not be_nil
+    end
+  end
+
+  describe "#breadcrumb" do
+    it "returns the breadcrumb from the request_env" do
+      Ariane.request_env[:breadcrumb] = "test_breadcrumb"
+      Ariane.breadcrumb.should == "test_breadcrumb"
+    end
+  end
+
+  describe "#breadcrumb=" do
+    it "sets the breadcrumb in the request_env" do
+      Ariane.breadcrumb = "test_breadcrumb"
+      Ariane.request_env[:breadcrumb].should == "test_breadcrumb"
+    end
+  end
+
+  describe "#default_renderer" do
+    it "returns the default renderer" do
+      Ariane.default_renderer = "test_renderer"
+      Ariane.default_renderer.should == "test_renderer"
+    end
+  end
+
+  describe "#default_renderer=" do
+    it "instanciates the renderer if a class is passed" do
+      Ariane.default_renderer = String
+      Ariane.default_renderer.should == ""
+    end
+  end
+end

metadata

@@ -0,0 +1,109 @@
+--- !ruby/object:Gem::Specification
+name: ariane
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Simon COURTOIS
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-02-26 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: actionpack
+  requirement: &70152268031300 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 2.3.0
+  type: :runtime
+  prerelease: false
+  version_requirements: *70152268031300
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: &70152268059680 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 2.3.0
+  type: :runtime
+  prerelease: false
+  version_requirements: *70152268059680
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &70152268059280 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70152268059280
+description: Ariane is a flexible breadcrumb system for Rails. It is fully compatible
+  with the Twitter Bootstrap and can be adapted to any kind of output.
+email:
+- scourtois@cubyx.fr
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- COPYING
+- Gemfile
+- README.md
+- Rakefile
+- ariane.gemspec
+- lib/ariane.rb
+- lib/ariane/breadcrumb.rb
+- lib/ariane/crumb.rb
+- lib/ariane/rails.rb
+- lib/ariane/rails/controller_helper.rb
+- lib/ariane/rails/view_helper.rb
+- lib/ariane/render.rb
+- lib/ariane/render/base.rb
+- lib/ariane/render/html.rb
+- lib/ariane/render/html_list.rb
+- lib/ariane/version.rb
+- spec/ariane/breadcrumb_spec.rb
+- spec/ariane/crumb_spec.rb
+- spec/ariane/render/base_spec.rb
+- spec/ariane/render/html_list_spec.rb
+- spec/ariane/render/html_spec.rb
+- spec/ariane_spec.rb
+homepage: http://github.com/simonc/ariane
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.10
+signing_key: 
+specification_version: 3
+summary: A flexible breadcrumb system for Rails, fully compatible with the Twitter
+  Bootstrap.
+test_files:
+- spec/ariane/breadcrumb_spec.rb
+- spec/ariane/crumb_spec.rb
+- spec/ariane/render/base_spec.rb
+- spec/ariane/render/html_list_spec.rb
+- spec/ariane/render/html_spec.rb
+- spec/ariane_spec.rb