aboutsummaryrefslogtreecommitdiffstats
path: root/railties/guides/w3c_validator.rb
blob: b55645a7a933a15a9a3bb14112cb6ec562346432 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
# ---------------------------------------------------------------------------
#
# This script validates the generated guides against the W3C Validator.
#
# Guides are taken from the output directory, from where all .html files are
# submitted to the validator.
#
# This script is prepared to be launched from the railties directory as a rake task:
#
# rake validate_guides
#
# If nothing is specified, all files will be validated, but you can check just
# some of them using this environment variable:
#
#   ONLY
#     Use ONLY if you want to validate only one or a set of guides. Prefixes are
#     enough:
#
#       # validates only association_basics.html
#       ONLY=assoc rake validate_guides
#
#     Separate many using commas:
#
#       # validates only 
#       ONLY=assoc,migrations rake validate_guides
#
# ---------------------------------------------------------------------------

require 'rubygems'
require 'w3c_validators'
include W3CValidators

module RailsGuides
  class Validator
    
    def validate
      validator = MarkupValidator.new

      guides_to_validate.each do |f|  
        puts "Validating #{f}"
        results = validator.validate_file(f)

        if !results.validity
          puts "#{f} FAILED W3C validation with #{results.errors.size} error(s):"
          results.errors.each do |error|
            puts error.to_s
          end
        end
      end
    end
    
    private
    def guides_to_validate
      guides = Dir["./guides/output/*.html"]
      ENV.key?('ONLY') ? select_only(guides) : guides
    end

    def select_only(guides)
      prefixes = ENV['ONLY'].split(",").map(&:strip)
      guides.select do |guide|
        prefixes.any? {|p| guide.start_with?("./guides/output/#{p}")}
      end
    end
  end
end

RailsGuides::Validator.new.validate