jeremyf-gretel 0.4.2

data/README.textile

@@ -0,0 +1,30 @@
+h1. Gretel
+
+A painfully simple tool for generating Rails based breadcrumbs.
+
+*Given*
+<pre>
+  Widget.find(1).to_s == 'widget named sue'
+</pre>
+*and*
+<pre>
+  Routed Resource of :widgets
+</pre>
+
+*When*
+<pre>
+  Gretel.new('/widgets/1').to_s
+</pre>
+
+*Then we get the following HTML*
+<pre>
+<code>
+  <div id="breadcrumb_trail">
+    <p>
+      <a href='/'>home</a> &raquo; 
+      <a href="/widgets">widgets</a> &raquo; 
+      <a href="/widgets/1">widget named sue</a>
+    </p>
+  </div>
+</code>
+</pre>

data/lib/gretel.rb

@@ -0,0 +1,5 @@
+module Gretel
+end
+require 'forwardable'
+require File.dirname(__FILE__) + '/gretel/builder'
+require File.dirname(__FILE__) + '/gretel/model_extractor'

data/lib/gretel/builder.rb

@@ -0,0 +1,52 @@
+module Gretel
+  
+  def self.new(*args)
+    Builder.new(*args)
+  end
+  
+  # The BreadcrumbTrail is responsible for building a breadcrumb.  This
+  # class specializes in extracting paths from the nested URLs.
+  #
+  # The heavy lifting of extracting an object is delegated to the ModelExtractor.
+  #
+  class Builder
+    extend Forwardable
+    def_delegator :model_extractor, :extract_from_path, :extract_model_from_path
+    attr_reader :request_path, :separator, :dom_id
+
+    def initialize(request_path = nil, options = {})
+
+      @request_path = request_path
+      @separator = options[:separator] || '»'
+      @dom_id = options[:dom_id] || 'breadcrumb_trail'
+    end
+
+    def to_s
+      levels = request_path.split('?')[0].split('/')
+      levels.delete_at(0)
+
+      links = "<a href='/'>home</a>"
+
+      levels.each_with_index do |level, index|
+        text, href = extract_text_and_href(level, levels[0..index])
+        links += %( #{separator} <a href="#{href}">#{text.to_s.downcase}</a>)
+      end
+
+      %(
+      <div id="#{dom_id}">
+      <p>#{links}</p>
+      </div>
+      )
+    end
+
+    protected
+    def extract_text_and_href(text, href_elements)
+      path = File.join("/", href_elements.join('/'))
+      return [extract_model_from_path(path) || text.downcase.gsub('_', ' '), path]
+    end
+
+    def model_extractor
+      ModelExtractor
+    end
+  end
+end

data/lib/gretel/model_extractor.rb

@@ -0,0 +1,26 @@
+module Gretel
+  module ModelExtractor  
+    def self.extract_from_path(path)
+      return nil unless path.split('?')[0].match(/\/\d+$/) # There is no singular object at this location
+      return nil unless options = ActionController::Routing::Routes.recognize_path(path, :method => :get)
+
+      model_name = begin
+        options[:controller].split('/').last.singularize.camelize.constantize
+      rescue 
+        return nil unless controller = extract_controller_class_from(options)
+        return nil unless controller.respond_to?(:model_name)
+        controller.model_name
+      end
+      model_name.find_by_id(options[:id])
+    rescue ActionController::RoutingError, ActiveRecord::RecordNotFound => e
+      return nil
+    end
+
+    protected
+      def self.extract_controller_class_from(options)
+        "#{options[:controller].camelize}Controller".constantize
+      rescue
+        nil
+      end
+  end
+end

metadata

@@ -0,0 +1,76 @@
+--- !ruby/object:Gem::Specification 
+name: jeremyf-gretel
+version: !ruby/object:Gem::Version 
+  version: 0.4.2
+platform: ruby
+authors: 
+- Jeremy Friesen
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-09-15 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rails
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 2.1.0
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: mocha
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.5.6
+    version: 
+description: A rather simple gem for generating breadcrumbs in a Rails project
+email: jeremyf@lightsky.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.textile
+files: 
+- lib/gretel/builder.rb
+- lib/gretel/model_extractor.rb
+- lib/gretel.rb
+- README.textile
+has_rdoc: true
+homepage: http://github.com/jeremyf/gretel
+post_install_message: 
+rdoc_options: 
+- --main
+- README.textile
+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.2.0
+signing_key: 
+specification_version: 2
+summary: A rather simple gem for generating breadcrumbs
+test_files: []
+