redirectr 0.1.1 → 1.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 2d2e5bda91ce0407fb196a450cf6adf0fc33aba2
-  data.tar.gz: bc3a10bed54b7ff7a3804d2894de0c8cb64d3a2d
+SHA256:
+  metadata.gz: aab12433022382d5fc61e4964d815430d39cf08aec7b6bbc32672065fdf7d115
+  data.tar.gz: 54b286ec8bc69898564184f1d2488189b3523f0da279d8d61b0ac3cd7444176a
 SHA512:
-  metadata.gz: 3f6eba38b0be27a841e24ed82381723befad33f545cd6ac603f8da33e91d582afb7b4d826a7e65032d6f48113cc2c8ddd7c77bb8adab01c24e62694f05b3cbca
-  data.tar.gz: 9bc23622bb0a245bff831d0c7323149e91da3c44c011d8209cf22a90b9c0ae1c9d07d84ad011492bb6a5631423c3aa399be8763fceb2abebc1b745a4066275df
+  metadata.gz: 96332b3a061883e9b49881d74d1a54475f2850f4b9952404c5bf7bc2e478fc698c3e0097b5ea2cc53075274632249f34d80e390b2692ff95936c309065c04eb1
+  data.tar.gz: 582e0f5a9a7175068924b6d5dec1d7ef2044b14b6c935861d35dc555302cfd461317425ea69e913fa92c46be903d185753e2f925fe2130247da156008c8cba25

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright 2020 Willem van Kerkhof
+
+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,153 @@
+# Redirectr
+
+In many web applications, the user triggers actions that result in simple or complex workflows that should, after that workflow is finished, result in the user being redirected to the page where he initially started it. Another example would be a "back"-Link on any page.
+A simple but completely Un-RESTful way would be to store the "current" page in a cookie each time the user calls an action and redirect to the url stored there if needed.
+
+A much better (and potentially even cacheable) way is to encode the "backlink" URL in an URL parameter or form field and pass it along with every workflow step until the last (or only) action uses it to redirect the user back to where he initially came from.
+
+Redirectr really does nothing more than provide a simple API for exactly that.
+
+Redirectr provides a few Controller and Helper methods that will be included in your ApplicationController and ApplicationHelper, respectively.
+
+## Installation
+
+when Using bundler, just at the following to your Gemfile
+
+    gem 'redirectr'
+
+and then call
+
+    bundle install
+
+## Migrating from 0.1.x to 1.0.0
+
+Please read this section if you are already using an older version of Redirectr in yout project. Otherwise, you may skip it.
+
+Pre-1.0 versions of Redirectr automatically included some view helpers (`hidden_referrer_input_tag`, `link_to_back`). This is no longer the case, so please add the following to your `app/helper/application_helper.rb`:
+
+    module ApplicationHelper
+      include Redirectr::ApplicationHelper
+    end
+
+Please note that methods like `current_path`, `referrer_path` have been removed. Only `current_url`, `referrer_url` exist. Please do also note that the value returned by these methods is not a String containing an URI value anymore. Instead, a Redirectr::ReferrerToken is returned which maps a token to an URI. To get the URI value, call `#to_s` (e.g. when used in a `redirect_to` call). When used as an URL parameter, Rails calls `#to_param` which returns the token.
+
+Summary:
+
+    # pre-1.0.0:
+    referrer_url.inspect # => 'https://example.com/...'
+    redirect_to referrer_url
+    redirect_to back_or_default
+
+    # post-1.0.0:
+    referrer_url.inspect # => '#<Redirectr::ReferrerToken:... @url="..." @token="...">'
+    redirect_to referrer_url.to_s
+    redirect_to back_or_default.to_s
+    # OR, if you mount Redirectr::Engine in your routes
+    redirect_to referrer_url
+    redirect_to back_or_default
+
+    # pre-1.0.0:
+    link_to 'take me back', back_or_default(my_url)
+
+    # post-1.0.0:
+    link_to 'take me back', back_or_default(my_url).to_s
+    # OR, if you mount Redirectr::Engine in your routes
+    link_to 'take me back', back_or_default(my_url)
+
+## Examples
+
+### Contact Form
+
+Suppose you have an application with a contact form that can be reached via a footer link on every page. After submitting the form, the user should be redirected to the page he was before clicking on the "contact form" link.
+
+for the footer link to the contact form:
+
+    <%= link_to 'Contact us!', new_contact_path(referrer_param => current_url) %>
+
+In the 'new contact' view:
+
+    <%= form_for ... do |f| %>
+      <%= hidden_referrer_input_tag %>
+      <!-- ... -->
+    <% end %>
+
+and finally, in the 'create' action of your ContactsController:
+
+    def create
+      # ...
+      redirect_to back_or_default.to_s
+    end
+
+### Custom default_url
+
+The above will redirect the user back to the page specified in the referrer param. However, if you want to provide a custom fallback url per controller in case no referrer param is provided, just define the `#default_url` in your controller:
+
+    class MyController < ApplicationController
+      def default_url
+        if @record
+          my_record_path(@record)
+        else
+          my_record_index_path
+        end
+      end
+    end
+
+### Nesting referrers
+
+Referrer params can be nested, which is helpful if your workflow involves branching into subworkflows. Thus, it is always possible to pass the referrer_param to another url:
+
+    <%= link_to 'go back directly', referrer_or_current_url %>
+    <%= link_to 'add new Foobar before going back', new_foobar_url(:foobar =>  {:name => 'My Foo'}, referrer_param => referrer_or_current_url) %>
+
+NOTE: If your URLs include lots of params, it is very advisable to use Referrer Tokens instead of plain URLs to avoud "URI too long" errors. See next section.
+
+## Unvalidated Redirect Mitigation
+
+Simply redirecting to an URI provided by HTTP params is considered a security vulnerability (see OWASP cheat sheet https://cheatsheetseries.owasp.org/cheatsheets/Unvalidated_Redirects_and_Forwards_Cheat_Sheet.html). Earlier versions of redirectr did not take any potential issues into account, allowing all kinds of phishing attacs.
+
+Redirectr offers three kinds of mitigation, two of them being optional:
+
+* checking the referrer param against a whitelist before performing a redirect (mandatory): by default, the request's host name and port number are allowed and all other hosts are disallowed.
+* encrypting and signing the referrer URL using the Rails secret key base: makes the referrer param absolutely tamper-proof but requires all services to use the same secret_key_base in a multi-service deployment.
+* using random tokens instead of referrer URLs and an token-to-URL lookup service. This leaves you with the additional side effect of also having an URL shortener.
+
+### Using the whitelist
+
+By default, Redirectr checks the protocol, hostname and port of the referrer against the corresponding values of the current request. You may add your own:
+
+    YourApp::Application.configure do
+      config.x.redirectr.whitelist = %w( http://localhost:3000 https://my.host.com )
+    end
+
+### Token instead of URL (URL-shortener)
+
+Instead of using a URL in the referrer token, redirectr can act as an URL shortener that maps random tokens to URLs. This requires a storage_implementation to be defined:
+
+
+    require 'redirectr/referrer_token/active_record_storage'
+
+    YourApp::Application.configure do
+      config.x.redirectr.use_referrer_token = true
+      config.x.redirectr.reuse_tokens = true # set to false to generate a new token for each and every link
+      config.x.redirectr.storage_implementation = Redirectr::ReferrerToken::ActiveRecordStorage
+    end
+
+This example requires a table named 'redirectr_referrer_tokens' to be present with two columns: `url` and `token`. To install and apply the required schema migration, run:
+
+    bundle exec rails redirectr:install:migrations
+    bundle exec rails db:migrate
+
+Redirectr::ReferrerToken has two representations: #to_s displays the URL and #to_param its tokenized form. Depending on your config, this can be either a random token, an encrypted URL or the plaintext URL.
+
+## Contributions
+
+Contributions like bugfixes and new ideas are more than welcome. Please just fork this project on github (https://github.com/wvk/redirectr) and send me a pull request with your changes.
+
+Thanks so far to:
+
+* Falk Hoppe for Rails 2.3.x interoperability
+* Dimitar Haralanov for Rails 3.0.x interoperability
+* Raffael Schmid for spotting a typo in the gemspec description ;)
+* Till Schulte-Coerne for removing implicit dependencies and cleaning up unused code
+
+Copyright (c) 2010 Willem van Kerkhof <wvk@consolving.de>, released under the MIT license

data/Rakefile

@@ -0,0 +1,32 @@
+begin
+  require 'bundler/setup'
+rescue LoadError
+  puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
+end
+
+require 'rdoc/task'
+
+RDoc::Task.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'Redirectr'
+  rdoc.options << '--line-numbers'
+  rdoc.rdoc_files.include('README.md')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+APP_RAKEFILE = File.expand_path("test/dummy/Rakefile", __dir__)
+load 'rails/tasks/engine.rake'
+
+load 'rails/tasks/statistics.rake'
+
+require 'bundler/gem_tasks'
+
+require 'rake/testtask'
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'test'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = false
+end
+
+task default: :test

data/app/helpers/redirectr/application_helper.rb

@@ -0,0 +1,19 @@
+module Redirectr
+  module ApplicationHelper
+    # Create a link back to the path specified in the referrer-param.
+    # title can be either a text string or anything else like an image.
+    # Remember to call #html_safe on the title argument if it contains
+    # HTML and you are using Rails >=3.
+    def link_to_back(title, options = {})
+      link_to title, back_or_default.to_s, options.merge(rel: 'back')
+    end
+
+    # Create a hidden input field containing the referrer or current path.
+    # Handy for use in forms that are called with a referrer param which
+    # has to be passed on and respected by the form processing action.
+    def hidden_referrer_input_tag(options = {})
+      hidden_field_tag :referrer, referrer_or_current_url.to_param, options
+    end
+
+  end
+end

data/config/routes.rb

@@ -0,0 +1,5 @@
+Redirectr::Engine.routes.draw do
+
+  #resources :referrer_tokens # for future use as URL shortener
+
+end

data/db/migrate/20201120110532_create_redirectr_referrer_tokens.rb

@@ -0,0 +1,10 @@
+class CreateRedirectrReferrerTokens < ActiveRecord::Migration[6.0]
+  def change
+    create_table :redirectr_referrer_tokens do |t|
+      t.string :url,   index: true
+      t.string :token, unique: true
+
+      t.timestamps
+    end
+  end
+end

data/lib/redirectr/engine.rb

@@ -0,0 +1,5 @@
+module Redirectr
+  class Engine < ::Rails::Engine
+    #isolate_namespace Redirectr
+  end
+end

data/lib/redirectr/referrer_token/active_record_storage.rb

@@ -0,0 +1,28 @@
+module Redirectr
+  class ReferrerToken
+
+    # this is a stora implementation for activerecord-
+    class ActiveRecordStorage < ActiveRecord::Base
+      validates_presence_of :url, :token
+
+      self.table_name = :redirectr_referrer_tokens
+
+      class << self
+        def store(record)
+          self.find_or_create_by url: record.url, token: record.token
+          record.url
+        end
+
+        def fetch(token)
+          url = self.find_by(token: token)&.url
+          ReferrerToken(url) if url
+        end
+
+        def token_for_url(url)
+          self.find_by(url: url)&.token
+        end
+      end
+    end
+
+  end
+end

data/lib/redirectr/referrer_token/global_var_storage.rb

@@ -0,0 +1,26 @@
+module Redirectr
+  class ReferrerToken
+
+    class GlobalVarStorage
+
+      def persisted?
+        false
+      end
+
+      class << self
+        def store(record)
+          $referrer_lookup[record.token] = record.url
+        end
+
+        def fetch(token)
+          ReferrerToken($referrer_lookup[token])
+        end
+
+        def token_for_url(url)
+          $referrer_lookup.key(url)
+        end
+      end
+    end
+
+  end
+end

data/lib/redirectr/referrer_token.rb

@@ -0,0 +1,73 @@
+require 'active_model'
+
+module Redirectr
+  class ReferrerToken
+
+    extend ActiveModel::Naming
+
+    attr_reader :url, :token
+
+    def initialize(url, token=nil)
+      @url   = url
+      @token = token
+
+      if Redirectr.config.use_referrer_token
+        if Redirectr.config.storage_implementation.nil?
+          raise "Missing storage implementation for referrer tokens! please define config.x.redirectr.storage_implementation"
+        end
+
+        if Redirectr.config.reuse_tokens
+          @token ||= Redirectr.config.storage_implementation.token_for_url(url)
+        end
+        @token ||= SecureRandom.hex(16)
+      elsif Redirectr.config.encrypt_referrer
+        @token ||= self.class.cryptr.encrypt_and_sign url
+      else
+        @token ||= url
+      end
+    end
+
+    def to_param
+      @token
+    end
+
+    def to_model
+      self
+    end
+
+    def to_s
+      @url
+    end
+
+    def persisted?
+      true
+    end
+
+    def save
+      if Redirectr.config.use_referrer_token
+        Redirectr.config.storage_implementation.store self
+      end
+    end
+
+    def self.from_param(param)
+      if Redirectr.config.encrypt_referrer
+        ReferrerToken.new self.class.cryptr.decrypt_and_verify param
+      elsif Redirectr.config.use_referrer_token
+        self.lookup(param)
+      else
+        ReferrerToken.new param
+      end
+    end
+
+    def self.lookup(token)
+      Redirectr.config.storage_implementation.fetch token
+    end
+
+    private
+
+    def self.cryptr
+      @cryptr ||= ActiveSupport::MessageEncryptor.new(Rails.application.secrets.secret_key_base)
+    end
+
+  end
+end

data/lib/redirectr/version.rb

@@ -0,0 +1,3 @@
+module Redirectr
+  VERSION = '1.0.3'
+end

data/lib/redirectr.rb

@@ -1,16 +1,48 @@
+require 'securerandom'
+
+require 'redirectr/engine'
+require 'redirectr/referrer_token'
+
+def ReferrerToken(url, token=nil)
+  case url
+  when Redirectr::ReferrerToken
+    url
+  when nil
+    nil
+  else
+    Redirectr::ReferrerToken.new(url, token).tap do |rt|
+      #puts "Token for #{url}: #{rt.token}"
+      rt.save
+    end
+  end
+end
+
+$referrer_lookup ||= {}
 
 module Redirectr
   REFERRER_PARAM_NAME = :referrer
 
+  class UrlNotInWhitelist < ArgumentError
+  end
+
+  class InvalidReferrerToken < ArgumentError
+  end
+
+  def self.config
+    Rails.configuration.x.redirectr
+  end
+
   module ControllerMethods
     extend ActiveSupport::Concern
 
     included do
-      helper_method :current_path, :current_url,
-                    :referrer_or_current_path, :referrer_or_current_url,
+      helper_method :current_url,
+                    :referrer_or_current_url,
                     :back_or_default,
-                    :referrer_path, :referrer_url,
-                    :referrer_param
+                    :referrer_url,
+                    :referrer_param,
+                    :redirectr_referrer_token_url,
+                    :redirectr_referrer_token_path
     end
 
     module ClassMethods
@@ -24,67 +56,64 @@ module Redirectr
       #   end
       #
       def use_referrer_param_name(new_name)
-        const_set Redirectr::REFERRER_PARAM_NAME, new_name.to_sym
+        Redirectr.remove_constant :REFERRER_PARAM_NAME
+        Redirectr.const_set :REFERRER_PARAM_NAME, new_name.to_sym
       end
     end
 
+    def redirectr_referrer_token_url(rt)
+      rt.to_s
+    end
+
+    def redirectr_referrer_token_path(rt)
+      rt.to_s
+    end
 
     # Return the name of the parameter used to pass the referrer path.
     # Use this instead of the real param name in creating your own links
     # to allow easily changing the name later
     # Example:
     #
-    #  <%= link_to my_messages_path :filter_by => 'date', referrer_param => current_path %>
+    #  <%= link_to my_messages_url :filter_by => 'date', referrer_param => current_url %>
     #
     def referrer_param
       Redirectr::REFERRER_PARAM_NAME
     end
 
     # Return the complete URL of the current request.
-    # Note that this path does include ALL query parameters and the host name,
+    # Note that this does include ALL query parameters and the host name,
     # thus allowing you to navigate back and forth between different hosts. If you
     # want the pre-0.1.0 behaviour back, just overwrite this method
     # in your controller so it returns "request.env['PATH_INFO']".
     # Example:
     #
-    #  <%= link_to my_messages_path referrer_param => current_path %>
+    #  <%= link_to my_messages_url referrer_param => current_url %>
     #
     def current_url
-#       request.env['PATH_INFO'] # old behaviour
       if request.respond_to? :url # for rack >= 2.0.0
-        request.url
+        ReferrerToken(request.url)
       elsif request.respond_to? :original_url # for rails >= 4.0.0
-        request.original_url
+        ReferrerToken(request.original_url)
       else
-        request.env['REQUEST_URI']
+        ReferrerToken(request.env['REQUEST_URI'])
       end
     end
 
-    # deprecated
-    def current_path
-      current_url
-    end
-
     # Return the referrer or the current path, it the former is not set.
     # Useful in cases where there might be a redirect path that has to be
     # taken note of but in case it is not present, the current path will be
     # redirected back to.
     # Example:
     #
-    #  <%= link_to my_messages_path referrer_param => referrer_or_current_path %>
+    #  <%= link_to my_messages_url referrer_param => referrer_or_current_url %>
     #
     def referrer_or_current_url
-      referrer_path.blank? ? current_url : referrer_url
-    end
-
-    # deprecated
-    def referrer_or_current_path
-      referrer_or_current_url
+      referrer_url.blank? ? current_url : referrer_url
     end
 
     # Used in back links, referrer based redirection after actions etc.
     # Accepts a default redirect path in case no param[referrer_param]
-    # is set, default being root_path.
+    # is set, default being root_url.
     # To set an own default path (per controller), you can overwrite
     # the default_url method (see below).
     # Example:
@@ -92,12 +121,12 @@ module Redirectr
     #   class MyController
     #     def create
     #       @my = My.create(...)
-    #       redirect_to back_or_default(my_path)
+    #       redirect_to back_or_default(my_url)
     #     end
     #   end
     #
-    # The above example will redirect to the referrer_path if it is defined, otherwise
-    # it will redirect to the my_path
+    # The above example will redirect to the referrer_url if it is defined, otherwise
+    # it will redirect to the my_url
     #
     # Example:
     #
@@ -108,57 +137,72 @@ module Redirectr
     #     end
     #   end
     #
-    # The above example will redirect to the referrer_path if it is defined, otherwise
-    # it will redirect to the root_path of the application.
+    # The above example will redirect to the referrer_url if it is defined, otherwise
+    # it will redirect to the root_url of the application.
     def back_or_default(default = nil)
-      unless referrer_path.blank?
-        referrer_path
+      if self.referrer_url.present?
+        self.referrer_url
       else
-        default || default_url
+        case default
+        when nil
+          ReferrerToken(self.default_url)
+        when String
+          ReferrerToken(default)
+        else
+          ReferrerToken(url_for(default))
+        end
       end
     end
 
     # to be overwritten by your controllers
     def default_url
-      root_path
-    end
-
-    # deprecated
-    def default_path
-      default_url
+      root_url
     end
 
-    # Convenience method for params[referrer_param]
+    # reads referrer_param from HTTP params and validates it against the whitelist
     def referrer_url
-      params[referrer_param]
-    end
+      return nil if params[referrer_param].blank?
 
-    # deprecated
-    def referrer_path
-      referrer_url
+      referrer_token = ReferrerToken.from_param params[referrer_param]
+      raise Redirectr::InvalidReferrerToken, "no URL matches given token value #{params[referrer_param]}" if referrer_token.blank?
+
+      parsed_url = URI.parse referrer_token.to_s
+      if parsed_url.absolute? and in_whitelist? parsed_url
+        referrer_token
+      elsif parsed_url.relative?
+        referrer_token
+      else
+        raise Redirectr::UrlNotInWhitelist, "#{parsed_url.inspect} - #{redirect_whitelist.inspect}"
+      end
     end
-  end
 
-  module Helpers
-    extend ActiveSupport::Concern
+    def redirect_to_with_whitelist(redirect_url)
+      case redirect_url
+      when nil
+        raise 'Cannot redirect to nil'
+      when String
+        parsed_url = URI.parse(redirect_url)
+        if parsed_url.relative? or in_whitelist? parsed_url
+          redirect_to parsed_url
+        else
+          raise Redirectr::UrlNotInWhitelist, "#{parsed_url.inspect} - #{redirect_whitelist.inspect}"
+        end
+      else
+        redirect_to default
+      end
+    end
 
-    # Create a link back to the path specified in the referrer-param.
-    # title can be either a text string or anything else like an image.
-    # Remember to call #html_safe on the title argument if it contains
-    # HTML and you are using Rails 3.
-    def link_to_back(title, options = {})
-      link_to title, back_or_default, options
+    def in_whitelist?(parsed_url)
+      redirect_whitelist.find {|url| parsed_url.host == url.host and parsed_url.port == url.port }
     end
 
-    # Create a hidden input field containing the referrer or current path.
-    # Handy for use in forms that are called with a referrer param which
-    # has to be passed on and respected by the form processing action.
-    def hidden_referrer_input_tag(options = {})
-      hidden_field_tag :referrer, referrer_or_current_url, options
+    def redirect_whitelist
+      @redirect_whitelist ||= [URI.parse(self.current_url.to_s)] +
+          Array(Redirectr.config.whitelist).map {|url| URI.parse url.to_s }
     end
-  end # module Helpers
+  end
+
 end # module Redirectr
 
 ActionController::Base.send :include, Redirectr::ControllerMethods
-ActionView::Helpers.send :include, Redirectr::Helpers
-ActionView::Base.send :include, Redirectr::Helpers
+

data/lib/tasks/redirectr_tasks.rake

@@ -0,0 +1,4 @@
+# desc "Explaining what the task does"
+# task :redirectr do
+#   # Task goes here
+# end

metadata

@@ -1,28 +1,69 @@
 --- !ruby/object:Gem::Specification
 name: redirectr
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 1.0.3
 platform: ruby
 authors:
 - Willem van Kerkhof
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2017-10-18 00:00:00.000000000 Z
-dependencies: []
+date: 2023-02-06 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '5.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '5.2'
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  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'
 description: Provides Rails-helper methods for referrer-style backlinks and setting
   redirect URLs after form submission
-email: wvk@consolving.de
+email:
+- wvk@consolving.de
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- README
+- MIT-LICENSE
+- README.md
+- Rakefile
+- app/helpers/redirectr/application_helper.rb
+- config/routes.rb
+- db/migrate/20201120110532_create_redirectr_referrer_tokens.rb
 - lib/redirectr.rb
+- lib/redirectr/engine.rb
+- lib/redirectr/referrer_token.rb
+- lib/redirectr/referrer_token/active_record_storage.rb
+- lib/redirectr/referrer_token/global_var_storage.rb
+- lib/redirectr/version.rb
+- lib/tasks/redirectr_tasks.rake
 homepage: http://github.com/wvk/redirectr
-licenses: []
+licenses:
+- MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -37,9 +78,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.5.2.1
-signing_key: 
+rubygems_version: 3.3.15
+signing_key:
 specification_version: 4
-summary: Provides Rails helper methods for referrer-style backlinks
+summary: Rails referrer-URL handling done right
 test_files: []

data/README

@@ -1,86 +0,0 @@
-h1. Redirectr
-
-In many web applications, the user triggers actions that result in simple or complex workflows that should, after that workflow is finished, result in the user being redirected to the page where he initially started it. Another example would be a "back"-Link on any page.
-A simple but completely Un-RESTful way would be to store the "current" page in a cookie each time the user calls an action and redirect to the url stored there if needed.
-
-A much better (and potentially even cacheable) way is to encode the "backlink" URL in an URL parameter or form field and pass it along with every workflow step until the last (or only) action uses it to redirect the user back to where he initially came from.
-
-Redirectr really does nothing more than provide a simple API for exactly that.
-
-Redirectr provides a few Controller and Helper methods that will be included in your ApplicationController and ApplicationHelper, respectively.
-
-h2. Installation
-
-when Using bundler, just at the following to your Gemfile
-
-    gem 'redirectr'
-
-and then call
-
-    bundle install
-
-h2. Examples
-
-h3. Contact Form
-
-Suppose you have an application with a contact form that can be reached via a footer link on every page. After submitting the form, the user should be redirected to the page he was before clicking on the "contact form" link.
-
-for the footer link to the contact form:
-
-    <%= link_to 'Contact us!', new_contact_path(referrer_param => current_url) %>
-
-In the 'new contact' view:
-
-    <%= form_for ... do |f| %>
-      <%= hidden_referrer_input_tag %>
-      <!-- ... -->
-    <% end %>
-
-and finally, in the 'create' action of your ContactsController:
-
-    def create
-      # ...
-      redirect_to back_or_default
-    end
-
-h3. Custom default_url
-
-The above will redirect the user back to the page specified in the referrer param. However, if you want to provide a custom fallback url per controller in case no referrer param is provided, just define the `#default_url` in your controller:
-
-    class MyController < ApplicationController
-      def default_url
-        if @record
-          my_record_path(@record)
-        else
-          my_record_index_path
-        end
-      end
-    end
-
-h3. Nesting referrers
-
-Referrer params can be nested, which is helpful if your workflow involves branching into subworkflows. Thus, it is always possible to pass the referrer_param to another url:
-
-    <%= link_to 'go back directly', referrer_or_current_url %>
-    <%= link_to 'add new Foobar before going back', new_foobar_url(:foobar =>  {:name => 'My Foo'}, referrer_param => referrer_or_current_url) %>
-
-for more detailed examples, see the Rdoc documentation.
-
-h2. Contributions
-
-Contributions like bugfixes and new ideas are more than welcome. Please just fork this project on github (https://github.com/wvk/redirectr) and send me a pull request with your changes.
-
-Thanks so far to:
-
-* Falk Hoppe for Rails 2.3.x interoperability
-* Dimitar Haralanov for Rails 3.0.x interoperability
-* Raffael Schmid for spotting a typo in the gemspec description ;)
-
-## Changelog
-
-0.1.1: deprecate *_path methods; improve Rails 5 compatibility by removing `alias` in view helpers
-0.1.0: Use absolute URI instead of path in current_path method
-0.0.8: Use ActiveSupport::Concern (Thanks to Dimitar Haralanov)
-0.0.7: Add Rails 3.0 compatibility (Thanks to Falk Hoppe)
-
-Copyright (c) 2010 Willem van Kerkhof <wvk@consolving.de>, released under the MIT license