breadcrumbs_on_rails 2.3.1 → 3.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f861ee1dec574febf12f825fdf42eb2724cd1533
-  data.tar.gz: 18113d4d55b083203257f36ed7c26326116f86e2
+  metadata.gz: ee122bb4062b89a562c760486bfa006531ad8d0d
+  data.tar.gz: 45ade515b86324c2bfe3062cc834876f7a7f5a75
 SHA512:
-  metadata.gz: 9b09772ae55aa3e5af148d774969e8729c16e69fe334963ee2909b3dfa5b59515b19b73d271c62d176b6a5eb61282d1ea8fb8021a6a5b46141414337b2800e00
-  data.tar.gz: ac31a1edcf7894c13da3382789e44082cfbfd9cb8503499bc55a0c6f9514c5b901c894f3b5e1f9bb5f6796d25683eaa55f479a42cb83a9b6e1d6550e2391f70a
+  metadata.gz: 70e1efd32dbc1a1f3b505763f2c577a311509faa46697661f95a1da0d1ca9234d17d06edd8d5837cf6c7e2ac63677c60134953f74b1db1f413f55b2dcac6d733
+  data.tar.gz: 2d14d97add461e23ef06dc50c18c0a2d88bd7f78472943a75dda59e2d5a114295dcc270cb27bd919a54658f4c382184fcfe3efa39c9f6305a7a1b4deb6d600f3

data/.ruby-version

@@ -1 +1 @@
-ruby-2.1
+2.3.1

data/.travis.yml

@@ -1,18 +1,25 @@
 rvm:
-  - 1.9.2
-  - 1.9.3
-  - 2.0.0
-  - 2.1.0
-  - 2.2.0
+  - 2.0
+  - 2.1
+  - 2.2.5
+  - 2.3.1
+
 gemfile:
-  - gemfiles/3.0.gemfile
-  - gemfiles/3.1.gemfile
-  - gemfiles/3.2.gemfile
   - gemfiles/4.0.gemfile
+  - gemfiles/4.1.gemfile
+  - gemfiles/4.2.gemfile
+  - gemfiles/5.0.gemfile
+
+before_install:
+  - gem install bundler
+
+matrix:
+  exclude:
+    - rvm: 2.0
+      gemfile: gemfiles/5.0.gemfile
+    - rvm: 2.1
+      gemfile: gemfiles/5.0.gemfile
+
 notifications:
   recipients:
     - weppos@weppos.net
-matrix:
-  exclude:
-    - rvm: 1.9.2
-      gemfile: gemfiles/4.0.gemfile

data/Appraisals

@@ -1,15 +1,12 @@
-appraise "3.0" do
-  gem "activerecord", "~> 3.0.0"
+appraise "4.0" do
+  gem "rails", "~> 4.0.0"
 end
-
-appraise "3.1" do
-  gem "activerecord", "~> 3.1.0"
+appraise "4.1" do
+  gem "rails", "~> 4.1.0"
 end
-
-appraise "3.2" do
-  gem "activerecord", "~> 3.2.0"
+appraise "4.2" do
+  gem "rails", "~> 4.2.0"
 end
-
-appraise "4.0" do
-  gem "activerecord", "~> 4.0.0"
+appraise "5.0" do
+  gem "rails", "~> 5.0.0"
 end

data/CHANGELOG.md

@@ -1,66 +1,73 @@
 # Changelog
 
-## Release 2.3.1
 
-- FIXED: Using `add_breadcrumbs` did not properly pass `options` (GH-46). [Thanks @link664]
+#### Release 3.0.0
+
+- FIXED: Fixed compatibility with Rails 5.0 (GH-80). [Thanks @ochko]
+- FIXED: Fixed initialization error (GH-75). [Thanks @soulcutter]
+- FIXED: Escape user input by default to avoid XSS attacks (GH-63). [Thanks @rdunlop]
 
+- CHANGED: Minimum requirements Rails >= 4 and Ruby >= 2.
 
-## Release 2.3.0
 
-* FIXED: In some circumstances the BreadcrumbsOnRails::ActionController::HelperMethods is not mixed into the controller.
+#### Release 2.3.1
+
+- FIXED: Using `add_breadcrumbs` did not properly pass `options` (GH-46). [Thanks @link664]
 
-* FIXED: Breadcrumbs now accepts a polymorphic path (GH-15).
 
-* CHANGED: Second argument on `add_breadcrumb` is now optional (GH-6, GH-32). [Thanks @mpartel]
+#### Release 2.3.0
 
-* CHANGED: Breadcrumb path computation fallbacks to url_for in case of unknown arguments.
+- FIXED: In some circumstances the BreadcrumbsOnRails::ActionController::HelperMethods is not mixed into the controller.
+- FIXED: Breadcrumbs now accepts a polymorphic path (GH-15).
 
+- CHANGED: Second argument on `add_breadcrumb` is now optional (GH-6, GH-32). [Thanks @mpartel]
+- CHANGED: Breadcrumb path computation fallbacks to url_for in case of unknown arguments.
 
-## Release 2.2.0
 
-* NEW: Support for Rails 3.2.
+#### Release 2.2.0
 
-* FIXED: Fixed Rails 3.2 ActiveSupport::Concern deprecation warning (GH-17, GH-20).
+- NEW: Support for Rails 3.2.
 
+- FIXED: Fixed Rails 3.2 ActiveSupport::Concern deprecation warning (GH-17, GH-20).
 
-## Release 2.1.0
 
-* NEW: Element now accepts a Hash of options. The options can be useful to customize the appearance of the element, for example to set a link title or class.
+#### Release 2.1.0
 
+- NEW: Element now accepts a Hash of options. The options can be useful to customize the appearance of the element, for example to set a link title or class.
 
-## Release 2.0.0
 
-* FIXED: Invalid documentation for Element target in the controller class context (closes #2)
+#### Release 2.0.0
 
-* CHANGED: Upgraded to Rails 3
+- FIXED: Invalid documentation for Element target in the controller class context (closes #2)
 
+- CHANGED: Upgraded to Rails 3
 
-## Release 1.0.1
 
-* FIXED: Since the removal of rails/init.rb in 7278376ab77651e540e39552384ad9677e32ff7e, Rails fails to load the helpers.
+#### Release 1.0.1
 
+- FIXED: Since the removal of rails/init.rb in 7278376ab77651e540e39552384ad9677e32ff7e, Rails fails to load the helpers.
 
-## Release 1.0.0
 
-* CHANGED: Removed empty install/uninstall hooks and tasks folder.
+#### Release 1.0.0
 
-* CHANGED: Removed rails/init hook because deprecated in Rails 3.
+- CHANGED: Removed empty install/uninstall hooks and tasks folder.
+- CHANGED: Removed rails/init hook because deprecated in Rails 3.
 
 
-## Release 0.2.0
+#### Release 0.2.0
 
-* Releasing the library as open source project.
+- Releasing the library as open source project.
 
-## Release 0.1.1
 
+#### Release 0.1.1
 
-* ADDED: documentation file.
 
-* CHANGED: run test against Rails ~> 2.3.0 but ensure compatibility with Rails 2.2.x.
+- NEW: documentation file.
 
-* CHANGED: Removed BUILD and STATUS constants. Added Version::ALPHA constant to be used when I need to package prereleases (see RubyGem --prerelease flag).
+- CHANGED: run test against Rails ~> 2.3.0 but ensure compatibility with Rails 2.2.x.
+- CHANGED: Removed BUILD and STATUS constants. Added Version::ALPHA constant to be used when I need to package prereleases (see RubyGem --prerelease flag).
 
 
-## Release 0.1.0
+#### Release 0.1.0
 
-* Initial version
+- Initial version

data/Gemfile

@@ -1,3 +1,3 @@
-source "http://rubygems.org"
+source 'https://rubygems.org'
 
 gemspec

data/LICENSE.txt

@@ -1,4 +1,4 @@
-Copyright (c) 2009-2014 Simone Carletti <weppos@weppos.net>
+Copyright (c) 2009-2016 Simone Carletti <weppos@weppos.net>
 
 MIT License
 

data/README.md

@@ -1,119 +1,265 @@
 # Breadcrumbs On Rails
-[![Code Climate](https://codeclimate.com/github/weppos/breadcrumbs_on_rails.png)](https://codeclimate.com/github/weppos/breadcrumbs_on_rails)
 
 <tt>BreadcrumbsOnRails</tt> is a simple Ruby on Rails plugin for creating and managing a breadcrumb navigation for a Rails project. It provides helpers for creating navigation elements with a flexible interface.
 
+[![Build Status](https://travis-ci.org/weppos/breadcrumbs_on_rails.svg?branch=master)](https://travis-ci.org/weppos/breadcrumbs_on_rails)
+[![Code Climate](https://codeclimate.com/github/weppos/breadcrumbs_on_rails.png)](https://codeclimate.com/github/weppos/breadcrumbs_on_rails)
+
 
 ## Requirements
 
-- Rails 3 or Rails 4
-
-Please note 
+- Rails 4 or Rails 5
 
-- <tt>BreadcrumbsOnRails</tt> 2.x requires Rails 3. Use <tt>BreadcrumbsOnRails</tt> 1.x with Rails 2.
-- <tt>BreadcrumbsOnRails</tt> doesn't work with Rails 2.1 or lower.
+For older versions of Ruby or Ruby on Rails, see the [CHANGELOG](CHANGELOG.md).
 
 
 ## Installation
 
-[RubyGems](http://rubygems.org) is the preferred way to install <tt>BreadcrumbsOnRails</tt> and the best way if you want install a stable version.
+Add this line to your application's `Gemfile`:
 
-    $ gem install breadcrumbs_on_rails
+    gem "breadcrumbs_on_rails"
 
-Specify the Gem dependency in the [Bundler](http://bundler.io/) `Gemfile`.
+And then execute `bundle` to install the dependencies:
 
-    gem "breadcrumbs_on_rails"
+    $ bundle
 
 Use [Bundler](http://bundler.io/) and the `:git` option if you want to grab the latest version from the Git repository.
 
 
-## Basic Usage
+## Usage
 
 Creating a breadcrumb navigation menu in your Rails app using <tt>BreadcrumbsOnRails</tt> is really straightforward.
 
 In your controller, call `add_breadcrumb` to push a new element on the breadcrumb stack. `add_breadcrumb` requires two arguments: the name of the breadcrumb and the target path.
 
-    class MyController
-    
-      add_breadcrumb "home", :root_path
-      add_breadcrumb "my", :my_path
-      
-      def index
-        # ...
-        
-        add_breadcrumb "index", index_path
-      end
-    
-    end
+```ruby
+class MyController
 
-The third, optional argument is a Hash of options to customize the breadcrumb link.
+  add_breadcrumb "home", :root_path
+  add_breadcrumb "my", :my_path
 
-    class MyController
-      add_breadcrumb "home", :root_path, :options => { :title => "Home" }
+  def index
+    # ...
 
-      def index
-        add_breadcrumb "index", index_path, :title => "Back to the Index"
-      end
-    end
+    add_breadcrumb "index", index_path
+  end
+
+end
+```
+
+See the section "Breadcrumb Element" for more details about name and target class types.
+
+The third, optional argument is a Hash of options to customize the breadcrumb link.
+
+```ruby
+class MyController
+  def index
+    add_breadcrumb "index", index_path, :title => "Back to the Index"
+  end
+end
+```
 
 In your view, you can render the breadcrumb menu with the `render_breadcrumbs` helper.
 
-    <!DOCTYPE html>
-    <html>
-    <head>
-      <title>untitled</title>
-    </head>
-    
-    <body>
-      <%= render_breadcrumbs %>
-    </body>
-    </html>
+```html
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
+  <title>untitled</title>
+</head>
+
+<body>
+  <%= render_breadcrumbs %>
+</body>
+</html>
+```
 
 `render_breadcrumbs` understands a limited set of options. For example, you can pass change the default separator with the `:separator` option.
 
-    <body>
-      <%= render_breadcrumbs :separator => ' / ' %>
-    </body>
+```html
+<body>
+  <%= render_breadcrumbs :separator => ' / ' %>
+</body>
+```
 
 Current possible options are:
+
 - `:separator`
 - `:tag`
 
 To use with Bootstrap you might use the following:
 
-    <body>
-      <ol class="breadcrumb">
-        <%= render_breadcrumbs :tag => :li, :separator => "" %>
-      </ol>
-    </body>
+```html
+<body>
+  <ol class="breadcrumb">
+    <%= render_breadcrumbs :tag => :li, :separator => "" %>
+  </ol>
+</body>
+```
+
+More complex customizations require a custom `Builder`.
+
+### HTML Escaping
+
+The text of the breadcrumb is html-escaped by default unless it is a SafeBuffer, to prevent XSS attacks.
+
+```ruby
+class MyController
+  add_breadcrumb "This is the <b>Main</b> page".html_safe
+
+  def profile
+    add_breadcrumb "#{@user_name} Profile", users_profile
+  end
+end
+```
+
+In this case, if `@user_name` is "<script>", it will output:
+
+    This is the <b>Main</b> page > &lt;script&gt; Profile
+
+
+### Breadcrumb Element
+
+A breadcrumbs menu is composed by a number of `Element` objects. Each object contains two attributes: the name of the breadcrumb and the target path.
+
+When you call `add_breadcrumb`, the method automatically creates a new `Element` object for you and append it to the breadcrumbs stack. `Element` name and path can be one of the following Ruby types:
+
+- `Symbol`
+- `Proc`
+- `String`
+
+#### Symbol
+
+If the value is a `Symbol`, the library calls the corresponding method defined in the same context the and sets the `Element` attribute to the returned value.
+
+```ruby
+class MyController
+  
+  # The Name is set to the value returned by
+  # the :root_name method.
+  add_breadcrumb :root_name, "/"
+  
+  protected
+  
+    def root_name
+      "the name"
+    end
+  
+end
+```
+
+#### Proc
+
+If the value is a `Proc`, the library calls the proc passing the current view context as argument and sets the `Element` attribute to the returned value. This is useful if you want to postpone the execution to get access to some special methods/variables created in your controller action.
+
+```ruby
+class MyController
+
+  # The Name is set to the value returned by
+  # the :root_name method.
+  add_breadcrumb Proc.new { |c| c.my_helper_method },
+                 "/"
+
+end
+```
+
+#### String
+
+If the value is a `String`, the library sets the `Element` attribute to the string value.
+
+```ruby
+class MyController
+
+  # The Name is set to the value returned by
+  # the :root_name method.
+  add_breadcrumb "homepage", "/"
+
+end
+```
+
+### Restricting breadcrumb scope
+
+The `add_breadcrumb` method understands all options you are used to pass to a Rails controller filter. In fact, behind the scenes this method uses a `before_filter` to store the tab in the `@breadcrumbs` variable.
+
+Taking advantage of Rails filter options, you can restrict a tab to a selected group of actions in the same controller.
+
+```ruby
+class PostsController < ApplicationController
+  add_breadcrumb "admin", :admin_path
+  add_breadcrumb "posts", :posts_path, :only => %w(index show)
+end
+
+class ApplicationController < ActionController::Base
+  add_breadcrumb "admin", :admin_path, :if => :admin_controller?
+  
+  def admin_controller?
+    self.class.name =~ /^Admin(::|Controller)/
+  end
+end
+```
+
+### Internationalization and Localization
+
+<tt>BreadcrumbsOnRails</tt> is compatible with the standard Rails internationalization framework.
+
+For example, if you want to localize your menu, define a new breadcrumbs node in your `.yml` file with all the keys for your elements.
+
+```yaml
+# config/locales/en.yml
+en:
+  breadcrumbs:
+    homepage: Homepage
+    first: First
+    second: Second
+    third: Third
+
+# config/locales/it.yml
+it:
+  breadcrumbs:
+    homepage: Homepage
+    first: Primo
+    second: Secondo
+    third: Terzo
+```
+
+In your controller, use the `I18n.t` method.
 
-More complex customizations require a custom Builder.
+```ruby
+class PostsController < ApplicationController
+  add_breadcrumb I18n.t("breadcrumbs.first"),  :first_path
+  add_breadcrumb I18n.t("breadcrumbs.second"), :second_path, :only => %w(second)
+  add_breadcrumb I18n.t("breadcrumbs.third"),  :third_path,  :only => %w(third)
+end
 
-Read the [documentation](http://simonecarletti.com/code/breadcrumbs_on_rails/docs/) to learn more about advanced usage and builders.
+class ApplicationController < ActionController::Base
+  add_breadcrumb I18n.t("breadcrumbs.homepage"), :root_path
+end
+```
 
 
 ## Credits
 
-<tt>BreadcrumbsOnRails</tt> was created and is maintained by [Simone Carletti](http://simonecarletti.com/). Many improvements and bugfixes were contributed by the [open source community](https://github.com/weppos/whois/graphs/contributors).
+<tt>BreadcrumbsOnRails</tt> was created and is maintained by [Simone Carletti](http://simonecarletti.com/). Many improvements and bugfixes were contributed by the [open source community](https://github.com/weppos/breadcrumbs_on_rails/graphs/contributors).
 
 
 ## Contributing
 
 Direct questions and discussions to [Stack Overflow](http://stackoverflow.com/questions/tagged/breadcrumbs-on-rails).
 
-[Pull requests](https://github.com/weppos/whois/breadcrumbs_on_rails) are very welcome! Please include tests for every patch, and create a topic branch for every separate change you make.
+[Pull requests](https://github.com/weppos/breadcrumbs_on_rails) are very welcome! Please include tests for every patch, and create a topic branch for every separate change you make.
 
 Report issues or feature requests to [GitHub Issues](https://github.com/weppos/breadcrumbs_on_rails/issues).
 
 
 ## More Information
 
-- [Homepage](http://simonecarletti.com/code/breadcrumbs_on_rails)
-- [RubyGems](http://rubygems.org/gems/breadcrumbs_on_rails)
-- [Documentation](http://simonecarletti.com/code/breadcrumbs_on_rails/docs/)
+- [Homepage](http://simonecarletti.com/code/breadcrumbs-on-rails)
+- [RubyGems](https://rubygems.org/gems/breadcrumbs_on_rails)
 - [Issues](https://github.com/weppos/breadcrumbs_on_rails/issues)
 
 
 ## License
 
-<tt>BreadcrumbsOnRails</tt> is Copyright (c) 2009-2014 Simone Carletti. This is Free Software distributed under the MIT license.
+Copyright (c) 2009-2015 Simone Carletti. This is Free Software distributed under the MIT license.

data/Rakefile

@@ -1,62 +1,12 @@
-require 'rubygems'
-require 'bundler'
+require 'bundler/gem_tasks'
 require 'appraisal'
 
-$:.unshift(File.dirname(__FILE__) + "/lib")
-require 'breadcrumbs_on_rails/version'
-
-
-PKG_NAME    = ENV['PKG_NAME']    || "breadcrumbs_on_rails"
-PKG_VERSION = ENV['PKG_VERSION'] || BreadcrumbsOnRails::VERSION
-
-
-# Run test by default.
-task :default => :test
-
-spec = Gem::Specification.new do |s|
-  s.name              = PKG_NAME
-  s.version           = PKG_VERSION
-  s.summary           = "A simple Ruby on Rails plugin for creating and managing a breadcrumb navigation."
-  s.description       = "BreadcrumbsOnRails is a simple Ruby on Rails plugin for creating and managing a breadcrumb navigation for a Rails project."
-
-  s.author            = "Simone Carletti"
-  s.email             = "weppos@weppos.net"
-  s.homepage          = "http://www.simonecarletti.com/code/breadcrumbs_on_rails"
-
-  s.files             = `git ls-files`.split("\n")
-  s.test_files        = `git ls-files -- {test,spec,features}/*`.split("\n")
-  s.require_paths     = %w( lib )
-
-  s.add_development_dependency "rails", ">= 3.0"
-  s.add_development_dependency "appraisal"
-  s.add_development_dependency "mocha", "~> 1.0.0"
-  s.add_development_dependency "yard"
-end
-
-
-require 'rubygems/package_task'
-
-Gem::PackageTask.new(spec) do |pkg|
-  pkg.gem_spec = spec
-end
-
-desc "Build the gemspec file #{spec.name}.gemspec"
-task :gemspec do
-  file = File.dirname(__FILE__) + "/#{spec.name}.gemspec"
-  File.open(file, "w") {|f| f << spec.to_ruby }
-end
-
-desc "Remove any temporary products, including gemspec."
-task :clean => [:clobber] do
-  rm "#{spec.name}.gemspec"
+if !ENV["APPRAISAL_INITIALIZED"] && !ENV["TRAVIS"]
+  task :default => :appraisal
+else
+  task :default => :test
 end
 
-desc "Remove any generated file"
-task :clobber => [:clobber_package]
-
-desc "Package the library and generates the gemspec"
-task :package => [:gemspec]
-
 
 require 'rake/testtask'
 
@@ -68,18 +18,10 @@ Rake::TestTask.new do |t|
 end
 
 
-require 'yard'
 require 'yard/rake/yardoc_task'
 
 YARD::Rake::YardocTask.new(:yardoc) do |y|
   y.options = ["--output-dir", "yardoc"]
 end
 
-namespace :yardoc do
-  desc "Remove YARD products"
-  task :clobber do
-    rm_r "yardoc" rescue nil
-  end
-end
-
-task :clobber => "yardoc:clobber"
+CLOBBER.include "yardoc"

data/breadcrumbs_on_rails.gemspec

@@ -1,39 +1,28 @@
-# -*- encoding: utf-8 -*-
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'breadcrumbs_on_rails/version'
 
-Gem::Specification.new do |s|
-  s.name = "breadcrumbs_on_rails"
-  s.version = "2.3.0"
+Gem::Specification.new do |spec|
+  spec.name          = "breadcrumbs_on_rails"
+  spec.version       = BreadcrumbsOnRails::VERSION
+  spec.authors       = ["Simone Carletti"]
+  spec.email         = ["weppos@weppos.net"]
 
-  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
-  s.authors = ["Simone Carletti"]
-  s.date = "2014-01-25"
-  s.description = "BreadcrumbsOnRails is a simple Ruby on Rails plugin for creating and managing a breadcrumb navigation for a Rails project."
-  s.email = "weppos@weppos.net"
-  s.files = [".gitignore", ".ruby-gemset", ".ruby-version", ".travis.yml", "Appraisals", "CHANGELOG.md", "Gemfile", "LICENSE.txt", "README.md", "Rakefile", "breadcrumbs_on_rails.gemspec", "gemfiles/3.0.gemfile", "gemfiles/3.1.gemfile", "gemfiles/3.2.gemfile", "gemfiles/4.0.gemfile", "init.rb", "lib/breadcrumbs_on_rails.rb", "lib/breadcrumbs_on_rails/action_controller.rb", "lib/breadcrumbs_on_rails/breadcrumbs.rb", "lib/breadcrumbs_on_rails/railtie.rb", "lib/breadcrumbs_on_rails/version.rb", "test/dummy.rb", "test/test_helper.rb", "test/unit/action_controller_test.rb", "test/unit/builder_test.rb", "test/unit/element_test.rb", "test/unit/simple_builder_test.rb", "test/views/example/default.html.erb"]
-  s.homepage = "http://www.simonecarletti.com/code/breadcrumbs_on_rails"
-  s.require_paths = ["lib"]
-  s.rubygems_version = "2.0.14"
-  s.summary = "A simple Ruby on Rails plugin for creating and managing a breadcrumb navigation."
-  s.test_files = ["test/dummy.rb", "test/test_helper.rb", "test/unit/action_controller_test.rb", "test/unit/builder_test.rb", "test/unit/element_test.rb", "test/unit/simple_builder_test.rb", "test/views/example/default.html.erb"]
+  spec.summary       = %q{A simple Ruby on Rails plugin for creating and managing a breadcrumb navigation}
+  spec.description   = %q{BreadcrumbsOnRails is a simple Ruby on Rails plugin for creating and managing a breadcrumb navigation for a Rails project.}
+  spec.homepage      = "https://simonecarletti.com/code/breadcrumbs_on_rails"
+  spec.license       = "MIT"
 
-  if s.respond_to? :specification_version then
-    s.specification_version = 4
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  spec.require_paths = ["lib"]
 
-    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
-      s.add_development_dependency(%q<rails>, [">= 3.0"])
-      s.add_development_dependency(%q<appraisal>, [">= 0"])
-      s.add_development_dependency(%q<mocha>, ["~> 1.0.0"])
-      s.add_development_dependency(%q<yard>, [">= 0"])
-    else
-      s.add_dependency(%q<rails>, [">= 3.0"])
-      s.add_dependency(%q<appraisal>, [">= 0"])
-      s.add_dependency(%q<mocha>, ["~> 1.0.0"])
-      s.add_dependency(%q<yard>, [">= 0"])
-    end
-  else
-    s.add_dependency(%q<rails>, [">= 3.0"])
-    s.add_dependency(%q<appraisal>, [">= 0"])
-    s.add_dependency(%q<mocha>, ["~> 1.0.0"])
-    s.add_dependency(%q<yard>, [">= 0"])
-  end
+  spec.required_ruby_version = ">= 2.0"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "bundler"
+  spec.add_development_dependency "appraisal"
+  spec.add_development_dependency "rails", ">= 4.0"
+  spec.add_development_dependency "mocha", ">= 1.0"
+  spec.add_development_dependency "yard"
 end

data/gemfiles/4.0.gemfile

@@ -1,7 +1,7 @@
 # This file was generated by Appraisal
 
-source "http://rubygems.org"
+source "https://rubygems.org"
 
-gem "activerecord", "~> 4.0.0"
+gem "rails", "~> 4.0.0"
 
-gemspec :path=>"../"
+gemspec :path => "../"

data/gemfiles/4.1.gemfile

@@ -0,0 +1,7 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "rails", "~> 4.1.0"
+
+gemspec :path => "../"

data/gemfiles/4.2.gemfile

@@ -0,0 +1,7 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "rails", "~> 4.2.0"
+
+gemspec :path => "../"

data/gemfiles/5.0.gemfile

@@ -0,0 +1,7 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "rails", "~> 5.0.0"
+
+gemspec :path => "../"

data/lib/breadcrumbs_on_rails.rb

@@ -3,7 +3,7 @@
 #
 # A simple Ruby on Rails plugin for creating and managing a breadcrumb navigation.
 #
-# Copyright (c) 2009-2014 Simone Carletti <weppos@weppos.net>
+# Copyright (c) 2009-2016 Simone Carletti <weppos@weppos.net>
 #++
 
 require 'breadcrumbs_on_rails/breadcrumbs'

data/lib/breadcrumbs_on_rails/action_controller.rb

@@ -3,7 +3,7 @@
 #
 # A simple Ruby on Rails plugin for creating and managing a breadcrumb navigation.
 #
-# Copyright (c) 2009-2014 Simone Carletti <weppos@weppos.net>
+# Copyright (c) 2009-2016 Simone Carletti <weppos@weppos.net>
 #++
 
 module BreadcrumbsOnRails
@@ -11,10 +11,14 @@ module BreadcrumbsOnRails
   module ActionController
     extend ActiveSupport::Concern
 
-    included do
+    included do |base|
       extend          ClassMethods
       helper          HelperMethods
       helper_method   :add_breadcrumb, :breadcrumbs
+
+      unless base.respond_to?(:before_action)
+        base.alias_method :before_action, :before_filter
+      end
     end
 
     protected
@@ -69,7 +73,7 @@ module BreadcrumbsOnRails
 
         element_options = filter_options.delete(:options) || {}
 
-        before_filter(filter_options) do |controller|
+        before_action(filter_options) do |controller|
           controller.send(:add_breadcrumb, name, path, element_options)
         end
       end

data/lib/breadcrumbs_on_rails/breadcrumbs.rb

@@ -3,7 +3,7 @@
 #
 # A simple Ruby on Rails plugin for creating and managing a breadcrumb navigation.
 #
-# Copyright (c) 2009-2014 Simone Carletti <weppos@weppos.net>
+# Copyright (c) 2009-2016 Simone Carletti <weppos@weppos.net>
 #++
 
 module BreadcrumbsOnRails
@@ -93,7 +93,7 @@ module BreadcrumbsOnRails
         if @options[:tag]
           @context.content_tag(@options[:tag], content)
         else
-          content
+          ERB::Util.h(content)
         end
       end
 

data/lib/breadcrumbs_on_rails/railtie.rb

@@ -3,16 +3,14 @@
 #
 # A simple Ruby on Rails plugin for creating and managing a breadcrumb navigation.
 #
-# Copyright (c) 2009-2014 Simone Carletti <weppos@weppos.net>
+# Copyright (c) 2009-2016 Simone Carletti <weppos@weppos.net>
 #++
 
 module BreadcrumbsOnRails
 
   class Railtie < Rails::Railtie
-    initializer "breadcrumbs_on_rails.initialize" do
-      ActiveSupport.on_load(:action_controller) do
-        include BreadcrumbsOnRails::ActionController
-      end
+    ActiveSupport.on_load(:action_controller) do
+      include BreadcrumbsOnRails::ActionController
     end
   end
 

data/lib/breadcrumbs_on_rails/version.rb

@@ -3,20 +3,9 @@
 #
 # A simple Ruby on Rails plugin for creating and managing a breadcrumb navigation.
 #
-# Copyright (c) 2009-2014 Simone Carletti <weppos@weppos.net>
+# Copyright (c) 2009-2016 Simone Carletti <weppos@weppos.net>
 #++
 
 module BreadcrumbsOnRails
-
-  module Version
-    MAJOR = 2
-    MINOR = 3
-    PATCH = 1
-    BUILD = nil
-
-    STRING = [MAJOR, MINOR, PATCH, BUILD].compact.join('.')
-  end
-
-  VERSION = Version::STRING
-
+  VERSION = "3.0.0"
 end

data/test/test_helper.rb

@@ -4,3 +4,6 @@ require 'dummy'
 
 $:.unshift File.expand_path('../../lib', __FILE__)
 require 'breadcrumbs_on_rails'
+
+Encoding.default_external = Encoding::UTF_8
+Encoding.default_internal = Encoding::UTF_8

data/test/unit/action_controller_test.rb

@@ -48,7 +48,7 @@ class ExampleControllerTest < ActionController::TestCase
   def test_render_compute_paths
     get :action_compute_paths
     assert_dom_equal  %(<a href="/">String</a> &raquo; <a href="/?proc">Proc</a> &raquo; <a href="/?polymorphic">Polymorphic</a>),
-                      @response.body
+                      @response.body.to_s
   end
 
 end
@@ -78,14 +78,15 @@ class ClassLevelExampleControllerTest < ActionController::TestCase
 
   def test_render_default
     expected = [].tap { |links|
-      links << "<a href=\"/\">String</a>"
-      links << "<a href=\"/?proc\">Proc</a>"
-      links << "<a href=\"/?polymorphic\">Polymorphic</a>"
-      links << "<a href=\"/\" title=\"Awesome\">With options</a>"
+      links << '<a href="/">String</a>'
+      links << '<a href="/?proc">Proc</a>'
+      links << '<a href="/?polymorphic">Polymorphic</a>'
+      links << '<a title="Awesome" href="/">With options</a>'
     }
 
     get :action_default
-    assert_dom_equal %(#{expected.join(" &raquo; ")}), @response.body
+    assert_dom_equal  expected.join(" &raquo; "), 
+                      @response.body.to_s
   end
 
 end

data/test/unit/simple_builder_test.rb

@@ -60,6 +60,29 @@ class SimpleBuilderTest < ActionView::TestCase
                      simplebuilder(@template, elements).render)
   end
 
+  def test_render_with_embedded_html
+    elements = [BreadcrumbsOnRails::Breadcrumbs::Element.new("Element <b>One</b>", nil)]
+    assert_dom_equal("Element &lt;b&gt;One&lt;/b&gt;",
+                     simplebuilder(@template, elements).render)
+  end
+
+  def test_render_with_embedded_html_and_tags
+    elements = [BreadcrumbsOnRails::Breadcrumbs::Element.new("Element <b>One</b>", nil)]
+    assert_dom_equal("<li>Element &lt;b&gt;One&lt;/b&gt;</li>",
+                     simplebuilder(@template, elements, {tag: :li} ).render)
+  end
+
+  def test_render_with_safe_embedded_html
+    elements = [BreadcrumbsOnRails::Breadcrumbs::Element.new("Element <b>One</b>".html_safe, nil)]
+    assert_dom_equal("Element <b>One</b>",
+                     simplebuilder(@template, elements).render)
+  end
+
+  def test_render_with_embedded_html_and_tags
+    elements = [BreadcrumbsOnRails::Breadcrumbs::Element.new("Element <b>One</b>".html_safe, nil)]
+    assert_dom_equal("<li>Element <b>One</b></li>",
+                     simplebuilder(@template, elements, {tag: :li} ).render)
+  end
 
   protected
 

metadata

@@ -1,29 +1,43 @@
 --- !ruby/object:Gem::Specification
 name: breadcrumbs_on_rails
 version: !ruby/object:Gem::Version
-  version: 2.3.1
+  version: 3.0.0
 platform: ruby
 authors:
 - Simone Carletti
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-08-06 00:00:00.000000000 Z
+date: 2016-08-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: rails
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: appraisal
   requirement: !ruby/object:Gem::Requirement
@@ -38,20 +52,34 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.0'
 - !ruby/object:Gem::Dependency
   name: mocha
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 1.0.0
+        version: '1.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 1.0.0
+        version: '1.0'
 - !ruby/object:Gem::Dependency
   name: yard
   requirement: !ruby/object:Gem::Requirement
@@ -68,7 +96,8 @@ dependencies:
         version: '0'
 description: BreadcrumbsOnRails is a simple Ruby on Rails plugin for creating and
   managing a breadcrumb navigation for a Rails project.
-email: weppos@weppos.net
+email:
+- weppos@weppos.net
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -84,10 +113,10 @@ files:
 - README.md
 - Rakefile
 - breadcrumbs_on_rails.gemspec
-- gemfiles/3.0.gemfile
-- gemfiles/3.1.gemfile
-- gemfiles/3.2.gemfile
 - gemfiles/4.0.gemfile
+- gemfiles/4.1.gemfile
+- gemfiles/4.2.gemfile
+- gemfiles/5.0.gemfile
 - init.rb
 - lib/breadcrumbs_on_rails.rb
 - lib/breadcrumbs_on_rails/action_controller.rb
@@ -101,8 +130,9 @@ files:
 - test/unit/element_test.rb
 - test/unit/simple_builder_test.rb
 - test/views/example/default.html.erb
-homepage: http://www.simonecarletti.com/code/breadcrumbs_on_rails
-licenses: []
+homepage: https://simonecarletti.com/code/breadcrumbs_on_rails
+licenses:
+- MIT
 metadata: {}
 post_install_message: 
 rdoc_options: []
@@ -112,7 +142,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '2.0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
@@ -120,10 +150,10 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.4.7
+rubygems_version: 2.5.1
 signing_key: 
 specification_version: 4
-summary: A simple Ruby on Rails plugin for creating and managing a breadcrumb navigation.
+summary: A simple Ruby on Rails plugin for creating and managing a breadcrumb navigation
 test_files:
 - test/dummy.rb
 - test/test_helper.rb

data/gemfiles/3.0.gemfile

@@ -1,7 +0,0 @@
-# This file was generated by Appraisal
-
-source "http://rubygems.org"
-
-gem "activerecord", "~> 3.0.0"
-
-gemspec :path=>"../"

data/gemfiles/3.1.gemfile

@@ -1,7 +0,0 @@
-# This file was generated by Appraisal
-
-source "http://rubygems.org"
-
-gem "activerecord", "~> 3.1.0"
-
-gemspec :path=>"../"

data/gemfiles/3.2.gemfile

@@ -1,7 +0,0 @@
-# This file was generated by Appraisal
-
-source "http://rubygems.org"
-
-gem "activerecord", "~> 3.2.0"
-
-gemspec :path=>"../"