md-roadie 2.4.2.md.1

data/.autotest

@@ -0,0 +1,10 @@
+# Override autotest default magic to rerun all tests every time a
+# change is detected on the file system.
+class Autotest
+  def get_to_green
+    begin
+      rerun_all_tests
+      wait_for_changes unless all_good
+    end until all_good
+  end
+end

data/.gitignore

@@ -0,0 +1,12 @@
+.DS_Store
+pkg
+.*~
+.yardoc
+
+.rspec
+.idea/*
+.rvmrc
+
+Gemfile.lock
+doc
+tmp

data/.travis.yml

@@ -0,0 +1,22 @@
+bundler_args: --without guard
+before_install:
+  - gem install bundler --pre
+
+rvm:
+  - 1.8.7
+  - 1.9.3
+  - 2.0.0
+  - jruby
+
+gemfile:
+  - gemfiles/rails_3.0.gemfile
+  - gemfiles/rails_3.1.gemfile
+  - gemfiles/rails_3.2.gemfile
+  - gemfiles/rails_4.0.gemfile
+
+matrix:
+  exclude:
+    - rvm: 1.8.7
+      gemfile: gemfiles/rails_4.0.gemfile
+  allow_failures:
+    - rvm: jruby

data/.yardopts

@@ -0,0 +1 @@
+--no-private

data/Appraisals

@@ -0,0 +1,15 @@
+appraise 'rails-3.0' do
+  gem 'rails',      '~> 3.0.0'
+end
+
+appraise 'rails-3.1' do
+  gem 'rails',      '~> 3.1.0'
+end
+
+appraise 'rails-3.2' do
+  gem 'rails',      '~> 3.2.0'
+end
+
+appraise 'rails-4.0' do
+  gem 'rails',      '~> 4.0'
+end

data/Changelog.md

@@ -0,0 +1,185 @@
+### dev
+
+[full changelog](https://github.com/Mange/roadie/compare/v2.4.2...master)
+
+* Nothing yet
+
+### 2.4.2
+
+[full changelog](https://github.com/Mange/roadie/compare/v2.4.1...v2.4.2)
+
+* Bug fixes:
+  * Fix Nokogiri version to allow only 1.5.x on ruby 1.8.7
+  * Blacklist :before, :after, :-ms-input-placeholder, :-moz-placeholder selectors – [Brian Bauer (bbauer)][https://github.com/bbauer].
+  * Build failed on 1.8.7 due to a change in `css_parser`
+
+### 2.4.1
+
+[full changelog](https://github.com/Mange/roadie/compare/v2.4.0...v2.4.1)
+
+* Bug fixes:
+  * Allow Nokogiri 1.5.x again; 1.6.x is unsupported in Ruby 1.8.7.
+
+### 2.4.0
+
+[full changelog](https://github.com/Mange/roadie/compare/v2.3.4...v2.4.0)
+
+* Enhancements:
+  * Support Rails 4.0, with the help of:
+    * [Ryunosuke SATO (tricknotes)](https://github.com/tricknotes)
+    * [Dylan Markow](https://github.com/dmarkow)
+  * Keep `!important` when outputting styles to help combat web mail styles being `!important`
+  * Support `:nth-child`, `:last-child`, etc.
+    * To make this work, Roadie have to catch errors from Nokogiri and ignore them. A warning will be printed when this happens so users can open issues with the project and tests can be expanded.
+  * Support for custom inliner (#58) — [Harish Shetty (kandadaboggu)](https://github.com/kandadaboggu) with friends
+* Bug fixes:
+  * Don't crash when URL options have protocols with "://" in them (#52).
+* Other:
+  * Be more specific on which versions are required; require newer `css_parser`
+  * Officially support MRI 2.0.0
+  * Add experimental support for JRuby
+  * Remove documentation that talks about passing CSS filenames as symbols; unsupported in Rails 4. (Thanks to [PikachuEXE](https://github.com/PikachuEXE))
+
+### 2.3.4
+
+[full changelog](https://github.com/Mange/roadie/compare/v2.3.3...v2.3.4)
+
+* Enhancements:
+  * Add `config.roadie.enabled` that can be set to `false` to disable Roadie completely.
+* Bug fixes:
+  * Proc objects to the `:css` option is now run in the context of the mailer instance, mirroring similar options from ActionMailer.
+  * Fix some tests that would always pass
+  * Improve JRuby compatibility
+  * Update Gemfile.lock and fix issues with newer gem versions
+
+### 2.3.3
+
+[full changelog](https://github.com/Mange/roadie/compare/v2.3.2...v2.3.3)
+
+* Enhancements:
+  * Allow proc objects to the `:css` option
+* Bug fixes:
+  * Ignore HTML comments and CDATA sections in CSS (support TinyMCE)
+
+### 2.3.2
+
+[full changelog](https://github.com/Mange/roadie/compare/v2.3.1...v2.3.2)
+
+* Bug fixes:
+  * Don't fail on selectors which start with @ (#28) — [Roman Shterenzon (romanbsd)](https://github.com/romanbsd)
+
+### 2.3.1
+
+[full changelog](https://github.com/Mange/roadie/compare/v2.3.0...v2.3.1)
+
+* Bug fixes:
+  * Does not work with Rails 3.0 unless provider set specifically (#23)
+
+### 2.3.0
+
+[full changelog](https://github.com/Mange/roadie/compare/v2.3.0.pre1...v2.3.0)
+
+* Nothing, really
+
+### 2.3.0.pre1
+
+[full changelog](https://github.com/Mange/roadie/compare/v2.2.0...v2.3.0.pre1)
+
+* Enhancements:
+  * Support Rails 3.2.pre1 - [Morton Jonuschat (yabawock)](https://github.com/yabawock)
+  * Sped up the Travis builds
+  * Official support for Rails 3.0 again
+    * Dependencies allow 3.0
+    * Travis builds 3.0 among the others
+
+### 2.2.0
+
+[full changelog](https://github.com/Mange/roadie/compare/v2.1.0...v2.2.0)
+
+* Enhancements:
+  * Support for the `url_options` method inside mailer instances
+    * You can now dynamically alter the URL options on a per-email basis
+
+### 2.1.0
+
+[full changelog](https://github.com/Mange/roadie/compare/v2.1.0.pre2...v2.1.0)
+
+* Full release!
+
+### 2.1.0.pre2
+
+[full changelog](https://github.com/Mange/roadie/compare/v2.1.0.pre1...v2.1.0.pre2)
+
+* Bug: Roadie broke `url_for` inside mailer views
+
+### 2.1.0.pre1
+
+[full changelog](https://github.com/Mange/roadie/compare/v2.0.0...v2.1.0.pre1)
+
+* Enhancements:
+  * Support normal filesystem instead of only Asset pipeline
+  * Enable users to create their own way of fetching CSS
+  * Improve test coverage a bit
+  * Use a railtie to hook into Rails
+  * Use real Rails for testing integration
+
+### 2.0.0
+
+[full changelog](https://github.com/Mange/roadie/compare/v1.1.3...v2.0.0)
+
+* Enhancements:
+  * Support the Asset pipeline - [Arttu Tervo (arttu)](https://github.com/arttu)
+* Dependencies:
+  * Requires Rails 3.1 to work. You can keep on using the 1.x series in Rails 3.0
+
+### 1.1.3
+
+[full changelog](https://github.com/Mange/roadie/compare/v1.1.2...v1.1.3)
+
+* Do not add another ".css" to filenames if already present - [Aliaxandr (saks)](https://github.com/saks)
+
+### 1.1.2
+
+[full changelog](https://github.com/Mange/roadie/compare/v1.1.1...v1.1.2)
+
+* Support for Rails 3.1.0 and later inside gemspec
+
+### 1.1.1
+
+[full changelog](https://github.com/Mange/roadie/compare/v1.1.0...v1.1.1)
+
+* Support for Rails 3.1.x (up to and including RC4)
+  * Rails 3.0.x is still supported
+* Added CI via [Travis CI](http://travis-ci.org)
+
+### 1.1.0
+
+[full changelog](https://github.com/Mange/roadie/compare/v1.0.1...v1.1.0)
+
+* Enhancements:
+  * Support for inlining `<link>` elements (thanks to [aliix](https://github.com/aliix))
+
+### 1.0.1
+
+[full changelog](https://github.com/Mange/roadie/compare/v1.0.0...v1.0.1)
+
+* Enhancements:
+  * Full, official support for Ruby 1.9.2 (in addition to 1.8.7)
+* Dependencies:
+  * Explicilty depend on nokogiri >= 1.4.4
+
+### 1.0.0
+
+[full changelog](https://github.com/Mange/roadie/compare/legacy...v1.0.0)
+
+Roadie fork!
+
+* Enhancements:
+  * Support for Rails 3.0
+  * Code cleanup
+  * Support `!important`
+  * Tests
+  * + some other enhancements
+* Deprecations:
+  * Removed support for Rails 2.x
+

data/Gemfile

@@ -0,0 +1,11 @@
+source 'https://rubygems.org'
+gemspec
+
+group :guard do
+  gem 'guard'
+  gem 'guard-rspec'
+
+  # Guard for Mac
+  gem 'rb-fsevent', '>= 0.9.0.pre5'
+  gem 'growl'
+end

data/Guardfile

@@ -0,0 +1,8 @@
+guard 'rspec' do
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^lib/(.+)\.rb$})     { |m| "spec/lib/#{m[1]}_spec.rb" }
+
+  watch(%r{spec/support/.*\.rb}) { "spec" }
+  watch('spec/spec_helper.rb')   { "spec" }
+end
+

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Jim Neath / Purify
+
+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,310 @@
+Roadie
+======
+
+> Making HTML emails comfortable for the Rails rockstars
+
+Roadie tries to make sending HTML emails a little less painful in Rails 3+ by inlining stylesheets and rewrite relative URLs for you.
+
+If you want to have this in Rails 2, please see [MailStyle](https://www.github.com/purify/mail_style).
+
+How does it work?
+-----------------
+
+Email clients have bad support for stylesheets, and some of them blocks stylesheets from downloading. The easiest way to handle this is to work with all styles inline, but that is error prone and hard to work with as you cannot use classes and/or reuse styling.
+
+This gem helps making this easier by automatically inlining stylesheet rules into the document before sending it. You just give it a list of stylesheets and it will go though all of the selectors assigning the styles to the maching elements. Careful attention has been put into rules being applied in the correct order, so it should behave just like in the browser¹.
+
+Roadie also rewrites all relative URLs in the email to a absolute counterpart, making images you insert and those referenced in your stylesheets work. No more headaches about how to write the stylesheets while still having them work with emails from your acceptance environments.
+
+¹: Of course, rules like `:hover` will not work by definition. Only static styles can be added.
+
+Build Status
+------------
+
+[![Build history and status](https://secure.travis-ci.org/Mange/roadie.png)](http://travis-ci.org/#!/Mange/roadie)
+
+Tested with [Travis CI](http://travis-ci.org) using [almost all combinations of](http://travis-ci.org/#!/Mange/roadie):
+
+* Ruby:
+  * MRI 1.8.7
+  * MRI 1.9.3
+  * MRI 2.0.0
+* Rails
+  * 3.0
+  * 3.1
+  * 3.2
+  * 4.0
+
+Let me know if you want any other combination supported officially.
+
+### Versioning ###
+
+This project follows [Semantic Versioning](http://semver.org/) and has been since version 1.0.0.
+
+Features
+--------
+
+* Supports Rails' Asset Pipeline and simple filesystem access out of the box
+* You can add support for CSS from any place inside your apps
+* Writes CSS styles inline
+  * Respects `!important` styles
+  * Does not overwrite styles already present in the `style` attribute of tags
+  * Supports the same CSS selectors as [Nokogiri](http://nokogiri.org/) (use CSS3 selectors in your emails!)
+* Makes image urls absolute
+  * Hostname and port configurable on a per-environment basis
+* Makes link `href`s absolute
+* Automatically adds proper html skeleton when missing (you don't have to create a layout for emails)²
+
+²: This might be removed in a future version, though. You really ought to create a good layout and not let Roadie guess how you want to have it structured
+
+Install
+-------
+
+Add the gem to Rails' Gemfile
+
+```ruby
+gem 'roadie'
+```
+
+Configuring
+-----------
+
+Roadie listens to the following options (set in `Application.rb` or in your environment's configuration files:
+
+* `config.roadie.enabled` - Set this to `false` to disable Roadie from working on your emails. Useful if you want to disable Roadie in some environments.
+* `config.action_mailer.default_url_options` - Used for making URLs absolute.
+* `config.assets.enabled` - If the asset pipeline is turned off, Roadie will default to searching for assets in `public/stylesheets`.
+* `config.roadie.provider` - Set the provider manually, ignoring all other options. Use for advanced cases, or when you have non-default paths or other options.
+* `config.roadie.after_inlining` - Set a custom inliner for the HTML document. The custom inliner in invoked after the default inliner.
+
+Usage
+-----
+
+Just add a `<link rel="stylesheet" />` or `<style type="text/css"></style>` element inside your email layout and it will be inlined automatically.
+
+**Note:** Do not use `stylesheet_link_tag` in your mail views. Just use a regular tag pointing to the logical asset name instead; e.g. `emails.css` instead of `emails-<SHA>.css`. This should hopefully be fixed in a later version. You are recommended to use the `:css` option to the mailer (detailed below) instead if you want to avoid problems with this.
+
+You can also specify the `:css` option to mailer to have it inlined automatically without you having to make a layout:
+
+```ruby
+class Notifier < ActionMailer::Base
+  default :css => 'email', :from => 'support@mycompany.com'
+
+  def registration_mail
+    mail(:subject => 'Welcome Aboard', :to => 'someone@example.com')
+  end
+
+  def newsletter
+    mail(:subject => 'Newsletter', :to => 'someone@example.com', :css => ['email', 'newsletter'])
+  end
+end
+```
+
+This will look for a css file called `email.css` in your assets. The `css` method can take either a string or an array of strings. The ".css" extension will be added automatically.
+
+### Image URL rewriting ###
+
+If you have `default_url_options[:host]` set in your mailer, then Roadie will do it's best to make the URLs of images and in stylesheets absolute.
+
+In `application.rb`:
+
+```ruby
+class Application
+  config.action_mailer.default_url_options = {:host => 'example.com'}
+end
+```
+
+If you want to to be different depending on your environment, just set it in your environment's configuration instead.
+
+### Ignoring stylesheets ###
+
+By default, `style` and `link` elements in the email document's `head` are processed along with the stylesheets and removed from the `head`.
+
+You can set a special `data-immutable="true"` attribute on `style` and `link` tags you do not want to be processed and removed from the document's `head`. This is the place to put things like `:hover` selectors that you want to have for email clients allowing them.
+
+Style and link elements with `media="print"` are always ignored.
+
+### Inlining link tags ###
+
+Any `link` element that is part of your email will be linked in. You can exclude them by setting `data-immutable` as you would on normal `style` elements. Linked stylesheets for print media is also ignored as you would expect.
+
+If the `link` tag uses an absolute URL to the stylesheet, it will not be inlined. Use a relative path instead:
+
+```html
+<head>
+  <link rel="stylesheet" type="text/css" href="/assets/emails/rock.css">             <!-- Will be inlined -->
+  <link rel="stylesheet" type="text/css" href="http://www.metal.org/metal.css">      <!-- Will NOT be inlined -->
+  <link rel="stylesheet" type="text/css" href="/assets/jazz.css" media="print">      <!-- Will NOT be inlined -->
+  <link rel="stylesheet" type="text/css" href="/ambient.css" data-immutable>         <!-- Will NOT be inlined -->
+</head>
+```
+
+Writing your own provider
+-------------------------
+
+A provider handles searching CSS files for you. You can easily create your own provider for your specific app by subclassing `Roadie::AssetProvider`. See the API documentation for information about how to build them.
+
+Example Subclassing the `AssetPipelineProvider`:
+
+```ruby
+# application.rb
+config.roadie.provider = UserAssetsProvider.new
+
+# lib/user_assets_provider.rb
+class UserAssetsProvider < Roadie::AssetPipelineProvider
+  def find(name)
+    user = User.find_by_name(name)
+    if user
+      user.custom_css
+    else
+      super
+    end
+  end
+end
+```
+
+Writing your own inliner
+-------------------------
+
+A custom inliner transforms an outgoing HTML email using application specific rules. The custom inliner is invoked after the default inliner.
+
+A custom inliner can be created using a `lambda` that accepts one parameter or an object that responds to the `call` method with one parameter.
+
+Example for using lambda as custom inliner:
+
+```ruby
+# application.rb
+config.roadie.after_inlining = lambda do |document|
+  document.css("a#new_user").each do |link|
+    link['href'] = "http://www.foo.com#{link['href']}"
+  end
+end
+```
+
+Example for using object as custom inliner:
+
+```ruby
+# application.rb
+config.roadie.after_inlining = PromotionInliner.new
+
+# lib/product_link_inliner.rb
+class PromotionInliner
+  def call(document)
+    document.css("a.product").each do |link|
+      fix_link link
+    end
+  end
+
+  def fix_link(link)
+    if link['class'] =~ /\bsale\b/
+      link['href'] = link['href'] + '?source=newsletter'
+    end
+  end
+end
+```
+
+### Custom inliner scopes
+
+- **All HTML emails**
+
+```ruby
+# application.rb. Custom inliner for all emails.
+config.roadie.after_inlining = PromotionInliner.new
+```
+- **All HTML emails sent by a mailer**
+
+```ruby
+class MarketingMailer < ActionMailer::Base
+  # Custom inliner for all mailer methods.
+  default after_inlining: PromotionInliner.new
+end
+```
+
+- **All HTML emails sent by a specific mailer method**
+
+```ruby
+class UserMailer < ActionMailer::Base
+  def registration
+    # Custom inliner for registration emails
+    mail(after_inlining: MarketingMailer.new)
+  end
+end
+```
+
+Bugs / TODO
+-----------
+
+* Improve overall performance
+* Clean up stylesheet assignment code
+* Assets referenced with digest URLs should be findable
+  * Roadie should be able to have multiple asset providers in a specific order
+
+FAQ
+---
+
+### I'm getting segmentation faults (or other C-like problems)! What should I do? ###
+
+Roadie uses Nokogiri to parse the HTML of your email, so any C-like problems like segfaults are likely in that end. The best way to fix this is to first upgrade libxml2 on your system and then reinstall Nokogiri.
+Instructions on how to do this on most platforms, see [Nokogiri's official install guide](http://nokogiri.org/tutorials/installing_nokogiri.html).
+
+### My `:hover` selectors don't work. How can I fix them? ###
+
+Put any styles using `:hover` in a separate stylesheet and make sure it is ignored. (See "Ignoring stylesheets" above)
+
+### My `@media` queries don't work. How can I fix them? ###
+
+Put any styles using them in a separate stylesheet and make sure it is ignored. (See "Ignoring stylesheets" above)
+
+### My vendor-specific styles don't work. How can I fix them? ###
+
+Put any styles using them in a separate stylesheet and make sure it is ignored. (See "Ignoring stylesheets" above)
+
+Documentation
+-------------
+
+* [Online documentation for 2.3.0](http://rubydoc.info/gems/roadie/2.3.0/frames)
+* [Online documentation for master](http://rubydoc.info/github/Mange/roadie/master/frames)
+* [Changelog](https://github.com/Mange/roadie/blob/master/Changelog.md)
+
+Running specs
+-------------
+
+Run specs for your current ruby against the latest compatible version of rails with `rake spec`. You can run against all supported combinations of ruby and rails by issuing `rake spec:all`.
+
+History and contributors
+------------------------
+
+Major contributors to Roadie:
+
+* [Arttu Tervo (arttu)](https://github.com/arttu) - Original Asset pipeline support
+* [Ryunosuke SATO (tricknotes)](https://github.com/tricknotes) - Initial Rails 4 support
+
+You can [see all contributors](https://github.com/Mange/roadie/contributors) on GitHub.
+
+This gem was originally developed for Rails 2 use on [Purify](http://purifyapp.com) under the name [MailStyle](https://www.github.com/purify/mail_style). However, the author stopped maintaining it and a fork took place to make it Rails 3+ compatible.
+
+The following people have contributed to the orignal gem:
+
+* [Jim Neath](http://jimneath.org) (Original author)
+* [Lars Klevans](http://tastybyte.blogspot.com/)
+* [Jonas Grimfelt](http://github.com/grimen)
+* [Ben Johnson](http://www.binarylogic.com)
+* [Istvan Hoka](http://istvanhoka.com/)
+* [Voraz](http://blog.voraz.com.br)
+
+License
+-------
+
+(The MIT License)
+
+Copyright (c) 2009-2013
+
+* [Jim Neath](http://jimneath.org)
+* Magnus Bergmark <magnus.bergmark@gmail.com>
+
+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.
+