Rack::AddressMunging

Rack::AddressMunging is a Rack middleware for automatic e-mail addresses munging.

Once added to your middleware stack, Rack::AddressMunging will parse the body of any HTML response and mung it to obfuscate email addresses, in hope to prevent spambots to collect them too easily.

Installation

Rack::AddressMunging is distributed as a gem and available on rubygems.org so you can add it to your Gemfile or install it manually with:

gem install rack-address_munging

Usage

To use the middleware with it's default configuration, just drop it in your middleware stack:

# In config.ru or wherever your stack is defined
require 'rack/address_munging'

use Rack::AddressMunging

If you want to use another munging strategy, precise it as an argument:

# In a Rails initializer
require 'rack/address_munging'

module YourRailsAppName
  class Application
    config.middleware.use Rack::AddressMunging, strategy: :hex
  end
end

Supported Strategies

:Hex

Replace email addresses and mailto href attributes values with an hexadecimal entities alternative.

Input:  email@example.com
Output: email@example.com

:Hex is the default strategy.

:Rot13JS

Replace email addresses and full mailto links with a <script> tag that will print it back into the page, based on a ROT13 version.

Input:  email@example.com
Output: <script type="text/javascript">document.write("rznvy(at)rknzcyr.pbz".replace(/(at)/, '@').replace(/[a-z]/gi,function(c){return String.fromCharCode((c<="Z"?90:122)>=(c=c.charCodeAt(0)+13)?c:c-26);});))</script>

For more informations about the exact behavior of each strategy, please refer to the strategies specs data.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/notus-sh/rack-address_munging.