gretel-lite 3.0.10

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: c04b679c18361079f9f8fe3df99d49ffa7cafcab
+  data.tar.gz: b293fea5337686ec2e02fb883858d2c9d7ad7eab
+SHA512:
+  metadata.gz: 429c53daa512ff2dbc21246f351ceb51f2bb6ccca77766c92f00cf9e521b772c9b4a03ca6ff504d967e404a7b2609005b4d39a2c3bf92053cc54b1a406428823
+  data.tar.gz: 2657ab28f5dba0e60878e91a92b4fd65de6d21f16f78cfe4307ecf9c77c94759c2a973a3054c02978b3188837dc05c338b1beaa183a3b0c3d0626539bfd68e4f

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.2.0
+  - 2.1.0
+  - 2.0.0
+  - 1.9.3
+gemfile:
+  - gemfiles/Gemfile-rails.3.1.x
+  - gemfiles/Gemfile-rails.3.2.x
+  - gemfiles/Gemfile-rails.4.0.x
+  - gemfiles/Gemfile-rails.4.1.x
+before_script:
+  - "cd test/dummy; rake db:migrate; rake db:test:prepare; cd ../.."
+notifications:
+  email: false

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,376 @@
+## Fork of gretel removing dependency on rails gem and using more granual dependencies instead
+
+
+<a href="http://travis-ci.org/lassebunk/gretel"><img src="https://secure.travis-ci.org/lassebunk/gretel.png" alt="Build Status" /></a>
+
+<img src="http://i.imgur.com/CAKEaBM.png" alt="Handle breadcrumb trails... like a boss :)" />
+
+([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 "gretel"
+```
+
+And run:
+
+```bash
+$ bundle install
+```
+
+## Example
+
+Start by generating breadcrumbs configuration file:
+
+```bash
+$ rails generate 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"`
+: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
+
+Since Gretel version 2.1.0, 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.
+
+### Setting breadcrumb trails
+
+The [gretel-trails](https://github.com/lassebunk/gretel-trails) gem can handle adding and hiding trails from the URL automatically. This makes it possible to link back to a different breadcrumb trail than the one specified in your breadcrumb, for example if you have a
+store with products that have a default parent to the category breadcrumb, but when visiting from the reviews section, you want to link back to the reviews instead.
+
+You can apply trails to select links by adding a simple JS selector (`js-append-trail` or another you choose), and after each page load it hides the trail from the URL, so the server sees it but the users don't.
+
+Check out the gem [here](https://github.com/lassebunk/gretel-trails).
+
+
+## Upgrading from version 2.0 or below
+
+Instead of using the initializer that in Gretel version 2.0 and below required restarting the application after breadcrumb configuration changes, the configuration of the breadcrumbs is now loaded from `config/breadcrumbs.rb` (and `config/breadcrumbs/*.rb` if you want to split your breadcrumbs configuration across multiple files).
+In the Rails development environment, these files are automatically reloaded when changed.
+
+Using the initializer (e.g. `config/initializers/breadcrumbs.rb`) was deprecated in Gretel version 2.1.0 and removed in version 3.0. It raises an error if you try to use it.
+
+To update to the latest version of Gretel, use `bundle update gretel`. Then remove the `Gretel::Crumbs.layout do ... end` block, so instead of:
+
+```ruby
+Gretel::Crumbs.layout do
+  crumb :root do
+    link "Home", root_path
+  end
+end
+```
+
+in the initializer, you write:
+
+```ruby
+crumb :root do
+  link "Home", root_path
+end
+```
+
+in `config/breadcrumbs.rb`.
+
+## Documentation
+
+* [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) and is maintained by [@WilHall](https://github.com/WilHall).
+
+[See the list of contributors](https://github.com/lassebunk/gretel/graphs/contributors)
+
+## 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), released under the MIT license