padrino-contrib 0.1.13 → 0.2.0

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    OGM1NTY5NDMyOWVkZDVhNGZkZjQxNTRkMzYzNDEzZDY1ODFmZWZiOQ==
+  data.tar.gz: !binary |-
+    MzJkM2EyN2EwOWQ4NjAzNWMwMWM4MzI4N2U1OTA1NzE5Yzk2MWE4Nw==
+!binary "U0hBNTEy":
+  metadata.gz: !binary |-
+    YjdmODEyZjQ3MmE5OGE4Y2ZmMGE2MGEyNTk3NTFhMTA4YTlkZWMxMzg4ZjYw
+    ZTQ0NDUwN2RjNjk5OGUzMzAxODg1NmU2NmRmYzYyOTA0MTU1ZTc3ZmFmNmRi
+    ZmNiYzA2OTQ0YTRhMjk3MGVkMjk0OTU3MjI0MWE5NTIzNDMzYWI=
+  data.tar.gz: !binary |-
+    ODk0ZDk5ZmE5OWQ2ODY2YjU5ZmFhYmM4MGFjZDFhYmQ4YWJlYjJjN2FmMGNm
+    YWM5NTFhNDg5YTM5YTZmNzYxNjIwYTI3ZTEzZjU0NTVmYzc2NWU2ODU1YjUx
+    MWE5ZDcxYWYyMTA2OTY0Mzk2MWJjOWIwZWEwODIzMzFjNmRjZDU=

data/.gitignore

@@ -2,3 +2,5 @@
 .bundle
 Gemfile.lock
 pkg/*
+*.swp
+*.swo

data/.travis.yml

@@ -0,0 +1,7 @@
+lang: ruby
+rvm:
+  - 1.8.7
+  - 1.9.3
+  - 2.0.0
+  - rbx-18mode
+  - jruby-19mode

data/Gemfile

@@ -1,4 +1,23 @@
-source "http://rubygems.org"
+source "https://rubygems.org"
 
 # Specify your gem's dependencies in padrino-contrib.gemspec
 gemspec
+
+gem 'i18n'
+
+group :development do
+  gem 'rake'
+end
+
+group :test, :development do
+  gem 'pry-debugger' unless ENV['TRAVIS']
+end
+
+group :test do
+  gem 'padrino-core'
+  gem 'padrino-helpers'
+  gem 'padrino-mailer'
+  gem 'rspec'
+  gem 'rack-test'
+  gem 'webrat'
+end

data/README.md

@@ -0,0 +1,38 @@
+# padrino-contrib
+
+## Contributed Plugins and Utilities
+
+This package includes a variety of add-on components for Padrino Framework:
+
+* breadcrumbs               - Simple breadcrumb navigation helpers
+* exception_notifier        - Send errors through mail or/and to redmine
+* auto_locale               - Switch for you automatically the I18n.locale
+* flash_session             - Middleware that help you in passing your session in the URI, when it should be in the cookie.
+* orm_ar_permalink          - Generate permalink for a specified column on ActiveRecord
+* orm_ar_permalink_i18n     - Generate permalink for a specified multi language column(s) on ActiveRecord
+* orm_ar_translate          - Translate for you your ActiveRecord columns
+* orm_mm_permalink          - Generate permalink for a specified column on MongoMapper
+* orm_mm_search             - Full text search in MongoMapper in specified columns
+* helpers_assets_compressor - Joins and compress your js/css with yui-compressor
+
+## Use
+
+In your Padrino project edit:
+
+```ruby
+# Gemfile
+gem 'padrino-contrib'
+
+# boot.rb
+require 'padrino-contrib/exception_notifier'
+# require 'padrino-contrib/orm/active_record/permalink'
+# require 'padrino-contrib/orm/active_record/textile'
+# require 'padrino-contrib/helpers/breadcrumbs'
+
+Padrino.load! # Remember to add contribs before that line!
+
+# app.rb
+class MyApp < Padrino::Application
+  register Padrino::Contrib::ExceptionNotifier
+end
+```

data/Rakefile

@@ -21,8 +21,7 @@ end
 task :release => :bump
 
 desc "Run complete application spec suite"
-RSpec::Core::RakeTask.new("spec") do |t|
-  t.skip_bundler = true
+RSpec::Core::RakeTask.new(:spec) do |t|
   t.pattern = './spec/**/*_spec.rb'
   t.rspec_opts = %w(-fs --color --fail-fast)
 end

data/lib/padrino-contrib.rb

@@ -9,6 +9,7 @@ module Padrino
       autoload :AssetsCompressor, 'padrino-contrib/helpers/assets_compressor.rb'
       autoload :JQuery, 'padrino-contrib/helpers/jquery.rb'
       autoload :Flash, 'padrino-contrib/helpers/flash.rb'
+      autoload :Breadcrumbs, 'padrino-contrib/helpers/breadcrumbs.rb'
     end # Helpers
   end # Contrib
 end # Padrino

data/lib/padrino-contrib/auto_locale.rb

@@ -9,6 +9,7 @@ module Padrino
     #   class MyApp < Padrino::Application
     #     register AutoLocale
     #     set :locales, [:en, :ru, :de] # First locale is the default locale
+    #     set :locale_exclusive_paths, ['/js', '/css', '/img'] # asset uri paths which shouldn't be localized
     #   end
     #
     #   # view.haml
@@ -22,7 +23,9 @@ module Padrino
         # This reload the page changing the I18n.locale
         #
         def switch_to_lang(lang)
-          request.path_info.sub(/\/#{I18n.locale}/, "/#{lang}") if settings.locales.include?(lang)
+          return unless settings.locales.include?(lang)
+          return url("/#{lang}", false) if request.path_info == '/'
+          url(request.path_info.sub(/\/#{I18n.locale}/, "/#{lang}"), false)
         end
       end # Helpers
 
@@ -30,17 +33,69 @@ module Padrino
         app.helpers Padrino::Contrib::AutoLocale::Helpers
         app.extend ClassMethods
         app.set :locales, [:en]
+        app.set :locale_exclusive_paths, []
+        @@exclusive_paths = false
         app.before do
+          # Gather excluded paths
+          unless @@exclusive_paths.is_a?(Array)
+            # auto include sinatra-assetpack configuration
+            if settings.respond_to?(:assets) and
+              settings.assets.respond_to?(:served) and
+              settings.assets.served.is_a?(Hash)
+              @@exclusive_paths = settings.locale_exclusive_paths + settings.assets.served.keys
+            else
+              @@exclusive_paths = settings.locale_exclusive_paths
+            end
+          end
+
+          # Default to the first locale
+          I18n.locale = settings.locales.first
+
+          # First check if the path starts with a known locale
           if request.path_info =~ /^\/(#{settings.locales.join('|')})\b/
             I18n.locale = $1.to_sym
+
+          # Then check if the path is excluded
+          elsif AutoLocale.excluded_path?(request.path_info, @@exclusive_paths)
+            next
+
+          # Root path "/" needs special treatment, as it doesn't contain any language parameter.
+          elsif request.path_info =~ /^\/?$/
+            # Try to guess the preferred language from the http header
+            for browser_locale in (request.env['HTTP_ACCEPT_LANGUAGE'] || '').split(",")
+              locale = browser_locale.split(";").first.downcase.sub('-', '_')
+              if settings.locales.include?(locale.to_sym)
+                I18n.locale = locale.to_sym
+                break
+              end
+            end
+            # Then redirect from "/" to "/:lang" to match the new routing urls
+            redirect url("/#{I18n.locale.to_s}/", false)
+
+          # Return 404 not found for everything else
           else
-            I18n.locale = settings.locales[0]
-            not_found if request.path_info !~ /^\/?$/
+            not_found
           end
         end
 
         def self.padrino_route_added(route, verb, path, args, options, block)
-          route.instance_variable_set(:@original_path, "/:lang#{route.original_path}") unless route.original_path =~/:lang/
+          ##
+          # TODO: Regex original_path needs to be served as well.
+          #
+          return unless route.original_path.is_a?(String)
+          excluded_paths = block.binding.eval('settings').locale_exclusive_paths
+          return if AutoLocale.excluded_path?(route.original_path, excluded_paths)
+          route.path = "/:lang#{route.original_path}" unless route.original_path =~ /:lang/
+        end
+
+        def self.excluded_path?(path, excluded_paths)
+          excluded_paths.detect do |excluded_path|
+            if excluded_path.is_a?(Regexp)
+              !!excluded_path.match(path)
+            elsif excluded_path.is_a?(String)
+              path.start_with?(excluded_path.end_with?("/") ? excluded_path : "#{excluded_path}/")
+            end
+          end
         end
       end
 
@@ -50,7 +105,7 @@ module Padrino
         #
         def url(*args)
           params = args.extract_options!
-          params[:lang] = I18n.locale
+          params[:lang] ||= I18n.locale
           args << params
           super(*args)
         end

data/lib/padrino-contrib/exception_notifier.rb

@@ -23,16 +23,23 @@ module Padrino
         app.set :exceptions_subject, "Exception" unless app.respond_to?(:exceptions_subject)
         app.set :exceptions_to,      "errors@localhost.local" unless app.respond_to?(:exceptions_to)
         app.set :exceptions_from,    "foo@bar.local" unless app.respond_to?(:exceptions_from)
-        app.set :exceptions_layout,  :layout unless app.respond_to?(:exceptions_layout)
+        app.set :exceptions_layout,  :application unless app.respond_to?(:exceptions_layout)
         app.set :exceptions_views,   app.views unless app.respond_to?(:exceptions_views)
         app.set :redmine, {} unless app.respond_to?(:redmine)
+        app.set :exceptions_params_filter, ['password', 'password_confirmation'] unless app.respond_to?(:exceptions_params_filter)
         app.error 500 do
           boom  = env['sinatra.error']
           body  = ["#{boom.class} - #{boom.message}:", *boom.backtrace].join("\n  ")
           body += "\n\n---Env:\n"
           env.each { |k,v| body += "\n#{k}: #{v}" }
           body += "\n\n---Params:\n"
-          params.each { |k,v| body += "\n#{k.inspect} => #{v.inspect}" }
+          params.each do |k,v|
+            if settings.exceptions_params_filter.include?(k)
+              body += "\n#{k.inspect} => [FILTERED]"
+            else
+              body += "\n#{k.inspect} => #{v.inspect}"
+            end
+          end
           logger.error body
           settings.redmine.each { |k,v| body += "\n#{k.to_s.capitalize}: #{v}" }
           app.email do
@@ -45,7 +52,7 @@ module Padrino
           content_type 'text/html', :charset => "utf-8"
           render settings.exceptions_page, :layout => settings.exceptions_layout, :views => settings.exceptions_views
         end
-        app.error 404 do
+        app.not_found do
           response.status = 404
           content_type 'text/html', :charset => "utf-8"
           render settings.exceptions_page, :layout => settings.exceptions_layout, :views => settings.exceptions_views

data/lib/padrino-contrib/helpers/breadcrumbs.rb

@@ -0,0 +1,185 @@
+module Padrino
+  module Contrib
+    module Helpers
+      class Breadcrumb
+        attr_accessor :home, :items
+  
+        DEFAULT_URL = "/"
+        DEFAULT_CAPTION ="Home Page"
+  
+        ##
+        # Initialize breadcrumbs with default value.
+        #
+        # @example
+        #   before do
+        #     @breadcrumbs = breadcrumbs.new
+        #   end
+        #
+        def initialize
+          reset!
+        end
+  
+        ##
+        # Set the custom home (Parent) link.
+        #
+        # @param [String] url
+        #  The url href.
+        #
+        # @param [String] caption
+        #   The  text caption.
+        #
+        # @param [Hash] options
+        #   The HTML options to include in li.
+        #
+        # @example
+        #   breadcrumbs.set_home "/HomeFoo", "Foo Home", :id => "home-breadcrumb"
+        #
+        def set_home(url, caption, options = {})
+          self.home = {
+            :url     => url.to_s,
+            :caption => caption.to_s.humanize.html_safe,
+            :name    => :home,
+            :options => options
+          }
+          reset
+        end
+  
+        ##
+        # Reset breadcrumbs to default or personal home.
+        #
+        # @example
+        #   breadcrumbs.reset
+        #
+        def reset
+          self.items = []
+          self.items << home
+        end
+  
+        ##
+        # Reset breadcrumbs to default home.
+        #
+        # @example
+        #   breadcrumbs.reset!
+        #
+        def reset!
+          self.home = {
+            :name    => :home,
+            :url     => DEFAULT_URL,
+            :caption => DEFAULT_CAPTION,
+            :options => {}
+          }
+          reset
+        end
+  
+        ##
+        # Add a new breadcrumbs.
+        #
+        # @param [String] name
+        #   The name of resource.
+        # @param [Symbol] name
+        #   The name of resource.
+        #
+        # @param [String] url
+        #   The url href.
+        #
+        # @param [String] caption
+        #   The text caption.
+        #
+        # @param [Hash] options
+        #   The HTML options to include in li.
+        #
+        # @example
+        #   breadcrumbs.add "foo", "/foo", "Foo Link", :id => "foo-id"
+        #   breadcrumbs.add :foo, "/foo", "Foo Link", :class => "foo-class"
+        #
+        def add(name, url, caption, options = {})
+          items << {
+            :name    => name.to_sym,
+            :url     => url.to_s,
+            :caption => caption.to_s.humanize.html_safe,
+            :options => options
+          }
+        end
+        alias :<< :add
+  
+        ##
+        # Remove a breadcrumb.
+        #
+        # @param [String] name
+        #  The name of resource to delete from breadcrumbs list.
+        #
+        # @example
+        #   breadcrumbs.del "foo"
+        #   breadcrumbs.del :foo
+        #
+        def del(name)
+          items.delete_if { |item| item[:name] == name.to_sym }
+        end
+      end # Breadcrumb
+  
+      module Breadcrumbs
+        ##
+        # Render breadcrumbs to view.
+        #
+        # @param [Breadcrumbs] breadcrumbs
+        #   The breadcrumbs to render into view.
+        #
+        # @param [Boolean] bootstrap
+        #  If true, render separation (useful with Twitter Bootstrap).
+        #
+        # @param [String] active
+        #  CSS class style set to active breadcrumb.
+        #
+        # @param [Hash] options
+        #   The HTML options to include in ul.
+        #
+        # @return [String] Unordered list with breadcrumbs
+        #
+        # @example
+        #  = breadcrumbs @breacrumbs
+        #  # Generates:
+        #  # <ul>
+        #  #   <li><a href="/foo">Foo Link</a></li>
+        #  #   <li class="active"><a href="/bar">Bar Link</a></li>
+        #  # </ul>
+        #
+        def breadcrumbs(breadcrumbs, bootstrap = false, active = "active", options = {})
+          content = ActiveSupport::SafeBuffer.new
+          breadcrumbs.items[0..-2].each do |item|
+            content << render_item(item, bootstrap)
+          end
+          last = breadcrumbs.items.last
+          last_options = last[:options]
+          last = link_to(last[:caption], last[:url])
+  
+          classes = [options[:class], last_options[:class]].map { |class_name| class_name.to_s.split(/\s/) }
+          classes[0] << "breadcrumb"
+          classes[1] << active if active
+          options[:class], last_options[:class] = classes.map { |class_name| class_name * " " }
+  
+          content << content_tag(:li, last, last_options)
+          content_tag(:ul, content, options)
+        end
+  
+        private
+        ##
+        # Private method to return list item.
+        #
+        # @param [Hash] item
+        #   The breadcrumb item.
+        #
+        # @param [Boolean] bootstrap
+        #   If true, render separation (useful with Twitter Bootstrap).
+        #
+        # @return [String] List item with breadcrumb
+        #
+        def render_item(item, bootstrap)
+          content = ActiveSupport::SafeBuffer.new
+          content << link_to(item[:caption], item[:url])
+          content << content_tag(:span, "/", :class => "divider") if bootstrap
+          content_tag(:li, content, item[:options])
+        end
+      end # Breadcrumbs
+    end # Helpers
+  end # Contrib
+end # Padrino

data/lib/padrino-contrib/version.rb

@@ -1,5 +1,5 @@
 module Padrino
   module Contrib
-    VERSION = '0.1.13'
+    VERSION = '0.2.0'
   end
 end

data/spec/auto_locale_spec.rb

@@ -0,0 +1,126 @@
+require 'spec_helper'
+
+describe Padrino::Contrib::AutoLocale do
+  before :all do
+    mock_app {
+      register Padrino::Contrib::AutoLocale
+      set :locales, [ :es, :en, :ru ]
+
+      get('/') { 'root' }
+      get('/bar') { 'bar' }
+      get(:foo) { 'foo' }
+    }
+  end
+  after(:each) { I18n.locale = I18n.default_locale }
+
+  describe 'when requesting a localized path' do
+    it 'sets I18n.locale to the requested locale' do
+      expect { get '/ru' }.to change { I18n.locale }.to :ru
+    end
+
+    it 'returns 404 if requesting an unsupported locale' do
+      get '/ja'
+      expect(last_response).to be_not_found
+    end
+  end
+
+  describe "when requesting the root path '/'" do
+    it 'redirects to the default locale' do
+      get '/'
+      expect(last_response).to be_redirect
+      follow_redirect!
+      expect(last_request.path_info).to eq "/#{@app.locales.first}/"
+    end
+
+    it 'sets I18n.locale to the first locale' do
+      expect { get '/' }.to change { I18n.locale }.to @app.locales.first
+    end
+
+    it "doesn't choke when the HTTP_ACCEPT_LANGUAGE header is not present" do
+      expect do
+        get '/', { }, 'HTTP_ACCEPT_LANGUAGE' => nil
+      end.not_to raise_exception NoMethodError
+    end
+  end
+
+  describe 'when setting locale_exclusive_paths' do
+    before :each do
+      mock_app {
+        register Padrino::Contrib::AutoLocale
+        set :locales, [ :es, :en ]
+        set :locale_exclusive_paths, [ '/unlocalized' ]
+        get('/bar') { 'bar' }
+        get('/unlocalized/path') { 'unlocalized path' }
+      }
+    end
+
+    it 'returns 404 if the path is not excluded' do
+      get '/bar'
+      expect(last_response).to be_not_found
+    end
+
+    context 'when the path is excluded' do
+      it 'does not prepend :lang to the route' do
+        expect(@app.routes.last.original_path).not_to match /:lang/
+      end
+
+      it 'lets the request through' do
+        get '/unlocalized/path'
+        expect(last_response).to be_ok
+        expect(last_response.body).to eq 'unlocalized path'
+      end
+
+      it 'sets I18n.locale to the first locale' do
+        expect { get '/unlocalized/path' }.to change { I18n.locale }.to @app.locales.first
+      end
+    end
+
+    it 'allows excluding the root path "/"' do
+      @app.locale_exclusive_paths << /^\/?$/
+      @app.get('/') { 'root path' }
+      get '/'
+      expect(last_response).not_to be_redirect
+      expect(last_response.body).to eq 'root path'
+    end
+  end
+
+  describe 'overloaded #url' do
+    before(:each) { get '/en' }
+
+    it 'prepends the current lang' do
+      expect(@app.url(:foo)).to eq '/en/foo'
+    end
+
+    it 'allows overriding lang' do
+      expect(@app.url(:foo, :lang => 'ru')).to eq '/ru/foo'
+    end
+  end
+
+  describe '#switch_to_lang' do
+    before :all do
+      mock_app {
+        register Padrino::Contrib::AutoLocale
+        set :locales, [ :es, :en ]
+        set :locale_exclusive_paths, [ /^\/?$/, '/unlocalized' ]
+
+        get('/(:lang)') { switch_to_lang(:en) }
+        get('/unlocalized/path') { switch_to_lang(:en) }
+      }
+    end
+
+    it 'returns the current localized path switched to the requested lang' do
+      get '/es'
+      expect(last_response.body).to eq '/en'
+    end
+
+    it 'switches the unlocalized root path to the requested lang' do
+      get '/'
+      expect(last_response.body).to eq '/en'
+    end
+
+    it 'returns the same path if the path is not localized' do
+      get '/unlocalized/path'
+      expect(last_response.body).to eq '/unlocalized/path'
+    end
+  end
+end

data/spec/breadcrumb_helpers_spec.rb

@@ -0,0 +1,133 @@
+require 'spec_helper'
+
+describe "BreadcrumbHelpers" do
+  include Padrino::Helpers::OutputHelpers
+  include Padrino::Helpers::TagHelpers
+  include Padrino::Helpers::AssetTagHelpers
+  include Padrino::Contrib::Helpers::Breadcrumbs
+
+  let(:breadcrumb){ Padrino::Helpers::Breadcrumb.new }
+  after(:each) { breadcrumb.reset! }
+
+  describe "for Breadcrumbs#breadcrumbs method" do
+    it 'should support breadcrumbs which is Padrino::Helpers::Breadcrumbs instance.' do
+      breadcrumb.add "foo", "/foo", "foo link"
+      expect(breadcrumbs(breadcrumb)).to have_selector(:a, :content => "Foo link", :href => "/foo")
+    end
+
+    it 'should support bootstrap' do
+      breadcrumb.add "foo", "/foo", "foo link"
+      expect(breadcrumbs(breadcrumb, true)).to have_selector(:span, :content => "/", :class => "divider")
+    end
+
+    it 'should support active' do
+      breadcrumb.add "foo", "/foo", "foo link"
+      expect(breadcrumbs(breadcrumb, nil, "custom-active")).to have_selector(:li, :class => "custom-active")
+    end
+
+    it 'should support options' do
+      actual_html = breadcrumbs(breadcrumb, nil, nil, :id => "breadcrumbs-id", :class => "breadcrumbs-class")
+      expect(actual_html).to have_selector(:ul, :class => "breadcrumbs-class breadcrumb", :id => "breadcrumbs-id")
+    end
+  end
+
+  describe "for #add method" do
+    it 'should support name of string and symbol type' do
+      breadcrumb.add "foo", "/foo", "Foo Link"
+      breadcrumb.add :bar, "/bar", "Bar Link"
+
+      actual_html = breadcrumbs(breadcrumb)
+      expect(actual_html).to have_selector(:a, :content => "Foo link", :href => "/foo")
+      expect(actual_html).to have_selector(:a, :content => "Bar link", :href => "/bar")
+    end
+
+    it 'should support url' do
+      breadcrumb.add :foo, "/foo", "Foo Link"
+      expect(breadcrumbs(breadcrumb)).to have_selector(:a, :href => "/foo")
+    end
+
+    it 'should support caption' do
+      breadcrumb.add :foo, "/foo", "Foo Link"
+      expect(breadcrumbs(breadcrumb)).to have_selector(:a, :content => "Foo link")
+    end
+
+    it 'should support options' do
+      breadcrumb.add :foo, "/foo", "Foo Link", :id => "foo-id", :class => "foo-class"
+      breadcrumb.add :bar, "/bar", "Bar Link", :id => "bar-id", :class => "bar-class"
+
+      actual_html = breadcrumbs(breadcrumb)
+      expect(actual_html).to have_selector(:li, :class => "foo-class", :id => "foo-id")
+      expect(actual_html).to have_selector(:li, :class => "bar-class active", :id => "bar-id")
+    end
+  end
+
+  describe "for #del method" do
+    it 'should support name of string type' do
+      breadcrumb.add "foo", "/foo", "Foo Link"
+      breadcrumb.add :bar, "/bar", "Bar Link"
+
+      breadcrumb.del "foo"
+      breadcrumb.del "bar"
+
+      actual_html = breadcrumbs(breadcrumb)
+      expect(actual_html).not_to have_selector(:a, :content => "Foo link", :href => "/foo")
+      expect(actual_html).not_to have_selector(:a, :content => "Bar link", :href => "/bar")
+    end
+
+    it 'should support name of symbol type' do
+      breadcrumb.add "foo", "/foo", "Foo Link"
+      breadcrumb.add :bar, "/bar", "Bar Link"
+
+      breadcrumb.del :foo
+      breadcrumb.del :bar
+
+      actual_html = breadcrumbs(breadcrumb)
+      expect(actual_html).not_to have_selector(:a, :content => "Foo link", :href => "/foo")
+      expect(actual_html).not_to have_selector(:a, :content => "Bar link", :href => "/bar")
+    end
+  end
+
+  describe "for #set_home method" do
+    it 'should modified home item elements.' do
+      breadcrumb.set_home("/custom", "Custom Home Page")
+      expect(breadcrumbs(breadcrumb)).to have_selector(:a, :content => "Custom home page", :href => "/custom")
+    end
+
+    it 'should support options' do
+      breadcrumb.set_home("/custom", "Custom Home Page", :id => "home-id")
+
+      actual_html = breadcrumbs(breadcrumb)
+      expect(actual_html).to have_selector(:li, :id => "home-id")
+      expect(actual_html).to have_selector(:a, :content => "Custom home page", :href => "/custom")
+    end
+  end
+
+  describe "for #reset method" do
+    it 'should be #items which contains only home item.' do
+      breadcrumb.set_home("/custom", "Custom Home Page")
+      breadcrumb.add "foo", "/foo", "Foo Link"
+      breadcrumb.add :bar, "/bar", "Bar Link"
+
+      breadcrumb.reset
+
+      actual_html = breadcrumbs(breadcrumb)
+      expect(actual_html).to have_selector(:a, :content => "Custom home page", :href => "/custom")
+      expect(actual_html).not_to have_selector(:a, :content => "Foo link", :href => "/foo")
+      expect(actual_html).not_to have_selector(:a, :content => "Bar link", :href => "/bar")
+    end
+  end
+
+  describe "for #reset! method" do
+    it 'should be #items which contains only default home item.' do
+      breadcrumb.add "foo", "/foo", "foo link"
+      breadcrumb.add :bar, "/bar", "Bar Link"
+
+      breadcrumb.reset!
+
+      actual_html = breadcrumbs(breadcrumb)
+      expect(actual_html).to have_selector(:a, :content => "Home Page", :href => "/")
+      expect(actual_html).not_to have_selector(:a, :content => "Foo link", :href => "/foo")
+      expect(actual_html).not_to have_selector(:a, :content => "Bar link", :href => "/bar")
+    end
+  end
+end

data/spec/exception_notifier_spec.rb

@@ -0,0 +1,102 @@
+require 'spec_helper'
+require 'mail'
+
+describe Padrino::Contrib::ExceptionNotifier do
+  before :each do
+    mock_app {
+      register Padrino::Helpers
+      register Padrino::Mailer
+      set :delivery_method, :test => { } # Resembles a more realistic SMTP configuration
+      register Padrino::Contrib::ExceptionNotifier
+      set :exceptions_views, Padrino.root('views/exception_notifier')
+      set :exceptions_page, 'errors.erb'
+      set :exceptions_layout, "layout.erb"
+
+      get(:boom) { 420 / 0 }
+    }
+  end
+
+  def last_email
+    Mail::TestMailer.deliveries.last
+  end
+
+  context 'when an exception is raised' do
+    it 'sends a notification email' do
+      expect { get '/boom' }.to change { Mail::TestMailer.deliveries }
+      expect(last_email.subject).to eq '[Exception] ZeroDivisionError - divided by 0'
+      expect(last_email.to).to eq [ 'errors@localhost.local' ]
+      expect(last_email.from).to eq [ 'foo@bar.local' ]
+    end
+
+    it 'allows customizing the email subject' do
+      @app.set :exceptions_subject, 'Custom subject'
+      get '/boom'
+      expect(last_email.subject).to eq '[Custom subject] ZeroDivisionError - divided by 0'
+    end
+
+    it 'allows customizing the recipients' do
+      @app.set :exceptions_to, 'Foo <foo@example.com>, bar@example.com'
+      get '/boom'
+      expect(last_email.to).to eq [ 'foo@example.com', 'bar@example.com' ]
+    end
+
+    it 'allows customizing the sender' do
+      @app.set :exceptions_from, 'Foo <foo@example.com>'
+      get '/boom'
+      expect(last_email.from).to eq [ 'foo@example.com' ]
+    end
+
+    it 'sends the request params' do
+      get '/boom', :foo => 'bar'
+      expect(last_email.body).to match /"foo" => "bar"/
+    end
+
+    it 'filters out password and password_confirmation params' do
+      get '/boom', :password => 'super_secret', :password_confirmation => 'super_secret'
+      expect(last_email.body).to match /"password" => \[FILTERED\]/
+      expect(last_email.body).to match /"password_confirmation" => \[FILTERED\]/
+    end
+
+    it 'allows customizing filtered params' do
+      @app.set :exceptions_params_filter, [ 'foo' ]
+      get '/boom', :foo => 'bar'
+      expect(last_email.body).to match /"foo" => \[FILTERED\]/
+    end
+
+    it 'renders an error page' do
+      get '/boom'
+      expect(last_response.status).to eq 500
+      expect(last_response.body).to eq "Exceptions layout\n500"
+    end
+
+    it 'allows customizing the error layout' do
+      @app.set :exceptions_layout, nil
+      get '/boom'
+      expect(last_response.body).to eq '500'
+    end
+
+    it 'requires a view to be configured for the error page' do
+      @app.instance_eval { undef :exceptions_page }
+      expect { get '/boom' }.to raise_exception NoMethodError
+    end
+  end
+
+  context 'when a 404 is returned' do
+    it 'renders an error page' do
+      get '/not_found'
+      expect(last_response.status).to eq 404
+      expect(last_response.body).to eq "Exceptions layout\n404"
+    end
+
+    it 'allows customizing the error layout' do
+      @app.set :exceptions_layout, nil
+      get '/not_found'
+      expect(last_response.body).to eq '404'
+    end
+
+    it 'requires a view to be configured for the error page' do
+      @app.instance_eval { undef :exceptions_page }
+      expect { get '/not_found' }.to raise_exception NoMethodError
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -1,3 +1,23 @@
+PADRINO_ENV = 'test'
+PADRINO_ROOT = File.dirname(__FILE__) unless defined?(PADRINO_ROOT)
 require 'rubygems' unless defined?(Gem)
-require 'rspec'    unless defined?(RSpec)
+require 'bundler'
+Bundler.require(:default, PADRINO_ENV)
+
 require 'padrino-contrib'
+
+RSpec.configure do |config|
+  config.include Rack::Test::Methods
+  config.include Webrat::Matchers
+
+  # Sets up a Sinatra::Base subclass defined with the block
+  # given. Used in setup or individual spec methods to establish
+  # the application.
+  def mock_app(base=Padrino::Application, &block)
+    @app = Sinatra.new(base, &block)
+  end
+
+  def app
+    @app
+  end
+end

data/spec/views/exception_notifier/errors.erb

@@ -0,0 +1 @@
+<%= response.status %>

data/spec/views/exception_notifier/layouts/layout.erb

@@ -0,0 +1,2 @@
+Exceptions layout
+<%= yield %>

metadata

@@ -1,44 +1,35 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: padrino-contrib
-version: !ruby/object:Gem::Version 
-  hash: 1
-  prerelease: 
-  segments: 
-  - 0
-  - 1
-  - 13
-  version: 0.1.13
+version: !ruby/object:Gem::Version
+  version: 0.2.0
 platform: ruby
-authors: 
+authors:
 - Davide D'Agostino
 - Nathan Esquenazi
 - Arthur Chiu
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2012-02-14 00:00:00 Z
+date: 2014-08-14 00:00:00.000000000 Z
 dependencies: []
-
 description: Contributed plugins and utilities for the Padrino Ruby Web Framework
 email: padrinorb@gmail.com
 executables: []
-
 extensions: []
-
 extra_rdoc_files: []
-
-files: 
+files:
 - .gitignore
+- .travis.yml
 - Gemfile
 - LICENSE
-- README.rdoc
+- README.md
 - Rakefile
 - lib/padrino-contrib.rb
 - lib/padrino-contrib/auto_locale.rb
 - lib/padrino-contrib/exception_notifier.rb
 - lib/padrino-contrib/flash_session.rb
 - lib/padrino-contrib/helpers/assets_compressor.rb
+- lib/padrino-contrib/helpers/breadcrumbs.rb
 - lib/padrino-contrib/helpers/flash.rb
 - lib/padrino-contrib/helpers/jquery.rb
 - lib/padrino-contrib/orm/active_record/permalink.rb
@@ -49,42 +40,41 @@ files:
 - lib/padrino-contrib/orm/mongo_mapper/search.rb
 - lib/padrino-contrib/version.rb
 - padrino-contrib.gemspec
+- spec/auto_locale_spec.rb
 - spec/autoload_spec.rb
+- spec/breadcrumb_helpers_spec.rb
+- spec/exception_notifier_spec.rb
 - spec/spec_helper.rb
+- spec/views/exception_notifier/errors.erb
+- spec/views/exception_notifier/layouts/layout.erb
 homepage: http://www.padrinorb.com
 licenses: []
-
+metadata: {}
 post_install_message: 
 rdoc_options: []
-
-require_paths: 
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
-  none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
-      - 0
-      version: "0"
-required_rubygems_version: !ruby/object:Gem::Requirement 
-  none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
-      - 0
-      version: "0"
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
 requirements: []
-
 rubyforge_project: padrino-contrib
-rubygems_version: 1.8.15
+rubygems_version: 2.0.7
 signing_key: 
-specification_version: 3
+specification_version: 4
 summary: Contributed plugins and utilities for Padrino Framework
-test_files: 
+test_files:
+- spec/auto_locale_spec.rb
 - spec/autoload_spec.rb
+- spec/breadcrumb_helpers_spec.rb
+- spec/exception_notifier_spec.rb
 - spec/spec_helper.rb
-has_rdoc: 
+- spec/views/exception_notifier/errors.erb
+- spec/views/exception_notifier/layouts/layout.erb

data/README.rdoc

@@ -1,32 +0,0 @@
-= Contributed Plugins and Utilities
-
-This package includes a variety of add-on components for Padrino Framework:
-
-*   exception_notifier        - Send errors through mail or/and to redmine
-*   auto_locale               - Switch for you automatically the I18n.locale
-*   flash_session             - Middleware that help you in passing your session in the URI, when it should be in the cookie.
-*   orm_ar_permalink          - Generate permalink for a specified column on ActiveRecord
-*   orm_ar_permalink_i18n     - Generate permalink for a specified multi language column(s) on ActiveRecord
-*   orm_ar_translate          - Translate for you your ActiveRecord columns
-*   orm_mm_permalink          - Generate permalink for a specified column on MongoMapper
-*   orm_mm_search             - Full text search in MongoMapper in specified columns
-*   helpers_assets_compressor - Joins and compress your js/css with yui-compressor
-
-=== Use
-
-In your Padrino project edit:
-
-  # Gemfile
-  gem 'padrino-contrib'
-
-  # boot.rb
-  require 'padrino-contrib/exception_notifier'
-  # require 'padrino-contrib/orm/active_record/permalink'
-  # require 'padrino-contrib/orm/active_record/textile'
-
-  Padrino.load! # Remember to add contribs before that line!
-
-  # app.rb
-  class MyApp < Padrino::Application
-    register Padrino::Contrib::ExceptionNotifier
-  end