be_valid_asset 1.2.2 → 1.2.3

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in be_valid_asset.gemspec
+gemspec

data/{MIT-LICENSE.txt → LICENSE.txt}

@@ -1,4 +1,6 @@
-Copyright (c) 2009 Unboxed Consulting
+Copyright (c) 2009-2012 Unboxed Consulting
+
+MIT License
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/README.md

@@ -0,0 +1,192 @@
+# be_valid_asset
+
+Provides `be_valid_markup`, `be_valid_css` and `be_valid_feed` matchers for RSpec controller and view tests.
+
+## Installation
+
+To use be_valid_asset in your project, add it to your Gemfile:
+
+```ruby
+gem 'be_valid_asset'
+```
+
+Alternatively you can install it as a Rails plugin:
+
+```ruby
+./script/plugin install git://github.com/unboxed/be_valid_asset.git
+```
+
+(Warning: This method is not recommended, we strongly encourage you to manage gem dependencies via [Bundler](http://gembundler.com/))
+
+Add the following to `spec/support/be_valid_asset.rb`:
+
+```ruby
+include BeValidAsset
+
+BeValidAsset::Configuration.display_invalid_content = true
+BeValidAsset::Configuration.enable_caching = true
+BeValidAsset::Configuration.cache_path = Rails.root.join('tmp', 'be_valid_asset_cache')
+```
+
+Note: For older versions of RSpec you'll need to require `be_valid_asset.rb` from `spec_helper.rb`.
+
+## Usage
+
+### Markup validation
+
+It can be used to test a Capybara Session object in a request spec as follows:
+
+```ruby
+scenario "Visiting foo and validate markup" do
+  visit foo_path
+  page.should be_valid_markup
+end
+```
+
+or an ActionController Response object:
+
+```ruby
+describe FooController do
+  render_views
+
+  describe "GET 'index'" do
+    it "renders valid markup" do
+      get :index
+      response.should be_valid_markup
+    end
+  end
+end
+```
+
+or to test a string:
+
+```ruby
+it "is valid markup" do
+  html = File.read(Rails.root.join('public', 'index.html'))
+  html.should be_valid_markup
+end
+```
+
+It is also possible to validate an html fragment.  This assumes xhtml-1.0 strict.
+
+```ruby
+it "is valid HTML" do
+  string = "<p>This is an html fragment</p>"
+  string.should be_valid_markup_fragment
+end
+```
+
+### CSS validation
+
+CSS files can be validated as follows:
+
+```ruby
+it "is valid CSS" do
+  css = File.read(Rails.root.join('public', 'stylesheets', 'main.css'))
+  css.should be_valid_css
+end
+```
+
+be_valid_css takes an optional parameter specifying the CSS profile to test against. It defaults to testing against CSS 2.1. It can be set to any of the profiles supported by the CSS validator (e.g. css1, css2, css21, css3). There are also the following shortcut methods:
+
+ * `be_valid_css1` => CSS 1.0
+ * `be_valid_css2` => CSS 2.1
+ * `be_valid_css3` => CSS 3.0
+
+### Feed validation
+
+RSS and Atom feeds can be validated from a response, or a string, in the same way as for html or CSS.  e.g.
+
+```ruby
+describe FooController do
+  render_views
+
+  describe "GET 'index.rss'" do
+    it "is a valid feed" do
+      get 'index.rss'
+      response.should be_valid_feed
+    end
+  end
+end
+```
+
+There are also aliased methods `be_valid_rss` and `be_valid_atom` that do the same thing.
+
+## Environment Variables
+
+### Disabling network tests
+
+If the environment variable `NONET` is set to true, then all tests with no cached response available will be marked as pending.
+
+### http_proxy
+
+If you need to use a proxy server to access the validator service, set the environment variable http_proxy.
+
+## Configuration options
+
+The following can be set in `spec/support/be_valid_asset.rb`:
+
+### Display Full source for failures:
+
+```ruby
+BeValidAsset::Configuration.display_invalid_content = false
+# defaults to false
+```
+
+### Display surrounding source for failures:
+
+This will cause it to output the failing line, and n surrounding lines (defaults to 5)
+
+```ruby
+BeValidAsset::Configuration.display_invalid_lines = true
+BeValidAsset::Configuration.display_invalid_lines_count = 10
+# defaults to false and 5 lines
+```
+
+### Change validator host/path:
+
+```ruby
+BeValidAsset::Configuration.markup_validator_host = 'validator.w3.org'
+BeValidAsset::Configuration.markup_validator_path = '/check'
+BeValidAsset::Configuration.css_validator_host = 'jigsaw.w3.org'
+BeValidAsset::Configuration.css_validator_path = '/css-validator/validator'
+BeValidAsset::Configuration.feed_validator_host = 'validator.w3.org'
+BeValidAsset::Configuration.feed_validator_path = '/feed/check.cgi'
+```
+
+If you are doing more than the occasional check, you should run your own copy of the validator, and use that.
+
+Instructions here: [http://validator.w3.org/docs/install.html](http://validator.w3.org/docs/install.html),  [http://jigsaw.w3.org/css-validator/DOWNLOAD.html](http://jigsaw.w3.org/css-validator/DOWNLOAD.html) or [https://github.com/w3c/css-validator-standalone](https://github.com/w3c/css-validator-standalone) and [http://validator.w3.org/feed/about.html#where](http://validator.w3.org/feed/about.html#where)
+
+### Caching
+
+be_valid_asset can cache the responses from the validator to save look-ups for documents that haven't changed. To use this feature, it must be enabled, and a cache path must be set:
+
+```ruby
+BeValidAsset::Configuration.enable_caching = true
+BeValidAsset::Configuration.cache_path = Rails.root.join('tmp', 'be_valid_asset_cache')
+```
+
+By default, cache busters for `href` and `src` attribute values are stripped like `src="/images/test.jpg?8171717"` is cached as `src="/images/test.jpg"`. If this is unwanted, add the following to the configuration file:
+
+```ruby
+BeValidAsset::Configuration.markup_cache_modifiers = []
+```
+
+### Markup modification prior to validation
+
+There might be specific parts of your markup that have not yet been standardised and you still want to validate the rest of your markup. There may be elements of your markup that causes validation to fail. If you want to ignore specific markup that causes failures but validate the rest, regular expressions can be used to modify the markup prior to validation. Ideally this would not be necessary, but with emerging standards like the [HTML Responsive Images Extension](http://dvcs.w3.org/hg/html-proposals/raw-file/tip/responsive-images/responsive-images.html) sometimes it is potentially the best solution until the markup validator is updated. If you are using the `srcset` attribute on an `img` tag and want to remove it prior to validation, set the configuration as shown below. `markup_modifiers` is a 2 dimensional array, where each constituent array has two elements that provide the arguments to a call to [`gsub`](http://www.ruby-doc.org/core-1.9.3/String.html#method-i-gsub).
+
+```ruby
+BeValidAsset::Configuration.markup_modifiers = [[/ srcset=".* \dx"/, '']]
+```
+
+## Issues / Feature Requests
+
+Please use the [Github issue tracker](http://github.com/unboxed/be_valid_asset/issues) to track any bugs/feature requests.
+
+## Licensing
+
+This was originally based on a blog post here: [http://www.anodyne.ca/2007/09/28/rspec-custom-matchers-and-be\_valid\_xhtml/](http://www.anodyne.ca/2007/09/28/rspec-custom-matchers-and-be_valid_xhtml/)
+
+This is distributed under the MIT Licence, see `LICENSE.txt` for the details.

data/Rakefile

@@ -1,18 +1,7 @@
-require 'rake'
-# require 'rake/rdoctask'
-require 'rspec/core/rake_task'
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
 
-# RSpec 2.0
-task :default => :spec
-RSpec::Core::RakeTask.new do |spec|
-  spec.rspec_opts = ['--options', File.join(File.dirname(__FILE__), %w(spec spec.opts))]
-end
+RSpec::Core::RakeTask.new('spec')
 
-# desc 'Generate documentation for the be_valid_asset plugin.'
-# Rake::RDocTask.new(:rdoc) do |rdoc|
-#   rdoc.rdoc_dir = 'rdoc'
-#   rdoc.title    = 'BeValidAsset'
-#   rdoc.options << '--line-numbers' << '--inline-source'
-#   rdoc.rdoc_files.include('README')
-#   rdoc.rdoc_files.include('lib/**/*.rb')
-# end
+# Run RSpec code examples as the default rake task
+task :default => :spec

data/be_valid_asset.gemspec

@@ -0,0 +1,24 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'be_valid_asset/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "be_valid_asset"
+  gem.version       = BeValidAsset::VERSION
+  gem.authors       = ["Alex Tomlins", "Attila Gyorffy", "Ben Brinckerhoff", "Jolyon Pawlyn", "Sebastian de Castelberg"]
+  gem.email         = ["github@unboxedconsulting.com"]
+  gem.description   = %q{Provides be_valid_markup, be_valid_css and be_valid_feed matchers for RSpec controller and view tests.}
+  gem.summary       = %q{Markup and asset validation for RSpec}
+  gem.homepage      = "http://github.com/unboxed/be_valid_asset"
+  gem.license       = "MIT"
+
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+
+  gem.add_dependency('rspec')
+  gem.add_development_dependency('rake')
+  gem.add_development_dependency('rspec', '>= 2.0')
+end

data/lib/be_valid_asset.rb

@@ -1,32 +1,5 @@
-module BeValidAsset
-  class Configuration
-    @@config = {
-      :display_invalid_content      => false,
-      :enable_caching               => false,
-      :display_invalid_lines        => false,
-      :display_invalid_lines_count  => 5
-    }
-
-    def self.method_missing(name, *args)
-      if name.to_s =~ /^(.*)=$/
-        @@config[$1.to_sym] = args[0]
-      elsif @@config.has_key?(name)
-        return @@config[name]
-      else
-        super
-      end
-    end
-
-    def self.cache_path=(path)
-      @@config[:cache_path] = path
-      unless File.directory? path
-        FileUtils.mkdir_p path
-      end
-
-    end
-  end
-end
-
+require 'be_valid_asset/version'
+require 'be_valid_asset/configuration'
 require 'be_valid_asset/be_valid_base'
 require 'be_valid_asset/be_valid_markup'
 require 'be_valid_asset/be_valid_xhtml'

data/lib/be_valid_asset/be_valid_markup.rb

@@ -8,6 +8,8 @@ module BeValidAsset
 
   Configuration.markup_validator_host = 'validator.w3.org'
   Configuration.markup_validator_path = '/check'
+  Configuration.markup_cache_modifiers = [[/(href=".*?)\?\d+/, '\1'], [/(src=".*?)\?\d+/, '\1']]
+  Configuration.markup_modifiers = []
 
   class BeValidMarkup < BeValidBase
   
@@ -24,7 +26,9 @@ module BeValidAsset
       elsif fragment.respond_to? :body
         fragment = fragment.body.to_s
       end
-          
+
+      fragment = apply_modifiers_to_fragment(fragment)
+
       if fragment.empty?
         @message = "Response was blank (maybe a missing integrate_views)"
         return false
@@ -53,6 +57,25 @@ module BeValidAsset
   
     private
 
+      def apply_modifiers_to_fragment(fragment)
+        if (Configuration.enable_caching && ! Configuration.markup_cache_modifiers.empty?) or ! Configuration.markup_modifiers.empty?
+          fragment = fragment.dup
+        end
+
+        if Configuration.enable_caching && ! Configuration.markup_cache_modifiers.empty?
+          Configuration.markup_cache_modifiers.each do |replacement|
+            fragment.gsub!(replacement[0], replacement[1])
+          end
+        end
+
+        if ! Configuration.markup_modifiers.empty?
+          Configuration.markup_modifiers.each do |replacement|
+            fragment.gsub!(replacement[0], replacement[1])
+          end
+        end
+        fragment
+      end
+
       def validator_host
         Configuration.markup_validator_host
       end

data/lib/be_valid_asset/configuration.rb

@@ -0,0 +1,27 @@
+module BeValidAsset
+  class Configuration
+    @@config = {
+      :display_invalid_content      => false,
+      :enable_caching               => false,
+      :display_invalid_lines        => false,
+      :display_invalid_lines_count  => 5
+    }
+
+    def self.method_missing(name, *args)
+      if name.to_s =~ /^(.*)=$/
+        @@config[$1.to_sym] = args[0]
+      elsif @@config.has_key?(name)
+        return @@config[name]
+      else
+        super
+      end
+    end
+
+    def self.cache_path=(path)
+      @@config[:cache_path] = path
+      unless File.directory? path
+        FileUtils.mkdir_p path
+      end
+    end
+  end
+end

data/lib/be_valid_asset/version.rb

@@ -0,0 +1,3 @@
+module BeValidAsset
+  VERSION = "1.2.3"
+end

data/spec/be_valid_asset/be_valid_markup_spec.rb

@@ -261,6 +261,40 @@ describe 'be_valid_markup' do
 
       ENV.delete('NONET')
     end
+
+    describe "with default modifiers" do
+      it "should strip off cache busters for href and src attributes" do
+        html = get_file('valid_with_cache_busters.html')
+        html_modified = get_file('valid_without_cache_busters.html')
+        be_valid_markup = BeValidAsset::BeValidMarkup.new
+        be_valid_markup.should_receive(:validate).with({:fragment => html_modified})
+        be_valid_markup.matches?(html)
+      end
+
+      it "should not strip off cache busters if caching isn't enabled" do
+        BeValidAsset::Configuration.enable_caching = false
+        html = get_file('valid_with_cache_busters.html')
+        be_valid_markup = BeValidAsset::BeValidMarkup.new
+        be_valid_markup.should_receive(:validate).with({:fragment => html})
+        be_valid_markup.matches?(html)
+      end
+    end
+  end
+
+  describe "markup modification" do
+    before :each do
+      BeValidAsset::Configuration.markup_modifiers = [[/ srcset=".*"/, '']]
+    end
+    after :each do
+      BeValidAsset::Configuration.markup_modifiers = []
+    end
+    it "should apply modification" do
+      html = get_file('html_with_srcset.html')
+      html_modified = get_file('html_without_srcset.html')
+      be_valid_markup = BeValidAsset::BeValidMarkup.new
+      be_valid_markup.should_receive(:validate).with({:fragment => html_modified})
+      be_valid_markup.matches?(html)
+    end
   end
 
   describe "Proxying" do

data/spec/files/html_with_srcset.html

@@ -0,0 +1,14 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
+  <title>Test Valid Page</title>
+</head>
+
+<body>
+
+<h1>Test#valid</h1>
+<img src="/images/test.jpg" alt="test" srcset="/images/test.jpg">
+<br>
+</body>
+</html>

data/spec/files/html_without_srcset.html

@@ -0,0 +1,14 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
+  <title>Test Valid Page</title>
+</head>
+
+<body>
+
+<h1>Test#valid</h1>
+<img src="/images/test.jpg" alt="test">
+<br>
+</body>
+</html>

data/spec/files/valid_with_cache_busters.html

@@ -0,0 +1,16 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
+  <title>Test Valid Page</title>
+</head>
+
+<body>
+
+<h1>Test#valid</h1>
+<p>This is an example valid html5 file</p>
+<a href="/testing?655557777">Test link</a>
+<img src="/images/test.jpg?123456" alt="test">
+<br>
+</body>
+</html>

data/spec/files/valid_without_cache_busters.html

@@ -0,0 +1,16 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
+  <title>Test Valid Page</title>
+</head>
+
+<body>
+
+<h1>Test#valid</h1>
+<p>This is an example valid html5 file</p>
+<a href="/testing">Test link</a>
+<img src="/images/test.jpg" alt="test">
+<br>
+</body>
+</html>

metadata

@@ -1,21 +1,23 @@
 --- !ruby/object:Gem::Specification
 name: be_valid_asset
 version: !ruby/object:Gem::Version
-  version: 1.2.2
+  version: 1.2.3
   prerelease: 
 platform: ruby
 authors:
 - Alex Tomlins
-- Sebastian de Castelberg
+- Attila Gyorffy
 - Ben Brinckerhoff
+- Jolyon Pawlyn
+- Sebastian de Castelberg
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-08-09 00:00:00.000000000 Z
+date: 2012-12-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &2151771900 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -23,27 +25,72 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *2151771900
-description: Provides be_valid_xhtml, be_valid_css and be_valid_feed matchers for
-  rspec controller and view tests.
-email: github@unboxedconsulting.com
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '2.0'
+description: Provides be_valid_markup, be_valid_css and be_valid_feed matchers for
+  RSpec controller and view tests.
+email:
+- github@unboxedconsulting.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- .gitignore
+- .rspec
+- Gemfile
+- LICENSE.txt
+- README.md
 - Rakefile
-- README.markdown
-- MIT-LICENSE.txt
+- be_valid_asset.gemspec
+- lib/be_valid_asset.rb
 - lib/be_valid_asset/be_valid_base.rb
 - lib/be_valid_asset/be_valid_css.rb
 - lib/be_valid_asset/be_valid_feed.rb
 - lib/be_valid_asset/be_valid_markup.rb
 - lib/be_valid_asset/be_valid_xhtml.rb
-- lib/be_valid_asset.rb
+- lib/be_valid_asset/configuration.rb
+- lib/be_valid_asset/version.rb
 - spec/be_valid_asset/be_valid_css_spec.rb
 - spec/be_valid_asset/be_valid_feed_spec.rb
 - spec/be_valid_asset/be_valid_markup_spec.rb
-- spec/spec_helper.rb
+- spec/files/html_with_srcset.html
+- spec/files/html_without_srcset.html
 - spec/files/invalid.css
 - spec/files/invalid.html
 - spec/files/invalid2.html
@@ -55,9 +102,12 @@ files:
 - spec/files/valid.html
 - spec/files/valid.html5
 - spec/files/valid_feed.xml
-- spec/spec.opts
+- spec/files/valid_with_cache_busters.html
+- spec/files/valid_without_cache_busters.html
+- spec/spec_helper.rb
 homepage: http://github.com/unboxed/be_valid_asset
-licenses: []
+licenses:
+- MIT
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -68,19 +118,41 @@ required_ruby_version: !ruby/object:Gem::Requirement
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
+      segments:
+      - 0
+      hash: -4532398578737053975
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
+      segments:
+      - 0
+      hash: -4532398578737053975
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.10
+rubygems_version: 1.8.23
 signing_key: 
 specification_version: 3
-summary: Markup validation for RSpec
+summary: Markup and asset validation for RSpec
 test_files:
 - spec/be_valid_asset/be_valid_css_spec.rb
 - spec/be_valid_asset/be_valid_feed_spec.rb
 - spec/be_valid_asset/be_valid_markup_spec.rb
+- spec/files/html_with_srcset.html
+- spec/files/html_without_srcset.html
+- spec/files/invalid.css
+- spec/files/invalid.html
+- spec/files/invalid2.html
+- spec/files/invalid_feed.xml
+- spec/files/valid-1.css
+- spec/files/valid-2.css
+- spec/files/valid-3.css
+- spec/files/valid.css
+- spec/files/valid.html
+- spec/files/valid.html5
+- spec/files/valid_feed.xml
+- spec/files/valid_with_cache_busters.html
+- spec/files/valid_without_cache_busters.html
+- spec/spec_helper.rb

data/README.markdown

@@ -1,158 +0,0 @@
-be\_valid\_asset
-==============
-
-Provides `be_valid_markup`, `be_valid_css` and `be_valid_feed` matchers for rspec controller and view tests.
-
-Installation
-------------
-
-To use be\_valid\_asset in your project, install the gem:
-
-    gem install be_valid_asset
-
-or install as a plugin
-
-    ./script/plugin install git://github.com/unboxed/be_valid_asset.git
-
-Add the following to the `spec/support/be_valid_asset.rb`:
-(for older versions of RSpec you'll need to require it from `spec_helper.rb`)
-
-    include BeValidAsset
-    
-    # BeValidAsset::Configuration.display_invalid_content = true
-    BeValidAsset::Configuration.enable_caching = true
-    BeValidAsset::Configuration.cache_path = File.join(RAILS_ROOT, %w(tmp be_valid_asset_cache))
-
-See below for details of the configuration options available
-
-Usage
------
-
-### Markup validation
-
-It can be used to test either an ActionController Response object as follows:
-
-    describe FooController do
-      integrate_views
-
-      describe "GET 'index'" do
-        it "should have valid markup" do
-          get 'index'
-          response.should be_valid_markup
-        end
-      end
-    end
-
-or
-
-    describe "/index.html" do
-      it "should be valid markup" do
-        render 'home/index', :layout => true
-        response.should be_valid_markup
-      end
-    end
-
-or to test a string:
-
-    it "should be valid markup" do
-      html = File.read(File.join(RAILS_ROOT, %w(public index.html)))
-      html.should be_valid_markup
-    end
-
-It is also possible to validate an html fragment.  This assumes xhtml-1.0 strict.
-
-    it "should be valid html" do
-      string = "<p>This is an html fragment</p>"
-      string.should be_valid_markup_fragment
-    end
-
-### CSS validation
-
-CSS files can be validated as follows:
-
-    it "should be valid CSS" do
-      css = File.read(File.join(RAILS_ROOT, %w(public stylesheets main.css)))
-      css.should be_valid_css
-    end
-
-be\_valid\_css takes an optional parameter specifying the css profile to test against. It defaults to testing against CSS 2.1. It can be set to any of the profiles supported by the CSS validator (e.g. css1, css2, css21, css3). There are also the following shortcut methods:
-
- * `be_valid_css1` => CSS 1.0
- * `be_valid_css2` => CSS 2.1
- * `be_valid_css3` => CSS 3.0
-
-### Feed validation
-
-RSS and Atom feeds can be validated from a response, or a string, in the same way as for html or CSS.  e.g.
-
-    describe FooController do
-      integrate_views
-
-      describe "GET 'index.rss'" do
-        it "should be valid" do
-          get 'index.rss'
-          response.should be_valid_feed
-        end
-      end
-    end
-
-There are also aliased methods `be_valid_rss` and `be_valid_atom` that do the same thing.
-
-Environment Variables
----------------------
-
-### Disabling network tests
-
-If the environment variable `NONET` is set to true, then all tests with no cached response available will be marked as pending.
-
-### http_proxy
-
-If you need to use a proxy server to access the validator service, set the environment variable http_proxy.
-
-Configuration
--------------
-
-The following can be set in `spec/support/be_valid_asset.rb`:
-
-### Display Full source for failures:
-
-    BeValidAsset::Configuration.display_invalid_content = false (default)
-
-### Display surrounding source for failures:
-
-This will cause it to output the failing line, and n surrounding lines (defaults to 5)
-
-    BeValidAsset::Configuration.display_invalid_lines = false (default)
-    BeValidAsset::Configuration.display_invalid_lines_count = 5 (default)
-
-### Change validator host/path:
-
-    BeValidAsset::Configuration.markup_validator_host = 'validator.w3.org'
-    BeValidAsset::Configuration.markup_validator_path = '/check'
-    BeValidAsset::Configuration.css_validator_host = 'jigsaw.w3.org'
-    BeValidAsset::Configuration.css_validator_path = '/css-validator/validator'
-    BeValidAsset::Configuration.feed_validator_host = 'validator.w3.org'
-    BeValidAsset::Configuration.feed_validator_path = '/feed/check.cgi'
-
-If you are doing more than the occasional check, you should run your own copy of the validator, and use that.
-Instructions here: [http://validator.w3.org/docs/install.html](http://validator.w3.org/docs/install.html),  [http://jigsaw.w3.org/css-validator/DOWNLOAD.html](http://jigsaw.w3.org/css-validator/DOWNLOAD.html) or [http://validator.w3.org/feed/about.html#where](http://validator.w3.org/feed/about.html#where)
-
-### Caching
-
-be\_valid\_asset can cache the responses from the validator to save look-ups for documents that haven't changed.
-To use this feature, it must be enabled, and a cache path must be set:
-
-    BeValidAsset::Configuration.enable_caching = true
-    BeValidAsset::Configuration.cache_path = File.join(RAILS_ROOT, %w(tmp be_valid_asset_cache))
-
-Issues / Feature Requests
--------------------------
-
-Please use the [github issue tracker](http://github.com/unboxed/be_valid_asset/issues) to track any bugs/feature requests.
-
-Licensing etc.
---------------
-
-This was originally based on a blog post here: [http://www.anodyne.ca/2007/09/28/rspec-custom-matchers-and-be\_valid\_xhtml/](http://www.anodyne.ca/2007/09/28/rspec-custom-matchers-and-be_valid_xhtml/)
-
-This is distributed under the MIT Licence, see `MIT-LICENSE.txt` for the details.