dat_gretel 4.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: ccaad8cb8f8ec8530bb91ea0e8bc410457c66828a7fd03bb0d6dbed37ce2f189
+  data.tar.gz: 00a5aa6e1f77ab33b97b0914f22a686f394e46bc879e4e861dd82c8b1d5037ee
+SHA512:
+  metadata.gz: b6c38ca23c2eaeca2e3f537bd88ea7596b2ba380cc813fc94bc48ee782d6ea61b8368f0dc6772d97330a48643b70befdc0dfe8b92f367dfac7eb69808aed8d40
+  data.tar.gz: 6be2a36c0ac7ecfa5ce9f39c89127380856aee330e3c39e388be62416b6905cc11653fdb434190d34b76429a83beb19ea7c5ea1c89f9ddb3dc4170f2fbfa83ae

data/.gitignore

@@ -0,0 +1,24 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+gemfiles/*.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+log/*.log
+test/dummy/db/*.sqlite3
+test/dummy/log/*.log
+test/dummy/tmp/
+test/dummy/.sass-cache
+.DS_Store

data/.travis.yml

@@ -0,0 +1,16 @@
+language: ruby
+sudo: false
+rvm:
+  - 2.5.1
+  - 2.2.2
+gemfile:
+  - gemfiles/Gemfile-rails.4.0.x
+  - gemfiles/Gemfile-rails.4.1.x
+  - gemfiles/Gemfile-rails.5.2.x
+before_script:
+  - "cd test/dummy; rake db:migrate; rake db:test:prepare; cd ../.."
+notifications:
+  email: false
+matrix:
+  allow_failures:
+  - rvm: 2.5.1

data/CHANGELOG.md

@@ -0,0 +1,56 @@
+# Changelog
+
+## Version 3.0.9
+* Adds breadcrumbs option `link_current_to_request_path` to link the current breadcrumb to the request path(#28 via #29)
+* Fixes semantic breadcrumbs when the last item has no link (via #55)
+* Downgrades Rails dependency to 3.1 (via #56)
+* Fixes jRuby issue with `Rails::Application` constant (via #50)
+* Fixes deprecation warnings for `alias_method_chain` (via #66)
+* Updated coprights (via #63)
+
+## Version 3.0.8
+* Parent breadcrumbs can now also be inferred from models responding to `model_name`.
+
+## Version 3.0.7
+* Pretext and posttext classes are now customizable with `<%= breadcrumbs pretext_class: "some-class" %>` and `<%= breadcrumbs posttext_class: "some-other-class" %>`.
+
+## Version 3.0.6
+* Pretext and posttext are now enclosed in spans with `<span class="pretext">` and `<span class="posttext">`.
+* Semantic breadcrumbs are now rendered in spans instead of divs to enable easier styling.
+
+## Version 3.0.3
+* Breadcrumbs can now be rendered for use in the [Foundation 5](http://foundation.zurb.com/) framework. Use `breadcrumbs style: :foundation5`.
+* Breadcrumbs are now automatically loaded from any engines' `config/breadcrumbs.rb` and `config/breadcrumbs/**/*.rb`. See the readme for details.
+* You can now pass options to links to be used when you render manually. See the readme for details.
+* Breadcrumb configuration files can now be put in the `app/views/breadcrumbs/` folder. This is an experimental feature that may replace loading breadcrumbs from the `config` folder in the future.
+
+## Version 3.0.2
+* Inferring breadcrumbs is now supported on all instances of objects that respond to `model_name`.
+
+## Version 3.0.1
+* Breadcrumbs can now be inferred if you pass in an ActiveRecord model instance. E.g. `breadcrumb @product` is short for `breadcrumb :product, @product`.
+
+## Version 3.0
+* Support for defining breadcrumbs using `Gretel::Crumbs.layout do ... end` in an initializer has been removed. See the readme for details on how to upgrade.
+* Breadcrumbs rendering is now done in a separate class to unclutter the view with helpers. The public API is still the same.
+* Support for rendering the breadcrumbs in different styles like ul- and ol lists, and for use with [Twitter Bootstrap](http://getbootstrap.com/). See the `:style` option in the readme for more info.
+* The `:show_root_alone` option is now called `:display_single_fragment` and can be used to display the breadcrumbs only when there are more than one link, also if it is not the root breadcrumb.
+* Links yielded from `<%= breadcrumbs do |links| %>` now have a `current?` helper that returns true if the link is the last in the trail.
+* New view helper: `parent_breadcrumb` returns the parent breadcrumb link (with `#key`, `#text`, and `#url`). This can for example be used to create a dynamic back link. You can supply options like `:autoroot` etc.
+  If you supply a block, it will yield the parent breadcrumb if it is present.
+
+## Version 2.1
+* Breadcrumbs are now configured in `config/breadcrumbs.rb` and `config/breadcrumbs/**/*.rb` and reloaded when changed in the development environment instead of the initializer that required restart when configuration changed.
+
+## Version 2.0
+
+* Totally rewritten for better structure.
+* `options[:autoroot]` is now `true` by default which means it will automatically link to the `:root` breadcrumb if no parent is specified.
+* Now accepts `options[:class]` for specifying the CSS class for the breadcrumbs container. Default: `"breadcrumbs"`.
+* Now accepts `options[:current_class]` for specifying the CSS class for the current link / span. Default: `"current"`.
+* `options[:link_last]` was deprecated in a previous version and is now removed. Use `options[:link_current]` instead.
+* The `link` method in `crumb :xx do ... end` no longer takes HTML options. The method for this is now by building the breadcrumbs manually (see the readme).
+* No longer supports procs for link text or URL as this is unnecessary when you can pass arguments to the block anyway.
+* It now accepts multiple arguments for `crumb` and `parent` (see the readme).
+* Breadcrumbs are now rendered with `<%= breadcrumbs %>`, although you can still use the old `<%= breadcrumb %>` (without *s*).
+* You can now access view helpers from inside `Gretel::Crumbs.layout do .. end`.

data/Gemfile

@@ -0,0 +1,23 @@
+source "http://rubygems.org"
+
+# Declare your gem's dependencies in gretel.gemspec.
+# Bundler will treat runtime dependencies like base dependencies, and
+# development dependencies will be added by default to the :development group.
+gemspec
+
+# Declare any dependencies that are still in development here instead of in
+# your gemspec. These might include edge Rails or gems from your path or
+# Git. Remember to move these dependencies to your gemspec before releasing
+# your gem to rubygems.org.
+
+# To use debugger
+# gem 'debugger'
+
+group :development do
+  # jquery-rails is used by the dummy application
+  gem "jquery-rails"
+end
+
+group :test do
+  gem 'test-unit', '~> 3.0' if RUBY_VERSION >= "2.2"
+end

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2010-2016 Lasse Bunk
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,359 @@
+<a href="https://travis-ci.org/marciodat/gretel"><img src="https://travis-ci.org/marciodat/gretel.svg" alt="Build Status" /></a>
+
+<img src="http://i.imgur.com/CAKEaBM.png" alt="Handle breadcrumb trails... like a boss :)" />
+
+This is an update of the amazing `gretel` gem with the following changes:
+
+- Added `fragment_class`: allows the user to specify classes for framents
+
+- Updated bootstrap default to the latest version
+
+- Updated rails to the latest version 
+
+- Updated tests
+
+Due to some changes on the latest rails version, the gem compatibility has been changed:
+
+- ruby = 2.2.2 / rails >= 4.0.x
+
+- ruby = 2.5.1 / rails >= 5.2.x
+
+---
+
+([TL;DR](http://i.imgur.com/nH25yiH.png)) Gretel is a [Ruby on Rails](http://rubyonrails.org) plugin that makes it easy yet flexible to create breadcrumbs.
+It is based around the idea that breadcrumbs are a concern of the view, so you define a set of breadcrumbs in *config/breadcrumbs.rb* (or multiple files; see below) and specify in the view which breadcrumb to use.
+Gretel also supports [semantic breadcrumbs](http://support.google.com/webmasters/bin/answer.py?hl=en&answer=185417) (those used in Google results).
+
+Have fun! And please do write, if you (dis)like it – [lassebunk@gmail.com](mailto:lassebunk@gmail.com).
+
+## Installation
+
+In your *Gemfile*:
+
+```ruby
+gem "dat_gretel"
+```
+
+And run:
+
+```bash
+$ bundle install
+```
+
+## Example
+
+Start by generating breadcrumbs configuration file:
+
+```bash
+$ rails generate dat_gretel:install
+```
+
+Then, in *config/breadcrumbs.rb*:
+
+```ruby
+# Root crumb
+crumb :root do
+  link "Home", root_path
+end
+
+# Issue list
+crumb :issues do
+  link "All issues", issues_path
+end
+
+# Issue
+crumb :issue do |issue|
+  link issue.title, issue
+  parent :issues
+end
+```
+
+At the top of *app/views/issues/show.html.erb*, set the current breadcrumb (assuming you have loaded `@issue` with an issue):
+
+```erb
+<% breadcrumb :issue, @issue %>
+```
+
+Then, in *app/views/layouts/application.html.erb*:
+
+```erb
+<%= breadcrumbs pretext: "You are here: ",
+                separator: " &rsaquo; " %>
+```
+
+This will generate the following HTML (indented for readability):
+
+```html
+<div class="breadcrumbs">
+  <span class="pretext">You are here:</span>
+  <a href="/">Home</a> &rsaquo;
+  <a href="/issues">All issues</a> &rsaquo;
+  <span class="current">My Issue</span>
+</div>
+```
+
+## Options
+
+You can pass options to `<%= breadcrumbs %>`, e.g. `<%= breadcrumbs pretext: "You are here: " %>`:
+
+Option                   | Description                                                                                                                | Default
+------------------------ | -------------------------------------------------------------------------------------------------------------------------- | -------
+:style                   | How to render the breadcrumbs. Can be `:inline`, `:ol`, `:ul`, or `:bootstrap`. See below for more info.                   | `:inline`
+:pretext                 | Text to be rendered before breadcrumb, e.g. `"You are here: "`.                                                            | None
+:posttext                | Text to be appended after breadcrumb, e.g. `"Text after breacrumb"`,                                                       | None
+:separator               | Separator between links, e.g. `" &rsaquo; "`.                                                                              | `" &rsaquo; "`
+:autoroot                | Whether it should automatically link to the `:root` crumb if no parent is given.                                           | True
+:display_single_fragment | Whether it should display the breadcrumb if it includes only one link.                                                     | False
+:link_current            | Whether the current crumb should be linked to.                                                                             | False
+:link_current_to_request_path            | Whether the current crumb should always link to the current request path. *Note:* This option will have no effect unless `:link_current` is set to `true`.                                                                             | True
+:semantic                | Whether it should generate [semantic breadcrumbs](http://support.google.com/webmasters/bin/answer.py?hl=en&answer=185417). | False
+:id                      | ID for the breadcrumbs container.                                                                                          | None
+:class                   | CSS class for the breadcrumbs container. Can be set to `nil` for no class.                                                 | `"breadcrumbs"`
+:current_class           | CSS class for the current link or span. Can be set to `nil` for no class.                                                  | `"current"`
+:fragment_class          | CSS class for the fragment link or span. Can be set to `nil` for no class.                                                 | `"breadcrumb-item"`
+:pretext_class           | CSS class for the pretext, if given. Can be set to `nil` for no class.                                                     | `"pretext"`
+:posttext_class          | CSS class for the posttext, if given. Can be set to `nil` for no class.                                                    | `"posttext"`
+:container_tag           | Tag type that contains the breadcrumbs.                                                                                    | `:div`
+:fragment_tag            | Tag type to contain each breadcrumb fragment/link.                                                                         | None
+
+### Styles
+
+These are the styles you can use with `breadcrumbs style: :xx`.
+
+Style          | Description
+-------------- | -----------
+`:inline`      | Renders each link by itself with `&rsaquo;` as the seperator.
+`:ol`          | Renders the links in `<li>` elements contained in an outer `<ol>`.
+`:ul`          | Renders the links in `<li>` elements contained in an outer `<ul>`.
+`:bootstrap`   | Renders the links for use in [Twitter Bootstrap](http://getbootstrap.com/).
+`:foundation5` | Renders the links for use in [Foundation 5](http://foundation.zurb.com/).
+
+Or you can build the breadcrumbs manually for full customization; see below.
+
+If you add other widely used styles, please submit a [Pull Request](https://github.com/lassebunk/gretel/pulls) so others can use them too.
+
+## More examples
+
+In *config/breadcrumbs.rb*:
+
+```ruby
+# Root crumb
+crumb :root do
+  link "Home", root_path
+end
+
+# Regular crumb
+crumb :projects do
+  link "Projects", projects_path
+end
+
+# Parent crumbs
+crumb :project_issues do |project|
+  link "Issues", project_issues_path(project)
+  parent project # inferred to :project
+end
+
+# Child
+crumb :issue do |issue|
+  link issue.name, issue_path(issue)
+  parent :project_issues, issue.project
+end
+
+# Recursive parent categories
+crumb :category do |category|
+  link category.name, category
+  if category.parent
+    parent category.parent # inferred to :category
+  else
+    parent :categories
+  end
+end
+
+# Product crumb with recursive parent categories (as defined above)
+crumb :product do |product|
+  link product.name, product
+  parent product.category # inferred to :category
+end
+
+# Crumb with multiple links
+crumb :test do
+  link "One", one_path
+  link "Two", two_path
+  parent :about
+end
+
+# Example of using params to alter the parent, e.g. to
+# match the user's actual navigation path
+# URL: /products/123?q=my+search
+crumb :search do |keyword|
+  link "Search for #{keyword}", search_path(q: keyword)
+end
+
+crumb :product do |product|
+  if keyword = params[:q].presence
+    parent :search, keyword
+  else # default
+    parent product.category # inferred to :category
+  end
+end
+
+# Multiple arguments
+crumb :multiple_test do |a, b, c|
+  link "Test #{a}, #{b}, #{c}", test_path
+  parent :other_test, 3, 4, 5
+end
+
+# Breadcrumb without link URL; will not generate a link
+crumb :without_link do
+  link "Breadcrumb without link"
+end
+
+# Breadcrumb using view helper
+module UsersHelper
+  def user_name_for(user)
+    user.name
+  end
+end
+
+crumb :user do |user|
+  link user_name_for(user), user
+end
+```
+
+## Building the breadcrumbs manually
+
+If you supply a block to the `breadcrumbs` method, it will yield an array with the breadcrumb links so you can build the breadcrumbs HTML manually:
+
+```erb
+<% breadcrumbs do |links| %>
+  <% if links.any? %>
+    You are here:
+    <% links.each do |link| %>
+      <%= link_to link.text, link.url, class: (link.current? ? "current" : nil) %> (<%= link.key %>)
+    <% end %>
+  <% end %>
+<% end %>
+```
+
+## Getting the parent breadcrumb
+
+If you want to add a link to the parent breadcrumb, you can use the `parent_breadcrumb` view helper.
+By default it returns a link instance that has the properties `#key`, `#text`, and `#url`.
+You can supply options like `autoroot: false` etc.
+
+If you supply a block, it will yield the link if it is present:
+
+```erb
+<% parent_breadcrumb do |link| %>
+  <%= link_to "Back to #{link.text}", link.url %>
+<% end %>
+```
+
+## Nice to know
+
+### Access to view methods
+
+When configuring breadcrumbs inside a `crumb :xx do ... end` block, you have access to all methods that are normally accessible in the view where the breadcrumbs are inserted. This includes your view helpers, `params`, `request`, etc.
+
+### Using multiple breadcrumb configuration files
+
+If you have a large site and you want to split your breadcrumbs configuration over multiple files, you can create a folder named `config/breadcrumbs` and put your configuration files (e.g. `products.rb` or `frontend.rb`) in there.
+The format is the same as `config/breadcrumbs.rb` which is also loaded.
+
+### Loading breadcrumbs from engines
+
+Breadcrumbs are automatically loaded from any engines' `config/breadcrumbs.rb` and `config/breadcrumbs/**/*.rb`.
+Breadcrumbs defined in your main app will override breadcrumbs from engines.
+
+### Inferring breadcrumbs
+
+Breadcrumbs can be automatically inferred if you pass an instance of an object that responds to `model_name` (like an ActiveRecord model instance).
+
+For example:
+
+```erb
+<% breadcrumb @product %>
+```
+
+is short for
+
+```erb
+<% breadcrumb :product, @product %>
+```
+
+### Passing options to links
+
+You can pass options to links to be used when you render breadcrumbs manually.
+
+In *config/breadcrumbs.rb*:
+
+```ruby
+crumb :something do
+  link "My Link", my_path, title: "My Title", other: "My Other Option"
+end
+```
+
+Example methods you can then use in the view:
+
+```ruby
+breadcrumbs do |links|
+  links.each do |link|
+    link.title?              # => true
+    link.title               # => "My Title"
+    link.other?              # => true
+    link.other               # => "My Other Option"
+    link.nonexisting_option? # => false
+    link.nonexisting_option  # => nil
+  end
+end
+```
+
+### Automatic reloading of breadcrumb configuration files
+
+The breadcrumb configuration files are now reloaded in the Rails development environment if they change. In other environments, like production, the files are loaded once, when first needed.
+
+
+## Documentation
+
+The original gretel documentation is still valid and can be found at:
+
+* [Full documentation](http://rubydoc.info/gems/gretel)
+* [Changelog](https://github.com/lassebunk/gretel/blob/master/CHANGELOG.md)
+* [Tutorial on using Gretel](http://www.sitepoint.com/breadcrumbs-rails-gretel/) (Sitepoint)
+
+## Versioning
+
+Follows [semantic versioning](http://semver.org/).
+
+## Contributing
+
+You are very welcome to help improve Gretel if you have suggestions for features that other people can use.
+
+To contribute:
+
+1. Fork the project
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Make your changes
+4. Add/Fix tests
+5. Prepare database for testing: `cd test/dummy; rake db:migrate; rake db:test:prepare; cd ../..`
+6. Run `rake` to make sure all tests pass
+7. Commit your changes (`git commit -am 'Add new feature'`)
+8. Push to the branch (`git push origin my-new-feature`)
+9. Create new pull request
+
+Thanks.
+
+## Contributors
+
+Gretel was created by [@lassebunk](https://github.com/lassebunk).
+
+This fork implements some updates/ fixes and is maintained by [@marciodat](https://github.com/marciodat).
+
+
+## And then
+
+<img src="http://i.imgur.com/u4Wbt4n.png" alt="After using Gretel, you'll be like this" />
+
+Have fun!
+
+Copyright (c) 2010-2016 [Lasse Bunk](http://lassebunk.dk) / [Marcio Silva](https://github.com/marciodat), released under the MIT license