RubyGems - gretel-trails - Versions diffs - 0.0.1 - Mend

gretel-trails 0.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (67) hide show

checksums.yaml +7 -0
data/.gitignore +23 -0
data/.travis.yml +11 -0
data/Gemfile +18 -0
data/LICENSE.txt +22 -0
data/README.md +123 -0
data/Rakefile +10 -0
data/gretel-trails.gemspec +28 -0
data/lib/assets/javascripts/gretel.trails.hidden.js.coffee.erb +32 -0
data/lib/assets/javascripts/gretel.trails.jsuri.js.coffee +370 -0
data/lib/gretel/trails/engine.rb +6 -0
data/lib/gretel/trails/strategies/hidden_strategy.rb +57 -0
data/lib/gretel/trails/version.rb +5 -0
data/lib/gretel/trails.rb +25 -0
data/lib/gretel-trails.rb +1 -0
data/test/dummy/README.rdoc +261 -0
data/test/dummy/Rakefile +7 -0
data/test/dummy/app/assets/javascripts/application.js +16 -0
data/test/dummy/app/assets/stylesheets/application.css +13 -0
data/test/dummy/app/controllers/application_controller.rb +3 -0
data/test/dummy/app/controllers/categories_controller.rb +5 -0
data/test/dummy/app/controllers/products_controller.rb +13 -0
data/test/dummy/app/controllers/reviews_controller.rb +5 -0
data/test/dummy/app/helpers/application_helper.rb +2 -0
data/test/dummy/app/mailers/.gitkeep +0 -0
data/test/dummy/app/models/.gitkeep +0 -0
data/test/dummy/app/models/category.rb +11 -0
data/test/dummy/app/models/product.rb +11 -0
data/test/dummy/app/views/categories/show.html.erb +9 -0
data/test/dummy/app/views/layouts/application.html.erb +16 -0
data/test/dummy/app/views/products/recent.html.erb +9 -0
data/test/dummy/app/views/products/show.html.erb +17 -0
data/test/dummy/app/views/reviews/index.html.erb +13 -0
data/test/dummy/config/application.rb +59 -0
data/test/dummy/config/boot.rb +10 -0
data/test/dummy/config/breadcrumbs.rb +21 -0
data/test/dummy/config/database.yml +25 -0
data/test/dummy/config/environment.rb +5 -0
data/test/dummy/config/environments/development.rb +37 -0
data/test/dummy/config/environments/production.rb +67 -0
data/test/dummy/config/environments/test.rb +37 -0
data/test/dummy/config/initializers/backtrace_silencers.rb +7 -0
data/test/dummy/config/initializers/gretel.rb +2 -0
data/test/dummy/config/initializers/inflections.rb +15 -0
data/test/dummy/config/initializers/mime_types.rb +5 -0
data/test/dummy/config/initializers/secret_token.rb +7 -0
data/test/dummy/config/initializers/session_store.rb +8 -0
data/test/dummy/config/initializers/wrap_parameters.rb +14 -0
data/test/dummy/config/locales/en.yml +5 -0
data/test/dummy/config/routes.rb +9 -0
data/test/dummy/config.ru +4 -0
data/test/dummy/db/migrate/20131016195709_create_products.rb +13 -0
data/test/dummy/db/migrate/20131016195903_create_categories.rb +11 -0
data/test/dummy/db/migrate/20131016201943_create_gretel_trails.rb +11 -0
data/test/dummy/db/schema.rb +45 -0
data/test/dummy/lib/assets/.gitkeep +0 -0
data/test/dummy/log/.gitkeep +0 -0
data/test/dummy/public/404.html +26 -0
data/test/dummy/public/422.html +26 -0
data/test/dummy/public/500.html +25 -0
data/test/dummy/public/favicon.ico +0 -0
data/test/dummy/script/rails +6 -0
data/test/dummy/test/fixtures/categories.yml +9 -0
data/test/dummy/test/fixtures/products.yml +11 -0
data/test/gretel_trails_test.rb +67 -0
data/test/test_helper.rb +28 -0
metadata +272 -0

checksums.yaml ADDED Viewed

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 75ba4eea078b14bb0d61eb137262d08d24388554
+  data.tar.gz: aacf75c20b0fea1e345149b423e73a38dc165c6f
+SHA512:
+  metadata.gz: 1ccee9ba8ed783a89dc99844d5d090b562f582a28520e68360ebe1e97c13d9a1cde904d3ceb78b3cd7a626e6365a813905d5ee7ecbb46bea2934316b371d7b48
+  data.tar.gz: 304d444bfdde884621754e8e9b3499dad62554e6092f7c2361cd117e9006ecdca79874f259b99a02f8c7071a543c8747d05d677e8f22458818a9c20b434fba0d

data/.gitignore ADDED Viewed

@@ -0,0 +1,23 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.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 ADDED Viewed

@@ -0,0 +1,11 @@
+language: ruby
+rvm:
+  - 2.0.0
+  - 1.9.3
+before_install:
+  - "export DISPLAY=:99.0"
+  - "sh -e /etc/init.d/xvfb start"
+before_script:
+  - "cd test/dummy; rake db:migrate; rake db:test:prepare; cd ../.."
+notifications:
+  email: false

data/Gemfile ADDED Viewed

@@ -0,0 +1,18 @@
+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
+# Used by the dummy application
+gem "jquery-rails"
+gem "coffee-rails"
+# 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'

data/LICENSE.txt ADDED Viewed

@@ -0,0 +1,22 @@
+Copyright (c) 2013 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 ADDED Viewed

@@ -0,0 +1,123 @@
+[![Build Status](https://secure.travis-ci.org/lassebunk/gretel-trails.png)](http://travis-ci.org/lassebunk/gretel-trails)
+# Gretel::Trails
+Gretel::Trails makes it easy to hide [Gretel](https://github.com/lassebunk/gretel) breadcrumb trails from the user, so they don't see them in URLs when navigating your site.
+## Installation
+Add this line to your Gemfile:
+```bash
+gem 'gretel-trails'
+```
+And run:
+```bash
+$ bundle
+```
+In an initializer, e.g. *config/initializers/gretel.rb*:
+```ruby
+Gretel::Trails.strategy = :hidden
+```
+Add a data attribute with the trail to your `<body>` tag, in *application.html.erb*:
+```erb
+<body data-trail="<%= breadcrumb_trail %>">
+...
+```
+And finally, at the bottom of *app/assets/javascripts/application.js*:
+```js
+//= require gretel.trails.hidden
+```
+Breadcrumb trails are now hidden from the user so they don't see them in URLs. It uses data attributes and `history.replaceState` to hide the trails from the URL.
+For older browsers it falls back gracefully to showing trails in the URL, as specified by `Gretel.trail_param`.
+Note: If you use [Turbolinks](https://github.com/rails/turbolinks), it's important that you add the require *after* you require Turbolinks. Else it won't work.
+## Usage
+When you want to invisibly add the current trail when the user clicks a link, you add a special JS selector to the link where you want the trail added on click:
+```erb
+<% @products.each do |product| %>
+  <%= link_to "My product", product, class: "js-append-trail" %>
+<% end %>
+```
+Trails are now transferred invisibly to the next page when the user clicks a link.
+See Customization below for info on changing the `.js-append-trail` selector.
+### Custom links
+Inside breadcrumbs, the links are automatically transformed with trails removed from the URLs and applied as data attributes instead.
+If you want to do custom breadcrumb links with these changes applied, you can use the `breadcrumb_link_to` helper:
+```erb
+<% parent_breadcrumb do |parent| %>
+  <%= breadcrumb_link_to "Back to #{parent.text}", parent.url %>
+<% end %>
+```
+The link will now have a URL without the trail param and `data-trail` containing the trail.
+## Customization
+### JS selector
+If you want to customize the JS selector (the default is `.js-append-trail`), you can do so in an initializer:
+```ruby
+Gretel::Trails::HiddenStrategy.js_selector = ".my-other-selector"
+```
+It supports all [CSS selectors](http://api.jquery.com/category/selectors/) that you can use in jQuery.
+### Data attribute
+The default trail data attribute for `<body>` and links is `data-trail` but you can change this in an initializer:
+```ruby
+Gretel::Trails::HiddenStrategy.data_attribute = "other-data-attribute"
+```
+That's it. :)
+### Trail param
+The trail param that's hidden from the user is `params[:trail]` by default. You can change this in an initializer:
+```ruby
+Gretel.trail_param = :other_param
+```
+## Requirements
+* Ruby >= 1.9.3 (1.9.2 may work)
+* Rails >= 3.2.0
+* Gretel >= 3.0.0
+* jQuery
+## Contributing
+You are very welcome to contribute with bug fixes or new features. To contribute:
+1. Fork the project
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new pull request
+## Versioning
+Follows [semantic versioning](http://semver.org/).
+Copyright (c) 2013 [Lasse Bunk](http://lassebunk.dk), released under the MIT license

data/Rakefile ADDED Viewed

@@ -0,0 +1,10 @@
+require 'rake/testtask'
+require 'bundler/gem_tasks'
+Rake::TestTask.new do |t|
+  t.libs << "test"
+  t.test_files = FileList['test/**/*_test.rb']
+  t.verbose = true
+end
+task default: :test

data/gretel-trails.gemspec ADDED Viewed

@@ -0,0 +1,28 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'gretel/trails/version'
+Gem::Specification.new do |spec|
+  spec.name          = "gretel-trails"
+  spec.version       = Gretel::Trails::VERSION
+  spec.authors       = ["Lasse Bunk"]
+  spec.email         = ["lassebunk@gmail.com"]
+  spec.description   = %q{Gretel::Trails is a collection of strategies for handling Gretel trails.}
+  spec.summary       = %q{Collection of strategies for handling Gretel trails.}
+  spec.homepage      = "https://github.com/lassebunk/gretel-trails"
+  spec.license       = "MIT"
+  spec.files         = `git ls-files`.split($/)
+  spec.test_files    = spec.files.grep(%r{^test/})
+  spec.require_paths = ["lib"]
+  spec.add_dependency "gretel", ">= 3.0.0.beta4"
+  spec.add_dependency "rails", ">= 3.2.0"
+  spec.add_development_dependency "rails", "~> 3.2.13"
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "sqlite3"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "capybara", "~> 2.1.0"
+  spec.add_development_dependency "capybara-webkit", "~> 1.0.0"
+end

data/lib/assets/javascripts/gretel.trails.hidden.js.coffee.erb ADDED Viewed

@@ -0,0 +1,32 @@
+//= require gretel.trails.jsuri
+<%
+unless defined?(Gretel::Trails::HiddenStrategy)
+  raise "Gretel::Trails::HiddenStrategy` was not found. Please add `Gretel::Trails.strategy = :hidden` to an initializer."
+end
+%>
+# Remove trail from querystring
+removeTrailFromUrl = ->
+  if history.replaceState?
+    return if location.href.indexOf("<%= Gretel.trail_param %>=") is -1
+    uri = new Gretel.Trails.Uri(location.href)
+    history.replaceState history.state, document.title, uri.deleteQueryParam("<%= Gretel.trail_param %>")
+# Remove trail on load
+removeTrailFromUrl()
+if Turbolinks?
+  # Remove trail after page change
+  $(document).on "page:change", -> removeTrailFromUrl()
+# Add trails to querystring
+$ ->
+  $("body").on "click", "[data-<%= Gretel::Trails::HiddenStrategy.data_attribute %>], <%= Gretel::Trails::HiddenStrategy.js_selector %>", ->
+    if trail = $(this).data("<%= Gretel::Trails::HiddenStrategy.data_attribute %>") || $("body").data("<%= Gretel::Trails::HiddenStrategy.data_attribute %>")
+      href = $(this).attr("href")
+      uri = new Gretel.Trails.Uri(href)
+      href = uri.deleteQueryParam("<%= Gretel.trail_param %>").addQueryParam("<%= Gretel.trail_param %>", trail)
+      $(this).attr("href", href)
+    else
+      console?.log "[Gretel] No `data-<%= Gretel::Trails::HiddenStrategy.data_attribute %>` was found on the <body> tag or the link you just clicked. Please set it using the `breadcrumb_trail` helper or see the Gretel::Trails readme for more info."

data/lib/assets/javascripts/gretel.trails.jsuri.js.coffee ADDED Viewed

@@ -0,0 +1,370 @@
+#!
+# * jsUri v1.1.1 – ported to CoffeeScript with http://js2coffee.org/
+# * https://github.com/derek-watson/jsUri
+# *
+# * Copyright 2011, Derek Watson
+# * Released under the MIT license.
+# * http://jquery.org/license
+# *
+# * Includes parseUri regular expressions
+# * http://blog.stevenlevithan.com/archives/parseuri
+# * Copyright 2007, Steven Levithan
+# * Released under the MIT license.
+# *
+# * Date: Mon Nov 14 20:06:34 2011 -0800
+#
+window.Gretel or= {}
+window.Gretel.Trails or= {}
+window.Gretel.Trails.Query = (queryString) ->
+  # query string parsing, parameter manipulation and stringification
+  "use strict"
+  # parseQuery(q) parses the uri query string and returns a multi-dimensional array of the components
+  parseQuery = (q) ->
+    arr = []
+    i = undefined
+    ps = undefined
+    p = undefined
+    keyval = undefined
+    return arr  if typeof (q) is "undefined" or q is null or q is ""
+    q = q.substring(1)  if q.indexOf("?") is 0
+    ps = q.toString().split(/[&;]/)
+    i = 0
+    while i < ps.length
+      p = ps[i]
+      keyval = p.split("=")
+      arr.push [keyval[0], keyval[1]]
+      i++
+    arr
+  params = parseQuery(queryString)
+  # toString() returns a string representation of the internal state of the object
+  toString = ->
+    s = ""
+    i = undefined
+    param = undefined
+    i = 0
+    while i < params.length
+      param = params[i]
+      s += "&"  if s.length > 0
+      s += param.join("=")
+      i++
+    (if s.length > 0 then "?" + s else s)
+  decode = (s) ->
+    s = decodeURIComponent(s)
+    s = s.replace("+", " ")
+    s
+  # getParamValues(key) returns the first query param value found for the key 'key'
+  getParamValue = (key) ->
+    param = undefined
+    i = undefined
+    i = 0
+    while i < params.length
+      param = params[i]
+      return param[1]  if decode(key) is decode(param[0])
+      i++
+  # getParamValues(key) returns an array of query param values for the key 'key'
+  getParamValues = (key) ->
+    arr = []
+    i = undefined
+    param = undefined
+    i = 0
+    while i < params.length
+      param = params[i]
+      arr.push param[1]  if decode(key) is decode(param[0])
+      i++
+    arr
+  # deleteParam(key) removes all instances of parameters named (key)
+  # deleteParam(key, val) removes all instances where the value matches (val)
+  deleteParam = (args...) ->
+    [key, val] = args
+    arr = []
+    i = undefined
+    param = undefined
+    keyMatchesFilter = undefined
+    valMatchesFilter = undefined
+    i = 0
+    while i < params.length
+      param = params[i]
+      keyMatchesFilter = decode(param[0]) is decode(key)
+      valMatchesFilter = decode(param[1]) is decode(val)
+      arr.push param  if (args.length is 1 and not keyMatchesFilter) or (args.length is 2 and not keyMatchesFilter and not valMatchesFilter)
+      i++
+    params = arr
+    this
+  # addParam(key, val) Adds an element to the end of the list of query parameters
+  # addParam(key, val, index) adds the param at the specified position (index)
+  addParam = (args...) ->
+    [key, val, index] = args
+    if args.length is 3 and index isnt -1
+      index = Math.min(index, params.length)
+      params.splice index, 0, [key, val]
+    else params.push [key, val]  if args.length > 0
+    this
+  # replaceParam(key, newVal) deletes all instances of params named (key) and replaces them with the new single value
+  # replaceParam(key, newVal, oldVal) deletes only instances of params named (key) with the value (val) and replaces them with the new single value
+  # this function attempts to preserve query param ordering
+  replaceParam = (args...) ->
+    [key, newVal, oldVal] = args
+    index = -1
+    i = undefined
+    param = undefined
+    if args.length is 3
+      i = 0
+      while i < params.length
+        param = params[i]
+        if decode(param[0]) is decode(key) and decodeURIComponent(param[1]) is decode(oldVal)
+          index = i
+          break
+        i++
+      deleteParam(key, oldVal).addParam key, newVal, index
+    else
+      i = 0
+      while i < params.length
+        param = params[i]
+        if decode(param[0]) is decode(key)
+          index = i
+          break
+        i++
+      deleteParam key
+      addParam key, newVal, index
+    this
+  # public api
+  getParamValue: getParamValue
+  getParamValues: getParamValues
+  deleteParam: deleteParam
+  addParam: addParam
+  replaceParam: replaceParam
+  toString: toString
+window.Gretel.Trails.Uri = (uriString) ->
+  # uri string parsing, attribute manipulation and stringification
+  "use strict"
+  #global Query: true
+  #jslint regexp: false, plusplus: false
+  strictMode = false
+  # parseUri(str) parses the supplied uri and returns an object containing its components
+  parseUri = (str) ->
+    #jslint unparam: true
+    parsers =
+      strict: /^(?:([^:\/?#]+):)?(?:\/\/((?:(([^:@]*)(?::([^:@]*))?)?@)?([^:\/?#]*)(?::(\d*))?))?((((?:[^?#\/]*\/)*)([^?#]*))(?:\?([^#]*))?(?:#(.*))?)/
+      loose: /^(?:(?![^:@]+:[^:@\/]*@)([^:\/?#.]+):)?(?:\/\/)?((?:(([^:@]*)(?::([^:@]*))?)?@)?([^:\/?#]*)(?::(\d*))?)(((\/(?:[^?#](?![^?#\/]*\.[^?#\/.]+(?:[?#]|$)))*\/?)?([^?#\/]*))(?:\?([^#]*))?(?:#(.*))?)/
+    keys = ["source", "protocol", "authority", "userInfo", "user", "password", "host", "port", "relative", "path", "directory", "file", "query", "anchor"]
+    q =
+      name: "queryKey"
+      parser: /(?:^|&)([^&=]*)=?([^&]*)/g
+    m = parsers[(if strictMode then "strict" else "loose")].exec(str)
+    uri = {}
+    i = 14
+    uri[keys[i]] = m[i] or ""  while i--
+    uri[q.name] = {}
+    uri[keys[12]].replace q.parser, ($0, $1, $2) ->
+      uri[q.name][$1] = $2  if $1
+    uri
+  uriParts = parseUri(uriString or "")
+  queryObj = new Gretel.Trails.Query(uriParts.query)
+  #
+  #            Basic get/set functions for all properties
+  #
+  protocol = (val) ->
+    uriParts.protocol = val  if typeof val isnt "undefined"
+    uriParts.protocol
+  hasAuthorityPrefixUserPref = null
+  # hasAuthorityPrefix: if there is no protocol, the leading // can be enabled or disabled
+  hasAuthorityPrefix = (val) ->
+    hasAuthorityPrefixUserPref = val  if typeof val isnt "undefined"
+    if hasAuthorityPrefixUserPref is null
+      uriParts.source.indexOf("//") isnt -1
+    else
+      hasAuthorityPrefixUserPref
+  userInfo = (val) ->
+    uriParts.userInfo = val  if typeof val isnt "undefined"
+    uriParts.userInfo
+  host = (val) ->
+    uriParts.host = val  if typeof val isnt "undefined"
+    uriParts.host
+  port = (val) ->
+    uriParts.port = val  if typeof val isnt "undefined"
+    uriParts.port
+  path = (val) ->
+    uriParts.path = val  if typeof val isnt "undefined"
+    uriParts.path
+  query = (val) ->
+    queryObj = new Gretel.Trails.Query(val)  if typeof val isnt "undefined"
+    queryObj
+  anchor = (val) ->
+    uriParts.anchor = val  if typeof val isnt "undefined"
+    uriParts.anchor
+  #
+  #            Fluent setters for Uri uri properties
+  #
+  setProtocol = (val) ->
+    protocol val
+    this
+  setHasAuthorityPrefix = (val) ->
+    hasAuthorityPrefix val
+    this
+  setUserInfo = (val) ->
+    userInfo val
+    this
+  setHost = (val) ->
+    host val
+    this
+  setPort = (val) ->
+    port val
+    this
+  setPath = (val) ->
+    path val
+    this
+  setQuery = (val) ->
+    query val
+    this
+  setAnchor = (val) ->
+    anchor val
+    this
+  #
+  #            Query method wrappers
+  #
+  getQueryParamValue = (key) ->
+    query().getParamValue key
+  getQueryParamValues = (key) ->
+    query().getParamValues key
+  deleteQueryParam = (args...) ->
+    [key, val] = args
+    if args.length is 2
+      query().deleteParam key, val
+    else
+      query().deleteParam key
+    this
+  addQueryParam = (args...) ->
+    [key, val, index] = args
+    if args.length is 3
+      query().addParam key, val, index
+    else
+      query().addParam key, val
+    this
+  replaceQueryParam = (args...) ->
+    [key, newVal, oldVal] = args
+    if args.length is 3
+      query().replaceParam key, newVal, oldVal
+    else
+      query().replaceParam key, newVal
+    this
+  #
+  #            Serialization
+  #
+  # toString() stringifies the current state of the uri
+  toString = ->
+    s = ""
+    is_ = (s) ->
+      s isnt null and s isnt ""
+    if is_(protocol())
+      s += protocol()
+      s += ":"  if protocol().indexOf(":") isnt protocol().length - 1
+      s += "//"
+    else
+      s += "//"  if hasAuthorityPrefix() and is_(host())
+    if is_(userInfo()) and is_(host())
+      s += userInfo()
+      s += "@"  if userInfo().indexOf("@") isnt userInfo().length - 1
+    if is_(host())
+      s += host()
+      s += ":" + port()  if is_(port())
+    if is_(path())
+      s += path()
+    else
+      s += "/"  if is_(host()) and (is_(query().toString()) or is_(anchor()))
+    if is_(query().toString())
+      s += "?"  if query().toString().indexOf("?") isnt 0
+      s += query().toString()
+    if is_(anchor())
+      s += "#"  if anchor().indexOf("#") isnt 0
+      s += anchor()
+    s
+  #
+  #            Cloning
+  #
+  # clone() returns a new, identical Uri instance
+  clone = ->
+    new Uri(toString())
+  # public api
+  protocol: protocol
+  hasAuthorityPrefix: hasAuthorityPrefix
+  userInfo: userInfo
+  host: host
+  port: port
+  path: path
+  query: query
+  anchor: anchor
+  setProtocol: setProtocol
+  setHasAuthorityPrefix: setHasAuthorityPrefix
+  setUserInfo: setUserInfo
+  setHost: setHost
+  setPort: setPort
+  setPath: setPath
+  setQuery: setQuery
+  setAnchor: setAnchor
+  getQueryParamValue: getQueryParamValue
+  getQueryParamValues: getQueryParamValues
+  deleteQueryParam: deleteQueryParam
+  addQueryParam: addQueryParam
+  replaceQueryParam: replaceQueryParam
+  toString: toString
+  clone: clone

data/lib/gretel/trails/engine.rb ADDED Viewed

@@ -0,0 +1,6 @@
+module Gretel
+  module Trails
+    class Engine < ::Rails::Engine
+    end
+  end
+end