redirectr 1.0.4 → 1.0.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cf3a0eaa6ed55c0c7722b84a88addea998ad0844dec44a9610d020bac71bdda5
-  data.tar.gz: cbe50d0fa0f7f0ff9cc72b2f2997a066cb5a11a0efd70987e69fd39c0a07b5e6
+  metadata.gz: 78c463712785fe0809de6365bbcdff48d9b1ac7ceaf460a927dc9f655d2c0a06
+  data.tar.gz: 1ddab2a796cb3721cd311cd4006f6625109e5b314a28e461f54707443714d57b
 SHA512:
-  metadata.gz: 8f940d86c27e9163aa842b6f3f3f92d9f9d1739cad2adbecf73979261d71bb8f1a10031dfe36fc809f9aeaa8028d58129c3ea6d5bce9ef4b45eeb5c32f2828a1
-  data.tar.gz: fe4aab1b8b7698820cfd26265c578bce574cbf9f2af0ed7ec926ce42230ac9a8edcbb74d58c1afc1075c74decdc836f9af889e43a16cd70a3bbba9d4f69a6fe6
+  metadata.gz: bc1e0061c954c452bca56fb5ec2cbf6334c2a22ddf3ff4c3709735a92d057b615ec6655a9a71478fc5f5919298c85e58bc1e043e0295e1361d61e982cee898ab
+  data.tar.gz: d3a733007656465049d1901816ce39a70af6f2d19ca2569426a1c4616511c8a4058ef1a8116b311a65868f420638746482bb839ca36c2e510eacebdc33d6a1c6

data/README.md

@@ -1,3 +1,5 @@
+[![Test](https://github.com/wvk/redirectr/actions/workflows/test.yml/badge.svg)](https://github.com/wvk/redirectr/actions/workflows/test.yml)
+
 # 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.
@@ -25,34 +27,38 @@ Please read this section if you are already using an older version of Redirectr
 
 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
+```ruby
+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.
+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)
+```ruby
+# 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
 
@@ -62,44 +68,54 @@ Suppose you have an application with a contact form that can be reached via a fo
 
 for the footer link to the contact form:
 
-    <%= link_to 'Contact us!', new_contact_path(referrer_param => current_url) %>
+```erb
+<%= 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 %>
+```erb
+<%= 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
+```ruby
+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
+```ruby
+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) %>
+```erb
+<%= 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.
+NOTE: If your URLs include lots of params, it is very advisable to use Referrer Tokens instead of plain URLs to avoid "URI too long" errors. See next section.
 
 ## Unvalidated Redirect Mitigation
 
@@ -115,27 +131,32 @@ Redirectr offers three kinds of mitigation, two of them being optional:
 
 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
+```ruby
+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:
 
+```ruby
+require 'redirectr/referrer_token/active_record_storage'
 
-    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
+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
+```bash
+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.
 

data/lib/redirectr/version.rb

@@ -1,3 +1,3 @@
 module Redirectr
-  VERSION = '1.0.4'
+  VERSION = '1.0.5'
 end

data/lib/redirectr.rb

@@ -28,6 +28,9 @@ module Redirectr
   class InvalidReferrerToken < ArgumentError
   end
 
+  class InvalidUrl < ArgumentError
+  end
+
   def self.config
     Rails.configuration.x.redirectr
   end
@@ -143,13 +146,15 @@ module Redirectr
       if self.referrer_url.present?
         self.referrer_url
       else
-        case default
+        url = default || self.default_url
+
+        case url
         when nil
-          ReferrerToken(self.default_url)
+          raise Redirectr::InvalidUrl, 'No URL given'
         when String
-          ReferrerToken(default)
+          ReferrerToken(url)
         else
-          ReferrerToken(url_for(default))
+          ReferrerToken(url_for(url))
         end
       end
     end
@@ -205,4 +210,3 @@ module Redirectr
 end # module Redirectr
 
 ActionController::Base.send :include, Redirectr::ControllerMethods
-

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: redirectr
 version: !ruby/object:Gem::Version
-  version: 1.0.4
+  version: 1.0.5
 platform: ruby
 authors:
 - Willem van Kerkhof
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-06-05 00:00:00.000000000 Z
+date: 2025-04-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -63,7 +62,6 @@ homepage: http://github.com/wvk/redirectr
 licenses:
 - MIT
 metadata: {}
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -78,8 +76,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.20
-signing_key:
+rubygems_version: 3.6.6
 specification_version: 4
 summary: Rails referrer-URL handling done right
 test_files: []